百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
S

StS2-Launcher

> 编程语言
开源

这是一个非官方的 Android 启动程序,用于 Slay the Spire 2。Alpha 版本可在 Cinderbox Discord 服务器上找到。

334 stars0 点赞14 次浏览
访问官网GitHub

工具介绍

这是一个非官方的 Android 启动程序,用于 Slay the Spire 2。Alpha 版本可在 Cinderbox Discord 服务器上找到。

StS2 Launcher

An Android launcher for Slay the Spire 2, built on a custom Godot 4.5.1 engine with .NET/Mono and Harmony runtime patching.

Disclaimer: This is an unofficial community project. Slay the Spire 2 is developed and published by Mega Crit Games. A valid Steam account that owns Slay the Spire 2 is required. Game files are downloaded directly from Steam after authentication. No game assets are included in this repository.

Features

  • Steam authentication
    Login via SteamKit2 with Steam Guard 2FA support.
  • Game file download
    Depot download directly from Steam, with update checking.
  • Cloud saves
    Full Steam cloud sync via SteamKit2's CCloud API, with timestamp-aware conflict resolution and non-blocking background uploads.
  • Mobile adaptation
    Touch input, UI scaling, layout adjustments, and app lifecycle handling via Harmony runtime patches.
  • LAN multiplayer
    UDP broadcast discovery and manual IP join.
  • Shader warmup
    Vulkan pipeline cache persistence and canvas ubershader support to eliminate first-encounter stutters.
  • Credential security
    Steam refresh tokens encrypted at rest via Android Keystore (AES-256-GCM, hardware-backed TEE).

How It Works

At startup, STS2Mobile.dll is loaded via coreclr_create_delegate and applies Harmony patches to adapt the desktop game for mobile. The launcher intercepts GameStartupWrapper() to present a Steam login screen before the game starts.

  • Launcher-only mode
    If no game files are present, the app loads a minimal bootstrap.pck and shows the launcher UI for Steam login and game download.
  • Normal mode
    With game files downloaded, all patches apply against sts2.dll and the game runs natively after authentication.

Engine Patches

Custom patches to the Godot 4.5.1 engine source for Android-specific issues:

  • Vulkan pipeline cache persistence
    Saves compiled pipelines when the app loses focus, preventing recompilation after Android kills the process.
  • Canvas ubershaders
    Enable ubershader fallback for 2D rendering, eliminating first-encounter VFX stutters from blocking pipeline compilation.

Project Structure

…

Prerequisites

  • .NET 9 SDK
  • Android SDK + NDK (see android/config.gradle for versions)
  • Python 3 (for make-bootstrap-pck.py and SCons)
  • Original game files in upstream/godot-export/
  • Custom Godot engine build (see scripts/build-godot.sh)
  • FMOD SDK in vendor/fmod-sdk/

Building

Note: This is a WIP. There are other binaries that are required and will fail if you just run the ./build.sh script. Godot Engine can be found on their repo https://github.com/godotengine/godot. Harmony can be found here https://github.com/Ekyso/Harmony but the version used in StS2 Launcher is compiled using dotnet 9.0. FMOD can be found here https://www.fmod.com/. Spine can be found here https://esotericsoftware.com/. I plan to upload the custom fork of Godot Engine used and the dotnet 9.0 Harmony soon. However, Spine and FMOD will not be uploaded due to licensing restrictions. Information on licensing can be found in the THIRD-PARTY-NOTICES.txt of the root folder.

bash
bash scripts/build.sh

This runs the full pipeline:

  1. dotnet publish the patcher (outputs STS2Mobile.dll + SteamKit2 dependencies)
  2. Copies published DLLs to android/assets/dotnet_bcl/
  3. Copies libSystem.Security.Cryptography.Native.Android.so to JNI libs (for TLS)
  4. Bumps the version in gradle.properties
  5. Builds the APK via ./gradlew assembleMonoRelease

Output: android/build/outputs/apk/mono/release/StS2Launcher-v.apk

Installing

bash
adb install -r android/build/outputs/apk/mono/release/StS2Launcher-v*.apk

# Fresh install (clear saved credentials + cached assemblies)
adb shell pm clear com.game.sts2launcher

Other build tasks

bash
# Regenerate bootstrap PCK (only if project.godot changes)
python3 scripts/make-bootstrap-pck.py

# Rebuild Godot engine (only if engine source changes)
bash scripts/build-godot.sh

# Rebuild native stubs (requires Android NDK)
bash src/stubs/build_stubs.sh

LAN Multiplayer

Both devices must be on the same local network. The mobile app discovers nearby games via UDP broadcast, or you can enter the PC's IP address manually.

On the PC, add --fastmp to the Steam launch options: Steam > Slay the Spire 2 > Properties > Launch Options and enter --fastmp

This enables the fast multiplayer mode that the mobile client expects.

Technical Notes

  • Native library stubs (src/stubs/) provide no-op .so files for desktop-only libraries (Steamworks SDK, Sentry) so the linker is satisfied at runtime.
  • The bootstrap PCK is a minimal project.godot wrapper that enables .NET module initialization without game files.
  • The game's Sentry plugin has no android.arm64 build, so it's disabled via PCK patching and Harmony patches.
  • GodotSharp interop is manually bootstrapped in ModEntry.cs since the Godot SDK source generators aren't available.

License

This project is licensed under the MIT License. See THIRD_PARTY_LICENSES.md for third-party dependency licenses.

FMOD requires a commercial license if your project generates revenue. Spine Runtimes require a valid Spine Editor license. See the third-party licenses file for details.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

C#

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月18日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言