标签

来自Minecraft Wiki
跳转至: 导航搜索
Information icon.svg
此特性为Java版基岩版独有。

数据包中的标签(Tag)允许玩家使用JSON文件将物品方块流体实体类型函数组合在一起。

用途[编辑 | 编辑源代码]

为了使用方块、物品、流体、实体类型或函数标签,JSON文件必须分别放置于数据包的data/(命名空间)/tags/blocksdata/(命名空间)/tags/itemsdata/(命名空间)/tags/fluidsdata/(命名空间)/tags/entity_typesdata/(命名空间)/tags/functions目录下。

游戏本身也使用了这些标签。原版方块标签被用于各种方块属性。原版物品标签被用于各种物品属性、原版进度文件与原版配方文件。原版实体类型标签被用于各种生物的属性。在#标签列表部分可以查看它们的用途。

但是并不存在原版函数标签,因为原版中不存在函数,不过游戏会读取minecraft命名空间下的特定函数标签。

文件结构[编辑 | 编辑源代码]

  • (数据包根目录)
    • data
      • (命名空间)
        • tags
          • blocks
            • (名称).json
          • entity_types
            • (名称).json
          • fluids
            • (名称).json
          • functions
            • (名称).json
          • items
            • (名称).json

方块标签[编辑 | 编辑源代码]

方块标签可以在用命令测试方块时以#(命名空间ID)的形式调用。只要方块满足了该标签中定义的任何一个方块,命令就会测试通过。

物品标签[编辑 | 编辑源代码]

物品标签可以在用命令测试物品时以#(命名空间ID)的形式调用。也可以在配方或进度中用"tag": "(命名空间ID)"的格式使用。只要物品满足了该标签中定义的任何一个物品,测试就会通过。

实体类型标签[编辑 | 编辑源代码]

实体类型标签可以在type实体选择器参数以及战利品表条件中以#(命名空间ID)的形式使用。只要物品满足了该标签中定义的任何一个物品,测试就会通过。

函数标签[编辑 | 编辑源代码]

函数标签可以在/function命令中以#(命名空间):(路径)的形式调用。所有在该标签中指定的函数都会按照它们第一次出现的顺序执行。就算一个函数在标签以及子标签中被多次引用,它也只会被执行意思。

另外,所有在tick标签中标记的函数将会在每刻的开始执行,在load标签中标记的函数将会在服务器加载及重载后的第1刻开始执行1次。

JSON格式[编辑 | 编辑源代码]


  • 根标签。

    •  replace:这个标签是否应该完全覆盖来自较低优先级数据包同命名空间下的同名标签。当设定为false时则为为此标签进行补充。默认为false

    •  values:一个物品、方块或函数列表。可以引用同类型的其他标签,但是不能循环引用。

      • :一个物品、方块、流体、实体类型或函数的命名空间ID。格式应为(命名空间):(名称)

      • :另一个同类型的标签的ID。格式应为#(命名空间):(路径)

标签列表[编辑 | 编辑源代码]

方块[编辑 | 编辑源代码]

标签名称 用途
acacia_logs acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood -
anvil anvil、chipped_anvil、damaged_anvil
  • 用来决定哪些方块能够用来打开铁砧的GUI界面。对其他方块无效,但是将默认元素移出该标签会使得GUI不出现。
  • 用来决定其下落方块形式是否伤害实体,用于死亡消息。
  • 用来判断一个方块是否会在使用或落地时“破坏”。在标签上添加可以自然掉落的块不会使它们在自然掉落时有机会在落地时消失。例如,添加sand将不会使自然生成的落沙在落地时会被破坏,但是通过命令生成的落沙将有机会破碎。
  • 用于从掉落中的实体中读取NBT。如果该实体没有HurtEntitiesNBT标签,则将hurtEntities设置为true
  • 用来决定方块是否有机会被通过铁砧GUI破损。
