Craftmark：数据驱动的纹理变体

变体如何工作

在首次启动时，Craftmark 会在你的 Minecraft 实例目录中创建一个 craftmark_variants/ 文件夹（与 mods/、config/、saves/ 同级），并生成一个可直接编辑的 brass 示例：

craftmark_variants/
└── brass/                                   ← 一个文件夹 = 一个变体（id: craftmark:brass）
    └── assets/minecraft/textures/block/
        ├── barrel_side.png
        ├── barrel_top.png
        ├── barrel_bottom.png
        └── barrel_top_open.png

在变体文件夹内，你需要使用与原始材质完全相同的资源包布局。brass/assets/minecraft/textures/block/barrel_side.png 会替换原版精灵图 minecraft:block/barrel_side。规则很简单：将你的 PNG 放在其原始路径下，位于你的变体文件夹内。

快速上手（2分钟——无需 KubeJS，无需制作材质）

brass 文件夹已经存在了。开启作弊模式后，运行：

/give @p minecraft:barrel[craftmark:variant="craftmark:brass"]

放置它——黄铜木桶。它在你的手中、物品栏、地面和物品展示框中都是黄铜外观；破坏它，掉落的物品会保留其外观，并且不会与普通木桶堆叠。编辑 craftmark_variants/brass/ 中的 PNG 文件，然后按 F3+T 即可实时查看更改。

制作你自己的变体

1. 在 craftmark_variants/ 中创建一个文件夹——使用小写字母、数字、_ . -：ruby、steel、diamond…… 其 id 将变为 craftmark:<文件夹名>。
2. 放入材质，镜像每个原始文件在 assets/ 下的路径：

   craftmark_variants/ruby/assets/refinedstorage/textures/block/controller.png

   （覆盖 refinedstorage:block/controller）
3. 按 F3+T 重新扫描——新文件夹无需重启即可被识别。
4. 使用该 id 标记物品：

   /give @p refinedstorage:controller[craftmark:variant="craftmark:ruby"]

• 只覆盖你想要的部分——跳过某个面，它就会正常渲染。路径错误则会静默保留原始材质（绝不会出现品红色）。
• 查找原始路径：解压源模组的 jar，在 assets/<ns>/textures/ 下查找；在你的文件夹内镜像该完整路径。
• 方块形状的物品会自动复用方块材质，平面物品精灵图也以相同方式镜像（assets/<ns>/textures/item/…）。

当面无法被覆盖时：逐方块覆盖 （1.1.0 新增）

craftmark_variants/<variant>/by_block/<block-namespace>/<block-path>/<face>.png

craftmark_variants/brass/by_block/refinedstorage/storage_monitor/bottom.png

将其整合到配方中（KubeJS）

命令用于测试；在真正的整合包中，你需要标记合成的输出物品，这样玩家才能获得外观。在 kubejs/server_scripts/ 中：

ServerEvents.recipes(event => {
    event.shapeless(
        Item.of('refinedstorage:controller', '[craftmark:variant="craftmark:ruby"]'),
        ['refinedstorage:controller', 'mymod:ruby']
    ).id('mypack:ruby_controller');
});

调试你的变体

每次资源（重新）加载时，都会为每个找到的变体文件夹记录一行：

craftmark: variant craftmark:brass: 4 texture(s) stitched

计数低于预期 = 某个路径未匹配。F3+T 会重新运行扫描并重新读取新文件夹。