BeamMP/Docs
1
0
Fork 0
mirror of https://github.com/BeamMP/Docs.git synced 2026-05-19 08:10:50 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
f59b99cdc0351bd20400acbce3008e69b62bc29b
Docs/docs/zh/game/getting-started.md
T
Ace06_10010 b2727b6586 Translate getting-started.md via GitLocalize
2026-05-14 09:30:38 +00:00

7.7 KiB
Raw Blame History

入门

1. 兼容性

BeamMP与Windows和Linux完全兼容，与MacOS的兼容性正在研究中。然而，Linux和MacOS都是次要平台，这意味着bug在所难免。

!!!警告

BeamMP将无法与盗版或过时版本的BeamNG.drive一起工作。
BeamMP支持团队不提供盗版/过期副本问题的支持。

2. 安装

2a. Windows 安装

!!!注意

截至 2026 年 4 月 1 日，Windows Defender SmartScreen 会将该 MSI 安装程序识别为“未知应用”。

若要跳过此警告，请点击“更多信息”，然后点击“仍要运行”。
  1. 前往 beammp.com 然后点击“下载”按钮
  2. 运行 BeamMP_Installer.msi安装程序并按照提示进行操作。
  3. BeamMP启动器的图标应该会出现在您的桌面上。如果没有出现，只需在 Windows 搜索栏中搜索“BeamMP”即可。

!!!注意

当你加载到一个有多个车辆的地图时，它可能需要比预期更长的时间才能加入。

2b. Linux 安装

目前您需要自己编译Launcher。为了做到这一点，您需要对如何编译应用程序有一个基本的了解。

确保你已经安装了基本的开发工具，通常可以在包中找到，例如：

  • Debian/Ubuntu: sudo apt install build-essential
  • Fedora: sudo dnf install cmake gcc gcc-c++ make perl perl-IPC-Cmd perl-FindBin perl-File-Compare perl-File-Copy kernel-headers kernel-devel
  • Arch: sudo pacman -S base-devel
  • openSUSE: zypper in -t pattern devel-basis
  • SteamOS (Arch): sudo pacman -S base-devel linux-api-headers glibc libconfig (You also need to do sudo steamos-readonly disable but make sure to enable it again after installing the packages)

克隆 vcpkg 仓库，执行引导脚本并加入系统路径

git clone https://github.com/microsoft/vcpkg.git

./vcpkg/bootstrap-vcpkg.sh

export VCPKG_ROOT="$(pwd)/vcpkg"
export PATH=$VCPKG_ROOT:$PATH

使用git将BeamMP-Launcher仓库克隆至本地，操作示例如下：git clone https://github.com/BeamMP/BeamMP-Launcher.git。查看GitHub仓库克隆操作完整指南

如果你使用了我们提供的示例克隆命令，你可以使用以下命令进入项目的根目录：
cd BeamMP-Launcher

查看用于 最新发布版本 的标签（Tag）。例如，如果最新版本使用的是 v2.8.0，则执行命令：git checkout v2.8.0

在项目的根目录中，

cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux

cmake --build bin --parallel

!!!注意 ""

如果在编译时内存耗尽，可以提交——parallel指令，由于只在一个CPU线程上编译，它将使用更少的RAM。

!!!注意 ""

通过不指定‘ -DCMAKE_BUILD_TYPE=Release ’，您正在编译一个调试版本，该版本的文件大小较大，但不包含launcher-can-only-connect-to- server-once错误

!!!注意 "Fedora 用户" 如果 vcpkg 在编译 OpenSSL 时因内核头文件（kernel headers）错误而失败，请确保已安装所有依赖项: bash sudo dnf install kernel-headers kernel-devel gcc gcc-c++ make perl 然后清理 vcpkg 缓存：bash rm -rf $VCPKG_ROOT/buildtrees/openssl 最后重新运行 cmake 配置命令。

将已编译完成的应用程序从/bin移出，放到它自己的文件夹中，然后从该文件夹运行它：

mkdir -p ~/beammp-launcher
cp bin/BeamMP-Launcher ~/beammp-launcher/
cd ~/beammp-launcher
./BeamMP-Launcher

