sfcraft-docs/assets/items/README.md

物品贴图库

本目录存放 crafting 合成组件使用的物品贴图（PNG）。

命名规则

一个物品对应一个文件：<名称>.png，文件名（不含 .png）就是引用时的名字。

例如放入 diamond.png 后，在合成组件中写 a1="diamond" 即可显示钻石。

推荐使用 16×16（或 32×32）的 Minecraft 像素风贴图，image-rendering: pixelated 会保证缩放后依然清晰锐利。

自动同步（推荐）

构建 / 开发时由 scripts/sync-items.ps1 自动维护本目录：

• sfcraft 自定义贴图（amethyst_cauldron_blank、exp_totem、lunch_box、pearl_token 等） 从 sfcraft 仓库 自动下载，缺失或远端变更时更新；
• 原版物品（diamond、stick 等）在本地缺失时从 Minecraft wiki 自动获取；
• 手动放入的贴图不会被覆盖；找不到的贴图会报错并列出物品 id，阻止构建 / 开发。

请使用 scripts\build.ps1 / scripts\dev.ps1 而非直接运行 hugo，详见 scripts/README.md。

组件用法

{{< crafting
  a1="diamond" a2="diamond" a3="diamond"
  b1=""        b2="stick"   b3=""
  c1=""        c2="stick"   c3=""
  out="diamond_pickaxe"
  caption="钻石镐（可选）"
>}}

• a1~c3：3×3 合成格的九个格子，out：输出格；
• 值 = 贴图文件名（不含 .png），留空 / 省略 = 空格子；
• 需要显示堆叠数量时写 名称:数量，例如 b2="stick:2"；
• caption 可选，显示在组件下方居中说明文字；
• 未运行自动同步且贴图缺失时，格子内会显示一个 ? 占位，方便发现写错的名字。