本指南涵盖了在 Legion Hosting 上运行 BeamMP 服务器所需的一切，从首次启动和认证密钥设置到 ServerConfig.toml 配置以及玩家如何连接。有关管理员命令、自定义地图和资源管理，请参阅 BeamMP 管理员和资源设置。
服务器面板： 所有服务器管理均通过 GPanel 完成：gpanel.legionhosting.net。BeamMP 服务器使用独立的 BeamMP-Server 应用程序 — 不使用 SteamCMD。
什么是 BeamMP？
BeamMP 是 BeamNG.drive 的多人游戏模组，允许玩家在同一地图上一起驾驶、竞速和碰撞。BeamMP-Server 应用程序作为独立的专用服务器运行。玩家通过 BeamMP 启动器连接，该启动器在多人游戏会话中替代标准的 BeamNG.drive 启动器。
需要认证密钥： 每台 BeamMP 服务器都需要来自 BeamMP Keymaster 的唯一认证密钥。没有有效密钥，您的服务器将不会出现在服务器浏览器中，玩家也无法连接。请参阅下方的认证密钥部分。
首次启动
当您首次收到 BeamMP 服务器时，请按照以下步骤使其上线：
- 登录 GPanel 并选择您的 BeamMP 服务器。
- 在启动之前，您必须获取认证密钥（见下文）。没有密钥，服务器将无法通过 BeamMP 服务的认证。
- 导航到 Startup 选项卡，将您的认证密钥粘贴到
AUTHKEY变量中。 - 可选择调整其他启动变量，如服务器名称和最大玩家数。
- 前往 Console 选项卡，点击 Start。
- 服务器将在首次启动时自动下载 BeamMP-Server 文件。这可能需要几分钟。
- 当控制台显示
[INFO] Server started!或类似信息时，您的服务器已上线，并将出现在 BeamMP 服务器浏览器中。
首次启动耗时较长： 初始启动包括完整下载 BeamMP-Server 文件。后续启动将快得多。
认证密钥（BeamMP Keymaster）
每台 BeamMP 服务器都需要一个认证密钥，将其链接到 BeamMP 后端服务。此密钥是免费的，与您的 BeamMP/Discord 账户绑定。
如何获取密钥
- 前往 beammp.com/k/keys（BeamMP Keymaster）。
- 使用您的 Discord 账户登录。如果您没有 BeamMP 账户，系统会提示您创建一个。
- 点击 Create a key（或 + / New Key，取决于当前界面）。
- 输入服务器名称（仅作为您的参考标签）和服务器的 IP 地址。
- 复制生成的密钥字符串。
将密钥添加到服务器
- 在 GPanel 中，前往 Startup 选项卡。
- 将您的密钥粘贴到
AUTHKEY变量中。 - 重启服务器使更改生效。
请妥善保管您的认证密钥。 不要公开分享。任何拥有您密钥的人都可以在另一台服务器上使用它，这可能会导致冲突或使您的密钥被 BeamMP 撤销。
密钥限制： 每个 BeamMP 账户可以创建有限数量的密钥（通常为 2 个）。如果您需要额外的密钥，请查看 BeamMP Keymaster 页面或其 Discord 了解当前限制。
GPanel 启动变量
BeamMP 将多个配置选项作为启动变量暴露在 GPanel 中。导航到 Startup 选项卡查看和修改这些变量。更改需要重启服务器才能生效。
| 变量 | 默认值 | 描述 |
|---|---|---|
AUTHKEY |
空 | 来自 Keymaster 的 BeamMP 认证密钥。服务器运行必需。 |
NAME |
BeamMP Server |
在 BeamMP 服务器浏览器中显示的名称。 |
MAX_PLAYERS |
10 |
最大同时在线玩家数。较高的值需要更多的 CPU 和 RAM。 |
MAP |
/levels/gridmap_v2/info.json |
要加载的地图。使用 BeamNG.drive 地图路径格式。请参阅地图选择部分了解可用地图。 |
PORT |
30814 |
服务器端口。由 GPanel 预配置 — 除非支持团队指示，否则不要更改。 |
MAX_CARS |
1 |
每位玩家的最大车辆数。每位玩家更多车辆会显著增加带宽和 CPU 使用。 |
PRIVATE |
false |
如果设为 true，服务器将不会出现在公共服务器浏览器中。玩家必须通过直接连接。 |
ServerConfig.toml
除启动变量外，完整的服务器配置位于服务器根目录的 ServerConfig.toml 中。您可以通过 GPanel 中的 Files 选项卡或通过 SFTP 编辑此文件。GPanel 中的启动变量会在每次启动时覆盖此文件中的值。
关键配置选项
[General]
AuthKey = "your-key-here"
Name = "My BeamMP Server"
Description = "A fun racing and freeroam server"
MaxPlayers = 10
Port = 30814
Map = "/levels/gridmap_v2/info.json"
Private = false
MaxCars = 1
ResourceFolder = "Resources"
LogChat = true| 设置 | 描述 |
|---|---|
AuthKey |
您的 BeamMP Keymaster 认证密钥。 |
Name |
在服务器浏览器中显示的服务器名称。支持部分格式化代码。 |
Description |
在浏览器中服务器名称下方显示的简短描述。 |
MaxPlayers |
玩家上限。典型值：8–20 以获得流畅的游戏体验。 |
Map |
要加载的地图路径。必须是有效的 BeamNG.drive 关卡路径。 |
Private |
设为 true 可从服务器浏览器中隐藏。 |
MaxCars |
每位玩家允许的车辆数。大型服务器推荐设为 1。 |
ResourceFolder |
包含服务器端模组和插件的 Resources 目录路径。 |
LogChat |
如果设为 true，玩家聊天消息将记录到控制台。 |
编辑 ServerConfig.toml 前请务必停止服务器。 如果在服务器运行时编辑，服务器可能会在关闭时覆盖您的更改。
地图选择
BeamMP 使用与 BeamNG.drive 相同的地图。地图在 Map 设置中以关卡路径指定。以下是最常用的默认地图：
| 地图名称 | 地图路径 | 描述 |
|---|---|---|
| Grid Map v2 | /levels/gridmap_v2/info.json |
平坦开阔的测试区域。非常适合自由搭建和车辆测试。 |
| West Coast USA | /levels/west_coast_usa/info.json |
大型精细地图，包含高速公路、城镇和多样地形。非常适合自由漫游。 |
| East Coast USA | /levels/east_coast_usa/info.json |
起伏的丘陵、森林和小镇。适合越野和巡游。 |
| Italy | /levels/italy/info.json |
风景优美的意大利乡村，狭窄的道路和海滨小镇。 |
| Utah | /levels/utah/info.json |
沙漠地形，拥有长长的高速公路和越野小径。 |
| Jungle Rock Island | /levels/jungle_rock_island/info.json |
热带岛屿，蜿蜒的道路和茂密的植被。 |
| Industrial | /levels/industrial/info.json |
紧凑的工业区域，包含坡道、跳台和障碍赛道。 |
| Small Island USA | /levels/small_island/info.json |
带有狭窄道路的小岛。适合较少玩家数量。 |
| Driver Training | /levels/driver_training/info.json |
专为车辆操控练习设计的绕桩赛道。 |
自定义地图： 您也可以通过将地图 .zip 文件放入
Resources/Client 文件夹并使用相应的地图路径来加载自定义/模组地图。有关添加自定义内容的详细信息，请参阅 BeamMP 管理员和资源设置。
最大玩家数和性能
BeamNG.drive 是一款物理计算密集型游戏。每个玩家和车辆都会为服务器和连接的客户端增加显著负载。请注意以下准则：
- MaxPlayers： 8–20 名玩家是获得流畅体验的典型值。更大的服务器（20+）是可行的，但需要更多资源和仔细的配置。
- MaxCars： 对于超过 10 名玩家的服务器，强烈建议将此值保持为每位玩家
1。每增加一辆车辆，需要同步的物理数据成倍增加。 - 地图选择很重要： 更大、更精细的地图（West Coast USA、Italy）比简单地图（Grid Map、Industrial）使用更多内存。
- 网络带宽： BeamMP 为每辆车辆发送详细的物理数据。高玩家数量加上每位玩家多辆车辆会迅速耗尽带宽。
性能提示： 如果玩家遇到延迟或橡皮筋现象，请尝试将
MaxCars 减少到 1 并降低 MaxPlayers。这是提高服务器性能最有效的方法。
如何连接
玩家通过 BeamMP 启动器连接到 BeamMP 服务器，而不是标准的 BeamNG.drive 启动器。
通过服务器浏览器
- 从 beammp.com 下载并安装 BeamMP 启动器。
- 启动 BeamMP 启动器。它将加载 BeamMP 多人游戏模组并启动 BeamNG.drive。
- 在主菜单中选择 Multiplayer。
- 浏览服务器列表或使用搜索栏按名称查找您的服务器。
- 点击您的服务器并选择 Connect。
通过直接连接
- 在 BeamMP 多人游戏菜单中，点击 Direct Connect。
- 以
IP:PORT格式输入您的服务器 IP 地址和端口（例如192.168.1.1:30814）。 - 点击 Connect。
服务器未在浏览器中显示？ 确保
PRIVATE 设为 false 且您的认证密钥有效。启动后可能需要一两分钟服务器才会出现在浏览器中。如果仍未出现，请检查控制台是否有认证错误。请注意，除非您有私有 IP，否则端口是随机分配的 -- 请在 GPanel 中查看正确的端口。
存档管理
BeamNG.drive 是一款基于会话的游戏。没有持久的世界状态或服务器存档文件。当玩家断开连接或服务器重启时，所有车辆位置和状态都会重置。每次会话都是全新开始。
- 没有需要备份或管理的世界存档。
- 服务器配置（
ServerConfig.toml）和资源在重启后保留。 - 玩家的车辆配置存储在客户端，而不是服务器上。
注意： 一些服务器端 Lua 插件可以实现自定义持久化功能（如保存玩家位置或经济数据），但这不是默认功能。有关插件的信息，请参阅 BeamMP 管理员和资源设置。
相关文章
- BeamMP 管理员和资源设置 — 管理员命令、自定义地图、插件和资源管理
- 如何查找您的服务器 IP 和端口
- 如何通过 SFTP 上传文件
- 服务器启动指南 — 在 Legion Hosting 上启动任何游戏服务器的通用指南
需要更多帮助？
如果您遇到本指南未涵盖的问题，我们的支持团队随时为您提供帮助。请在 legionhosting.net/submitticket.php 提交工单，附上您的服务器详细信息和问题描述。
