ВЕРСИИ (32)

1. If Create mod is detected, item drop stacking optimization will be disabled by default. Stacking optimization conflicts with some scenarios in Create and the issue cannot be resolved. 2. Added pickup range modification in custom options. It can only be changed in cheat mode or by the server owner. ---------------------------------------------------------------------------- 1. 当检测到机械动力模组存在时，默认关闭掉落物堆叠优化，堆叠优化与机械动力部分场景冲突无法解决 2. 在自定义选项里添加了拾取范围修改，只允许作弊模式下或者服主更改

1. If Create mod is detected, item drop stacking optimization will be disabled by default. Stacking optimization conflicts with some scenarios in Create and the issue cannot be resolved. 2. Added pickup range modification in custom options. It can only be changed in cheat mode or by the server owner. ---------------------------------------------------------------------------- 1. 当检测到机械动力模组存在时，默认关闭掉落物堆叠优化，堆叠优化与机械动力部分场景冲突无法解决 2. 在自定义选项里添加了拾取范围修改，只允许作弊模式下或者服主更改

1. If Create mod is detected, item drop stacking optimization will be disabled by default. Stacking optimization conflicts with some scenarios in Create and the issue cannot be resolved. 2. Added pickup range modification in custom options. It can only be changed in cheat mode or by the server owner. ---------------------------------------------------------------------------- 1. 当检测到机械动力模组存在时，默认关闭掉落物堆叠优化，堆叠优化与机械动力部分场景冲突无法解决 2. 在自定义选项里添加了拾取范围修改，只允许作弊模式下或者服主更改

1. If Create mod is detected, item drop stacking optimization will be disabled by default. Stacking optimization conflicts with some scenarios in Create and the issue cannot be resolved. 2. Added pickup range modification in custom options. It can only be changed in cheat mode or by the server owner. ---------------------------------------------------------------------------- 1. 当检测到机械动力模组存在时，默认关闭掉落物堆叠优化，堆叠优化与机械动力部分场景冲突无法解决 2. 在自定义选项里添加了拾取范围修改，只允许作弊模式下或者服主更改

修复精妙背包拾取升级失效的问题，现可正常共存 Fixed the Sophisticated Backpacks pickup upgrade being disabled; both now work together.

修复精妙背包拾取升级失效的问题，现可正常共存 Fixed the Sophisticated Backpacks pickup upgrade being disabled; both now work together.

修复拖拽掉落物到物品栏槽位的刷物品漏洞 Fix the item duplication exploit caused by dragging dropped items into inventory slots

修复拖拽掉落物到物品栏槽位的刷物品漏洞 Fix the item duplication exploit caused by dragging dropped items into inventory slots

修复拖拽掉落物到物品栏槽位的刷物品漏洞 Fix the item duplication exploit caused by dragging dropped items into inventory slots

修复拖拽掉落物到物品栏槽位的刷物品漏洞 Fix the item duplication exploit caused by dragging dropped items into inventory slots

### 功能 - **长按拾取模式配置**：新增配置项，可选择"全部拾取"或"单行全部拾取"，默认全部拾取。 - **物品栏列表全量拾取修饰键**：新增修饰键，按住时单击或拖拽均拾取该行全部物品。 - **修饰键默认值**：拾取修饰键默认改为 Shift，优化语言文件。 ### 修复 - **pick-up-notifier 兼容性**：修复该模组拾取提示刷屏的问题。 --- ### Features - **Long-press Pickup Mode Config**: Added configuration to choose between "Pickup All" or "Pickup Single Row All", defaults to Pickup All. - **Inventory List Full Row Pickup Modifier Key**: Added modifier key; when held, both click and drag pick up all items in that row. - **Default Modifier Key**: Pickup modifier key now defaults to Shift; optimized language files. ### Fixes - **pick-up-notifier Compatibility**: Fixed spam issue with pick-up notification messages from that mod.

### 功能 - **长按拾取模式配置**：新增配置项，可选择"全部拾取"或"单行全部拾取"，默认全部拾取。 - **物品栏列表全量拾取修饰键**：新增修饰键，按住时单击或拖拽均拾取该行全部物品。 - **修饰键默认值**：拾取修饰键默认改为 Shift，优化语言文件。 ### 修复 - **pick-up-notifier 兼容性**：修复该模组拾取提示刷屏的问题。 --- ### Features - **Long-press Pickup Mode Config**: Added configuration to choose between "Pickup All" or "Pickup Single Row All", defaults to Pickup All. - **Inventory List Full Row Pickup Modifier Key**: Added modifier key; when held, both click and drag pick up all items in that row. - **Default Modifier Key**: Pickup modifier key now defaults to Shift; optimized language files. ### Fixes - **pick-up-notifier Compatibility**: Fixed spam issue with pick-up notification messages from that mod.

