《骑马与砍杀2：霸主》Mod 制作文档
TaleWorlds 官方的《霸主》Mod 制作指南：模块、资产、场景、编辑器工具、音频、多人游戏和海战内容。代码参考请查看 API 文档。
快速开始
第一次制作《霸主》Mod？请按顺序完成以下步骤：
- 创建一个Mod - 快速入门：创建并注册你的第一个模块。
- 添加与覆盖资产：添加新资产或替换现有资产。
- 将模块XML文件与原生数据合并：无需复制整个文件即可修改游戏数据。
- 上传/更新一个模组：将你的 Mod 发布到 Steam 创意工坊。
- 常见问题解答：常见问题的解答。
我想要……
添加音效和音乐
制作船只和海战内容
所有章节
资产管理
创建模块，添加或覆盖资产：网格、材质、纹理、动画、预制件等。
编辑任务场景
各类任务场景的要求，以及驱动游戏玩法的脚本组件和回调函数。
编辑器
使用场景编辑器和资源编辑器处理地形、导航网格、材质、骨骼和布料。
Audio Modding
使用 FMOD Studio 添加音效和音乐，从事件设置到场景音频和优化。
War Sails
为 War Sails 资料片制作船只、海上劫掠场景和世界地图内容。
多人游戏
架设服务器、创建自定义游戏模式和制作多人游戏场景。
最佳实践范例
XML 合并、XSLT、代码扩展和场景性能的推荐做法。
Steam 创意工坊
在 Steam 创意工坊上传和更新你的 Mod。
社区与资源
- API 文档：《霸主》代码参考。
- 骑马与砍杀 Mod 制作 Discord：提问并与其他 Mod 作者交流。
- Developer Workshop – Map Editor：TaleWorlds 官方直播，演示如何使用战役地图编辑器（英文）。
- TaleWorlds 论坛 – The Smithy：官方 Mod 开发论坛。
- 在 GitHub 上贡献：为本文档提出修改建议或新页面。
社区资源
以下资源由社区制作和维护，并非由 TaleWorlds 提供。部分资源基于旧版游戏制作，细节可能与当前版本不同。大多数资源仅提供英文版本。
文档与指南
- Bannerlord Documentation：社区编写的指南，包括 Gauntlet UI 和为 Vortex 打包 Mod。
- BannerlordModding.LT：记录 Mod 制作流程、技巧和经验的社区百科。
- Unofficial Bannerlord API Docs (BUTR)：根据游戏文件生成的各版本 API 参考。
- BUTR Documentation：Harmony 调试、崩溃报告以及使用 GitHub Actions 发布 Mod 的操作指南。
- Documentation & Tutorials 论坛版块：社区在 TaleWorlds 论坛分享的教程。
社区指南（Google 文档）
- 3D Asset Workflow：为《霸主》准备 3D 资源。
- Asset Import Workflow：分步骤的资源导入流程。
- Importing Assets into BL Editor：将你的资源导入《霸主》编辑器。
- Importing Material Maps in Editor：导入纹理和材质贴图。
- Basic World Mapping：制作自定义战役地图入门。
- Adding Custom Scenes to Custom Battle：在自定义战斗中测试你的场景。
- Adding Flora to flora_kinds：在 flora_kinds 中注册新植被。
- Bannerlord Layer Buttons, Options, and Settings（部分完成）：编辑器图层按钮、选项和设置的说明。
视频教程
- Lesser Scholar – Artisan Workshop Mod：共 19 集的 C# 课程，涵盖环境配置、战役行为、对话、Gauntlet UI、Harmony 和发布。
- A_Jannik：C# 入口点、调试和 Harmony 补丁。
- Danqna & Gispry：共 6 集的 C# 系列，涵盖 Visual Studio 配置、对话、存档和 MCM 菜单。
- Macbeth of Gondor：共 19 集的场景编辑器系列，涵盖地形、植被、导航网格、季节、预制件和屏障。
- Banner Lab：无需代码的 XML Mod 制作：兵种、物品、文化、王国、英雄和定居点。
- Lykon Development：XML 兵种、武器和王国，加载画面，以及 Blender 权重绘制。
- Adam Dotlačil：自定义弓、弩和箭袋，以及自定义模型的手部动画。
- BabyLettuce – Skeletons & Races：自定义骨骼和种族的完整教程。
工具
- Bannerlord Scene Toolkit（作者：FiefEvictionNotice）：在场景编辑器内运行的工具集，提供材质替换与重新着色、预制件创建、分布与镜像、场景分析和备份功能。参见教程视频（英文）。
- XBannerlord（作者：cookgreen）：Windows 平台的 XML 编辑器，以树形结构显示《霸主》XML 文件，并可通过与 AI 模型对话来编辑所选节点。提供英文和中文界面。GitHub 源代码。
- Bannerlord Crafting Tool（作者：haterade22）：Windows 工具，可在 2D 和 3D 中预览武器锻造部件，无需启动游戏即可调整部件偏移并检查武器长度。
入门资源包
- Campaign Map Prefab Starter Pack（作者：Lemmy1916）：带有预建定居点和脚本的现成战役地图，可用于制作新的世界地图。
- War Sails Campaign Map Prefab Starter Pack（作者：Lemmy1916）：为 War Sails 配置的同款入门地图。