本指南涵盖了在 Legion Hosting 上管理 BeamMP 服务器的管理员设置、服务器端资源、自定义地图、车辆管理和故障排除。有关初始服务器设置、认证密钥和基本配置，请参阅 BeamMP 服务器设置指南。
管理员设置
BeamMP 没有传统的管理员登录或密码系统。管理员命令通过服务器控制台执行，或通过检查玩家标识符的服务器端 Lua 插件来实现。
控制台命令
GPanel 中的服务器控制台提供对内置服务器命令的直接访问。直接在控制台输入字段中输入命令：
| 命令 | 描述 |
|---|---|
kick <player_id> <reason> |
将玩家踢出服务器，可附带原因消息。 |
ban <player_name> |
封禁玩家。被封禁的玩家无法重新连接。 |
unban <player_name> |
解除玩家的封禁，允许其重新连接。 |
list |
列出所有当前连接的玩家及其 ID。 |
say <message> |
从控制台发送全服聊天消息。 |
status |
显示服务器状态信息，包括玩家数量和运行时间。 |
help |
列出所有可用的控制台命令。 |
list 命令查看已连接的玩家及其 ID。kick 等命令需要这些 ID。
资源文件夹结构
BeamMP 使用 Resources 文件夹来组织服务器端内容。该文件夹包含两个具有不同用途的子目录：
Resources/
Client/ <-- Client-side mods (maps, vehicles) synced to players
Server/ <-- Server-side Lua plugins (not sent to players)客户端资源
放置在 Resources/Client/ 中的文件会在玩家连接时自动下载。用于：
- 自定义地图 — 玩家加载服务器地图所需的地图模组 .zip 文件。
- 自定义车辆 — 添加新车辆或修改现有车辆的车辆模组 .zip 文件。
- 其他客户端模组 — 任何需要在客户端存在的 BeamNG.drive 模组。
Resources/Client/ 中的所有内容都会被每个加入的玩家下载。大文件或过多模组会显著增加连接时间。保持客户端资源精简以获得最佳玩家体验。
服务器资源（Lua 插件）
Resources/Server/ 目录包含服务器端 Lua 插件。这些插件仅在服务器上运行，不会发送给玩家。每个插件位于自己的子文件夹中，包含一个 main.lua 文件：
Resources/
Server/
MyPlugin/
main.lua <-- Plugin entry point
AnotherPlugin/
main.lua服务器端插件可以：
- 响应玩家事件（加入、离开、聊天消息、车辆生成）。
- 实现通过聊天触发的自定义命令（例如
/tp、/give）。 - 管理车辆权限和限制。
- 添加经济系统、传送或其他自定义玩法功能。
- 记录玩家活动并执行规则。
添加自定义地图
要在 BeamMP 服务器上运行自定义（非默认）地图：
- 从 BeamNG.drive 模组来源（例如 BeamNG.drive 模组仓库）下载地图模组的
.zip文件。 - 在 GPanel 中停止服务器。
- 通过 Files 选项卡或 SFTP 将
.zip文件上传到Resources/Client/。不要解压 zip 文件。 - 将
MAP启动变量（或ServerConfig.toml中的Map）更新为自定义地图的正确地图路径。此路径通常格式为/levels/map_name/info.json— 请查看模组文档以获取确切路径。 - 启动服务器。
Map 值与模组 .zip 文件内的实际路径不匹配，服务器将无法加载地图。请查看模组文档或检查 .zip 结构以找到正确的 /levels/ 路径。
Resources/Client/ 中玩家尚未拥有的所有文件。玩家不需要手动安装地图模组。
车辆管理
BeamMP 服务器上的车辆管理通过 MaxCars 设置控制，也可通过服务器端 Lua 插件进行可选控制。
MaxCars 设置
ServerConfig.toml 中的 MaxCars 设置（或 MAX_CARS 启动变量）控制每个玩家可以同时生成的车辆数量：
1— 每个玩家同时只能有一辆车（推荐用于大型服务器）。2–3— 允许玩家拥有几辆车，适用于较小的服务器或车展。- 更高的值会按比例增加服务器负载。
自定义车辆模组
要向服务器添加自定义车辆：
- 下载车辆模组的
.zip文件。 - 将其放入
Resources/Client/。 - 重启服务器。玩家连接时将自动下载车辆模组。
通过插件限制车辆
要进行更精细的控制（例如禁止特定车辆、限制车辆类型），您需要一个服务器端 Lua 插件。这些插件可以拦截车辆生成事件，并根据自定义规则允许或拒绝。请查看 BeamMP 论坛获取车辆管理插件。
安装和管理插件
服务器端 Lua 插件扩展了服务器的功能。以下是安装和管理插件的方法：
安装插件
- 下载插件文件（通常是包含
main.lua和可能的其他文件的文件夹）。 - 停止服务器。
- 通过 Files 选项卡或 SFTP 将插件文件夹上传到
Resources/Server/。 - 确保文件夹结构正确：
Resources/Server/PluginName/main.lua。 - 启动服务器。控制台将在插件加载时显示消息。
移除插件
- 停止服务器。
- 从
Resources/Server/删除插件文件夹。 - 启动服务器。
故障排除
认证密钥错误
- 验证密钥已正确粘贴到
AUTH_KEY启动变量中 — 没有多余的空格或换行符。 - 确保密钥未在 BeamMP Keymaster 上被撤销或过期。
- 每个密钥一次只能用于一台服务器。如果您在其他地方使用了相同的密钥，将会失败。
- 如果密钥无效，控制台将在启动时显示认证错误。
玩家无法连接
- 确认服务器已完全启动并在 GPanel 中显示为在线。
- 检查玩家是否使用的是 BeamMP 启动器，而不是标准的 BeamNG.drive 启动器。
- 如果服务器设置为
Private = true，玩家必须使用正确的 IP 和端口进行直接连接。请参阅如何查找您的服务器 IP 和端口。 - 确保玩家的 BeamMP 启动器版本与服务器版本兼容。过时的启动器可能无法连接。
- 如果服务器已满（达到
MaxPlayers），其他玩家在有人离开之前无法加入。
模组同步问题
- 如果玩家在下载过程中卡住或收到有关缺少模组的错误，请验证
Resources/Client/中的模组 .zip 文件未损坏。 - 如果 .zip 文件已损坏，请重新下载并重新上传模组文件。
- 非常大的模组文件可能会导致网速较慢的玩家超时。考虑移除不必要的大型模组。
- 确保模组 .zip 文件没有嵌套（即 .zip 文件内的文件夹内的另一个 .zip）。
多玩家/车辆时的性能问题
- 将
MaxCars减少到每位玩家1辆。 - 如果服务器持续出现延迟，降低
MaxPlayers。 - 切换到更简单的地图（Grid Map 或 Industrial）以在高玩家数量下获得更好的性能。
- 从
Resources/Client/移除不必要的客户端模组，以减少下载时间和内存使用。 - 检查 GPanel 的资源使用图表 — 如果 CPU 或 RAM 持续处于上限，请考虑升级服务器方案。提交支持工单讨论选项。
服务器未在浏览器中显示
- 确保配置中
Private设置为false。 - 验证认证密钥有效且未被其他服务器使用。
- 启动后等待 1–2 分钟，让服务器向 BeamMP 后端注册。
- 检查控制台是否有与主服务器连接相关的错误。
相关文章
- BeamMP 服务器设置指南 — 初始设置、认证密钥、配置和连接说明
- 如何查找您的服务器 IP 和端口
- 如何通过 SFTP 上传文件
- 服务器启动指南 — 在 Legion Hosting 上启动任何游戏服务器的通用指南
需要更多帮助？
如果您遇到本指南未涵盖的问题，我们的支持团队随时为您提供帮助。请在 legionhosting.net/submitticket.php 提交工单，附上您的服务器详细信息、问题描述以及 GPanel 控制台中的相关错误消息。