### 功能 - **长按拾取模式配置**：新增配置项，可选择"全部拾取"或"单行全部拾取"，默认全部拾取。 - **物品栏列表全量拾取修饰键**：新增修饰键，按住时单击或拖拽均拾取该行全部物品。 - **修饰键默认值**：拾取修饰键默认改为 Shift，优化语言文件。 ### 修复 - **pick-up-notifier 兼容性**：修复该模组拾取提示刷屏的问题。 --- ### Features - **Long-press Pickup Mode Config**: Added configuration to choose between "Pickup All" or "Pickup Single Row All", defaults to Pickup All. - **Inventory List Full Row Pickup Modifier Key**: Added modifier key; when held, both click and drag pick up all items in that row. - **Default Modifier Key**: Pickup modifier key now defaults to Shift; optimized language files. ### Fixes - **pick-up-notifier Compatibility**: Fixed spam issue with pick-up notification messages from that mod.

### 功能 - **长按拾取模式配置**：新增配置项，可选择"全部拾取"或"单行全部拾取"，默认全部拾取。 - **物品栏列表全量拾取修饰键**：新增修饰键，按住时单击或拖拽均拾取该行全部物品。 - **修饰键默认值**：拾取修饰键默认改为 Shift，优化语言文件。 ### 修复 - **pick-up-notifier 兼容性**：修复该模组拾取提示刷屏的问题。 --- ### Features - **Long-press Pickup Mode Config**: Added configuration to choose between "Pickup All" or "Pickup Single Row All", defaults to Pickup All. - **Inventory List Full Row Pickup Modifier Key**: Added modifier key; when held, both click and drag pick up all items in that row. - **Default Modifier Key**: Pickup modifier key now defaults to Shift; optimized language files. ### Fixes - **pick-up-notifier Compatibility**: Fixed spam issue with pick-up notification messages from that mod.

# BetterLooting 2.0 更新日志 ## 皮肤系统 - 新增**悬窗背景皮肤**功能，玩家可自由切换界面风格。 - 首发内置三款皮肤：**默认风格**、**星露谷物语**、**泰拉瑞亚**。 - 支持**自定义皮肤**，制作方法详见 `config/better_looting/skins/README.txt`。 ## 新增功能 ### 物品栏左侧列表 - 打开背包时，界面左侧同步显示掉落物列表，支持拖拽或单击拾取。 - 可在自定义配置中调整位置、尺寸与缩放。 ### 其他功能 - **全局黑名单**：黑名单中的物品将在全局范围内被屏蔽。 - **自定义界面全面升级**：更美观、更流畅的交互体验。 - **第二拾取按键**：新增备用拾取按键（`PICKUP_ALT`），默认未绑定。 - **物品堆叠数量显示**：掉落物上显示堆叠数量。 ## 自定义配置新增项 | 配置项 | 说明 | |---|---| | 物品栏左侧列表开关 | 控制背包界面左侧列表的显示 | | 物品信息预览开关 | 控制物品详情悬浮预览 | | 过滤模式包含稀有物品 | 过滤时是否默认包含稀有物品 | | 按键提示框开关 | 控制按键提示弹窗 | | NEW 标记文本 | 自定义 "NEW" 标记的显示文字 | | 动画速度 | 快 / 中 / 慢 | | 堆叠数量显示模式 | 物品数量 / 堆叠组数 / 关闭 | | 拾取拦截策略 | 智能兼容 / 始终拦截 | ## 兼容性与 Bug 修复 - 修复了与**精妙背包**等模组的磁铁/拾取类功能冲突，拾取逻辑默认兼容第三方模组，可在设置中调整。 - 修复了**机械动力**部分场景下，合并功能导致机器失效或效率降低的问题。 --------------------------------------------------------------------------------- # BetterLooting 2.0 Changelog ## Skin System - Added **hover window background skins** — freely switch between UI styles. - Three built-in skins: **Default**, **Stardew Valley**, **Terraria**. - **Custom skins** supported — see `config/better_looting/skins/README.txt` for instructions. ## New Features ### Inventory Sidebar - When opening the inventory, a drop list now appears on the left side. Drag or click to loot items directly. - Position, size, and scale are configurable. ### Other Features - **Global Blacklist**: Blacklisted items are now filtered everywhere. - **Revamped Customization UI**: Smoother and more polished. - **Secondary Pickup Key**: Added `PICKUP_ALT` keybind (unbound by default). - **Stack Count Display**: Stack sizes are shown on dropped items. ## New Config Options | Option | Description | |---|---| | Inventory Sidebar Toggle | Show/hide the left-side drop list in inventory | | Item Tooltip Preview Toggle | Show/hide item info on hover | | Include Rare Items in Filter | Whether filtering includes rare items by default | | Key Hint Overlay Toggle | Show/hide keybinding hints | | NEW Badge Text | Customize the "NEW" label text | | Animation Speed | Fast / Normal / Slow | | Stack Display Mode | Item Count / Stack Groups / Off | | Pickup Interception Strategy | Smart Compat / Always Intercept | ## Compatibility & Bug Fixes - Fixed conflicts with magnet/pickup features from mods like **Sophisticated Backpacks** — pickup logic now defaults to third-party compatibility, adjustable in settings. - Fixed **Create** mod issues where merge logic caused machine failures or efficiency loss in certain scenarios.

