Restyle

English

一个 Fabric 客户端模组：在运行时用 AI 模型重绘 Minecraft 的方块材质—— 无需资源包。每次资源重载时，模组把未缓存的方块材质打包成 128x128 的 棋盘板，送入 ONNX 模型推理，然后渐进式替换：你附近的方块优先，所以 几秒内就能看到新外观。结果缓存在磁盘上，之后即时复用。

环境要求

• Minecraft 1.20.1、Fabric Loader、Fabric API
• 一个兼容的 ONNX 模型（1x3x128x128，float [0,1]，RGB）

安装

1. 把模组 jar 放入 .minecraft/mods/。
2. 将模型放到 .minecraft/restyle/model.onnx。
3. 启动游戏。首次重载会重绘所有方块材质；结果缓存在 .minecraft/restyle/cache/ 下，此后直接复用。

没有模型文件时，模组保持不激活状态，不会对游戏做任何改动。

构建

gradlew.bat build

jar 内捆绑了 ONNX Runtime（MIT 许可证），见 THIRD-PARTY-NOTICES.txt。

许可证

MIT——见 LICENSE。

TODO

1. 扩展版本支持

• onnxruntime 版本更新/回退？

2. 模型训练

• alpha 通道模型原生而不是照搬原版（可使用多个预定色板值）（尤其注意草方块等）
• 将模型换成 DiT
• 增加生物支持
• 增加物品支持
• 提升模型质量
• 增加 UI 支持（不重要）