SpreadLoot

SpreadLoot — Minecraft 1.21.1（NeoForge）智能战利品分配系统

SpreadLoot 是一个适用于 NeoForge 1.21.1 的模组，允许服务器管理员组织资源收集和分配。该模组会自动从特殊标记的箱子中收集物品，并根据配置规则将其分配到其他箱子中。

核心功能

箱子标记

• 拿起任意物品并将其重命名为工具名称（默认：Reg）。
• 按住 Shift + 右键点击箱子、木桶或潜影盒，将其添加到模组注册表中。
• 每个注册的箱子都与它的拥有者（进行标记的玩家）绑定。
• 再次按住 Shift + 右键点击可移除标记。

箱子类型（通过重命名区分）

默认名称	作用
Res / RareRes / EpicRes / LegRes	资源来源。模组从这些箱子中取走物品进行分配。每个类别都有各自的权重。
Res+	加成箱。其内容物始终会放入每个战利品箱中。
Loot	目标箱。模组将收集到的资源放入这些箱子中。

权重类别

• Res — 权重 8
• RareRes — 权重 4
• EpicRes — 权重 2
• LegRes — 权重 1

权重越高，该类别中的物品出现频率越高。

分配模式

• 复制（copy） — 物品以整组堆叠方式放置。
• 随机（random） — 从每个堆叠中随机取出一部分数量。

自动清理

• 每隔 60 分钟，模组会检查所有注册过的箱子并移除已毁坏的箱子。
• 注册表每 5 秒保存一次。
• 所有文件均通过临时文件加原子移动的方式进行保存。

世界扫描

/spreadloot scan <radius> 命令允许你：

• 扫描半径内的所有区块。
• 自动注册找到的具有自定义名称的箱子。
• 收集资源并将其分配到半径内的战利品箱中。

权限系统

该模组支持多个管理员级别：

1. 服务器管理员（权限等级 2 及以上）。
2. 单人世界拥有者或局域网主机。
3. 受信任的 UUID — 通过配置文件或 /spreadloot trust <player> 设置。
4. 受信任的名称（离线模式的备用方案）。

变更跟踪

• 战利品箱 — 消息对所有玩家可见。
• 资源来源箱 — 通知仅发送给标记拥有者。

/set 参数

参数	值	描述
min	数字（0-64）	每个箱子最小物品数量
max	数字（0-64）	每个箱子最大物品数量
mode	copy 或 random	分配模式
tool	名称	用于标记的工具名称
res	名称	Res 类别名称
resplus	名称	加成箱名称
rareres	名称	RareRes 类别名称
epicres	名称	EpicRes 类别名称
legres	名称	LegRes 类别名称
loot	名称	目标箱名称

配置文件

模组在世界文件夹中创建两个 JSON 文件：

• spreadloot_settings.json — 包含所有模组设置（名称、权重、限制、受信任数据）。
• spreadloot_registry.json — 包含所有已标记箱子的注册表及其拥有者绑定。如果主文件损坏，模组会从备份中恢复。

使用示例

1. 设置名称：/spreadloot set tool Finder，/spreadloot set loot Reward

2. 玩家拿起 Finder 物品，按住 Shift+右键点击装有资源的箱子 — 箱子即被注册。

3. 多余的物品放入 Res+ 箱子中。

4. 创建名为 Reward 的空箱子。

5. 管理员运行 /spreadloot spread confirm — 资源被分配到 Reward 箱子中。

6. 玩家打开 Reward 箱子并收集战利品。