骑马与砍杀2Mod开发新手指南cnedwin（持续更新ing）

cnedwin · 发表于 2021-4-25 23:04:03

本帖最后由 cnedwin 于 2021-4-26 00:35 编辑

内容会逐渐编写，大家如果有什么建议，可以给我发帖留言。

内容提纲：
第一章：准备工作和部分文档
第二章：如何创建一个新的Mod，以及C#工程示例
第三章：骑马与砍杀2的游戏主体结构讲解
第四章：如何通过修改XML来修改装备和兵种
第五章：如何在大地图上制作一个新的定居点
第六章：骑马与砍杀2的一些程序常见定义
第七章：骑马与砍杀2的GUI系统和组件布局
第八章：通过HarmonyLib修改骑砍与砍杀2的方法和关键参数
第九章：骑马与砍杀2的监听器(Tick)和事件注册(Event)
第十章：骑马与砍杀2的消息提示和输入输出
十一章：骑马与砍杀2的如何增加和修改热键（Key）
十二章：骑马与砍杀2的本地化(Localization)和多语言系统
十三章：骑马与砍杀2的存档数据(SaveData)与同步机制
十四章：骑马与砍杀2的角色创建和角色开发相关
十五章：骑马与砍杀2的角色技能和特质系统
十六章：骑马与砍杀2的定居点相关功能
十七章：骑马与砍杀2的摄像头控制
十八章：骑马与砍杀2的战场相关和AI控制
十九章：骑马与砍杀2的 Mod编辑器如何导入3D模型
二十章：骑马与砍杀2的 Mod编辑器如何创建制作一件装备
二十一章：骑马与砍杀2的 Mod编辑器如何创建一个新的场景

第一章：准备工作和部分文档

骑马与砍杀是自研引擎，使用C++开发底层引擎，整个游戏的逻辑是基于C#语言开发，保存配置和数据使用XML文件。
因此我们需要准备一下常用的软件：
C#开发用 Visual Studio 2019 https://visualstudio.microsoft.com/zh-hans/vs/
编辑XML文件 NotePad++  https://notepad-plus.en.softonic.com/download
反编译查看骑砍2的源代码
   dnSPY https://github.com/dnSpy/dnSpy/releases/tag/v6.1.8 代码还原度比较高，但是自带调试工具，强大的关联分析，而且可以直接修改DLL
   ILSPY    https://github.com/icsharpcode/ILSpy/releases/tag/v7.0-rc2 代码还原度比较高，轻便，但只能阅读和搜索，建议的分析
   DotPeek  https://www.jetbrains.com/decompiler/    代码还原度很高，并且可以导出一个VS工程，但不能编译回原有工程
对比不同的文件夹或者文件差异 Beyond Compare 4 https://www.scootersoftware.com/BCompare-zh-4.3.7.25118.exe
骑马与砍杀2 官方 Mod编辑器  在 Steam的游戏库中勾选工具，安装 Mount & Blade II Bannerlord Modding Kit

以下是一些有用的资料：

官方的文档库：
https://github.com/TaleWorlds/Documentations
http://docs.modding.bannerlord.com/zh_cn/
VS2019的Mod工程模板：
https://github.com/BUTR/Bannerlord.Module.Template
砍2MOD开发技术以及mod工具部分教程
https://bbs.mountblade.com.cn/thread-2069427-1-1.html
砍2Mod场景编辑器教程
https://www.bilibili.com/medialist/detail/ml1093229335?spm_id_from=333.788.b_636f6d6d656e74.4
Aewol 的砍2MOD开发技术以及mod工具部分教程
https://www.bilibili.com/read/cv7847470
秃猴的骑马与砍杀2 武器模型导入教程
https://www.bilibili.com/video/BV1Va4y1L74B

如果你没有C#语言基础，还可以在B站找到类似的教程

最新某机构C#零基础入门全套课程 https://www.bilibili.com/video/BV1UK4y1v713

另外推荐一些：学习C#的好去处

