ModinMobileSTS /Sts2MobileLauncher

an unofficial sts2 mobile launcher that support mods,optimized mobile control

★ 603⑂ 23👁 3⑃ 0● 127▤ 12
JavaMITCreated 2026-05-22
下载:v0.1.12v0.1.12 ↓0.1.122026-11-13
+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

Discussions

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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON