物品拾取范围 EX

物品拾取范围模组

扩展版

Minecraft 版本： 1.20.1
Fabric Loader 版本： 0.16.14+
原作者： wenhao
本版本作者： Arona74
许可证： MIT

---

描述

物品拾取范围模组允许玩家调整在 Minecraft 中自动拾取物品的范围（默认为 1.0）。每位玩家可以单独设置自己的拾取半径，服务器管理员可以定义可配置的最小和最大限制，以保持范围平衡。

该模组支持每位玩家自定义，数值在会话之间持久保存，并在配置限制更改时自动限制现有玩家的数值。

---

功能

• 每位玩家的拾取范围 – 每位玩家都可以设置自己的范围。
• 可配置限制 – 服务器管理员可以在 JSON 配置文件中定义 minPickupRange 和 maxPickupRange。
• 自动限制 – 如果玩家范围超过新的配置限制，将自动调整。
• 持久化数值 – 玩家拾取范围会保存到 NBT 并从中加载。
• 简单命令 – 所有功能均可通过一个根命令访问：/PickupRange。

---

安装

1. 为 Minecraft 1.20.1 安装 Fabric Loader 0.16.14+。
2. 为 Minecraft 1.20.1 安装 Fabric API。
3. 将此模组编译后的 .jar 文件放入你的 mods/ 文件夹。
4. 使用 Fabric 配置文件启动 Minecraft。

---

配置

模组配置存储在：

config/item_pickup_range.json

{
  "minPickupRange": 0.5,
  "maxPickupRange": 5.0
}

• minPickupRange：允许的最小拾取范围
• maxPickupRange：允许的最大拾取范围

更改数值并重新加载配置后，会自动调整玩家当前的范围。

---

命令

所有命令均位于根命令下：/PickupRange

命令	描述	权限
/PickupRange set <value>	设置你的个人物品拾取范围（在配置限制内）	所有玩家
/PickupRange get	显示你当前的拾取范围	所有玩家
/PickupRange reload	重新加载配置并限制所有玩家的范围	仅 OP（权限等级 2）

---

工作原理

• 玩家范围单独存储并保存到 NBT，因此会在会话之间持久保存。
• 模组会在服务器启动或重新加载配置时自动限制玩家数值。
• 如果玩家的拾取范围因新限制而被调整，会收到通知。

---

开发

• 语言：Java
• 构建系统：使用 Fabric Loom 的 Gradle
• 使用 Mixins 将拾取范围逻辑注入到 PlayerEntity 中。

---

许可证

本模组基于 MIT 许可证 发布。只要包含许可证条款，你可以自由使用、修改和重新分发它。