# BetterLooting 2.0 更新日志 ## 皮肤系统 - 新增**悬窗背景皮肤**功能，玩家可自由切换界面风格。 - 首发内置三款皮肤：**默认风格**、**星露谷物语**、**泰拉瑞亚**。 - 支持**自定义皮肤**，制作方法详见 `config/better_looting/skins/README.txt`。 ## 新增功能 ### 物品栏左侧列表 - 打开背包时，界面左侧同步显示掉落物列表，支持拖拽或单击拾取。 - 可在自定义配置中调整位置、尺寸与缩放。 ### 其他功能 - **全局黑名单**：黑名单中的物品将在全局范围内被屏蔽。 - **自定义界面全面升级**：更美观、更流畅的交互体验。 - **第二拾取按键**：新增备用拾取按键（`PICKUP_ALT`），默认未绑定。 - **物品堆叠数量显示**：掉落物上显示堆叠数量。 ## 自定义配置新增项 | 配置项 | 说明 | |---|---| | 物品栏左侧列表开关 | 控制背包界面左侧列表的显示 | | 物品信息预览开关 | 控制物品详情悬浮预览 | | 过滤模式包含稀有物品 | 过滤时是否默认包含稀有物品 | | 按键提示框开关 | 控制按键提示弹窗 | | NEW 标记文本 | 自定义 "NEW" 标记的显示文字 | | 动画速度 | 快 / 中 / 慢 | | 堆叠数量显示模式 | 物品数量 / 堆叠组数 / 关闭 | | 拾取拦截策略 | 智能兼容 / 始终拦截 | ## 兼容性与 Bug 修复 - 修复了与**精妙背包**等模组的磁铁/拾取类功能冲突，拾取逻辑默认兼容第三方模组，可在设置中调整。 - 修复了**机械动力**部分场景下，合并功能导致机器失效或效率降低的问题。 --------------------------------------------------------------------------------- # BetterLooting 2.0 Changelog ## Skin System - Added **hover window background skins** — freely switch between UI styles. - Three built-in skins: **Default**, **Stardew Valley**, **Terraria**. - **Custom skins** supported — see `config/better_looting/skins/README.txt` for instructions. ## New Features ### Inventory Sidebar - When opening the inventory, a drop list now appears on the left side. Drag or click to loot items directly. - Position, size, and scale are configurable. ### Other Features - **Global Blacklist**: Blacklisted items are now filtered everywhere. - **Revamped Customization UI**: Smoother and more polished. - **Secondary Pickup Key**: Added `PICKUP_ALT` keybind (unbound by default). - **Stack Count Display**: Stack sizes are shown on dropped items. ## New Config Options | Option | Description | |---|---| | Inventory Sidebar Toggle | Show/hide the left-side drop list in inventory | | Item Tooltip Preview Toggle | Show/hide item info on hover | | Include Rare Items in Filter | Whether filtering includes rare items by default | | Key Hint Overlay Toggle | Show/hide keybinding hints | | NEW Badge Text | Customize the "NEW" label text | | Animation Speed | Fast / Normal / Slow | | Stack Display Mode | Item Count / Stack Groups / Off | | Pickup Interception Strategy | Smart Compat / Always Intercept | ## Compatibility & Bug Fixes - Fixed conflicts with magnet/pickup features from mods like **Sophisticated Backpacks** — pickup logic now defaults to third-party compatibility, adjustable in settings. - Fixed **Create** mod issues where merge logic caused machine failures or efficiency loss in certain scenarios.

