启动器命令行参数

01基本用法

StartRide.exe [options]

不带参数就是正常打开界面。参数主要给三种场景用：自动化脚本、桌面快捷方式、以及技术支持时让你复现某个状态。

02三种启动方式

03参数：-level

• 地图名要和本机已安装的地图标识对得上，写错不会自动回退到默认地图，而是加载失败。
• 联机时地图由房间决定，这个参数主要用于单人 / 回放场景。
• 排查「地图加载不出来」时，先用游戏自己启动一次确认地图是好的，再回到启动器试。

04参数：--userpath

如果真的需要传（比如做隔离测试），那就要连最后一层版本目录一起算进去，并且清楚自己在做什么：

--userpath D:\BeamNG-Test
      ↓ 实际生效
D:\BeamNG-Test\<版本号>\mods      <-- 模组真正被读写的位置

05参数：--dir=

06注入的环境变量

启动器在拉起游戏进程时，会注入两个 Steam 身份变量，让游戏把这次运行当成 Steam 启动，从而正常记录游玩时长。

284160 是 BeamNG.drive 在 Steam 上的应用 ID。这两个变量只在启动器拉起的那个子进程里生效，不改动系统环境，也不影响 Steam 客户端本身。

为什么要这么做

• 游戏直接双击运行时，Steam 不认为它被启动了，时长就不会被记录。
• 注入这两个变量后，游戏把这次运行当成一次正常的 Steam 启动，时长能正常同步。
• 这是进程级注入，退出即失效，不留任何常驻改动。

07退出码与日志

08自动化脚本示例

给日常最常用的两个场景各写一段。注意路径按自己的安装位置改：

# PowerShell：指定地图启动一次
Start-Process -FilePath "D:\StartRide\StartRide.exe" -ArgumentList "-level","gridmap_v2"

# 等游戏退出后再继续
Start-Process -FilePath "D:\StartRide\StartRide.exe" -Wait

#!/usr/bin/env bash
# 用指定地图启动（Windows 上的 Git Bash 里也能用）
"D:/StartRide/StartRide.exe" -level gridmap_v2 &

09排错表