Wiki

trigger · is_hired_as_advisor

Definition

  • Supported scope:CHARACTER
  • Supported target:none

Description

is_hired_as_advisor = yes/no - Checks if the current character has at least one advisor role for which they are hired

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

is_hired_as_advisor is commonly used in advisor-related events or decisions to check whether a character is currently in "employed advisor" status, thereby determining whether to trigger dismissal, promotion, or special storylines. For example, in a mod where you want to add an extra trait to an employed advisor, or in the available block of a country decision to restrict certain tasks to only advisors currently being hired:

# Example: Only allow subsequent effects to trigger when the character is hired as an advisor
some_character = {
    limit = {
        is_hired_as_advisor = yes
    }
    add_trait = { token = experienced_advisor }
}

Synergy

  • [has_advisor_role](/wiki/trigger/has_advisor_role) — Use together to first check whether a character possesses a certain advisor role definition, then use is_hired_as_advisor to further confirm whether that role is truly in active service, forming a dual filter of "has role and on duty."
  • [advisor_can_be_fired](/wiki/trigger/advisor_can_be_fired) — Often appears together in conditional checks within dismissal workflows, first confirming the character has been hired, then checking whether the advisor is currently allowed to be fired, avoiding redundant checks on characters not in service.
  • [remove_advisor_role](/wiki/effect/remove_advisor_role) — Use together in effect blocks: first gate-check with is_hired_as_advisor = yes in the limit, confirm active status, then safely remove the advisor role, preventing script errors or abnormal behavior from attempting removal on inactive characters.
  • [set_can_be_fired_in_advisor_role](/wiki/effect/set_can_be_fired_in_advisor_role) — When needing to dynamically lock an advisor as non-dismissible, typically first use is_hired_as_advisor = yes to confirm active status, then modify the dismissal attribute through this effect for more rigorous logic.

Common Pitfalls

  1. Confusing it with is_advisor: is_advisor only checks whether a character possesses an advisor role definition (whether they are configured as an advisor), while is_hired_as_advisor checks whether the character is currently actually employed by a country; failing to distinguish these two causes false positives when a character has not yet been hired by any nation.
  2. Incorrect scope usage: This trigger must be used under CHARACTER scope; if written directly in a country scope conditional block without first switching to character scope, the game will error or silently return false, a common mistake where beginners forget to wrap the character with = { } and switch scope before invoking the trigger.