原生的 Linux 版 BeamMP 启动器将会启动，并使用原生的 Linux 版 BeamNG.drive。

2c. 在Proton兼容层上游玩BeamNG.drive

若您需要在Proton环境运行BeamNG.drive时同步使用原生Linux版BeamMP启动器，可通过以下方案实现：

使用--no-launch参数运行BeamMP-Launcher（此参数将阻止启动器唤起原生Linux版BeamNG.drive）。更多启动器参数详解请参阅开发环境配置指南

将Proton-BeamNG.drive的用户文件夹路径指向Linux-BeamNG.drive的位置（因原生Linux版BeamMP-Launcher当前仅支持向Linux-BeamNG.drive用户文件夹写入数据）

例如，您可以通过创建符号链接实现该配置

  • 记录Linux-BeamNG.drive用户文件夹路径（通常位于~/.local/share/BeamNG.drive），并将其重命名为类似BeamNG.drive_old的名称
  • 记录Proton-BeamNG.drive用户文件夹路径（通常位于~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive）
  • 建立双端用户文件夹的符号链接桥接 ln -s ~/.local/share/Steam/steamapps/compatdata/284160/pfx/drive_c/users/steamuser/AppData/Local/BeamNG.drive ~/.local/share

当用户文件夹间符号链接就绪且启动器完成编译后，可通过调整Steam启动参数实现：既让Steam通过Proton运行游戏，又能自动触发启动器执行。请前往Steam库中该游戏的属性设置界面，替换原版游戏启动参数为下方配置模板：

  • ~/BeamMP/BeamMP-Launcher --no-launch & %command% ; killall BeamMP-Launcher

请注意：此配置默认假设您已将编译完成的启动器二进制文件存放于/home/user/BeamMP/。请根据实际二进制文件存放路径调整配置，且每次启动器版本更新时需切换至官方Git仓库对应分支重新执行编译流程。

!!! 提示 "安装表情符号字体实现文本内嵌表情"

若需在服务器列表（作为服务器自定义名称组成部分）或游戏内聊天中显示表情符号，您需部署包含表情符号的字形库。例如，可通过安装Windows Segoe UI 表情符号字体的 Linux 移植版实现。

2d. 更新启动器

如果您已经构建了启动器并想要对其进行更新：

export VCPKG_ROOT="$(pwd)/vcpkg"
cd BeamMP-Launcher
git fetch --tags

检出用于 最新发布版本 的标签。例如，如果最新版本使用的是 v2.8.0，则执行 git checkout v2.8.0。

cmake . -B bin -DCMAKE_TOOLCHAIN_FILE=$VCPKG_ROOT/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-linux
cmake --build bin --parallel
cp bin/BeamMP-Launcher ~/beammp-launcher/
cd ~/beammp-launcher
./BeamMP-Launcher

3. 使用BeamMP

  1. 启动程序后，您应该会看到一个终端窗口。紧接着，标准的 BeamNG 启动程序也会随之启动。请勿关闭该终端窗口。
  2. 在 BeamNG.drive 的主菜单中，点击 Repository（仓库） 按钮，并检查确认 multiplayerbeammp 是 唯一 启用的插件（Mod）。
  3. 返回主菜单，点击“More..”和“多人模式”按钮开始多人模式。
  4. 系统将提示您登录或以访客身份游玩（并非所有服务器都允许访客）。您可以在我们的论坛上创建一个帐户，然后使用相同的凭据登录BeamMP。
  5. 选择您感兴趣的任何服务器，然后点击连接 。尽情享受吧！

4. 已知问题

  • 当前原生Linux版BeamMP启动器存在单会话限制：成功连接服务器并断开后需重启启动器。可通过热重载方案实现不关闭游戏进程的快速重启
  • 若未显示多人游戏按钮，请确认以下操作：
    检查BeamMP模组是否已安装并在模组管理器中启用
    尝试执行热重载快捷键 Ctrl + L
  • 任何类型的vpn都可能导致连接问题。
  • 如果启动器报告任何错误，请阅读FAQ。

如果启动器报告任何错误，请阅读FAQ。

Reference in New Issue View Git Blame Copy Permalink