ModinMobileSTS/Sts2MobileLauncher

项目介绍

《杀戮尖塔 2》是运行在 Godot/Mono 上的 PC 游戏。本项目是一个非官方 Android 外壳：用户把自有的 PC 游戏文件导入手机后，由它启动游戏。仓库不附带任何游戏素材，基础游戏要么来自用户提供的压缩包，要么来自应用内登录 Steam 后按 SteamPipe 下载（仓库说明）。

整体分三层：Android 启动器负责导入、Steam 登录与下载、创意工坊浏览、存档快照与同步、本地 Mod 管理；Android 兼容包基于 Harmony 在游戏启动流程最前端挂接，处理输入适配、路径重定向、PC 着色器替换和 Mod 加载桥接；第三层是用户自备的游戏本体（项目结构）。此外还提供内置全键盘、悬浮鼠标按钮、多人表情按钮补全，以及可选的日志分析页面（对接 OpenAI 兼容接口）。

它面向已经拥有 PC 版、希望在 Android 设备上（通常还带 Mod）游玩的玩家。

快速使用

README 没有描述现成的二进制包，文档给出的路径是自己构建导入版 APK。完整首次流程如下：

1. 准备 Linux / macOS / WSL 环境，安装 JDK 17+、Android SDK（API 35）与 NDK、.NET SDK、Python 3。
2. 带子模块克隆：git clone --recursive https://github.com/ModinMobileSTS/Sts2MobileLauncher.git，然后 cd Sts2MobileLauncher。
3. 复制环境模板（cp .env.example .env、cp local.properties.example local.properties），填写 JAVA_HOME、ANDROID_HOME、DOTNET_BIN 以及用于编译兼容包的原始 PC DLL 引用路径。
4. 运行 tools/android/sync-runtime-from-references.sh 同步运行时产物。Android 版 FMOD 引擎和 Godot 桥接必须与 PC 游戏的 2.03.06 版本匹配。
5. 运行 tools/android/stage-bundled-compat-artifacts.sh 把兼容包编入 APK 资源。
6. 运行 tools/package/build_importer_apk.sh 构建导入版 APK，输出到 dist/sts2-re-importer.apk。
7. 安装 APK 后，登录拥有该游戏的 Steam 账号（或导入本地 SlayTheSpire2.zip 等受支持的压缩包）并启动。若当前游戏包没有匹配的兼容包，启动器会弹出推荐面板。

环境细节见构建与打包文档，连接真机调试可用 ADB 自动化脚本。

使用约束与风险

• 设备与运行时： 标称支持 Android 7.0+，底层为 Godot 4.5 Mono。发布构建保留了 debuggable=true 以便抓日志，这意味着任何拥有 ADB 权限的电脑都能从应用中取走数据，包括加密的 Steam 凭据（安全说明）。
• 账号数据： Steam 密码和 Guard 验证码只留在内存中，Refresh Token 经加密后存于本地。README 建议只使用自行编译或来自高度可信渠道的 APK。
• Mod 即任意代码： C# Mod 可以绕过沙箱读取手机本地文件，包括存有 Steam Token 的配置。安装来历不明的 Mod 前应先退出应用内 Steam 登录。
• 覆盖范围有限： 超过 4 人的玩家数量仍属实验性，部分原版界面仍按 4 人假设；竖屏模式需要另装兼容的竖屏 UI Mod，启动器不提供；通过自定义 Manifest 下载旧版本不保证 Android 兼容。
• 许可： 启动器本体为 MIT，附带的第三方组件（如 Spine 运行时、Godot）沿用各自许可（第三方许可）。

HotRepo 点评

该项目在 2026-11-14 的 Java 日榜上以 573 星、22 个 fork 排到第 10 名，当天新增 13 星。目前只有这一条榜单记录，只能说明当天的名次，不能据此判断长期趋势。README 的细节密度——带版本号的兼容包目标、普通存档与 Mod 存档的路径隔离、可复现的构建脚本——更像围绕特定游戏的真实社区项目；MIT 许可加完整文档，对拥有 PC 版并且愿意自行构建 APK 的玩家来说是一个值得考虑的选项。