https://msdn.microsoft.com
https://www.cnblogs.com (中文，强烈推荐)
https://www.codeplex.com (源码，强烈推荐)
https://www.codeproject.com (英文，强烈推荐)
https://code.msdn.microsoft.com/ (推荐)
https://www.asp.net
https://www.gotdotnet.com
https://www.windowsforms.com
https://www.c-sharpcorner.com

cnedwin · 发表于 2021-4-25 23:04:06

本帖最后由 cnedwin 于 2021-5-1 00:13 编辑

第二章：如何创建一个新的Mod，以及C#工程示例

骑砍2的Mod是由C#语言编写，引用官方的dll库，编译为dll，再通过修改submodules.xml来引入游戏的。

创建模组（SubModule.xml）
1. 前往游戏文件下的 Modules 目录。
2. 创建一个新的文件夹并命名为 ExampleMod（必须跟你第4步使用的id相同）。
3. 创建一个新的文件夹并命名为 bin 然后在其中新建一个子文件夹并命名为 Win64_Shipping_Client。
4. 在你第2步创建的目录下新建一个文件 SubModule.xml（必须是这个文件名）并粘贴该代码：源链接

<Module>
<Name value="Example Mod"/>
<Id value="ExampleMod"/>
<Version value="v1.0.0"/>
<SingleplayerModule value="true"/>
<MultiplayerModule value="false"/>
<DependedModules>
<DependedModule Id="Native"/>
<DependedModule Id="SandBoxCore"/>
<DependedModule Id="Sandbox"/>
<DependedModule Id="CustomBattle"/>
<DependedModule Id="StoryMode" />
</DependedModules>
<SubModules>
<SubModule>
<Name value="ExampleMod"/>
<DLLName value="ExampleMod.dll"/>
<SubModuleClassType value="ExampleMod.MySubModule"/>
<Tags>
<Tag key="DedicatedServerType" value="none" />
<Tag key="IsNoRenderModeElement" value="false" />
</Tags>
</SubModule>
</SubModules>
<Xmls/>
</Module>

复制代码

注意：MySubModule 是在编程部分会使用的类的名字。
5. 如果你使用了不同的名字，请修改以上文件并匹配你的 Module/SubModule 的值。
6. 打开游戏启动器并确认你的模组名字出现在了 Singleplayer > Mods 中。
查看更多有关目录的信息，请访问目录结构。

创建项目
在创建项目之前，要告知你这里对于基础模组（如物品/场景/文化等）而言是不需要的。

启动 Microsoft Visual Studio 并点击新建项目（Create New Project）。
选择 Class Library (.NET Framework)。
将你的项目命名为 ExampleMod（如果你用了其它名字请确保命名空间和程序集名称是正确的）并使用.NET Framework 4.7.2 作为 Framework。如果没有这个选项，在这里下载（开发包）。
建好项目后，设置你的编译路径为游戏目录下的 Modules/ExampleMod/bin/Win64_Shipping_Client。
引用在你游戏文件目录（不是你的模组目录）下 bin\Win64_Shipping_Client 中的 TaleWorlds.*（DLLs），并且引用每个官方模组目录 Modules\ModuleName\bin\Win64_Shipping_Client 下的 TaleWorlds.* DLLs。

调试项目（可选）

打开项目属性并转至 调试Debug 标签页。
选择 Start external program 选项并浏览至游戏文件（不是你的模组）下的目录 bin\Win64_Shipping_Client 中的 Bannerlord.exe。
设置工作目录为游戏文件（不是你的模组）下的目录 bin\Win64_Shipping_Client。
添加以下命令行参数（确定把 ExampleMod 换成了你的模组的名字）

/singleplayer _MODULES_*Native*SandBoxCore*CustomBattle*SandBox*StoryMode*ExampleMod*_MODULES_

编程
1. 在你的 VS 项目中新建一个类并命名为 MySubModule，然后打开它。
2. 将以下指令添加到你的类中：

using TaleWorlds.Core;
using TaleWorlds.Localization;
using TaleWorlds.MountAndBlade;

复制代码

3. 继承 MBSubModuleBase 类。
4. 复写 OnSubModuleLoad() 继承方法。
5. 添加如下代码到你的复写方法中：源链接

