Wiki

effect · add_history_entry

Definition

  • Supported scope:(none)
  • Supported target:none

Description

add_history_entry = {
key = custom_localized_key
subject = "Custom String (not localized)"
allow = yes/no (allow medal award)
}

Hands-On Notes

Hands-on notes are AI-generated and checked against the vanilla command vocabulary — treat them as a starting point, not authoritative reference. The definition above is the game's own documentation.

Hands-On Usage

add_history_entry is commonly used to log significant diplomatic events, war crimes verdicts, or special historical milestones, allowing players to see traceable records of actions in event logs or character profiles. For example, in a tribunal event, when the player chooses to convict a general, that decision can be written to a history entry:

option = {
    name = war_tribunal.1.a
    add_history_entry = {
        key = war_tribunal_convicted
        subject = "General Schmidt convicted of war crimes"
        allow = yes
    }
}

Synergy

Currently, there are no other documented companion effects or triggers in the whitelist under this scope, making it impossible to provide verified cross-references. When using this effect, it is recommended to trigger it in conjunction with standard control flow within event or decision frameworks, and avoid referencing unverified commands.

Common Pitfalls

  1. Filling the subject field with localization keys instead of strings: The subject field accepts raw unlocalized strings. If you mistakenly enter a localization key name, the game will display the key name itself directly in the log without automatic translation, resulting in display errors.

  2. Misunderstanding the allow field purpose: Beginners often overlook the allow field's connection to medal award logic and treat it as a simple conditional toggle. In reality, this field controls whether specific medal reward logic triggers, and cannot replace trigger condition checks.