命令百科

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 完成注册流程的对比参考。

常见坑

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