UMU-Launcher中GAMEID参数的使用注意事项

概述

在使用UMU-Launcher运行非Steam游戏时，开发者发现GAMEID参数在使用umu-database ID时未能按预期工作。本文将详细解析该问题的技术背景和解决方案。

问题现象

当用户尝试通过umu-database ID（如"umu-582660"）指定游戏时，ProtonFixes日志显示游戏被识别为"UNKNOWN"，且未应用预期的修复补丁。而当使用纯数字的Steam ID（如"582660"）时，修复补丁则能正常应用。

技术原理

UMU-Launcher的核心机制是通过ProtonFixes来应用针对特定游戏的兼容性修复。要实现这一功能，需要正确识别游戏身份。系统通过两个关键参数进行识别：

1. GAMEID：游戏的唯一标识符
2. STORE：游戏来源的平台标识（默认为Steam）

当使用umu-database ID格式（如"umu-582660"）时，系统需要明确知道这是来自UMU数据库的ID，而非Steam ID。若未指定STORE参数，系统会默认按Steam ID处理，导致识别失败。

解决方案

要正确使用umu-database ID，用户需要同时设置两个环境变量：

STORE=umu GAMEID=umu-582660

这种组合方式明确告知系统：

• 游戏来源平台是UMU（STORE=umu）
• 游戏ID采用UMU数据库格式（GAMEID=umu-582660）

最佳实践

1. 对于Steam游戏：只需设置GAMEID为纯数字Steam ID
2. 对于UMU数据库游戏：必须同时设置STORE和GAMEID
3. 对于其他平台游戏：根据平台要求设置相应的STORE值

实现细节

在底层实现上，ProtonFixes会根据STORE值决定如何解析GAMEID：

• 当STORE=steam（默认）：将GAMEID视为纯数字Steam AppID
• 当STORE=umu：识别并去除"umu-"前缀，使用剩余数字部分进行匹配
• 其他STORE值：按各平台特定规则处理

总结

正确使用GAMEID参数需要理解UMU-Launcher的游戏识别机制。对于非Steam平台游戏，特别是来自UMU数据库的游戏，务必同时设置STORE参数以指明ID来源。这一设计既保持了与Steam生态的兼容性，又扩展了对其他游戏平台的支持。