Modding 百科

入门

• 模组的目录结构与 descriptor.mod：模组放在哪、两个描述文件各管什么、内容文件夹怎么摆
• 加载顺序与覆盖规则：整文件覆盖与同名对象覆盖、FIOS/LIOS，以及 !!! 前缀为何会坑你
• 调试：控制台、error.log 与 -debug_mode：看懂日志、用控制台触发事件和执行脚本、带调试参数启动游戏

脚本基础

• 脚本语法与作用域：脚本基本写法、触发器与效果、this/root/from/prev
• 本地化（Localisation）：.yml 编码格式、$key$ 引用、§ 颜色、£ 图标与 replace
• 事件（Events）：事件文件的结构、命名空间、事件类型、触发方式与选项
• on_actions：在开局、每月、殖民、开战等时刻自动触发你的事件
• 脚本化触发器、效果、变量与 inline_script：用脚本化触发器/效果、脚本变量和 inline_script 复用脚本
• 修正（Modifiers）与触发式修正：修正键、静态修正、add_modifier 与触发式修正
• 变量、脚本值与脚本化本地化：运行时变量的读写与运算，script_values 的公式写法与参数，以及 scripted_loc 的 defined_text

内容模组

• 科技：common/technology 的字段、抽卡权重、可重复科技、科技替换与解锁显示
• 建筑、区划与区域：4.x 的行星建设三层结构：区划、区域槽、区域与建筑，以及各自的关键字段
• 岗位与人口阶层：pop_jobs 的岗位定义、swappable_data、准入条件与产出，以及 pop_categories 阶层
• 物种特质与领袖特质：common/traits 中物种特质和领袖特质的写法、可用性条件、修正块与图标
• 政体、国家理念与起源：governments 文件夹下的权力结构、国家理念、起源与政府名称，以及它们特有的列表式条件语法
• 政策与法令：policies 的多选项结构与 policy_flags，edicts 的时长、费用与修正，以及在脚本里设置它们
• 舰船：船体、区段与部件：ship_sizes、section_templates、component_templates 三层结构，武器数值表，全局舰船设计与模型命名规则
• 战争借口与战争目标：casus_belli 如何自动产生与销毁，war_goals 如何引用它、控制和谈结果，以及用脚本宣战
• 考古遗址与遗珍：archaeological_site_types 的分阶段挖掘、阶段事件写法，relics 遗珍与 artifact_actions 小型古物用途

界面与图形

• GFX、Sprite 与字体：.gfx 文件里的 spriteType 等精灵类型、图标的两种查找方式、贴图格式，以及 fonts.gfx 与 fonts.asset
• 界面（.gui）入门：.gui 文件结构、常用元素、定位规则，修改原版界面的限制，以及 effectbuttonType 和事件 custom_gui

原生插件（stl-plugin）

• 原生插件是什么：DLL 插件与脚本模组的区别、加载方式，以及作者和玩家都要清楚的风险
• 插件清单格式（stl-plugin.json）：stl-plugin.json 每个字段的含义，以及启动器如何校验与判断版本兼容
• 插件开发与调试流程：构建、链接安装、注入、日志与设置，以 stellaris-mcp 为例
• 插件的发布与索引：打包、GitHub Release 自动更新与 plugins.jsonl 索引