RGSS

RPG Maker 游戏包检测与试跑宿主。Spark 是引擎，本仓负责认出游戏根并经脚本链路试跑。

XP / VX / VX Ace 的脚本是 RGSS 特殊 Ruby。2000 / 2003 只有事件指令，这里只报告版本，不执行。

本仓库不附带 RPG Maker 运行时、RTP 或任何游戏素材。

开窗口试跑

pnpm install
pnpm launch -- --path "<游戏根>"

发布构建：pnpm launch -- --path "<游戏根>" --release。

等价命令：

rgss --path <游戏根>
cargo run -p rgss-game --bin rgss -- --path <游戏根>

Esc 退出。可用环境变量 RGSS_MAX_FRAMES 限制标题帧数后自动关窗。

仅检测

rgss detect --path <游戏根>

成功时打印一行，例如 XP RgssRuby Library=RGSS103J.dll。

引擎	结果
2000 / 2003	Event
XP / VX / VX Ace	RgssRuby
MV / MZ	失败，错误码 rgss.detect.js_engine

无头 play

rgss play --path <游戏根>

加载 Scripts，经 oak-ruby → spark-script-ruby → spark-vm 编译并尝试入口（不开窗口）。

开发构建

cargo test -p rgss-core
cargo check -p rgss-game --bin rgss
cargo check -p rgss-napi