命令百科

effect · set_naval_oob

Definition

  • Supported scope:COUNTRY
  • Supported target:none

Description

Registers an Order of Battle (OOB) file to be loaded for a country at game start, replacing any previously registered OOB (with key "naval") on that country.
Only intended to be used within history files.

Example:
set_naval_oob = "ENG_1936_Naval"

实战 · 配合 · 坑

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

实战用法

set_naval_oob 主要用于历史模式 mod 中为某个国家指定开局海军编制文件，常见于修改默认海军阵容、新增历史国家或彻底重构某国开局舰队的场景。指定的文件路径相对于 history/units/ 目录，文件名无需带扩展名。

# 在 history/countries/ENG - United Kingdom.txt 中
set_naval_oob = "ENG_1936_Naval_Custom"

配合关系

  • [create_ship](/wiki/effect/create_ship)：当 OOB 文件中的舰船需要额外的初始变体定义时，可在同一历史文件中先用此命令预先创建舰船变体，确保 OOB 加载时变体已存在。
  • [create_equipment_variant](/wiki/effect/create_equipment_variant)：海军 OOB 文件中引用的装备变体须事先注册，该命令通常与 set_naval_oob 出现在同一历史文件块中，负责声明舰船型号。
  • [has_capitulated](/wiki/trigger/has_capitulated)：在事件或决策中动态调整海军编制前，可用此触发器检查目标国是否仍处于活跃状态，避免无效赋值。
  • [destroy_ships](/wiki/effect/destroy_ships)：若需先清空某国现有舰队再通过新 OOB 重建，可在同一执行块中配合使用。

常见坑

  1. 在非历史文件中使用：该命令官方说明仅限于 history/ 文件内使用，若放入事件、决策或 focus 的 effect 块中，游戏已完成初始化加载，OOB 不会被正确解析，舰队不会生成。
  2. OOB 文件路径写错或大小写不匹配：文件名对大小写敏感，且必须与 history/units/ 下的实际文件名完全一致；写错会导致该国开局完全没有海军，且游戏日志中的报错容易被忽略。