Skip to content

Latest commit

 

History

History
98 lines (78 loc) · 4.42 KB

basic-csharp-mod.md

File metadata and controls

98 lines (78 loc) · 4.42 KB

基本 C# Mod

介绍

本文档旨在一步一步教你如何创建一个简单的 C# Mod。这个Mod将会在单人模式的标题页面增加一个叫做 消息 的按钮。当点击按钮的时候，将会在聊天界面输出 Hello World。

准备

创建 C# 项目

创建 C# 项目之前，要明白的是，如果只是修改/增加物品，人物或场景的话，可以不需要创建项目。

  1. 启动 Microsoft Visual Studio 并且选择 创建新项目。
  2. 选择 类库 (.NET Framework)。
  3. 给项目起名字并且选择框架 .NET Framework 4.7.2。如果不能选这个选项，可以从这里下载。下载(开发者包)
  4. 现在你的项目已经创建好，设置你的构建路径到你的游戏目录下的Modules/MyModule/bin/Win64_Shipping_Client。
  5. 引用 游戏目录（不是指Modules目录）bin\Win64_Shipping_Client下的所有TaleWorlds.* DLLs 文件。并且引用每个官方模组的 TaleWorlds.* DLLs文件，目录为 Modules\ModuleName\bin\Win64_Shipping_Client。

Debugging 项目

  1. 打开 项目属性 到 Debug 选项卡。
  2. 选择 启动外部程序 选项，同时浏览到你游戏目录下（不是Modules目录）的bin\Win64_Shipping_Client文件夹里面的 Bannerlord.exe。
  3. 设置工作目录到游戏目录（不是Modules目录）下的 bin\Win64_Shipping_Client。
  4. 添加如下的命令行参数(要确定替代 MyModule 的名字)
    • /singleplayer _MODULES_*Native*SandBox*SandBoxCore*StoryMode*CustomBattle*MyModule*_MODULES_

在本教程中，我们的项目名字叫做 ExampleMod。

配置你的Module (SubModule.xml)

  1. 进入游戏目录下的Modules文件夹。

  2. 创建一个新的文件夹并且起名字，进入文件夹。

  3. 创建文件夹名字为 bin。

  4. 在 Visual Studio 中设置 构建输出的DLL到这个 bin 文件夹下面。

  5. 在 VS Project 下创建一个新的类 MySubModule。

  6. 创建文件 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>

  7. 如果你用了不同的名字，记得修改对应的值

  8. 开始启动，确保你的 Mod 出现 Singleplayer > Mods。

对于Mod文件结构的信息，请参考这里

编写代码

  1. 打开 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 然后选择你的 Mod， 然后启动游戏。

  8. 在标题页面，你应该能看到一个按钮叫做 消息 ，点击你应该能看到 Hello World 出现在屏幕左下角。

  9. 现在你已经成功创建了第一个骑马与砍杀2：霸主的Mod！