Kabutack Essentials

Auto-Refill Item Identity Fix

English

Fixed

• Auto-refill no longer hands over a different item when several custom items are built on the same vanilla base item (e.g. two artifacts that are both minecraft:stick).
• Worn tools still refill: Damage and RepairCost are excluded from the identity comparison.

Added

• nbtIdentityKeys (default CustomModelData): items carrying an identity key are matched by that key alone, ignoring instance UUID / remaining uses / lore. This fixes auto-refill on custom-item servers such as The Sky Blessing.
• nbtIgnoreKeys, nbtMatchMode, allowSameItemFallback for finer control.
• Identity diagnostics under debugRefillLogging.

Changed

• If no item with the same identity exists in the inventory, auto-refill now does nothing instead of picking another item with the same ID.
• config/kabutack-auto-refill.properties is generated with inline comments (UTF-8 + BOM); new options are appended and existing values are preserved.

Notes

• Client and server should both run v1.4.2. Older clients fall back to item-ID matching.

简体中文

修复

• 修复了同一件原版底料的多个自定义道具（例如两个都是 minecraft:stick 的神器）互相补错的问题。
• 耐久型工具仍可正常补给：身份比较中剔除 Damage 与 RepairCost。

新增

• nbtIdentityKeys（默认 CustomModelData）：物品带有身份主键时只看主键，忽略实例 UUID / 剩余次数 / Lore。玩法服（如 The Sky Blessing）依赖这一项才能补对物品。
• 新增 nbtIgnoreKeys、nbtMatchMode、allowSameItemFallback 三个可调项。
• debugRefillLogging 下新增身份诊断日志。

调整

• 背包中没有同一身份的物品时不再补给，而不是拿一件同 ID 的其他物品顶上。
• config/kabutack-auto-refill.properties 改为带中文注释的格式（UTF-8 + BOM），新增项自动追加，已有取值保留。

说明

• 建议客户端与服务端同时更新到 v1.4.2；旧客户端会自动退回按物品 ID 匹配。