Mount and Blade II Bannerlord 管理员设置

本指南涵盖了您的 Mount & Blade II: Bannerlord 专用服务器的管理员设置、玩家管理、服务器控制台命令、地图轮换管理、游戏模式切换、模组支持和故障排除。有关初始服务器设置、游戏模式配置、地图选择、阵营设置和连接说明，请参阅 Mount and Blade II Bannerlord 服务器设置指南。

1. 管理员设置

设置管理员密码

管理员密码通过 GPanel 中的 ADMIN_PASSWORD 启动变量设置，或在配置文件中使用 AdminPassword 命令设置：

AdminPassword YourAdminPassword

此密码是访问 Web 管理界面和游戏内管理员权限所必需的。

切勿分享您的管理员密码。 任何拥有管理员密码的人都可以完全控制您的服务器，包括踢出/封禁玩家、更换地图和在比赛中修改服务器设置。

访问 Web 管理面板

Bannerlord 包含一个由 DedicatedCustomServerHelper 模块提供支持的内置 Web 管理面板。

在 GPanel 的 Network 标签页中找到您服务器的 IP 地址和端口。
打开网页浏览器并导航至：
```
http://<your-server-ip>:<port>
```
Web 面板运行在与游戏服务器相同的端口上（默认 UDP 7210）。请查看 GPanel 的 Network 标签页获取确切端口。
在提示时输入您的管理员密码。

Web 面板功能： Web 界面允许您查看已连接的玩家、管理比赛、更改设置、监控聊天以及无需加入游戏即可访问服务器命令。请注意，在活动任务期间许多设置将变为只读。

游戏内管理员访问

以普通玩家身份加入您的服务器。
使用 Alt + ~（波浪号键）打开游戏控制台。
输入 Help 查看可用命令。
如果出现提示，您可能需要通过游戏内管理员菜单使用管理员密码进行身份验证。

2. 服务器控制台命令

以下命令可在服务器控制台（GPanel 控制台）或 Web 管理面板中使用。在控制台中输入 Help 或 list 可查看所有可用命令。

服务器管理命令

命令	描述
`ServerName <name>`	更改服务器显示名称。
`GameType <mode>`	更改游戏模式（Siege、TeamDeathmatch、Captain、Skirmish、Duel、Battle）。
`WelcomeMessage <text>`	设置玩家加入时显示的消息。
`start_game`	使服务器在服务器浏览器中可见并允许连接。
`start_mission`	开始当前任务/比赛。玩家可以开始战斗。
`start_game_and_mission`	组合命令：启动服务器并立即开始游戏。
`add_map_to_usable_maps <MapName> <GameType>`	将地图注册为指定游戏模式的可用地图。
`add_map_to_automated_battle_pool <MapName>`	将地图添加到自动轮换池中。
`enable_automated_battle_switching`	启用每场比赛后的自动地图轮换。
`set_automated_battle_count <number>`	设置服务器关闭前要进行的比赛次数。适用于计划重启。
`list`	显示所有可用命令。

3. 玩家管理

踢出玩家

要将玩家从服务器中移除：

Web 管理： 在 Web 管理面板中导航到"玩家"部分，找到该玩家并点击 Kick。
聊天命令： 打开游戏内聊天并输入：
```
!kick <playername>
```

被踢出的玩家可以立即重新加入，除非您同时封禁他们或设置服务器密码。

封禁玩家

要永久阻止某玩家加入：

Web 管理： 使用 Web 管理面板"玩家"部分中的封禁选项。
聊天命令： 打开游戏内聊天并输入：
```
!ban <playername>
```

封禁在服务器重启后仍然有效。

解除封禁

要解除封禁并允许玩家重新加入：

!unban <playername>

禁言玩家

要阻止某玩家使用游戏内聊天：

使用 Web 管理面板中的禁言选项。
被禁言的玩家仍然可以进行游戏，但无法发送聊天消息。

聊天命令需要管理员身份验证。 您必须以管理员身份登录（通过 Web 面板或以管理员权限加入服务器），聊天命令才能生效。

4. 地图轮换管理

更换当前地图

要在游戏过程中更换地图，请使用 Web 管理面板或修改配置文件并重启服务器。地图必须与当前游戏模式匹配。

编辑地图轮换

地图轮换在您的游戏模式配置文件中定义。要进行更改：

从 GPanel 停止服务器。
打开配置文件（例如 Modules/Native/siege_config.txt）。
修改 add_map_to_automated_battle_pool 行以添加或移除地图。
如果您希望自动轮换，请确保包含 enable_automated_battle_switching。
保存并重启服务器。

单地图模式

要运行单张地图而不进行轮换，请仅包含一行 add_map_to_automated_battle_pool 并省略 enable_automated_battle_switching。每轮将重复相同的地图。

5. 游戏模式切换

更改游戏模式需要同时更新 GameType 设置和地图池，因为地图是特定于模式的。

从 GPanel 停止服务器。
打开配置文件并更改 GameType 行：
```
GameType Siege
```
将 add_map_to_automated_battle_pool 行替换为与新模式兼容的地图。有关地图列表，请参阅设置指南。
保存文件并启动服务器。

更改游戏模式需要重启服务器。 在活动任务期间无法更改游戏类型。您必须停止服务器、更新配置，然后重新启动。

6. 模组支持

