BeatSaber-IPA-Reloaded 命令行参数详解

项目概述

BeatSaber-IPA-Reloaded 是一个用于《Beat Saber》游戏的模块加载器，它提供了强大的命令行参数系统，允许用户通过命令行控制安装过程和游戏运行时的各种行为。本文将全面解析该项目的命令行参数使用方法。

安装程序命令行参数

安装程序 IPA.exe 提供了丰富的命令行选项，可以通过以下命令查看帮助信息：

IPA.exe -h
# 或
IPA.exe --help

帮助信息会显示所有可用参数及其说明，包括但不限于：

• 安装路径指定
• 静默安装模式
• 日志级别控制
• 特殊功能开关等

建议在首次使用时先查看帮助信息，了解当前版本支持的所有选项。

游戏运行时命令行参数

游戏运行时支持多种命令行参数，可以精细控制调试、日志和模块加载行为。以下是主要参数的详细说明：

调试相关参数

1. --verbose

   • 功能：启动时显示控制台窗口并输出日志信息
   • 高级用法：可以指定进程ID，使游戏使用外部控制台
   • 示例（PowerShell）：

     .\steam.exe -applaunch 620980 --verbose $PID
     

   • 注意：无法在提升权限的终端中使用

2. --debug

   • 功能：启用Mono调试信息加载
   • 额外效果：强制显示所有调试消息及其调用位置
   • 会覆盖配置文件中的 Debug.ShowDebug 和 Debug.ShowCallSource 设置

3. --mono-debug

   • 功能：启用Mono软调试器引擎
   • 默认行为：作为客户端，需要本地10000端口上有调试服务器
   • 隐含启用 --debug

4. --server

   • 单独使用无效果
   • 与 --mono-debug 配合：使调试器以服务器模式运行
   • 行为：监听10000端口，暂停启动直到调试器连接

日志控制参数

1. --trace

   • 功能：启用跟踪级别消息
   • 会覆盖配置文件中的 Debug.ShowTrace 设置

2. --condense-logs

   • 功能：减少日志文件数量
   • 默认行为：为每个模块创建子文件夹和日志
   • 启用后：仅创建全局日志和模块日志
   • 会覆盖配置文件中的 Debug.CondenseModLogs 设置

3. --plugin-logs

   • 功能：为每个插件创建单独的日志文件
   • 历史：4.1.6版本前是默认行为
   • 会覆盖配置文件中的 Debug.CreateModLogs 设置

模块管理参数

1. --no-yeet
   • 功能：禁用模块自动迁移
   • 默认行为：检测到游戏版本更新时，将模块移动到其他文件夹
   • 会覆盖配置文件中的 YeetMods 设置

VR模式控制

1. -vrmode
   • 功能：更改OpenXR运行时
   • 参数值：必须是运行时文件名的子字符串
   • 特殊值：设置为none可禁用VR模式

实用技巧

1. 调试组合：开发时建议使用 --debug --mono-debug --server 组合，配合调试器可以更好地诊断问题。

2. 日志管理：对于普通用户，--condense-logs 可以减少日志文件数量；对于开发者，--plugin-logs 可以更方便地追踪特定模块的问题。

3. 版本升级：当游戏更新后遇到模块兼容性问题时，可以尝试不使用 --no-yeet 参数，让系统自动处理旧模块。

4. 非VR模式：通过 -vrmode none 可以在没有VR设备的情况下运行游戏，适合某些特殊测试场景。

注意事项

1. 命令行参数会覆盖配置文件中的对应设置，优先级更高。

2. 某些参数（如调试相关）需要相应的开发环境支持才能发挥完整功能。

3. 不同版本的 BeatSaber-IPA-Reloaded 可能支持不同的命令行参数集，建议查阅对应版本的文档。

通过合理使用这些命令行参数，用户可以更灵活地控制游戏行为，开发者也能获得更完善的调试信息，从而提升游戏和模块的开发效率。