trigger · `has_cosmetic_tag`

Definition

Supported scope:COUNTRY
Supported target:none

Description

Checks if country has specific cosmetic tag set.
Example: INS = { has_cosmetic_tag = INS1 }

实战 · 配合 · 坑

实战内容由 AI 生成,并已对照 vanilla 命令词表校验 —— 请当作起点而非权威依据。上方的定义节才是游戏自带文档原文。

实战用法

has_cosmetic_tag 常用于外观标签系统中，判断某国当前是否处于特定的"化妆标签"状态，从而决定是否触发后续事件、允许某项决议，或展示特定的本地化文本。例如在一个分裂/统一剧情 mod 里，可以用它来检查德国是否已经变成了"大德意志"外观，再决定是否开放相应的国策：

focus = {
    id = GER_unite_germany
    available = {
        has_cosmetic_tag = GER_grossdeutschland
    }
    ...
}

配合关系

[drop_cosmetic_tag](/wiki/effect/drop_cosmetic_tag)：在满足某条件后移除化妆标签，常与 has_cosmetic_tag 搭配形成"检查后撤销"的逻辑，例如战败或政权更迭时还原外观。
[has_country_flag](/wiki/trigger/has_country_flag)：化妆标签切换往往伴随国旗记录，两者合用可以更精准地区分同一国家在不同剧情阶段的状态。
[exists](/wiki/trigger/exists)：在涉及傀儡或分裂国家的场景中，先检查目标国是否存在再检查其化妆标签，避免因国家不存在而报错或产生意外结果。
[has_completed_focus](/wiki/trigger/has_completed_focus)：外观标签通常由国策赋予，用此 trigger 双重验证"完成了对应国策且标签已生效"，可提升条件判断的健壮性。

常见坑

作用域混淆：has_cosmetic_tag 只能在 COUNTRY scope 下使用，若不小心写在 STATE scope（如 any_owned_state 内部）会直接报错或静默失败，务必确认当前作用域是国家而非省份/州。
标签名拼写与大小写：化妆标签必须在 cosmetic_tags 文件中预先注册，且名称区分大小写；直接填写三字母国家标签（如 GER）并不等同于化妆标签，两者不可混用，否则条件永远不会为真。

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

has_cosmetic_tag is commonly used in cosmetic tag systems to determine whether a country is currently in a specific "cosmetic tag" state, thereby deciding whether to trigger subsequent events, allow certain decisions, or display specific localized text. For example, in a split/unification scenario mod, you can use it to check whether Germany has already become the "Großdeutsch" cosmetic appearance, and then decide whether to unlock the corresponding national focus:

focus = {
    id = GER_unite_germany
    available = {
        has_cosmetic_tag = GER_grossdeutschland
    }
    ...
}

Synergy

[drop_cosmetic_tag](/wiki/effect/drop_cosmetic_tag): Removes a cosmetic tag once a condition is met. Often paired with has_cosmetic_tag to create a "check then revoke" logic, such as restoring the original appearance when defeated or during regime change.
[has_country_flag](/wiki/trigger/has_country_flag): Cosmetic tag switches often go hand-in-hand with country flag tracking. Using both together allows more precise distinction between a country's states at different story stages.
[exists](/wiki/trigger/exists): In scenarios involving puppets or split nations, check whether the target country exists before checking its cosmetic tag, preventing errors or unexpected results from a non-existent nation.
[has_completed_focus](/wiki/trigger/has_completed_focus): Cosmetic tags are typically granted via national focuses. Use this trigger for double verification that "the corresponding focus was completed and the tag is now active," improving the robustness of condition checks.

Common Pitfalls

Scope Confusion: has_cosmetic_tag only works in COUNTRY scope. If you accidentally write it within STATE scope (such as inside any_owned_state), it will cause errors or fail silently. Always verify that the current scope is a country, not a state or province.
Tag Name Spelling and Case Sensitivity: Cosmetic tags must be pre-registered in the cosmetic_tags file, and names are case-sensitive. Using a three-letter country code directly (such as GER) is not equivalent to a cosmetic tag; the two cannot be used interchangeably, otherwise the condition will never evaluate to true.

trigger · has_cosmetic_tag