Basic Csharp Mod

访问源文档
返回目录

介绍

这个教程接下来将一步一步教你创建一个基于 C# 的模组，这个模组将添加一个叫 Message 的按钮到单人游戏主界面，在点击这个按钮后将输出 Hello World。

准备工作

本教程中，我们将这个项目命名为 ExampleMod。

创建模组（SubModule.xml）

1. 前往游戏文件下的 Modules 目录。
2. 创建一个新的文件夹并命名为 ExampleMod（必须跟你第4步使用的id相同）。
3. 创建一个新的文件夹并命名为 bin 然后在其中新建一个子文件夹并命名为 Win64_Shipping_Client。
4. 在你第2步创建的目录下新建一个文件 SubModule.xml（必须是这个文件名）并粘贴该代码：查看代码
   注意：MySubModule 是在编程部分会使用的类的名字。
5. 如果你使用了不同的名字，请修改以上文件并匹配你的 Module/SubModule 的值。
6. 打开游戏启动器并确认你的模组名字出现在了 Singleplayer > Mods 中。

查看更多有关目录的信息，请访问目录结构。

创建项目

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

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