banners white_banner、orange_banner、magenta_banner、light_blue_banner、yellow_banner、lime_banner、pink_banner、gray_banner、light_gray_banner、cyan_banner、purple_banner、blue_banner、brown_banner、green_banner、red_banner、black_banner、white_wall_banner、orange_wall_banner、magenta_wall_banner、light_blue_wall_banner、yellow_wall_banner、lime_wall_banner、pink_wall_banner、gray_wall_banner、light_gray_wall_banner、cyan_wall_banner、purple_wall_banner、blue_wall_banner、brown_wall_banner、green_wall_banner、red_wall_banner、black_wall_banner -
birch_logs birch_log、birch_bark、stripped_birch_log、stripped_birch_bark -
buttons #wooden_buttons、stone_button -
carpets white_carpet、orange_carpet、magenta_carpet、light_blue_carpet、yellow_carpet、lime_carpet、pink_carpet、gray_carpet、light_gray_carpet、cyan_carpet、purple_carpet、blue_carpet、brown_carpet、green_carpet、red_carpet、black_carpet -
coral_blocks tube_coral_block, brain_coral_block, bubble_coral_block, fire_coral_block, horn_coral_block -
corals tube_coral, brain_coral, bubble_coral, fire_coral, horn_coral, tube_coral_fan, brain_coral_fan, bubble_coral_fan, fire_coral_fan, horn_coral_fan -
dark_oak_logs dark_oak_log, dark_oak_bark, stripped_dark_oak_log, stripped_dark_oak_bark -
doors #wooden_doors、iron_door -
enderman_holdable grass_block、dirt、coarse_dirt、podzol、sand、red_sand、gravel、dandelion、poppy、blue_orchid、allium、azure_bluet、red_tulip、orange_tulip、white_tulip、pink_tulip、oxeye_daisy、brown_mushroom、red_mushroom、tnt、cactus、clay、pumpkin、carved_pumpkin、melon_block、mycelium、netherrack
  • 用来决定哪些方块可以被末影人拾起。
flower_pots flower_pot、potted_poppy、potted_blue_orchid、potted_allium、potted_azure_bluet、potted_red_tulip、potted_orange_tulip、potted_white_tulip、potted_pink_tulip、potted_oxeye_daisy、potted_dandelion、potted_oak_sapling、potted_spruce_sapling、potted_birch_sapling、potted_jungle_sapling、potted_acacia_sapling、potted_dark_oak_sapling、potted_red_mushroom、potted_brown_mushroom、potted_dead_bush、potted_fern、potted_cactus -
ice ice, packed_ice, blue_ice, frosted_ice -
impermeable glass, white_stained_glass, orange_stained_glass, magenta_stained_glass, light_blue_stained_glass, yellow_stained_glass, lime_stained_glass, pink_stained_glass, gray_stained_glass, light_gray_stained_glass, cyan_stained_glass, purple_stained_glass, blue_stained_glass, brown_stained_glass, green_stained_glass, red_stained_glass, black_stained_glass
  • 这个标签下的方块的上方有液体时不会展示水滴/熔岩粒子效果。
jungle_logs jungle_log, jungle_bark, stripped_jungle_log, stripped_jungle_bark -
leaves jungle_leaves, oak_leaves, spruce_leaves, dark_oak_leaves, acacia_leaves, birch_leaves -
logs #dark_oak_logs, #oak_logs, #acacia_logs, #birch_logs, #jungle_logs, #spruce_logs
  • 用于鹦鹉的栖息AI对方块的要求之一。
  • 如果该标签的方块周围有树叶,树叶方块会将其check_decay方块状态设为false。
  • 树会生长进入此标签的方块。
  • 如果默认村落结构中的方块与该标签内的方块匹配,则它们将被砂岩、云杉木或金合欢原木(取决于生物群系)替换。
  • 检查破坏树木教程步骤的进度。
oak_logs oak_log, oak_bark, stripped_oak_log, stripped_oak_bark -
planks oak_planks、spruce_planks、birch_planks、jungle_planks、acacia_planks、dark_oak_planks
  • 如果默认村庄结构的方块有此标签中的方块,则这些方块会被替换为平滑砂岩、云杉木板和金合欢木板(取决于生物群系)。
rails rail, powered_rail, detector_rail, activator_rail
  • 检测是否可以放置矿车。
  • 检测是否与铁轨相连。
  • 矿车是否可在此方块上行驶。
sand sand, red_sand -
saplings oak_sapling、spruce_sapling、birch_sapling、jungle_sapling、acacia_sapling、dark_oak_sapling
  • 树会生长进入此标签的方块。
