BetterLooting

核心机制与体验优化

• 新增拾取延迟保护：有效解决拾取键与副手键绑定冲突的问题，防止因单次拾取过快而导致的误触交换副手物品。
• 优化拾取判定：调整了拾取范围的 Y 轴默认值，修复了玩家在有载物状态下无法检测到脚下掉落物的 Bug。
• UI 升级：对自定义界面进行了轻度重构与视觉优化。

配置与指令更新

• 防作弊与全局控制：拾取范围现由服务端全局控制，防止玩家私自修改作弊。服主或管理员可使用指令 /bl range <xz> <y> 动态调整全局范围。
• 全新配置文件：配置文件格式由 .json 全面迁移至 .toml，并补充了详细的注释说明。
• 更多自定义项：现在支持在配置文件中自定义**“批次拾取时间”与“延迟保护时间”**。

兼容性与开发者 API

• 底层逻辑重构：拾取动作现会标准触发 Minecraft 原版事件，大幅提升与其他依赖原版拾取事件模组的兼容性。
• 新增 KubeJS 支持：添加 KubeJS 软依赖，触发拾取时将自动抛出 ItemEvents.PICKED_UP 事件，方便整合包作者编写联动脚本。

Core Mechanics & QoL

• Added Pickup Delay Protection: Prevents accidental off-hand item swapping when the pickup key and off-hand key are bound to the same button (caused by rapid pickup triggers).
• Optimized Hitbox Detection: Adjusted the default Y-axis pickup range, fixing an issue where dropped items underfoot couldn't be detected while the player is carrying loads/entities.
• UI Refactor: Slightly refactored and improved the custom user interface.

Configurations & Commands

• Anti-Cheat & Global Sync: The pickup range is now globally synchronized by the server to prevent client-side cheating. Server hosts/admins can adjust the range dynamically using the command /bl range <xz> <y>.
• Config Upgrade: Migrated the configuration file format from .json to .toml and added detailed comments for easier setup.
• New Custom Settings: Added configurable options for Batch Pickup Time and Delay Protection Time.

Compatibility & API

• Logic Refactor: Pickups now correctly trigger Vanilla Minecraft events, significantly improving compatibility with other mods that rely on these events.
• KubeJS Support: Added KubeJS as a soft dependency. Triggering a pickup will now automatically fire the ItemEvents.PICKED_UP event, making it easier for modpack developers to write custom scripts.