sg-sprite

MAGES 引擎精灵布局解析器。

此应用程序从 .png 和 .lay 文件中恢复原始（完整且未裁剪）精灵，这些文件位于 chara.mpk 归档中。请注意，此解析器不直接与 mpk 文件一起工作，您需要先解包精灵。这里有一个很好的工具：[https://github.com/rdavisau/sg-unpack](https://github.com/rdavisau/sg-unpack)

兼容的游戏列在下面的兼容性列表中。此列表将在测试（并在需要和可能的情况下修复）其他标题的解析器后立即更新。如果您发现它与基于 mages 引擎构建的非列表游戏一起工作（或不起作用），请随时提交 PR 或问题。

您还可以在此处阅读格式描述。它仅基于对 s;g0 精灵的反向工程，因此是粗糙和不完整的，但它应该给出文件结构的近似视图。

常见问题解答

• • 问：我的存档具有 .cpk 扩展名。我如何解包它？
  • 答：使用 arc_unpacker 项目：arc_unpacker --dec=cri/cpk --no-recurse chara.cpk（它还可以提取 mpk 文件：--dec=mages/mpk）
• • 问：在解包 chara 存档后，我看到 .gxt 文件而不是 .png
  • 答：GXT 是 PS Vita 纹理格式。在用 sg-sprite 使用之前，将它们转换为 png：[https://github.com/xdanieldzd/Scarlet](https://github.com/xdanieldzd/Scarlet) 项目。
    转换后的 PNG 将具有 (Image 0) 后缀，但自 0.2.3 版本起，sg-sprite 也会选择它们，因此您不需要将它们重命名为与 .lay 文件名匹配。
    在这种情况下，生成的精灵可能存在背景问题，我怀疑这是gxt转png转换的问题（你可以查看其中一个转换/源PNG文件来确认）。如果有更好的维护者，请告诉我，我可以更换链接。
• • 问：我在输出文件夹中看到一些带有_oX后缀的透明PNG文件。这是什么意思？
  • 答：这些是叠加层。它们旨在绘制在精灵上方，你可以用你喜欢的图片编辑器（例如GIMP）自己完成。它们应该与文件中的大多数精灵兼容。此外，它们与原始精灵大小相同，因此你不需要进行任何手动定位。

兼容性列表

以下标题已知可以工作，但其他一些也可能可以工作（见readme顶部）

• Steins;Gate 0
• Steins;Gate Steam Edition
• Steins;Gate Linear Bounded Phenogram
• Steins;Gate My Darling's Embrace
• Chaos;Child
• Yahari Game Demo Ore no Seishun Love-Kome wa Machigatteiru. Zoku

安装

Windows和Linux的构建可在GitHub发行版中找到

还有一个适用于Arch Linux的AUR软件包

请注意，此应用程序没有图形用户界面。你应该从终端（或在Windows上的cmd.exe）运行它。运行sg-sprite --help以获取使用详情。

使用示例

• cd进入包含解包精灵的目录
• 创建输出目录（例如out）
• 运行sg-sprite --d out *.lay

构建

安装cargo（https://rust-lang.net.cn/tools/install）

在项目目录中运行此命令：cargo build --release

生成的二进制文件将在target/release目录中