按命令鸣笛

请阅读说明！

在为某些领主的派系作战时，我经常会在向部队下达命令时听到号角声，我不确定这是否只在我的游戏中出现，但当我领导一支军队时从未听到过这些号角声。考虑到这一点，我制作了这个简单的模组，它会在你向部队下达每一个移动命令时添加号角声。

手动安装：
只需将 HornOnOrders 文件夹复制到 Mount & Blade II Bannerlord/Modules 目录下。

• 你的文件夹结构应如下所示：Mount & Blade II Bannerlord/Modules/HornOnOrders/SubModules.xml。

加载外部文件：
遗憾的是，我未能如愿以偿地通过 SoundEvent.CreateEventsFromExternalFiles() 方法播放外部文件，从而让模组实现 2D 音效播放。在我仍在排查问题原因的同时，我采用了一个临时解决方案：通过外部库来播放 .ogg 音频文件，具体使用了 NVorbis 和 NAudio 这两个库（详情如下）。

要加载外部文件，只需按照几个步骤操作，并遵循预定的文件结构。
声音文件夹位于 Mount & Blade II Bannerlord\Modules\HornOnOrders\Sounds。
在那里你会看到一个名为 Default 的文件夹，该文件夹内包含一些该模组的默认号角音效。

如何添加更多音效：
您只需将 .ogg 文件添加到所需文件夹即可，但为了确保它们正常工作，需要满足一些要求：

• 文件必须为 .ogg 格式，否则游戏在尝试播放时会崩溃。
• 文件名必须为指令名称，后接一个下划线 "_" 和序号（例如：charge_01、charge_02 等）。你可以为同一指令添加任意数量的音效，代码会遍历它们，并在指令下达时随机播放其中一个。
• 目前唯一可用的指令有：前进、冲锋、撤退、跟随、坚守、后退、停止。
• 要更改声音，只需覆盖它们；要删除，只需从文件夹中删除文件。

如何为特定派系添加音效：
为此，你需要在 Mount & Blade II Bannerlord\Modules\HornOnOrders\Sounds 路径下添加一个新文件夹，并以你想要添加自定义音效的派系名称命名。例如 Mount & Blade II Bannerlord\Modules\HornOnOrders\Southern Empire。在该文件夹内，你需要按照上述要求添加相应的文件。
请注意，如果派系文件夹不存在，将使用 Default 默认文件夹；如果派系文件夹存在但没有特定指令对应的文件，则在发出该指令时不会播放任何声音。

原版派系名称：
北方帝国、南方帝国、西方帝国、巴坦尼亚、瓦兰迪亚、斯特吉亚、阿塞莱、库赛特

这个模组里那些额外的 .dll 文件是什么？
它们让我的临时解决方案得以运作，至少在我成功利用游戏功能从外部文件播放 2D 音效之前是这样。你可以在以下位置找到每个的文档：

• NVorbis - Github 链接
• NAudio - GitHub 链接
• NAudio.Vorbis - Github 链接
• System.Buffers - Microsoft 文档链接
• System.Memory - NuGet 链接
• System.Runtime.CompilerServices.Unsafe - Microsoft 文档链接

模组运行所需条件：

• 只需拥有超过 40 个单位（不包括玩家），应该就能生效。

关于 ModLib
由于 ModLib 在使用该模组时引发了一些问题，我决定将其从代码中移除。因此，目前该模组没有自定义配置。

已知问题：
不必要的大声 - 尝试寻找一种方法使用游戏内配置来设置模组音量

最后但同样重要的是，
我计划保持这个模组的开源状态，你可以在这个 GitHub 上查看它。