slabs stone_slab, stone_brick_slab, sandstone_slab, acacia_slab, birch_slab, dark_oak_slab, jungle_slab, oak_slab, spruce_slab, purpur_slab, quartz_slab, red_sandstone_slab, brick_slab, cobblestone_slab, nether_brick_slab, petrified_oak_slab, prismarine_slab, prismarine_bricks_slab, dark_prismarine_slab -
spruce_logs spruce_log, spruce_bark, stripped_spruce_log, stripped_spruce_bark -
stairs oak_stairs, cobblestone_stairs, spruce_stairs, sandstone_stairs, acacia_stairs, jungle_stairs, birch_stairs, dark_oak_stairs, nether_brick_stairs, stone_brick_stairs, brick_stairs, purpur_stairs, quartz_stairs, red_sandstone_stairs, prismarine_bricks_stairs, prismarine_stairs, dark_prismarine_stairs -
stone_bricks stone_bricks、mossy_stone_bricks、cracked_stone_bricks、chiseled_stone_bricks -
underwater_bonemeals seagrass, #corals, #wall_corals
  • 当在暖洋生物群系中在水下使用骨粉时,该标签中的方块将取代水源方块(在5个水平块和2个垂直块内)。
  • 如果该标记中的方块是自定义的,则该行为将应用于任何生物群系中的水源方块。这些方块在默认情况下不会充水。
valid_spawn grass_block, podzol
  • 用于确定位置是否是玩家的有效出生位置。
wall_corals tube_coral_wall_fan, brain_coral_wall_fan, bubble_coral_wall_fan, fire_coral_wall_fan, horn_coral_wall_fan -
wooden_buttons oak_button、spruce_button、birch_button、jungle_button、acacia_button、dark_oak_button
  • 用于标签#buttons。
wooden_doors oak_door、spruce_door、birch_door、jungle_door、acacia_door、dark_oak_door
  • 用于标签#doors。
wooden_pressure_plates oak_pressure_plate、spruce_pressure_plate、birch_pressure_plate、jungle_pressure_plate、acacia_pressure_plate、dark_oak_pressure_plate -
wooden_slabs oak_slab、spruce_slab、birch_slab、jungle_slab、acacia_slab、dark_oak_slab -
wooden_stairs oak_stair、spruce_stair、birch_stair、jungle_stairs、acacia_stairs、dark_oak_stairs -
wool white_wool、orange_wool、magenta_wool、light_blue_wool、yellow_wool、lime_wool、pink_wool、gray_wool、light_gray_wool、cyan_wool、purple_wool、blue_wool、brown_wool、green_wool、red_wool、black_wool
  • 此标签的方块可以被使用剪刀快速破坏,并增加剪刀的使用统计。
  • 放在该标签的方块上的音符盒会发出吉他音效。

流体[编辑 | 编辑源代码]

Tag name Values Usage
lava lava, flowing_lava
  • 在这种液体附近的仙人掌会被摧毁
  • 用于在这种液体上显示流动的熔岩的材质(MC-129244?)
  • 用于在雨中产生烟雾粒子,而不是普通的雨粒子。
  • 用于显示熔岩的雾效果。
  • 用于标签Invulnerable为true时的燃烧图示。
  • 当一个装着这种液体的桶把液体倒在地上时,会播放熔岩的音效。
  • 指示LAVA探路系统节点。
  • 用于生成石头/圆石/黑曜石的过程。
  • 由这种液体决定它在这种液体内部的颜色
  • 确定实体是否会像在岩浆中一样移动。
