动态宝箱战利品

Dynamic Chest Loot

Dynamic Chest Loot 是一个 Minecraft 模组，允许你随机化并自定义世界中现有容器的战利品，为地图、整合包、冒险和服务器创建简单而强大的战利品系统。

其理念很简单：你可以拿一张已经建好的地图——例如一座城市、地牢、冒险世界或装满容器的自定义地图——并将这些容器变成动态战利品的来源，包括其他模组添加的物品。

---

它是如何工作的？

流程很简单：

1. 创建战利品分类
创建一个分类，定义一组可能的物品和生成规则。

2. 向分类添加物品
添加可能出现的物品，并配置它们各自的属性、数量、权重、附魔、效果和其他选项。

3. 配置分类
选择生成规则，并使用箱子预览查看战利品在容器内可能出现的样子。

4. 设置分类权重
每个分类都有一个 Weight（权重），决定在随机化容器时其被选中的相对概率。

5. 生成战利品
当找到有效的容器时，会根据权重选择一个分类，并将配置的物品随机生成到容器的槽位中。

例如，这可以让一张现有地图中的整座城市的容器都装满整合包中的物品，而无需手动编辑每个容器。

防止物品丢失

为了防止玩家丢失他们的物品，战利品不会生成在玩家放置的容器中，也不会生成在已经打开过的容器中。

该系统主要设计用于世界中已经存在且尚未被打开的容器。

---

主菜单

主菜单是管理战利品配置的起点。

战利品几率

定义战利品生成的总几率。

你可以通过模组的系统控制容器获得战利品的概率，避免每个容器都必然被填充。

创建分类

创建一个新的战利品分类。

分类允许你区分不同类型的战利品，例如：

• 普通战利品
• 稀有战利品
• 地牢战利品
• 城市战利品
• 资源战利品

每个分类都可以有自己的规则和物品。

导入

导入现有的战利品分类或配置。

这使得在不同世界、地图或整合包之间共享配置变得更加容易。

导出

导出你的分类，以便复用或分享。

这对于想要保持战利品配置井然有序或分发预设的地图和整合包作者尤其有用。

编辑分类

打开现有分类以修改其设置、物品和生成规则。

---

编辑分类

编辑分类时，模组会将其配置组织到不同的部分中，以便更轻松地管理战利品。

通用配置

分类的通用设置。

在这里，你可以定义每个槽位生成物品的几率以及该分类被选中的权重。

填充几率

定义每个容器槽位生成物品的几率。

百分比越高，该槽位获得物品的几率就越大。

权重

定义选择战利品时该分类的权重。

权重较高的分类在随机化容器时被选中的相对概率更大。

此部分是该分类的中央配置点。

---

物品列表

物品列表定义了哪些物品可以出现在战利品中。

每个物品都可以单独配置不同的属性：

• 物品权重 - 控制该物品相对于分类中其他物品的相对权重/几率。
• 最小数量 - 可以生成的最小数量。
• 最大数量 - 可以生成的最大数量。

这允许你创建从装有食物和工具的简单容器到完全自定义物品的任何内容。

---

物品编辑

• 物品权重
• 最小数量
• 最大数量

附魔

添加游戏中已注册的附魔，包括其他模组添加的附魔。

你可以配置：

• 附魔
• 最小等级
• 最大等级
• 固定等级
• 添加 / 移除附魔

例如，一把剑可以获得随机等级的锋利，而另一件物品则可以始终获得特定的附魔。

---

自定义名称与描述

使用以下选项自定义生成物品的外观：

• 自定义名称 - 自定义物品名称。
• 描述 - 多行自定义描述。
• 颜色 - 自定义文本颜色。
• 格式 - 文本格式。

这对于任务物品、特殊武器、神器以及 RPG 系统尤其有用。

---

效果

为支持效果的物品（如药水和消耗品）配置效果。

你可以定义：

• 效果类型
• 持续时间
• 等级

持续时间可以按刻或秒进行配置，让你对生成的效果有更大的控制权。

---

原始 NBT / 数据组件

对于高级用户，可以使用 NBT/SNBT 和数据组件定义自定义数据。

这允许你使用其他模组特有的属性，例如：

• 装备数据
• 自定义物品属性
• 能力
• 自定义数据包系统

该系统还包括语法验证，以帮助防止配置格式错误。

---

箱子预览

箱子预览允许你实时查看分类在容器中可能出现的样子。

无需生成世界或打开多个容器来测试你的配置，你可以提前预览潜在的物品分布。

这使得创建、测试和平衡战利品变得更加容易。

---

分类设置

分类设置控制分类何时以及如何参与战利品生成。

容器类型

你可以配置该分类可用于哪些类型的容器，例如：

• 箱子
• 木桶
• 潜影盒
• 运输矿车
• 带有自定义名称的容器

这允许你创建专门针对世界各地不同类型容器的分类。

---

战利品生成模式

选择物品如何添加到容器中。

填充空位

仅在空槽位中生成物品。

容器中已有的任何物品都会被保留。

保留一个

在容器中生成物品，并且可以替换槽位中已有的物品，同时至少保留一个现有物品。

当你想要添加随机战利品，同时保留部分原始容器内容时，此模式非常有用。

全部清除

移除现有物品，并根据分类的配置生成新的战利品。

此模式允许你完全替换容器的内容。

---

战利品生成如何工作？

Dynamic Chest Loot 使用你配置的分类和物品来决定容器内生成的内容。

简化形式如下：

容器 → 战利品检查 → 分类选择 → 物品选择 → 应用属性 → 最终战利品

系统使用物品权重来决定它们的相对出现频率。

例如，假设一个分类包含：

物品	权重
面包	50
铁锭	25
钻石	5

面包会比钻石常见得多，而铁锭则介于两者之间。

物品数量也可以是随机的。如果某物品配置为：

Min Quantity: 2
Max Quantity: 8

则容器可以获得该范围内的任意数量。

与简单使用固定物品列表相比，这允许你创建更加多样化的战利品表。

---

模组兼容性

Dynamic Chest Loot 的主要特点之一是能够与其他模组注册的物品配合使用。

这意味着整合包可以使用多个已安装模组中的物品来创建分类。

例如：

Minecraft + 科技模组 + 魔法模组 + 冒险模组

你可以创建一个结合所有这些模组物品的分类，并让它们自然地出现在世界各地的容器中。

---

为地图而打造

想象一下下载一张废弃城市的地图，其中包含地图作者已经放置的数百个容器。

通常，向这些容器添加自定义物品需要手动编辑地图。

使用 Dynamic Chest Loot，你可以创建如下配置：

废弃城市

• 食物
• 工具
• 材料
• 武器
• 科技物品
• 魔法物品
• 稀有物品

然后，模组可以使用这些配置来动态填充容器。

地图保持不变——但其容器的内容可以不同。

---

非常适合

• 冒险地图
• 城市地图
• 地牢
• RPG
• 整合包
• 自定义地图
• 服务器

---

创建你自己的战利品系统

Dynamic Chest Loot 将你世界中现有的容器转变为灵活、随机且完全可配置的战利品系统。

创建分类、定义概率、自定义物品、添加附魔和效果、使用其他模组的数据，然后让世界处理其余的事情。

你的地图。你的规则。你的战利品。

兼容性

• 模组加载器： Forge / Fabric
• 侧： 仅服务端
• 客户端： 可选的游戏内配置界面

Dynamic Chest Loot 主要是服务端的。 该模组可以直接通过服务器的配置文件进行配置，无需客户端界面。

但是，如果你想使用游戏内配置界面来轻松创建、编辑、预览、导入和导出战利品分类，建议在客户端也安装该模组。