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.

🧰 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 下每个玩家独立保存自己的偏好。

🧰 快捷栏预设

• 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 不会被强制改写；旧安装如需切换到新默认值，请手动编辑或删除该文件。