命令百科

effect · load_oob

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Immediately loads an Order of Battle (OOB) file.

Example:
load_oob = "ENG_1936"

实战 · 配合 · 坑

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

实战用法

load_oob 常用于历史情景 mod 中，在特定触发条件下（如玩家完成某个国策或到达某一历史节点）为国家重新加载一套预设部队编制，也可用于内战事件中给叛军阵营即时刷入军队。注意 OOB 文件需位于 history/units/ 目录下且文件名与参数严格一致。

# 某国策完成后立即加载 1939 年的战时编制
complete_national_focus = SOV_war_preparations
hidden_effect = {
    load_oob = "SOV_1939_mobilization"
}

配合关系

  • [delete_units](/wiki/effect/delete_units)：在加载新 OOB 之前先清除旧部队，避免重复部队与新编制叠加产生冗余单位。
  • [add_manpower](/wiki/effect/add_manpower)：OOB 文件生成部队会消耗人力，提前补充人力可确保部队完整生成而不出现残编。
  • [country_event](/wiki/effect/country_event)：常作为事件选项的效果之一，在玩家做出选择后立即加载对应的部队编制，搭配叙事性事件使用体验更流畅。
  • [has_completed_focus](/wiki/trigger/has_completed_focus)：作为触发 load_oob 的前置条件判断，确保只在完成特定国策后才执行部队加载，防止提前或重复触发。

常见坑

  1. 文件名大小写不匹配：HOI4 在 Linux/Mac 环境下对文件名大小写敏感，若脚本中写的是 "ENG_1936" 而实际文件名为 "eng_1936.txt"，游戏将静默失败且不报错，导致部队根本不出现。
  2. 未清理旧部队直接加载：直接在已有大量部队的国家上调用 load_oob 不会替换现有部队，而是叠加生成，造成师级单位数量爆炸，严重影响 AI 行为和游戏性能。