<div align="center"> <h1>🚀 Kabutack Essentials</h1> </div> <p align="center"> <b>A lightweight Fabric QoL mod featuring a minimal HUD, smart inventory interaction, auto-refill, hotbar presets, and one-key sorting.</b><br> <b>一款集成极简 HUD、智能背包交互、自动补给、快捷栏预设与一键整理的 Fabric 实用增强模组。</b> </p> <p align="center"> <img src="https://img.shields.io/badge/Minecraft-1.21.11-success" alt="Minecraft Version"> <img src="https://img.shields.io/badge/Minecraft-1.21.1-success" alt="Minecraft Version"> <img src="https://img.shields.io/badge/Minecraft-1.20%20~%201.20.4-success" alt="Minecraft Version"> <img src="https://img.shields.io/badge/Loader-Fabric-blue" alt="Fabric"> <img src="https://img.shields.io/badge/Release-v1.4.0-orange" alt="Release Version"> </p> --- (#-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. <br> --- ## 🏮 简体中文 ### 📊 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` 不会被强制改写；旧安装如需切换到新默认值，请手动编辑或删除该文件。