保姆级教程：手把手教你从零写一个Rimworld 1.4 Mod的About.xml配置文件
从零构建Rimworld 1.4 Mod的About.xml配置文件：新手避坑指南
当你第一次打开Rimworld的Mod文件夹时，那些看似简单的XML文件背后其实隐藏着整个Mod生态的通行证。About.xml就像你Mod的身份证——它不仅决定了玩家在订阅列表中看到什么，更影响着Mod加载时的生死存亡。我曾见过一个标点符号的错误导致整个Mod列表崩溃，也遇到过因为packageId冲突让玩家无法启动游戏的惨剧。让我们从最基础的"自动厨房"Mod案例开始，一步步拆解这个不到1KB却能决定Mod命运的关键文件。
1. 创建About.xml的基础框架
打开你喜欢的文本编辑器（VSCode、Sublime Text甚至Notepad++都可以），新建一个名为About.xml的纯文本文件。第一行必须声明XML版本和编码，这是所有XML文件的通用规范：
<?xml version="1.0" encoding="utf-8"?> <ModMetaData> </ModMetaData>这个骨架就像房子的地基——没有它，后续所有内容都无法被游戏正确识别。保存时务必确认：
- 文件名严格区分大小写，必须是
About.xml而非about.xml或ABOUT.XML - 编码选择UTF-8无BOM格式（在Notepad++中通过"编码"菜单转换）
- 文件直接放在Mod文件夹的根目录下，不要放在子文件夹中
提示：在VSCode中安装XML扩展后，输入
<时会自动补全闭合标签，大幅降低语法错误概率
2. 核心字段：Mod的身份证信息
2.1 name字段：第一印象的艺术
<name>自动厨房 (Auto Kitchen)</name>- 命名禁忌：
- 禁止包含
<、>等XML特殊字符（可用<等实体代替） - 避免使用连续空格或制表符
- 长度控制在50个字符以内以保证UI显示完整
- 禁止包含
- 最佳实践：
- 中英文对照方便国际玩家识别
- 添加版本号如
[1.4]帮助玩家确认兼容性 - 使用
|、-等符号分隔修饰词
2.2 author字段：你的开发者签名
<!-- 单作者写法 --> <author>你的Steam昵称</author> <!-- 团队开发写法 --> <authors> <li>主开发者</li> <li>美术设计</li> <li>测试人员</li> </authors>- 如果使用
<authors>列表，游戏只会显示第一个作者名+等字 - 商业Mod注意：这里填写的作者名将作为版权声明的依据
2.3 packageId：不可重复的Mod DNA
这是整个About.xml中最重要的字段，相当于Mod的全局唯一标识符。格式规范如下：
<packageId>yourname.mod.autokitchen</packageId>命名规则对照表：
| 错误示例 | 正确示例 | 原因分析 |
|---|---|---|
Auto Kitchen | autokitchen | 不能有空格 |
自动厨房 | autokitchen | 只能用ASCII字符 |
1stKitchen | firstkitchen | 不能数字开头 |
yourname..mod | yourname.mod | 不能连续小数点 |
致命错误：我曾见过两个Mod使用相同的
packageId导致玩家整个Mod列表崩溃。检查方法是在Steam Workshop搜索你的packageId，确认未被占用
3. 版本兼容性与依赖管理
3.1 supportedVersions：适配多版本策略
Rimworld 1.4的Mod可以这样声明版本兼容性：
<supportedVersions> <li>1.4</li> <li>1.3</li> </supportedVersions>当游戏版本与列表中的任何一项匹配时，Mod会正常显示；否则会黄色高亮并移至列表末尾。特殊技巧：
- 用
<li>1.4</li>精确匹配特定版本 - 用
<li>1.</li>匹配所有1.x版本（但不推荐）
3.2 依赖关系的三种控制方式
必须依赖（modDependencies）
<modDependencies> <li> <packageId>brrainz.harmony</packageId> <displayName>Harmony库</displayName> <!-- 可选 --> <steamWorkshopUrl>steam://url/CommunityFilePage/2009463077</steamWorkshopUrl> </li> </modDependencies>当依赖Mod不存在时，你的Mod根本不会加载
加载顺序（loadAfter/loadBefore）
<loadAfter> <li>brrainz.harmony</li> <li>OskarPotocki.VanillaFactionsExpanded.Core</li> </loadAfter>这就像告诉游戏："请把我的Mod排在Harmony和VFE核心之后加载"
强制不兼容（incompatibleWith）
<incompatibleWith> <li>CETeam.CombatExtended</li> </incompatibleWith>当检测到CE Mod时，游戏会阻止同时启用这两个Mod
4. description字段：你的Mod广告牌
描述字段支持多行文本和简单HTML标签，但要注意：
<description> <size=14>自动厨房 v1.4</size> ■ 功能亮点： • 自动完成食材拣选 • 智能避免食物腐败 • 可配置工作优先级 ■ 已知问题： - 与"冰箱"Mod同时使用时需要手动调整加载顺序 联系作者：your@email.com </description>排版技巧对照表：
| 效果 | 写法 | 注意事项 |
|---|---|---|
| 换行 | 直接回车或<br/> | 需要两个空格才会显示换行 |
| 加大字号 | <size=14>文本</size> | 最大不超过20 |
| 颜色 | <color=#FF0000>警告</color> | 要用HEX颜色码 |
| 列表 | ■、•等符号 | 不要使用<ul>标签 |
实测发现：描述框的显示宽度约450像素，超过10行会被截断，关键信息应放在前五行
5. 高级配置与版本分流
对于需要区分游戏版本的复杂Mod，可以使用*ByVersion系列标签：
<descriptionsByVersion> <v1.4> 1.4专属功能：新增电磁炉系统 </v1.4> <v1.3> 基础厨房功能（不含电磁炉） </v1.3> </descriptionsByVersion> <modDependenciesByVersion> <v1.4> <li> <packageId>newlib.1.4</packageId> </li> </v1.4> </modDependenciesByVersion>这种写法特别适合：
- 不同版本有重大API变更时
- 依赖库本身有版本分化时
- 需要为不同版本玩家提供差异化描述时
6. 验证与调试技巧
完成About.xml后，用这个检查清单确认无误：
基础验证：
- 用 XML验证器 检查语法
- 确认文件编码为UTF-8无BOM
- 检查所有标签闭合且嵌套正确
游戏内测试：
# 启动游戏时添加日志参数 RimWorldWin.exe -log查看生成的
Player.log文件，搜索你的packageId：Mod [你的Mod名] loaded successfully表示成功Duplicate packageId说明有冲突XML error指向具体的格式问题
极端情况测试：
- 临时修改packageId为已存在的值，观察冲突表现
- 故意写错supportedVersions，看黄色警告效果
- 测试依赖Mod缺失时的提示信息
记得每次更新About.xml后：
- 删除ModsConfig.xml让游戏重建Mod列表
- 检查所有依赖Mod的packageId是否随版本更新而变化
- 如果上架Steam Workshop，description的HTML标签需要额外转义
当你的Mod开始与其他创作者产生依赖关系时，一个规范的About.xml就像良好的API文档——它让整个生态更稳定。有次我忘记更新supportedVersions，导致玩家在1.4版本看到警告提示，这个教训让我养成了每次游戏更新都检查版本号的习惯。现在，你的"自动厨房"已经拥有了合法的身份证明，接下来就可以进入真正的C#编码环节了。