掉落表与生成规则
掉落表(Loot Table)和生成规则(Spawn Rules)是《我的世界》数据驱动系统中两个核心机制。掉落表控制实体死亡、方块破坏、箱子打开等场景下的物品产出;生成规则控制实体在世界中的自然刷新条件。本文将介绍两者的 JSON 配置格式与使用方法。
适用版本
掉落表和生成规则均为原版 addon 支持的功能,不需要开启实验性玩法。
掉落表概述
掉落表定义了特定场景下物品的掉落逻辑。所有掉落表 JSON 文件应放置在行为包的 loot_tables/ 目录下。
behavior_pack/
└── loot_tables/
├── entities/
│ └── my_mob.json
├── blocks/
│ └── my_block.json
└── chests/
└── my_chest.json待补充:掉落表的触发场景分类与优先级说明。
掉落表 JSON 格式
每个掉落表由一个或多个 pools(池)组成,每个池包含一组 entries(条目)以及可选的 conditions(条件)和 functions(函数)。
{
"pools": [
{
"rolls": 1,
"entries": [
{
"type": "item",
"name": "minecraft:diamond",
"weight": 1
}
]
}
]
}待补充:rolls、entries、type 字段的完整说明。
条件与函数
条件(Conditions)
条件用于控制掉落池或条目是否生效。常见条件包括:
| 条件 | 说明 |
|---|---|
killed_by_player | 是否被玩家击杀 |
random_chance | 随机概率 |
random_chance_with_looting | 受抢夺附魔影响的概率 |
has_mark_variant | 实体是否具有特定标记变体 |
待补充:所有条件类型的完整列表与参数说明。
函数(Functions)
函数用于修改掉落物品的属性。常见函数包括:
| 函数 | 说明 |
|---|---|
set_count | 设置物品数量 |
set_data | 设置物品附加值 |
set_nbt | 设置 NBT 数据 |
enchant_with_levels | 按等级随机附魔 |
looting_enchant | 抢夺附魔加成 |
待补充:所有函数类型的完整列表与参数说明。
实体掉落表
实体掉落表控制生物死亡时掉落的物品。在实体的行为定义中通过 minecraft:loot 组件指定掉落表路径。
待补充:实体掉落表的绑定方式、条件组合示例。
方块掉落表
方块掉落表控制方块被破坏时掉落的物品。在方块的行为定义中通过 minecraft:loot 组件指定掉落表路径。
待补充:方块掉落表的绑定方式、精准采集与时运附魔的条件配置。
生成规则概述
生成规则控制实体在世界中的自然生成。所有生成规则 JSON 文件应放置在行为包的 spawn_rules/ 目录下。
behavior_pack/
└── spawn_rules/
└── my_mob_spawn.json待补充:生成规则与实体行为文件的关系说明。
生成规则 JSON 格式
{
"format_version": "1.8.0",
"minecraft:spawn_rules": {
"description": {
"identifier": "minecraft:my_mob",
"population_control": "animal"
},
"conditions": [
{
// 生成条件配置
}
]
}
}description 字段
| 参数 | 类型 | 说明 |
|---|---|---|
identifier | string | 要生成的实体标识符 |
population_control | string | 种群控制类型(animal/monster/ambient 等) |
待补充:population_control 各类型的容量限制说明。
生成条件与权重
conditions 数组中可配置多组生成条件,常用的过滤器包括:
| 过滤器 | 说明 |
|---|---|
minecraft:weight | 生成权重 |
minecraft:herd | 群体大小范围 |
minecraft:density_limit | 密度限制 |
minecraft:brightness_filter | 亮度过滤 |
minecraft:height_filter | 高度过滤 |
minecraft:biome_filter | 群系过滤 |
minecraft:spawns_underground | 是否地下生成 |
minecraft:spawns_on_surface | 是否地表生成 |
待补充:各过滤器详细参数与组合示例。
完整示例
待补充:一个包含实体掉落表和生成规则的完整配置示例,展示如何让自定义生物在特定群系生成并掉落自定义物品。
下一步
- 了解 自定义附魔 以在掉落表中配置附魔物品
- 了解 自定义维度与生物群系 以配合生成规则使用
- 查阅原版掉落表参考:
data/loot_tables/目录
