Kabutack Essentials

🇺🇸 English

🚀 Features

• Intelligent Auto-Refill: Automatically restocks depleted hotbar slots with identical items from the inventory.
• NBT Persistence: Added server-side NBT saving (kabutack_hotbars.dat) for hotbar presets. Layouts now persist across game restarts and world reloads.
• "Best-Fit" Algorithm: F7 restoration now prioritizes exact NBT matches; if none exist, it intelligently selects items with the closest durability to your preset.
• Offline Mode Support: Implemented dual-matching logic (UUID + Username) to prevent data loss when UUIDs fluctuate in offline/pirated clients.
• Alt Filtering Sort: Hold Alt and drag to transfer only items of the same type. Includes a visual highlighting overlay.

🔧 Tweaks & Fixes

• Expanded Search Radius: Hotbar restoration now searches the entire inventory (slots 0-35) instead of just the main inventory (9-35).
• Anti-Oscillation Logic: Added interception logic to prevent an infinite swapping loop when multiple identical items exist in the inventory.
• Cross-Version API Fixes: Resolved crashes on Minecraft 1.20.2 - 1.20.4 by using Reflection for PersistentStateManager and adopting modern Entity name fetching.
• Lock Lifecycle: Fixed a bug where the isMovingItems state lock failed to release if the GUI was force-closed via the Esc key.
• HUD Refinement: Added cycling HUD positions via the = key to easily avoid UI overlap.

🇨🇳 简体中文

🚀 新增特性

• 智能自动补给：当快捷栏物品耗尽时，自动从背包中寻找同类物品补满当前槽位。
• 预设永久存储：引入服务端 NBT 存储系统（kabutack_hotbars.dat），支持跨存档、跨重启永久保存快捷栏布局。
• 智能择优匹配算法：使用 F7 恢复时，优先匹配完全一致的 NBT 数据；若无，则自动寻找耐久度最接近预设的物品，避免新旧工具误换。
• 离线模式深度兼容：实现 UUID 与 玩家名双重识别存储系统，确保离线模式玩家在 UUID 变动后仍能找回快捷栏数据。
• Alt 分类整理：新增“同类项过滤”转移功能。按住 Alt 键滑动鼠标时，仅转移与起始物品同类的项，并附带视觉高亮遮罩提示。

🔧 优化与修复补丁

• 扩大搜索范围：将物品恢复的搜索半径从仅主背包扩大至全物品栏（槽位 0-35），确保放在快捷栏其他位置的物品也能被正确归位。
• 交换拦截机制：增加了“仅在更优时交换”的判定机制，杜绝了多个同类物品存在时可能导致的无限来回替换（振荡）问题。
• 完美跨版本兼容：通过底层反射（Reflection）技术动态适配 API 差异，修复了在 1.20.2 ~ 1.20.4 版本上的各种崩溃（如 PersistentStateManager 及 EntityName 报错），实现单文件通杀！
• 泄露修复：修复了通过 Esc 键意外关闭容器界面后，可能导致状态锁未能正确释放的隐患。
• HUD 位置循环：按下 = 键支持在屏幕四个角循环切换 HUD 位置，防遮挡更方便。