Kabutack Essentials

A lightweight Fabric QoL mod featuring a minimal HUD, smart inventory interaction, auto-refill, hotbar presets, and one-key sorting.
一款集成极简 HUD、智能背包交互、自动补给、快捷栏预设与一键整理的 Fabric 实用增强模组。

🇺🇸 English | 🇨🇳 简体中文

🌐 English

📊 HUD Display

• Shows FPS, Chunks, Light Level, and In-Game Time.
• Press H to open the HUD settings screen.
• Press - to toggle HUD visibility.
• Press = to cycle HUD position through the four screen corners.
• Uses dynamic colors for performance, block-light danger, and day/night time.

📦 Inventory Interaction

• Shift + Left Drag: fast drag-transfer items across slots.
• Alt + Left Drag: fast drag-transfer only the same item type.
• Matching same-type slots are highlighted while dragging.

♻️ Auto Refill

• Automatically refills the selected hotbar slot when the item is consumed or broken.
• Open the refill settings with O.
• Supports both BLACKLIST and WHITELIST modes.
• Preferences are per-player and persist independently in multiplayer/LAN.
• Items are matched by item ID + item NBT, so two custom items built on the same vanilla base item (e.g. both are minecraft:stick) are never swapped for each other.
• Refill config: config/kabutack-auto-refill.properties
• Key options:
  • nbtIdentityKeys=CustomModelData
    • default. If an item carries any of these keys, its identity is decided by those keys alone, and every other NBT field (instance UUID, remaining uses, lore) is ignored.
    • this is what makes custom-item servers (TSB, resource-pack CMD packs) refill the right item instead of a random one.
    • dotted paths such as TSB.ID are supported; leave empty to disable.
  • nbtIgnoreKeys=Damage,RepairCost
    • used when an item has no identity key. Volatile fields are removed before comparing, so a worn tool still matches a fresh one.
  • nbtMatchMode=normalized
    • normalized (default) / strict / item_only (legacy: compares item ID only, may refill the wrong item).
  • allowSameItemFallback=false
    • false (default): never refill with a different item. true restores the old "any item with the same ID" behavior.
  • windowTicks / cooldownTicks / requireSameSlot / requireClientUseSignal: trigger tuning.
  • debugRefillLogging=false: set to true to log why a refill was rejected, including an NBT diff of every same-ID item in the inventory.
• The config file is generated with inline comments; new options are appended automatically and existing values are preserved.

🧰 Hotbar Presets

• F6: quick-save preset #1
• F7: quick-restore preset #1
• B: open the hotbar preset panel
• Presets are stored server-side and persist across world restarts.
• Restore prefers exact NBT matches, then falls back to same-item best-fit matching.

🗂️ One-Key Sorting

• J: sort the current container area
• K: sort the player inventory
• Shift + K: sort player inventory + hotbar
• Armor slots and offhand are excluded from sorting.
• Supported targets:
  • player inventory
  • chests / double chests
  • barrels
  • shulker boxes
• Sorting mode config: config/kabutack-item-sort.properties
• Available sorting modes:
  • sortMode=VANILLA
    • default for new or regenerated configs in v1.4.0
    • sorts by the item's primary vanilla creative-tab category, then by that tab's internal order
  • sortMode=BROAD
    • merges multiple vanilla creative tabs into fewer survival-friendly groups
    • inside each broad group, keeps the item's primary vanilla-tab relative order
• Existing config/kabutack-item-sort.properties files keep their current value. Edit or delete the file if you want an older install to pick up the new default.

🏮 简体中文

📊 HUD 显示

• 显示 FPS、区块、光照、游戏时间。
• 按 H 打开 HUD 设置界面。
• 按 - 显示 / 隐藏 HUD。
• 按 = 在四个角之间循环切换 HUD 位置。
• 会根据性能、方块光、昼夜时间动态变色。

📦 背包交互

• Shift + 左键拖动：快速滑动转移物品。
• Alt + 左键拖动：只转移与起始物品同类的物品。
• 同类拖动时会高亮匹配槽位。

♻️ 自动补给

• 当前快捷栏物品被消耗完或损坏时，自动从背包补同一件物品。
• 按 O 打开自动补给设置。
• 支持 黑名单 / 白名单 两种模式。
• 多人/LAN 下每个玩家独立保存自己的偏好。
• 补给按 物品 ID + 物品 NBT 判定身份，底料相同（比如都是 minecraft:stick）的两件自定义道具不会互相补错。
• 补给配置文件：config/kabutack-auto-refill.properties
• 主要选项：
  • nbtIdentityKeys=CustomModelData
    • 默认值。物品带有其中任一键时，身份只看这些键，其余 NBT（实例 UUID、剩余次数、Lore）全部忽略。
    • 玩法服（TSB、资源包 CustomModelData 方案）能补对物品，靠的就是这一项。
    • 支持 TSB.ID 这种点分路径；留空 = 关闭。
  • nbtIgnoreKeys=Damage,RepairCost
    • 物品没有身份主键时使用。比较前剔除会随使用变化的字段，所以用旧的工具仍能匹配到全新副本。
  • nbtMatchMode=normalized
    • normalized（默认）/ strict / item_only（旧行为：只比物品 ID，可能补错）。
  • allowSameItemFallback=false
    • false（默认）：身份不一致就不补，避免补错。
    • true：恢复旧行为，可能把物品 A 补成物品 B。
  • windowTicks / cooldownTicks / requireSameSlot / requireClientUseSignal：触发时机微调。
  • debugRefillLogging=false：设为 true 会输出补给被拒绝的原因，以及背包里同 ID 物品的 NBT 差异，用于排查玩法服补给问题。
• 配置文件自带中文注释；新版本新增的选项会自动追加，已有取值不会被覆盖。

🧰 快捷栏预设

• F6：快速保存预设 #1
• F7：快速恢复预设 #1
• B：打开快捷栏预设面板
• 预设存储在服务端，可跨重启持久化。
• 恢复时优先精确 NBT 匹配，其次进行同类最佳匹配。

🗂️ 一键整理

• J：整理当前容器区域
• K：整理玩家背包
• Shift + K：整理玩家背包 + 快捷栏
• 护甲栏和副手不会被整理。
• 当前支持：
  • 玩家背包
  • 箱子 / 大箱子
  • 木桶
  • 潜影盒
• 整理模式配置文件：config/kabutack-item-sort.properties
• 可选整理模式：
  • sortMode=VANILLA
    • v1.4.0 中作为新建/重建配置时的默认值
    • 先按物品的主归属原版创造栏分类排序，再按该分类内顺序排序
  • sortMode=BROAD
    • 将多个原版创造栏折叠成更少的大类
    • 每个大类内部仍保留物品主归属创造栏的相对顺序
• 已有 config/kabutack-item-sort.properties 不会被强制改写；旧安装如需切换到新默认值，请手动编辑或删除该文件。