Skip to content

构建与安装 ​

依赖 ​

项目说明
CMake ≥ 3.17构建系统
C++20 编译器MSVC 2019+ / GCC 11+ / Clang 14+
库zlib、liblzma、lzo、zstd、libpng;GUI 还需要 SDL2/Allegro、freetype、harfbuzz、ICU、opusfile(Windows 用 WinHttp,无需 curl)

Windows 推荐使用 vcpkg 安装依赖(项目自带 vcpkg.json)。

构建步骤 ​

bash
# 1. 配置(在项目根目录的 build 子目录)
cmake -B build -G "Visual Studio 17 2022" -A x64 -DCMAKE_TOOLCHAIN_FILE=<vcpkg>/scripts/buildsystems/vcpkg.cmake

# 2. 编译
cmake --build build --config Release -j

# 3. 产物
# build/openttd-jrpm.exe        (可执行文件名,jrpm 版本)

Linux / MSYS2:

bash
cmake -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
# build/openttd-jrpm

版本标识

构建时会读取根目录 .ottdrev-vc 生成版本号。当前为 jrpm-0.1.0(tagged)。运行 openttd-jrpm -v 可确认版本与构建信息。

常见问题 ​

CMake 找不到依赖 ​

先通过 vcpkg 安装:vcpkg install(按 vcpkg.json)。或安装系统包(Linux:sudo apt install zlib1g-dev liblzma-dev liblzo2-dev libzstd-dev libpng-dev libsdl2-dev libfreetype6-dev libharfbuzz-dev libicu-dev libopusfile-dev)。

只想跑专用服务器(无 GUI) ​

cmake -B build -DOPTION_DEDICATED=ON,然后 openttd-jrpm -D -c server.cfg。

构建报 [safe-delete] 操作失败(Windows 沙箱/CI) ​

给构建命令加 NODE_OPTIONS="" 前缀可绕过安全删除 shim 对 .temp/.cache 清理的干扰。

从源码运行 ​

bash
# 专用服务器
openttd-jrpm -D -c openttd.cfg

# GUI 客户端
openttd-jrpm