Bannerlord 支持在专用服务器上使用自定义模块（模组）。模组可以添加新地图、游戏模式、武器、兵种类型和游戏机制。

安装模组

从 GPanel 停止服务器。
通过 SFTP 连接到您的服务器。有关说明，请参阅如何通过 SFTP 上传文件。
导航到 Modules/ 目录。
将模组文件夹上传到 Modules/。每个模组应在其自己的目录中，并包含一个 SubModule.xml 文件。
更新服务器的启动命令或批处理文件，将模组包含在模块列表中。启动配置中的 _MODULES_ 参数必须引用所有活动模块：
```
Native*Multiplayer*DedicatedCustomServerHelper*YourModName
```
模块之间用星号（*）分隔。加载顺序很重要——将依赖模组放在其前置模组之后。
启动服务器。

所有玩家必须拥有匹配的模组。 加入模组服务器的玩家需要在其客户端上安装相同的模组。模组不匹配将导致无法连接或出现不同步问题。

Steam 创意工坊模组

Bannerlord 支持通过 Steam 创意工坊分发模组。要在专用服务器上安装创意工坊模组：

从常规 Bannerlord 安装中订阅 Steam 创意工坊上的模组。
在您本地 Bannerlord 安装的 Modules/ 目录中找到下载的模组文件夹。
通过 SFTP 将模组文件夹上传到您专用服务器的 Modules/ 目录。
将模块名称添加到启动模块列表中。

DedicatedCustomServerHelper 模块

此内置模块提供 Web 管理面板。它必须始终包含在模块列表中。如果在游戏更新后遇到版本不匹配错误：

停止服务器。
导航到 Modules/DedicatedCustomServerHelper/。
打开 SubModule.xml。
将 Version 值更新为当前游戏版本。
相应地更新所有 DependedModule 版本值。
保存并重启服务器。

7. 故障排除

服务器启动时崩溃

检查控制台输出中的错误消息。常见原因包括：
- 缺失或过期的身份验证令牌——如果您看到令牌错误，请联系支持。
- 无效的 AdminPassword 配置——确保 AdminPassword 行存在且有值。
- 配置文件语法错误——每个命令必须在单独的行上，且没有尾随字符。
- 游戏更新后模块版本不匹配——更新 SubModule.xml 版本号。
尝试移除所有自定义模组，仅使用默认模块运行（Native*Multiplayer*DedicatedCustomServerHelper）。
删除配置文件并让服务器重新生成默认设置，以排除配置问题。

玩家无法连接

在 GPanel 中验证服务器是否正在运行。
确认玩家使用的是 GPanel Network 标签页中正确的 IP 和端口。
检查游戏密码是否正确（区分大小写）。
确保玩家安装了相同的游戏版本和模组。
如果使用模组，请验证玩家是否拥有完全相同的模块版本。
检查控制台中的"player rejected"消息，这可能会指出具体原因。

服务器未出现在浏览器中

确认服务器已完全启动，且控制台显示正在接受连接。
检查配置文件是否包含 start_game 或 start_game_and_mission——没有此命令，服务器将不会在主服务器列表中注册。
服务器浏览器可能需要几分钟才能更新。在等待期间尝试直接连接。
如果身份验证令牌已过期，服务器可能启动但不会出现在浏览器中。联系支持进行令牌续期。

模组冲突

如果服务器在添加模组后崩溃，请移除该模组并重新测试以确认是否为原因所在。
检查模组的 SubModule.xml 是否列出了正确的依赖项，以及模块列表中的加载顺序是否正确。
验证模组是否与当前版本的 Bannerlord 兼容。旧版本的模组可能会导致崩溃。
某些模组之间会相互冲突。请查看模组文档和社区论坛了解已知的不兼容性。
如果在更改模组后遇到图形问题或加载错误，请清除服务器的着色器缓存和临时文件。

玩家不同步

不同步发生在玩家的游戏状态与服务器产生偏差时。症状包括玩家看起来在瞬移、攻击无法命中或出现橡皮筋效应。
最常见的原因是高延迟。建议受影响的玩家检查其网络连接。
修改游戏机制（移动速度、物理效果、武器属性）的模组更容易导致不同步。
如果不同步现象广泛存在，尝试降低 MaxNumberOfPlayers 或切换到更轻量的游戏模式（用 Duel 或 Skirmish 代替 Siege）。
重启服务器可以解决持续性的不同步问题。

身份验证令牌问题

Bannerlord 需要有效的身份验证令牌才能运行专用服务器。令牌大约每 3 个月过期一次。
如果您在控制台中看到与令牌相关的错误，则令牌可能需要续期。
提交支持工单以刷新您服务器的身份验证令牌。

8. 日志文件

Bannerlord 服务器日志对于诊断崩溃、连接问题和玩家活动非常有用。

日志文件存储在服务器的日志目录中，通常可通过 GPanel 的 Files 标签页或 SFTP 访问。
当控制台输出本身不够充分时，请检查日志文件以获取详细的错误消息。
在提交支持工单时附上相关日志摘录，以便更快解决问题。

需要帮助？

如果您遇到本指南未涵盖的 Bannerlord 服务器问题，请提交支持工单，并提供您的服务器 IP、正在运行的游戏模式、已安装的模组以及来自 GPanel 控制台或日志文件的相关错误消息。

Mount and Blade II Bannerlord 管理员设置 - 知識庫

技术支持

分类