water water, flowing_water
  • 珊瑚至少有一面接触这种液体。
  • 珊瑚扇必须放在这种液体里。
  • 耕地利用这种液体判定湿润程度。
  • 甘蔗检测自身被种植的方块旁边是否有这种液体或霜冰。
  • 海绵会摧毁这种液体
  • 这种液体决定这些粒子该不该出现:(bubblebubble_column_upcurrent_downunderwater
  • 水粒子由这种液体决定它在这种液体内部的颜色。
  • 用于显示水的雾效果。
  • 确定实体是否会像在水中一样移动。
  • 指定WATER探路系统节点,部分生物会找到它。
  • 船会检测这种液体。
  • 混凝土粉末会检测这种液体。
  • 物品和经验球会漂浮在这种液体中。
  • 守卫者、鱼、海龟会检测这种液体。
  • 钓鱼竿浮漂会在这种液体里跳跃。
  • 玻璃瓶可以被这种液体装满。
  • 这种液体不能倒在下界里。
  • 用于是否将火焰熄灭。
  • 用于Air标签是否在此液体中减少。
  • 充水方块也受此影响。

物品[编辑 | 编辑源代码]

标签名称 Values Usage
acacia_logs acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood
  • 用于acacia_planks.json进度和合成配方文件,以及logs.json物品标签文件。
anvil anvil, chipped_anvil, damaged_anvil -
banners white_banner, orange_banner, magenta_banner, light_blue_banner, yellow_banner, lime_banner, pink_banner, gray_banner, light_gray_banner, cyan_banner, purple_banner, blue_banner, brown_banner, green_banner, red_banner, black_banner
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加300刻的燃烧时间。
birch_logs birch_log, birch_wood, stripped_birch_log, stripped_birch_wood
  • 用于birch_planks.json进度和合成配方文件以及logs.json物品标签文件。
boats oak_boat, spruce_boat, birch_boat, jungle_boat, acacia_boat, dark_oak_boat
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加200刻的燃烧时间。
buttons #wooden_buttons, stone_button -
carpets white_carpet, orange_carpet, magenta_carpet, light_blue_carpet, yellow_carpet, lime_carpet, pink_carpet, gray_carpet, light_gray_carpet, cyan_carpet, purple_carpet, blue_carpet, brown_carpet, green_carpet, red_carpet, black_carpet
  • 此标签中的物品可以添加到羊驼的装饰栏中来改变羊驼的外观。其他物品若加入此标签也会生效,但不会更改羊驼的外观。
  • 用于检查物品是否能放入熔炉的燃料槽,并重置燃烧时间至67。
dark_oak_logs dark_oak_log, dark_oak_wood, stripped_dark_oak_log, stripped_dark_oak_wood
  • 用于dark_oak_planks.json进度和合成配方文件,以及logs.json物品标签文件。
doors #wooden_doors, iron_door -
fishes cod, cooked_cod, salmon, cooked_salmon, pufferfish, tropical_fish
  • 此标签中的物品出现在玩家的主手或副手中时,海豚会背着玩家游泳。
  • 使用此标签中的物品喂养海豚会使它们“信任”你。
  • 用于统计已捕获的鱼的数量的fish_caught统计数据。
jungle_logs jungle_log, jungle_wood, stripped_jungle_log, stripped_jungle_wood
  • 用于jungle_planks.json进度和合成配方文件,以及logs.json物品标签文件。
leaves jungle_leaves, oak_leaves, spruce_leaves, dark_oak_leaves, acacia_leaves, birch_leaves -
logs oak_log, spruce_log, birch_log, jungle_log, acacia_log, dark_oak_log, oak_bark, spruce_bark, birch_bark, jungle_bark, acacia_bark, dark_oak_bark
  • 用于各种检测,以跳过或进入“punch_tree”教程步骤。
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加300刻的燃烧时间。
oak_logs oak_log, oak_wood, stripped_oak_log, stripped_oak_wood
  • 用于oak_planks.json进度和合成配方文件,以及logs.json物品标签文件。
planks oak_planks, spruce_planks, birch_planks, jungle_planks, acacia_planks, dark_oak_planks
  • 用于在修复木质工具时,检测用于修复的物品。
  • 用于在修复盾牌时,检测用于修复的物品。
  • 用于各种检测,以跳过或进入“craft_planks”教程步骤。
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加300刻的燃烧时间。
  • 用于这三个进度文件这三十二个合成配方文件
rails rail, powered_rail, detector_rail, activator_rail -
sand sand, red_sand
  • 用于glass.json进度和合成配方文件。
saplings oak_sapling, spruce_sapling, birch_sapling, jungle_sapling, acacia_sapling, dark_oak_sapling
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加100刻的燃烧时间。
slabs stone_slab, stone_brick_slab, sandstone_slab, acacia_slab, birch_slab, dark_oak_slab, jungle_slab, oak_slab, spruce_slab, purpur_slab, quartz_slab, red_sandstone_slab, brick_slab, cobblestone_slab, nether_brick_slab, petrified_oak_slab, prismarine_slab, prismarine_bricks_slab, dark_prismarine_slab -
spruce_logs spruce_log, spruce_wood, stripped_spruce_log, stripped_spruce_wood
  • 用于spruce_planks.json进度和合成配方文件,以及logs.json物品标签文件。
stairs oak_stairs, cobblestone_stairs, spruce_stairs, sandstone_stairs, acacia_stairs, jungle_stairs, birch_stairs, dark_oak_stairs, nether_brick_stairs, stone_brick_stairs, brick_stairs, purpur_stairs, quartz_stairs, red_sandstone_stairs, prismarine_bricks_stairs, prismarine_stairs, dark_prismarine_stairs -
stone_bricks stone_bricks, mossy_stone_bricks, cracked_stone_bricks, chiseled_stone_bricks
  • 用于这三个进度文件这两个合成配方文件
wooden_buttons oak_button, spruce_button, birch_button, jungle_button, acacia_button, dark_oak_button
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加100刻的燃烧时间。
  • 在标签#buttons 中使用。
wooden_doors oak_door, spruce_door, birch_door, jungle_door, acacia_door, dark_oak_door
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加100刻的燃烧时间。
  • 用于doors.json物品标签文件
wooden_pressure_plates oak_pressure_plate, spruce_pressure_plate, birch_pressure_plate, jungle_pressure_plate, acacia_pressure_plate, dark_oak_pressure_plate
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加300刻的燃烧时间。
wooden_slabs oak_slab, spruce_slab, birch_slab, jungle_slab, acacia_slab, dark_oak_slab
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加150刻的燃烧时间。
  • 在配方书文件'dayllght_detector.json' 中使用。
wooden_stairs oak_stair, spruce_stair, birch_stair, jungle_stairs, acacia_stairs, dark_oak_stairs
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加300刻的燃烧时间。
wool white_wool, orange_wool, magenta_wool, light_blue_wool, yellow_wool, lime_wool, pink_wool, gray_wool, light_gray_wool, cyan_wool, purple_wool, blue_wool, brown_wool, green_wool, red_wool, black_wool
  • 用于检查一个物品是否能进入熔炉的燃料槽并增加300刻的燃烧时间。
  • 在配方书和进度文件'painting.json' 中使用。

历史[编辑 | 编辑源代码]

Java版
1.13 17w49a 为方块和物品添加了标签。
加入了原版方块标签plankswool
加入了原版物品标签 plankswool
17w49b 函数现在可以被标记。
tick标签的函数现在从开始运行后的每一刻都运行。
加入了原版方块标签buttonscarpetsdoorsflower_potslogssaplingsstone_bricks
加入了原版物品标签 buttonscarpetsdoorslogssaplingsstone_bricks
17w50a 加入了原版方块标签wooden_buttonswooden_doors
加入了原版物品标签 wooden_buttonswooden_doors
更新了原版方块和物品标签buttonsdoors,分别包括stone_buttoniron_door
18w01a load标签的函数将在(re)加载后运行一次。
加入了原版方块标签 anvil
18w02a 加入了原版方块标签 enderman_holdable
18w06a 加入了原版方块标签bannerswooden_pressure_plateswooden_slabswooden_stairs
加入了原版物品标签 bannersboatswooden_pressure_plateswooden_slabs,和wooden_stairs
18w07a 加入了原版方块标签slabsstairswater_hacked
加入了方块和物品标签acacia_logsbirch_logsdark_oak_logsjungle_logsoak_logs,和spruce_logs
18w07b 加入了方块标签 waterlogged
加入了方块和物品标签railssand
18w09a 加入了原版方块和物品标签 coral
water_hacked标签现在包括箱子
18w10a 加入了方块和物品标签 coral_plants
waterlogged方块标签现在包括珊瑚。
18w10c 移除了方块标签water_hackedwaterlogged
18w19a 加入了方块标签 leaves、液体标签waterlava、物品标签fishesleaves
pre8 加入了方块标签 wall_coralsimpermeable
1.13.1 18w31a 加入了方块标签 underwater_bonemeals

你知道吗[编辑 | 编辑源代码]

当液体同时附上water与lava标签时会有些有趣的效果,如熔岩将熔岩变成黑曜石或单格水自动生成圆石等。

漏洞[编辑 | 编辑源代码]

关于“标签”的漏洞由漏洞追踪器维护,请在此汇报漏洞。