moly-root

中文 | English

Note

本仓库已归档。 开发已结束：不再增加功能，也不再修复问题，Issues 与 Pull requests 均已关闭。代码按许可证可自由 fork 与修改。

moly-root 是一套不依赖 Unity 引擎的资源提取工具：它读取使用者自己提供的 Unity 资源包、包清单与 master 表，输出 moly 运行所需的资源目录（glTF 模型与动作、贴图、表格与音频）。

本仓库不含、也不分发任何游戏数据。输入由使用者自行准备，输出同样属于使用者自己的数据，不随代码分发。

安装

需要 Python 3.11 或更高版本与 Rust 工具链。在仓库根目录执行：

python -m pip install '.[jp]'

安装后提供命令 moly。提取需要仓库自带的着色器转换工具，用 Rust 编译：

cargo build --release --manifest-path tools/shader-bridge/Cargo.toml

产物是 tools/shader-bridge/target/release/moly-shader-bridge（Windows 上带 .exe）。解码音频需要另装 vgmstream 的 vgmstream-cli（可选再装 ffmpeg），用 --vgmstream、--ffmpeg 指定；没有它们时音频档照常写出，只是不解码。

使用步骤

以下命令在一个空的工作目录里执行，<...> 换成自己的值。

1. 生成资源包清单并下载资源包：

   moly jp manifest --out manifest.json
   moly jp download --manifest manifest.json --out workspace

2. 取得与资源版本匹配的 master 表：

   moly jp master --manifest manifest.json --out workspace/master --all-tables

3. 解密并提取：

   moly jp pull --manifest manifest.json --out workspace \
     --extract-out workspace/extracted --master workspace/master \
     --shader-compiler <moly-shader-bridge 路径>

4. 组装成 moly 读取的运行时资源目录。--ui-jp-from 是 moly ui-layout --region jp 的输出；--ui-from 是另一份已组装的运行时目录，只提供共用的界面图片（见 运行时资源）：

   moly jp prepare --manifest manifest.json --workspace workspace --out runtime \
     --master-from workspace/master --ui-from <界面来源目录> --ui-jp-from <界面提取目录> \
     --vgmstream <vgmstream-cli 路径>

5. 校验：

   moly validate-runtime --asset-root runtime

6. 交给 moly：把环境变量 MOLY_ASSET_ROOT（或 moly.toml 的 resources.root 键）设为 runtime 目录后启动 moly。

中途失败的步骤可以直接重跑，已完成的部分会被复用。每个子命令的全部参数见 moly <子命令> --help。

文档

• 运行时资源：上面各步的参数与选项。
• 提取管线：可复用的提取任务、缓存与校验。
• 清单提取与拉取流程：按包清单选择、下载与提取。
• 数据契约：输出文件的格式。
• 下载、缓存与分包的完整性：打包与校验。

许可证

MIT。第三方归属见 LICENSE 和 THIRD_PARTY_NOTICES.md。