Skip to content

掉落表与生成规则 ​

掉落表(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(函数)。

json
{
  "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 格式 ​

json
{
  "format_version": "1.8.0",
  "minecraft:spawn_rules": {
    "description": {
      "identifier": "minecraft:my_mob",
      "population_control": "animal"
    },
    "conditions": [
      {
        // 生成条件配置
      }
    ]
  }
}

description 字段 ​

参数类型说明
identifierstring要生成的实体标识符
population_controlstring种群控制类型(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是否地表生成

待补充:各过滤器详细参数与组合示例。

完整示例 ​

待补充:一个包含实体掉落表和生成规则的完整配置示例,展示如何让自定义生物在特定群系生成并掉落自定义物品。

下一步 ​