# BetterLooting 2.0 更新日志 ## 皮肤系统 - 新增**悬窗背景皮肤**功能，玩家可自由切换界面风格。 - 首发内置三款皮肤：**默认风格**、**星露谷物语**、**泰拉瑞亚**。 - 支持**自定义皮肤**，制作方法详见 `config/better_looting/skins/README.txt`。 ## 新增功能 ### 物品栏左侧列表 - 打开背包时，界面左侧同步显示掉落物列表，支持拖拽或单击拾取。 - 可在自定义配置中调整位置、尺寸与缩放。 ### 其他功能 - **全局黑名单**：黑名单中的物品将在全局范围内被屏蔽。 - **自定义界面全面升级**：更美观、更流畅的交互体验。 - **第二拾取按键**：新增备用拾取按键（`PICKUP_ALT`），默认未绑定。 - **物品堆叠数量显示**：掉落物上显示堆叠数量。 ## 自定义配置新增项 | 配置项 | 说明 | |---|---| | 物品栏左侧列表开关 | 控制背包界面左侧列表的显示 | | 物品信息预览开关 | 控制物品详情悬浮预览 | | 过滤模式包含稀有物品 | 过滤时是否默认包含稀有物品 | | 按键提示框开关 | 控制按键提示弹窗 | | NEW 标记文本 | 自定义 "NEW" 标记的显示文字 | | 动画速度 | 快 / 中 / 慢 | | 堆叠数量显示模式 | 物品数量 / 堆叠组数 / 关闭 | | 拾取拦截策略 | 智能兼容 / 始终拦截 | ## 兼容性与 Bug 修复 - 修复了与**精妙背包**等模组的磁铁/拾取类功能冲突，拾取逻辑默认兼容第三方模组，可在设置中调整。 - 修复了**机械动力**部分场景下，合并功能导致机器失效或效率降低的问题。 --------------------------------------------------------------------------------- # BetterLooting 2.0 Changelog ## Skin System - Added **hover window background skins** — freely switch between UI styles. - Three built-in skins: **Default**, **Stardew Valley**, **Terraria**. - **Custom skins** supported — see `config/better_looting/skins/README.txt` for instructions. ## New Features ### Inventory Sidebar - When opening the inventory, a drop list now appears on the left side. Drag or click to loot items directly. - Position, size, and scale are configurable. ### Other Features - **Global Blacklist**: Blacklisted items are now filtered everywhere. - **Revamped Customization UI**: Smoother and more polished. - **Secondary Pickup Key**: Added `PICKUP_ALT` keybind (unbound by default). - **Stack Count Display**: Stack sizes are shown on dropped items. ## New Config Options | Option | Description | |---|---| | Inventory Sidebar Toggle | Show/hide the left-side drop list in inventory | | Item Tooltip Preview Toggle | Show/hide item info on hover | | Include Rare Items in Filter | Whether filtering includes rare items by default | | Key Hint Overlay Toggle | Show/hide keybinding hints | | NEW Badge Text | Customize the "NEW" label text | | Animation Speed | Fast / Normal / Slow | | Stack Display Mode | Item Count / Stack Groups / Off | | Pickup Interception Strategy | Smart Compat / Always Intercept | ## Compatibility & Bug Fixes - Fixed conflicts with magnet/pickup features from mods like **Sophisticated Backpacks** — pickup logic now defaults to third-party compatibility, adjustable in settings. - Fixed **Create** mod issues where merge logic caused machine failures or efficiency loss in certain scenarios.

