ModinMobileSTS /Sts2MobileLauncher
an unofficial sts2 mobile launcher that support mods,optimized mobile control
★ 603⑂ 23👁 3⑃ 0● 127▤ 12
+15
日增长
603
stars
23
forks
3
watchers
0
prs
127
issues
12
releases
README
Slay the Spire 2 Android 启动器
基于 Godot/Mono 运行时的非官方开源《杀戮尖塔2》移动端兼容层与启动器环境。
应用截图
项目简介
本项目是一个实验性的、非官方的《杀戮尖塔2》Android 移植与启动器框架。它不包含任何游戏本体文件,而是提供了一个 Android 运行外壳,让玩家能在手机上导入并运行自己合法拥有的 PC 版游戏文件,同时支持 MOD 加载、Steam 创意工坊公开浏览/下载记录(未登录时可匿名浏览公开条目,并默认启用兼容访问路径以绕过部分网络下 Steam Community 直连超时)、本地存档快照、Steam Cloud/WebDAV 云存档同步,以及关于页的启动器更新检查。
应用核心架构分为三层:
1. Android 启动器外壳 (android/): 负责游戏数据的导入、Steam 账号登录与本体下载、Steam 创意工坊公开浏览/下载记录(含默认开启的兼容访问路径)、Steam 云存档同步、本地文件/MOD 管理,并在准备就绪后拉起 Godot 游戏进程。
2. Android 兼容包 (port-mod/ 子模块): 作为底层 Hook(基于 Harmony),在游戏启动的最早期加载,用于拦截并修复 PC 版在 Android 上的各种水土不服(如输入适配、路径重定向、PC 专有 Shader 替换、MOD 加载器桥接等)。
3. 游戏本体 (用户提供): 由用户通过导入 PC 版 SlayTheSpire2.zip 或在应用内登录 Steam 账号通过 SteamPipe 接口合法下载。
Steam Cloud 与 WebDAV 会分别同步普通存档(profile1–3/saves)和 MOD 存档(modded/profile1–3/saves),以及各自的 profile.save 档位选择文件,不自动合并。PC 即使只装纯 UI/快速重开 MOD,也可能使用 MOD 存档目录。手机不使用 MOD 时,先备份两套存档,再视情况显式使用 附加设置 → MOD存档转移 → MOD存档 → 普通存档;此操作会覆盖目标档位,不能转换含 MOD 专属内容的存档。详见存档路径映射。
自定义超过四人的联机人数仍属实验功能。full 兼容包现在会按实际数量动态创建宝箱遗物槽和休息点角色槽,并为第五位玩家提供安全默认焦点、分散宝箱奖励/剪刀石头布手势;这修复了五人宝箱在剪刀石头布后卡住的问题。其他原版界面仍可能存在四人假设,因此可配置容量不代表所有人数都已经过完整流程认证。
在 Android 上,full 兼容包会补回 PC 本体场景中缺失的联机表情按钮。进入多人大厅后(包括角色选择/准备界面和显示中的等待面板),游戏正式开始前也会保留该按钮;按住右下角悬浮按钮并拖动选择原版表情轮盘的一项,松手后通过本体已有的反应同步器发送。轮盘按 viewport 坐标精确居中到按钮,并在响应式 Canvas/UI 尺寸变化后为每个选项保持稳定的未选中基准;被指向的选项仍保留原版向外强调动画,但转完一圈不再让整组项目向右下漂移。松手发送前还会把 viewport 中心逆变换到反应容器的 control 坐标,再交给原版本地动画和网络归一化路径,缩放 Canvas 下也能在正确位置看到发出的表情。“附加设置 → 系统 → 显示联机表情按钮”可实时控制显示,默认开启。
兼容包还会用游戏自带本地化字体补齐 Godot 独立下拉弹窗(包括 OptionButton 的选项与分隔行);部分三星 ROM 不会替这些弹窗可靠选择中文字体。此修复保留原字体与已有 fallback,也不额外打包游戏字体。
---
法律声明
- 非官方作品: 本项目为玩家社区开源的技术研究工程,不隶属于 Mega Crit、Slay the Spire 2 或 Godot 引擎官方,也不能代表其任何立场。
- 不提供游戏资产: 本仓库绝对不包含、也不分发任何受版权保护的商业游戏资源(包含但不限于音频、图像、PCK文件、DLL核心逻辑等)。
- 合法使用: 请遵守相关软件许可、平台规则和当地法律。您必须合法拥有《Slay the Spire 2》的 PC 副本,才能使用此工具在您自己的设备上运行游戏。
- 禁止分发侵权 APK: 请勿将打包了商业游戏资产的直装版 APK 用于公开发布或商业牟利。
---
鸣谢与参考项目
本项目的诞生离不开开源社区的探索,特别感谢以下项目的启发与代码参考:
- StS2-Launcher_Mod_Manager
提供了底层的 Godot/Mono 运行时剥离思路、Android 兼容补丁加载顺序以及部分构建脚本的设计参考。
- SlayTheAmethystModded
STS1 的非官方移动端启动器。本作的 steam-protocol (Steam 协议)、steam-content (SteamPipe 游戏下载) 以及 Steam Cloud 云存档的逆向接入方案与源码主要移植/改编自该项目。
- WorkshopAndroidDownloader
Android Steam 创意工坊下载器参考项目,用于本启动器的工坊浏览、下载和更新记录流程。
- STS2-RitsuLib / BaseLib-StS2
作为 Android 端 MOD 兼容性排查的重要测试基准参考库。
- Google Material Symbols
提供启动器 UI 使用的官方 Rounded 图标轮廓,并由 bundled 字体离线生成 Android vector drawable。
- Android desugar_jdk_libs
为 Android 7.x 设备提供包括 java.time 在内的 Java 8+ library API 兼容实现。
(详细的第三方开源协议,包括不会打入 APK 的 Kotlin Test/JUnit、Robolectric(启动器数据安全回归)与 OkHttp MockWebServer 测试依赖,见 THIRD_PARTY_LICENSES.md)
---
核心安全说明
为了您的设备与账号安全,使用及编译本应用时请务必注意:
1. ADB 与 Debuggable 风险:
当前默认的 release 构建选项中保留了 debuggable=true(为了便于发生崩溃时抓取日志排查)。这意味着任何连接到您的手机并获得 ADB 权限的电脑或恶意软件,都能提取此应用的数据(包含加密保存的 Steam 凭据)。请绝对不要将手机的 ADB 调试权限授予不可信的电脑或第三方应用市场。
2. Steam 账号安全:
- 本应用绝不会将您的 Steam 账号密码上传至任何第三方服务器。密码和本次登录输入的 Steam Guard 动态码只在内存中使用,不写入磁盘、Android service Intent 或日志。
- Steam 接受初始凭据请求后,启动器只会临时加Top issues
#118ritsulib导致游戏黑屏9 comments · 2026-11-13#94建议:VFX 池化扩容 + GC 堆参数与遮挡期回收 + 显示锁 60Hz——三项移动端体验优化(附实现与数据)6 comments · 2026-10-03#115v0.1.12无法安装5 comments · 2026-11-13#86皮皮倒带程序集dll初始化失败5 comments · 2026-09-17#22简而言之我尝试下载的时候总会出现这种 bug 必须让我购买游戏原版内容才能下载模组 这个离谱bug😅我都没电脑 虽然我有账户但是我购买了之后肯定在电脑上玩不了啊 这种 bug 导致了我根本下不了任何创意工坊的内容4 comments · 2026-06-21#108进入对局就画面卡死3 comments · 2026-10-22#95立绘看不了吗只能2d吗?好可惜3 comments · 2026-10-03#81杀戮尖塔2 1.111.0beta版进不去游戏3 comments · 2026-09-13
Discussions
#119New Version1 comments · 2026-11-13#38Cross platform multiplayer support1 comments · 2026-07-07#34Welcome to Sts2MobileLauncher Discussions!4 comments · 2026-07-05
Latest release
v0.1.12 v0.1.12 2026-11-13- 新增游戏 v0.113.0 兼容支持,适配联机、商店、宝箱与模糊效果。 - 新增内置全键盘、键盘悬浮入口与实体键鼠/触屏自动切换。 - 新增创意工坊订阅列表与图片查看器,改进下载管理和图片请求取消。 - 改进文件浏览器与日志查看器,新增 AI 日志分析和多种归档导入支持。 - 改进 MOD 更新与兼容包自动匹配,修复 MOD 扩展存档和云存档问题。 - 新增高刷/60Hz/跟随系统与竖屏模式,改进 shader 兼容和动画预热。 - Added game v0.113.0 support with multiplayer, shop, treasure-room, and blur adaptations. - Added a built-in full keyboard, floating keyboard button, and automatic switching between hardware input and touch. - Added Workshop subscriptions and an image viewer; improved download management and image request cancellation. - Improved the file browser and log viewer; added AI log a