Module.CurrentModule.AddInitialStateOption(new InitialStateOption("Message",
new TextObject("消息", null),
9990,
() => { InformationManager.DisplayMessage(new InformationMessage("Hello World!")); },
false));

复制代码

6. 编译你的项目并确定文件被输出到了 Modules\ExampleMod\bin\Win64_Shipping_Client。
7. 打开游戏启动器转到 Singleplayer > Mods 确定你的模组被勾选了并启动。
8. 在主界面中，你应该可以看到一个 Message 按钮，单击后你会在左下角聊天框看见输出了 Hello World。
9. 你成功地创建了你的第一个游戏模组！

现成的Mod工程VS模板

Bannerlord.Module.Template https://github.com/BUTR/Bannerlord.Module.Template
下载安装后，在Visual Studio 2019中就可以直接创建一个Mod工程，非常方便。

cnedwin · 发表于 2021-4-25 23:04:08

本帖最后由 cnedwin 于 2021-5-1 00:52 编辑

第三章，骑马与砍杀2的游戏主体结构讲解

1，骑砍的文件夹结构
QQ图片20210501003348.png

这是Mod文件夹（安装其他Mod只要丢到这个文件夹里就可以）
QQ图片20210501003932.png

在启动器里的顺序如下（从上往下，也叫从前往后）：
1，Native
QQ图片20210501005133.png

2,
3,
4,
5,

cnedwin · 发表于 2021-4-25 23:04:11

11111111111

cnedwin · 发表于 2021-4-25 23:04:14

11111111111

cnedwin · 发表于 2021-4-25 23:04:20

本帖最后由 cnedwin 于 2021-4-26 01:17 编辑

第六章：骑马与砍杀2的一些程序常见定义

Mission

Agent

Behavior

Logic

Component

MVVM模式
View
ViewModel
Model

Brushes （笔刷）
Prefabs (预制元件)

HUD

Hero

CharacterObjcet

Monster

Harmony

Sencne
Screen

cnedwin · 发表于 2021-4-25 23:04:29

1111111

cnedwin · 发表于 2021-4-25 23:04:35

11111111111

cnedwin · 发表于 2021-4-25 23:04:37

1111111111111

cnedwin · 发表于 2021-4-25 23:04:39

1111111111111

cnedwin · 发表于 2021-4-25 23:05:21

111111111

cnedwin · 发表于 2021-4-25 23:05:25

1111111111111

cnedwin · 发表于 2021-4-25 23:05:29

111111111111

cnedwin · 发表于 2021-4-25 23:05:34

1111111111

cnedwin · 发表于 2021-4-25 23:05:36

11111111111

cnedwin · 发表于 2021-4-25 23:05:39

11111111

cnedwin · 发表于 2021-4-25 23:40:14

111111111

cnedwin · 发表于 2021-4-25 23:40:17

11111111111

cnedwin · 发表于 2021-4-25 23:40:20

111111111111111

cnedwin · 发表于 2021-4-25 23:40:22

11111111111

cnedwin · 发表于 2021-4-25 23:40:25

1111111

cnedwin · 发表于 2021-4-25 23:40:28

1111111111

cnedwin · 发表于 2021-4-25 23:40:32

1111111111

cnedwin · 发表于 2021-4-25 23:40:34

111111111

cnedwin · 发表于 2021-4-25 23:40:38

111111111111

cnedwin · 发表于 2021-4-25 23:44:28

1111111111

cnedwin · 发表于 2021-4-25 23:44:30

111111111111

cnedwin · 发表于 2021-4-25 23:44:32

11111111111111111

cnedwin · 发表于 2021-4-25 23:44:36

11111111111

cnedwin · 发表于 2021-4-25 23:44:40

1111111111111

		自动登录	找回密码
密码			注册(Register!)

[版主推荐] 骑马与砍杀2Mod开发新手指南cnedwin（持续更新ing）

评分

鲜花鸡蛋

鲜花鸡蛋

鲜花鸡蛋

战团正版勋章

霸主正版勋章

骑士美德之英勇勋章[杰出会员活跃勋章]

骑士美德之仁慈勋章[杰出会员互助勋章]

骑士美德之正义勋章[杰出会员荣誉勋章]

大航海时代勋章

舰长勋章