Tyranor-Next README

The project's README from github.com/Weiss-UltimateSavior/Tyranor-Next. As one markdown file: README.md.

Tyranor Next

Tyranor Next

基于 Tyranor 模拟器逆向重写的多引擎视觉小说（Galgame）聚合启动器，面向 Android 平台。内置 Kirikiri / ONScripter / Tyrano / Artemis 四套引擎运行环境，并支持 Ren'Py、RPG Maker RGSS 外置 APK 引擎模块，可识别和启动多类游戏，提供游戏库管理、封面获取、存档镜像、引擎参数调节等一体化体验。

主打轻便、简单、快捷，不引入其他冗余功能的简约设计思路

企鹅群：364439133

感谢 @安音 为本项目绘画的logo娘！

支持范围

引擎与游戏类型

游戏类型 典型识别特征 运行环境
Kirikiri / Kirikiri2 .xp3、startup.tjs Kirikiroid2 / krkrsdl3 原生运行时
ONScripter nscript.dat、.nsa ONScripter 原生运行时
Artemis system.ini、.pfs Artemis 原生运行时
TyranoBuilder index.html、tyrano/ 内置 Tyrano Web 运行环境
RPG Maker XP .rgssad、Game.ini + Data/*.rxdata 外置 RPGM APK 模块
RPG Maker VX .rgss2a、Game.ini + Data/*.rvdata 外置 RPGM APK 模块
RPG Maker VX Ace .rgss3a、Game.ini + Data/*.rvdata2 外置 RPGM APK 模块
mkxp-z 用户选择/内部别名 internal.mkxp-z 外置 RPGM APK 模块
RPG Maker MV www/、js/rpg_core.js 内置 Web 运行环境
RPG Maker MZ www/、js/rmmz_core.js 内置 Web 运行环境
VN globalData.vndata 内置 Web 运行环境
WebOther 通用 index.html 网页游戏 内置 Web 运行环境
Ren'Py .rpa、game/script.rpy、game/options.rpy、renpy/ + .rpy/.rpyc 外置 RenPy APK 模块

内置 Web 运行环境同时支持部分以 app.asar 打包的 NW.js 游戏；启动时会根据归档内容进一步识别具体类型。 Ren'Py 与 RPG Maker XP/VX/VX Ace/mkxp-z 当前通过外置 APK 模块运行：Ren'Py 支持 8.5 / 7.7.1 版本，可在全局或单游戏设置中选择引擎版本；自动模式会读取 Ren'Py script_version 与 Python2 运行库特征，在 8.5 / 7.7.1 模块间匹配。主 App 默认启用该能力，仅在引擎页检查目标模块是否已安装；未安装时引擎 item 显示打叉并提示下载安装。RPG Maker MV/MZ 属于 Web runtime，继续使用内置 Web 运行环境。

平台与文件要求

参与贡献

欢迎参与项目开发与维护！

在提交 Pull Request 前，请先阅读务必阅读遵守 贡献指南。 如果不符合贡献指南的要求，可能会被拒绝合并。 代码务必符合项目整体风格，避免引入新的问题。 提交前请务必使用项目内AGENT.md文件内的审核方式进行提交前审核。 如果代码一眼丁真，一定拒绝合并。

技术架构

模块划分

模块 职责
app Android 应用壳：Compose UI、功能抽象层、配置、封面、存档、授权、后台更新等应用侧能力
engine 底层引擎运行时核心：SDL2/SDL3、Kirikiri TVP、krkrsdl3、ONScripter、Artemis、Tyrano、Native/JNI 与引擎宿主 Activity

三层目录架构

当前项目按职责归类为三层，依赖方向固定为：

界面 UI 交互层 -> 功能抽象层 -> 底层引擎层
层级 目录 职责
底层引擎层 engine/ KRKR/Kirikiroid、krkrsdl3、ONS、Artemis、Tyrano、SDL/Cocos/IJK、Native/JNI、引擎宿主 Activity、引擎资源与 Native 插件底层加载
功能抽象层 app/src/main/java/com/tyranor/next/core/ 游戏扫描、游戏模型、启动编排、封面抓取、存档管理、在线补丁、应用/引擎/单游戏配置、授权、后台更新
界面 UI 交互层 app/src/main/java/com/tyranor/next/ui/ Compose 页面、Activity 壳、弹窗、导航、顶部栏、搜索框、用户输入、加载态与错误态

功能抽象层按领域继续拆分：

UI 层按页面域继续拆分：

技术栈

引擎集成设计

构建

# 编译 Debug APK
./gradlew assembleDebug --no-daemon

产物位于 app/build/outputs/apk/debug/。需要 Android SDK（本地平台 android-37）环境。

目录结构

app/
├── src/main/java/com/tyranor/next/
│   ├── core/      功能抽象层：扫描、启动、引擎模块、封面、存档、补丁、配置、授权、更新
│   ├── ui/        界面 UI 交互层：主界面、游戏页、设置页、弹窗、公共组件
│   └── theme/     Compose / Miuix 主题、色调、深浅色适配
├── src/main/assets/
│   ├── engine/        App 专属 Web 引擎注入脚本
│   └── nativeplugins/ Gradle 构建期生成的 Native 插件 zip
└── src/main/nativeplugins/ 插件 manifest 与 app-only 插件源头

engine/
├── src/main/java/          底层引擎宿主、桥接代码与运行时入口
├── src/main/cpp/           Native/JNI、SDL、引擎运行时代码
├── src/main/assets/        底层引擎资源与共享引擎脚本源头
└── src/main/nativeplugins/ 共享 Native 插件 so 源头

docs/   设计文档、逆向分析、功能计划与优化方案

许可证

本项目基于 GNU General Public License v2.0 发布，详见 LICENSE（GPL-2.0-only）。

致谢

Tyranor-Next (Weiss-UltimateSavior/Tyranor-Next)

Searching Database…

668 ·GitHub
Tyranor-Next
这是什么？Tyranor Next 是一个安卓多引擎视觉小说（Galgame）启动器。它的引擎运行时是基于 Tyranor 模拟器逆向重写的，内置 Kirikiri、ONScripter、Tyrano 和 Artemis 的原生运行时，还提供游戏库管理、封面获取、存档镜像和引擎调校。
它能原生运行所有视觉小说引擎，还是也要依赖外部模块？Kirikiri、ONScripter、Artemis 和 Tyrano 通过内置的原生/网页运行时运行，而 Ren'Py 和 RPG Maker XP/VX/VX Ace 则要通过单独安装的外部 APK 引擎模块运行。RPG Maker MV/MZ 使用内置的网页运行时。
怎么让它找到我的游戏？你通过安卓的 Storage Access Framework（SAF）文件选择器授权访问游戏文件夹；应用随后会扫描并根据文件夹内容自动识别引擎类型。
玩 Ren'Py 或经典 RPG Maker 游戏需要额外安装什么吗？需要，Ren'Py 和 RPG Maker XP/VX/VX Ace/mkxp-z 游戏要通过单独的外部 APK 模块运行，你必须安装它们；在安装之前，对应引擎条目会显示叉号并提示你下载。
它在任何安卓手机上都能运行吗？不能，原生引擎库目前只提供 arm64-v8a 版本，因此你需要 Android 8.0（API 26）或更高版本的 64 位 ARM 设备；实际游戏兼容性仍取决于所用的具体引擎版本、打包/加密方式和脚本变体。
GPL-2.0 许可证有什么坑？引擎运行时逆向自 Kirikiroid2 和 ONScripter 等 GPL-2.0 项目，因此整个应用采用 GPL-2.0，任何衍生作品都必须附带完整源代码；内置的 Anime4K 着色器是单独的 MIT 许可例外。
尝试启动 PSP 或 Switch 游戏会发生什么？启动器会检测到并转交给外部模拟器（PSP 用 PPSSPP，Switch 用 Eden），而不是通过自己的引擎运行时运行。
除了启动游戏还能做什么？它还负责游戏库管理、封面图获取、存档镜像，以及按游戏或按引擎的参数调校。
它为什么叫 Tyranor Next？它的引擎运行时和核心架构是基于原版 Tyranor 模拟器的逆向重写，扫描和 SAF 路径映射逻辑则改编自 RinneMobile 项目。
它有什么改善老游戏画面的功能吗？有，它内置 Anime4K GLSL 着色器（MIT 许可，来自 bloc97），可对 Kirikiri 游戏画面进行实时的线条重建超分辨率放大。
What are similar projects?BiliPai, YunX, Metrolist, DSHA, Echo-Music, Seal, vivi-music, Shizuku-Next
Which topics is it in?engine, launcher, anime, super-resolution, apk, jetpack-compose, emulator, material-design, backup, gplv2, android-app, oauth
Creator
Weiss-UltimateSavior
Size
235.8 MB
Stars
668
Updated
CommitOct 18
Age
1mo
Commits · 90 Days