**核心机制与体验优化**
* **新增拾取延迟保护**:有效解决拾取键与副手键绑定冲突的问题,防止因单次拾取过快而导致的误触交换副手物品。
* **优化拾取判定**:调整了拾取范围的 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.
Developer information
Projects on Modrinth are automatically available through a Maven repository for use with JVM build tools such as Gradle.
maven { name = "Modrinth"; url = "https://api.modrinth.com/maven" }