effect · `recruit_character`

Definition

Supported scope:COUNTRY
Supported target:none

Description

Attach a character to a country. Must be in country scope.

Example:
GER = { recruit_character = GER_Character_token }

实战 · 配合 · 坑

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

实战用法

recruit_character 常用于国家焦点、决议或事件中，将事先在 characters 块定义好的角色（顾问、将领、国家领袖等）正式加入某个国家，使其出现在游戏内可供激活或指挥。典型场景是剧本触发某条历史事件后，为目标国动态补充一名新将领或顾问候选人。

# 在某国完成焦点后，将预定义角色招募进该国
focus = {
    id = GER_new_general
    ...
    completion_reward = {
        GER = {
            recruit_character = GER_Rommel
        }
    }
}

配合关系

[activate_advisor](/wiki/effect/activate_advisor) — 角色被招募后若携带顾问角色，需要再调用此命令才能让其真正上任为活跃顾问，否则角色仅存在于名单中而不产生效果。
[add_advisor_role](/wiki/effect/add_advisor_role) — 可在招募角色之后动态为其追加顾问职能，适合需要根据游戏状态灵活扩展角色能力的场景。
[has_character](/wiki/trigger/has_character) — 在执行招募前用此触发器检查目标角色是否已存在于该国，可防止重复招募导致脚本报错或逻辑混乱。
[generate_character](/wiki/effect/generate_character) — 当角色需要随机生成而非使用固定 token 时，先用此命令生成，再配合 recruit_character 完成注册流程的对比参考。

常见坑

角色 token 必须已在 characters 文件中预先定义，直接填写不存在的 token 不会报语法错误，但角色不会出现在游戏中，且控制台会静默失败，排查时极易忽略。
招募 ≠ 激活：recruit_character 只是将角色"挂载"到国家，若该角色带有顾问槽位，还需额外调用 activate_advisor 才能使其产生加成；新手常误以为招募后顾问效果会自动生效。

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

recruit_character is commonly used in national focuses, decisions, or events to formally add a character (advisor, general, national leader, etc.) that has been predefined in the characters block to a country, making them available for activation or command in-game. A typical scenario involves triggering a historical event in a script, after which a new general or advisor candidate is dynamically added to the target nation.

# After a country completes a focus, recruit a predefined character into that country
focus = {
    id = GER_new_general
    ...
    completion_reward = {
        GER = {
            recruit_character = GER_Rommel
        }
    }
}

Synergy

[activate_advisor](/wiki/effect/activate_advisor) — After a character is recruited, if they carry an advisor role, this command must be called separately to make them an active advisor; otherwise, the character exists only in the roster without producing any effects.
[add_advisor_role](/wiki/effect/add_advisor_role) — Allows you to dynamically add advisor functions to a character after recruitment, useful for scenarios where character capabilities need to be flexibly expanded based on game state.
[has_character](/wiki/trigger/has_character) — Use this trigger before executing recruitment to check whether the target character already exists in the country, preventing duplicate recruitment that could cause script errors or logic confusion.
[generate_character](/wiki/effect/generate_character) — When a character needs to be randomly generated rather than using a fixed token, use this command first to generate, then pair with recruit_character to complete the registration process for comparison reference.

Common Pitfalls

The character token must be predefined in the characters file — directly using a non-existent token will not cause a syntax error, but the character will not appear in-game, and the console will silently fail, making it easy to overlook during troubleshooting.
Recruitment ≠ Activation — recruit_character only "mounts" the character to the nation; if that character has an advisor slot, you must additionally call activate_advisor to make them produce bonuses. Newcomers often mistakenly assume that advisor effects take effect automatically after recruitment.

effect · recruit_character