# BetterLooting 2.0 更新日志 ## 皮肤系统 - 新增**悬窗背景皮肤**功能，玩家可自由切换界面风格。 - 首发内置三款皮肤：**默认风格**、**星露谷物语**、**泰拉瑞亚**。 - 支持**自定义皮肤**，制作方法详见 `config/better_looting/skins/README.txt`。 ## 新增功能 ### 物品栏左侧列表 - 打开背包时，界面左侧同步显示掉落物列表，支持拖拽或单击拾取。 - 可在自定义配置中调整位置、尺寸与缩放。 ### 其他功能 - **全局黑名单**：黑名单中的物品将在全局范围内被屏蔽。 - **自定义界面全面升级**：更美观、更流畅的交互体验。 - **第二拾取按键**：新增备用拾取按键（`PICKUP_ALT`），默认未绑定。 - **物品堆叠数量显示**：掉落物上显示堆叠数量。 ## 自定义配置新增项 | 配置项 | 说明 | |---|---| | 物品栏左侧列表开关 | 控制背包界面左侧列表的显示 | | 物品信息预览开关 | 控制物品详情悬浮预览 | | 过滤模式包含稀有物品 | 过滤时是否默认包含稀有物品 | | 按键提示框开关 | 控制按键提示弹窗 | | NEW 标记文本 | 自定义 "NEW" 标记的显示文字 | | 动画速度 | 快 / 中 / 慢 | | 堆叠数量显示模式 | 物品数量 / 堆叠组数 / 关闭 | | 拾取拦截策略 | 智能兼容 / 始终拦截 | ## 兼容性与 Bug 修复 - 修复了与**精妙背包**等模组的磁铁/拾取类功能冲突，拾取逻辑默认兼容第三方模组，可在设置中调整。 - 修复了**机械动力**部分场景下，合并功能导致机器失效或效率降低的问题。 --------------------------------------------------------------------------------- # BetterLooting 2.0 Changelog ## Skin System - Added **hover window background skins** — freely switch between UI styles. - Three built-in skins: **Default**, **Stardew Valley**, **Terraria**. - **Custom skins** supported — see `config/better_looting/skins/README.txt` for instructions. ## New Features ### Inventory Sidebar - When opening the inventory, a drop list now appears on the left side. Drag or click to loot items directly. - Position, size, and scale are configurable. ### Other Features - **Global Blacklist**: Blacklisted items are now filtered everywhere. - **Revamped Customization UI**: Smoother and more polished. - **Secondary Pickup Key**: Added `PICKUP_ALT` keybind (unbound by default). - **Stack Count Display**: Stack sizes are shown on dropped items. ## New Config Options | Option | Description | |---|---| | Inventory Sidebar Toggle | Show/hide the left-side drop list in inventory | | Item Tooltip Preview Toggle | Show/hide item info on hover | | Include Rare Items in Filter | Whether filtering includes rare items by default | | Key Hint Overlay Toggle | Show/hide keybinding hints | | NEW Badge Text | Customize the "NEW" label text | | Animation Speed | Fast / Normal / Slow | | Stack Display Mode | Item Count / Stack Groups / Off | | Pickup Interception Strategy | Smart Compat / Always Intercept | ## Compatibility & Bug Fixes - Fixed conflicts with magnet/pickup features from mods like **Sophisticated Backpacks** — pickup logic now defaults to third-party compatibility, adjustable in settings. - Fixed **Create** mod issues where merge logic caused machine failures or efficiency loss in certain scenarios.

Fixed the startup crash on Fabric caused by missing config file dependencies. 修复了 Fabric 端因缺少配置文件依赖导致的启动崩溃问题

Fixed the startup crash on Fabric caused by missing config file dependencies. 修复了 Fabric 端因缺少配置文件依赖导致的启动崩溃问题

**核心机制与体验优化** * **新增拾取延迟保护**：有效解决拾取键与副手键绑定冲突的问题，防止因单次拾取过快而导致的误触交换副手物品。 * **优化拾取判定**：调整了拾取范围的 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.

**核心机制与体验优化** * **新增拾取延迟保护**：有效解决拾取键与副手键绑定冲突的问题，防止因单次拾取过快而导致的误触交换副手物品。 * **优化拾取判定**：调整了拾取范围的 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.

**核心机制与体验优化** * **新增拾取延迟保护**：有效解决拾取键与副手键绑定冲突的问题，防止因单次拾取过快而导致的误触交换副手物品。 * **优化拾取判定**：调整了拾取范围的 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.

**核心机制与体验优化** * **新增拾取延迟保护**：有效解决拾取键与副手键绑定冲突的问题，防止因单次拾取过快而导致的误触交换副手物品。 * **优化拾取判定**：调整了拾取范围的 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.