使用 Steam 兼容层启动
Linux 版 LunaBox 可以通过 Steam 启动游戏，并读取或修改该游戏的 Proton 兼容工具设置。官方 Proton 与 compatibilitytools.d 中登记的 GE-Proton 等工具均可显示在选择框中。
本文介绍 Linux 上的 Proton 配置。Windows 用户需要 Steam Input 手柄映射或 Steam 界面时，请参阅使用 Steam 启动游戏。
准备 Steam 游戏
推荐先通过从 Steam 导入游戏，这样 LunaBox 会保存 AppID、安装目录和 Steam 启动关联。
也可以将 LunaBox 中的游戏加入 Steam 后再使用 Steam 启动。Steam 快捷方式需要属于当前 Steam 用户，并且 Steam 客户端能够识别该条目。
选择 Proton
- 进入游戏详情并打开启动配置。
- 将 默认启动方式 设为 Steam 启动。
- 在 Proton 版本 中选择 Steam 默认，或选择已安装的 Proton 工具。
- 保存设置。Steam 运行期间修改配置时，可点击 重启 Steam 使设置生效。
- 从 LunaBox 启动游戏。
LunaBox 会读取 Steam 的兼容工具配置，并把选择结果写回当前用户的 Steam 配置。原生 Steam 游戏的自定义启动参数建议在 Steam 游戏属性中设置。
Steam 启动参数
非 Steam 快捷方式可以在 LunaBox 中保存 Steam 启动参数。参数支持 %command% 占位符，例如：
LANG=zh_CN.UTF-8 PROTON_LOG=1 %command%Steam 客户端完全退出后，LunaBox 才能安全更新 shortcuts.vdf 中的快捷方式参数。保存后重新启动 Steam。
Proton Prefix
Steam 通常会在首次通过 Proton 启动后创建 steamapps/compatdata/<AppID>/pfx。启动配置会显示发现的 Proton Prefix，并提供打开目录的按钮。
Prefix 尚未显示时，请先通过 Steam 成功启动一次游戏，再返回 LunaBox 刷新 Steam 设置。
Protontricks 与快捷工具
在 设置 → 游玩配置 中可以填写 Protontricks 的可执行文件位置。留空时，LunaBox 会从 PATH 与常见位置查找。
游戏启动配置中的快捷工具可用于打开 Proton Prefix、C 盘、注册表、Wine 配置、Explorer 和 CMD。工具可用性取决于当前 Proton Prefix 与 Protontricks 安装状态。
与本机 Proton 启动的区别
| 方式 | Steam 客户端 | 适用场景 |
|---|---|---|
| Steam 启动与 Proton | 需要 Steam 和游戏关联 | Steam 原生游戏、Steam 快捷方式、希望由 Steam 管理 Proton 的游戏 |
| 普通启动与本机 Proton | 可脱离 Steam | 已安装 Proton、GE-Proton 或 DW-Proton，并希望由 LunaBox 调用的游戏 |
普通启动方式下，本机 Proton 会显示在游戏的 兼容层 选择框中。留空具体工具时，LunaBox 会从已发现的 Proton 工具中选择。
常见问题
| 现象 | 检查内容 |
|---|---|
| 未发现 Steam | 确认 Linux Steam 客户端已安装，且 LunaBox 能访问 Steam 目录 |
| 游戏尚未关联 Steam | 先从 Steam 导入，或把游戏加入 Steam 快捷方式 |
| Proton 列表缺少自定义工具 | 检查 compatibilitytools.d 中的 compatibilitytool.vdf |
| Prefix 为空 | 先通过 Steam 使用 Proton 启动一次游戏 |
| 设置未生效 | 完全退出并重新启动 Steam |