本文章介绍的是数据包标签。关于其他用途,请见“标签(消歧义)”。
数据包中的标签(Tag)允许玩家使用JSON文件将物品、方块和函数组合在一起。
用途
为了使用方块、物品或函数标签,JSON文件必须分别放置于数据包的data/(命名空间)/tags/blocks
、data/(命名空间)/tags/items
或data/(命名空间)/tags/functions
里面。
方块标签可以在检查方块参数时以#(命名空间):(tag)
的形式被调用。如果指定方块符合任何记录于标签内的方块那么将会输出成功。物品标签可以在检查物品参数时以#(命名空间):(tag)
的形式或者在配方、进度中以"tag": "(命名空间):(tag)"
的形式被调用,如果指定物品符合任何记录于标签内的物品那么将会输出成功。函数标签可以在/function
命令中以#(命名空间):(tag)
的形式被调用,这将会让多个函数依据顺序分别执行。
游戏本身也使用了这些标签。原版方块标签被用于各种方块属性。原版物品标签被用于各种物品属性、原版进度文件与原版配方文件。但是并不存在原版函数标签,因为并不存在原版函数,但任何标记了minecraft:tick
标签的函数都会在每一刻的刻开始时执行,而被标记了minecraft:load
标签的函数则会在载入及重载时执行。
JSON格式
- 根标签。
- replace:这个标签是否应该完全覆盖来自较低优先级数据包同命名空间下的同名标签。当设定为
false
时则为为此标签进行补充。预设为false
。 - values:一个物品、方块或函数列表。将会接受同类型的其他标签,但递归不可用。
- (命名空间):(名称):一个列表中的物品、方块或函数元素。
- #(命名空间):(名称):一个列表中的物品、方块或函数标签,标签必须是同种类型。
- replace:这个标签是否应该完全覆盖来自较低优先级数据包同命名空间下的同名标签。当设定为
标签列表
方块
标签名称 | 值 | 用途 |
---|---|---|
minecraft:acacia_logs | minecraft:acacia_log, minecraft:acacia_wood, minecraft:stripped_acacia_log, minecraft:stripped_acacia_wood | - |
minecraft:anvil | minecraft:anvil、minecraft:chipped_anvil、minecraft:damaged_anvil |
|
minecraft:banners | minecraft:white_banner、minecraft:orange_banner、minecraft:magenta_banner、minecraft:light_blue_banner、minecraft:yellow_banner、minecraft:lime_banner、minecraft:pink_banner、minecraft:gray_banner、minecraft:light_gray_banner、minecraft:cyan_banner、minecraft:purple_banner、minecraft:blue_banner、minecraft:brown_banner、minecraft:green_banner、minecraft:red_banner、minecraft:black_banner、minecraft:white_wall_banner、minecraft:orange_wall_banner、minecraft:magenta_wall_banner、minecraft:light_blue_wall_banner、minecraft:yellow_wall_banner、minecraft:lime_wall_banner、minecraft:pink_wall_banner、minecraft:gray_wall_banner、minecraft:light_gray_wall_banner、minecraft:cyan_wall_banner、minecraft:purple_wall_banner、minecraft:blue_wall_banner、minecraft:brown_wall_banner、minecraft:green_wall_banner、minecraft:red_wall_banner、minecraft:black_wall_banner | - |
minecraft:birch_logs | minecraft:birch_log、minecraft:birch_bark、minecraft:stripped_birch_log、minecraft:stripped_birch_bark | - |
minecraft:buttons | #minecraft:wooden_buttons、minecraft:stone_button | - |
minecraft:carpets | minecraft:white_carpet、minecraft:orange_carpet、minecraft:magenta_carpet、minecraft:light_blue_carpet、minecraft:yellow_carpet、minecraft:lime_carpet、minecraft:pink_carpet、minecraft:gray_carpet、minecraft:light_gray_carpet、minecraft:cyan_carpet、minecraft:purple_carpet、minecraft:blue_carpet、minecraft:brown_carpet、minecraft:green_carpet、minecraft:red_carpet、minecraft:black_carpet | - |
minecraft:coral_blocks | minecraft:tube_coral_block, minecraft:brain_coral_block, minecraft:bubble_coral_block, minecraft:fire_coral_block, minecraft:horn_coral_block | - |
minecraft:corals | minecraft:tube_coral, minecraft:brain_coral, minecraft:bubble_coral, minecraft:fire_coral, minecraft:horn_coral, minecraft:tube_coral_fan, minecraft:brain_coral_fan, minecraft:bubble_coral_fan, minecraft:fire_coral_fan, minecraft:horn_coral_fan | - |
minecraft:dark_oak_logs | minecraft:dark_oak_log, minecraft:dark_oak_bark, minecraft:stripped_dark_oak_log, minecraft:stripped_dark_oak_bark | - |
minecraft:doors | #minecraft:wooden_doors、minecraft:iron_door | - |
minecraft:enderman_holdable | minecraft:grass_block、minecraft:dirt、minecraft:coarse_dirt、minecraft:podzol、minecraft:sand、minecraft:red_sand、minecraft:gravel、minecraft:dandelion、minecraft:poppy、minecraft:blue_orchid、minecraft:allium、minecraft:azure_bluet、minecraft:red_tulip、minecraft:orange_tulip、minecraft:white_tulip、minecraft:pink_tulip、minecraft:oxeye_daisy、minecraft:brown_mushroom、minecraft:red_mushroom、minecraft:tnt、minecraft:cactus、minecraft:clay、minecraft:pumpkin、minecraft:carved_pumpkin、minecraft:melon_block、minecraft:mycelium、minecraft:netherrack |
|
minecraft:flower_pots | minecraft:flower_pot、minecraft:potted_poppy、minecraft:potted_blue_orchid、minecraft:potted_allium、minecraft:potted_azure_bluet、minecraft:potted_red_tulip、minecraft:potted_orange_tulip、minecraft:potted_white_tulip、minecraft:potted_pink_tulip、minecraft:potted_oxeye_daisy、minecraft:potted_dandelion、minecraft:potted_oak_sapling、minecraft:potted_spruce_sapling、minecraft:potted_birch_sapling、minecraft:potted_jungle_sapling、minecraft:potted_acacia_sapling、minecraft:potted_dark_oak_sapling、minecraft:potted_red_mushroom、minecraft:potted_brown_mushroom、minecraft:potted_dead_bush、minecraft:potted_fern、minecraft:potted_cactus | - |
minecraft:ice | minecraft:ice, minecraft:packed_ice, minecraft:blue_ice, minecraft:frosted_ice | - |
minecraft:impermeable | minecraft:glass, minecraft:white_stained_glass, minecraft:orange_stained_glass, minecraft:magenta_stained_glass, minecraft:light_blue_stained_glass, minecraft:yellow_stained_glass, minecraft:lime_stained_glass, minecraft:pink_stained_glass, minecraft:gray_stained_glass, minecraft:light_gray_stained_glass, minecraft:cyan_stained_glass, minecraft:purple_stained_glass, minecraft:blue_stained_glass, minecraft:brown_stained_glass, minecraft:green_stained_glass, minecraft:red_stained_glass, minecraft:black_stained_glass |
|
minecraft:jungle_logs | minecraft:jungle_log, minecraft:jungle_bark, minecraft:stripped_jungle_log, minecraft:stripped_jungle_bark | - |
minecraft:leaves | minecraft:jungle_leaves, minecraft:oak_leaves, minecraft:spruce_leaves, minecraft:dark_oak_leaves, minecraft:acacia_leaves, minecraft:birch_leaves | - |
minecraft:logs | #minecraft:dark_oak_logs, #minecraft:oak_logs, #minecraft:acacia_logs, #minecraft:birch_logs, #minecraft:jungle_logs, #minecraft:spruce_logs |
|
minecraft:oak_logs | minecraft:oak_log, minecraft:oak_bark, minecraft:stripped_oak_log, minecraft:stripped_oak_bark | - |
minecraft:planks | minecraft:oak_planks、minecraft:spruce_planks、minecraft:birch_planks、minecraft:jungle_planks、minecraft:acacia_planks、minecraft:dark_oak_planks |
|
minecraft:rails | minecraft:rail, minecraft:powered_rail, minecraft:detector_rail, minecraft:activator_rail |
|
minecraft:sand | minecraft:sand, minecraft:red_sand | - |
minecraft:saplings | minecraft:oak_sapling、minecraft:spruce_sapling、minecraft:birch_sapling、minecraft:jungle_sapling、minecraft:acacia_sapling、minecraft:dark_oak_sapling |
|
minecraft:slabs | minecraft:stone_slab, minecraft:stone_brick_slab, minecraft:sandstone_slab, minecraft:acacia_slab, minecraft:birch_slab, minecraft:dark_oak_slab, minecraft:jungle_slab, minecraft:oak_slab, minecraft:spruce_slab, minecraft:purpur_slab, minecraft:quartz_slab, minecraft:red_sandstone_slab, minecraft:brick_slab, minecraft:cobblestone_slab, minecraft:nether_brick_slab, minecraft:petrified_oak_slab, minecraft:prismarine_slab, minecraft:prismarine_bricks_slab, minecraft:dark_prismarine_slab | - |
minecraft:spruce_logs | minecraft:spruce_log, minecraft:spruce_bark, minecraft:stripped_spruce_log, minecraft:stripped_spruce_bark | - |
minecraft:stairs | minecraft:oak_stairs, minecraft:cobblestone_stairs, minecraft:spruce_stairs, minecraft:sandstone_stairs, minecraft:acacia_stairs, minecraft:jungle_stairs, minecraft:birch_stairs, minecraft:dark_oak_stairs, minecraft:nether_brick_stairs, minecraft:stone_brick_stairs, minecraft:brick_stairs, minecraft:purpur_stairs, minecraft:quartz_stairs, minecraft:red_sandstone_stairs, minecraft:prismarine_bricks_stairs, minecraft:prismarine_stairs, minecraft:dark_prismarine_stairs | - |
minecraft:stone_bricks | minecraft:stone_bricks、minecraft:mossy_stone_bricks、minecraft:cracked_stone_bricks、minecraft:chiseled_stone_bricks | - |
minecraft:underwater_bonemeals | minecraft:seagrass, #minecraft:corals, #minecraft:wall_corals |
|
minecraft:valid_spawn | minecraft:grass_block, minecraft:podzol |
|
minecraft:wall_corals | minecraft:tube_coral_wall_fan, minecraft:brain_coral_wall_fan, minecraft:bubble_coral_wall_fan, minecraft:fire_coral_wall_fan, minecraft:horn_coral_wall_fan | - |
minecraft:wooden_buttons | minecraft:oak_button、minecraft:spruce_button、minecraft:birch_button、minecraft:jungle_button、minecraft:acacia_button、minecraft:dark_oak_button |
|
minecraft:wooden_doors | minecraft:oak_door、minecraft:spruce_door、minecraft:birch_door、minecraft:jungle_door、minecraft:acacia_door、minecraft:dark_oak_door |
|
minecraft:wooden_pressure_plates | minecraft:oak_pressure_plate、minecraft:spruce_pressure_plate、minecraft:birch_pressure_plate、minecraft:jungle_pressure_plate、minecraft:acacia_pressure_plate、minecraft:dark_oak_pressure_plate | - |
minecraft:wooden_slabs | minecraft:oak_slab、minecraft:spruce_slab、minecraft:birch_slab、minecraft:jungle_slab、minecraft:acacia_slab、minecraft:dark_oak_slab | - |
minecraft:wooden_stairs | minecraft:oak_stair、minecraft:spruce_stair、minecraft:birch_stair、minecraft:jungle_stairs、minecraft:acacia_stairs、minecraft:dark_oak_stairs | - |
minecraft:wool | minecraft:white_wool、minecraft:orange_wool、minecraft:magenta_wool、minecraft:light_blue_wool、minecraft:yellow_wool、minecraft:lime_wool、minecraft:pink_wool、minecraft:gray_wool、minecraft:light_gray_wool、minecraft:cyan_wool、minecraft:purple_wool、minecraft:blue_wool、minecraft:brown_wool、minecraft:green_wool、minecraft:red_wool、minecraft:black_wool |
流体
Tag name | Values | Usage |
---|---|---|
minecraft:lava | minecraft:lava, minecraft:flowing_lava | |
minecraft:water | minecraft:water, minecraft:flowing_water |
|
物品
标签名称 | Values | Usage |
---|---|---|
minecraft:acacia_logs | minecraft:acacia_log, minecraft:acacia_wood, minecraft:stripped_acacia_log, minecraft:stripped_acacia_wood |
|
minecraft:anvil | minecraft:anvil, minecraft:chipped_anvil, minecraft:damaged_anvil | - |
minecraft:banners | minecraft:white_banner, minecraft:orange_banner, minecraft:magenta_banner, minecraft:light_blue_banner, minecraft:yellow_banner, minecraft:lime_banner, minecraft:pink_banner, minecraft:gray_banner, minecraft:light_gray_banner, minecraft:cyan_banner, minecraft:purple_banner, minecraft:blue_banner, minecraft:brown_banner, minecraft:green_banner, minecraft:red_banner, minecraft:black_banner |
|
minecraft:birch_logs | minecraft:birch_log, minecraft:birch_wood, minecraft:stripped_birch_log, minecraft:stripped_birch_wood |
|
minecraft:boats | minecraft:oak_boat, minecraft:spruce_boat, minecraft:birch_boat, minecraft:jungle_boat, minecraft:acacia_boat, minecraft:dark_oak_boat |
|
minecraft:buttons | #minecraft:wooden_buttons, minecraft:stone_button | - |
minecraft:carpets | minecraft:white_carpet, minecraft:orange_carpet, minecraft:magenta_carpet, minecraft:light_blue_carpet, minecraft:yellow_carpet, minecraft:lime_carpet, minecraft:pink_carpet, minecraft:gray_carpet, minecraft:light_gray_carpet, minecraft:cyan_carpet, minecraft:purple_carpet, minecraft:blue_carpet, minecraft:brown_carpet, minecraft:green_carpet, minecraft:red_carpet, minecraft:black_carpet |
|
minecraft:dark_oak_logs | minecraft:dark_oak_log, minecraft:dark_oak_wood, minecraft:stripped_dark_oak_log, minecraft:stripped_dark_oak_wood |
|
minecraft:doors | #minecraft:wooden_doors, minecraft:iron_door | - |
minecraft:fishes | minecraft:cod, minecraft:cooked_cod, minecraft:salmon, minecraft:cooked_salmon, minecraft:pufferfish, minecraft:tropical_fish |
|
minecraft:jungle_logs | minecraft:jungle_log, minecraft:jungle_wood, minecraft:stripped_jungle_log, minecraft:stripped_jungle_wood |
|
minecraft:leaves | minecraft:jungle_leaves, minecraft:oak_leaves, minecraft:spruce_leaves, minecraft:dark_oak_leaves, minecraft:acacia_leaves, minecraft:birch_leaves | - |
minecraft:logs | minecraft:oak_log, minecraft:spruce_log, minecraft:birch_log, minecraft:jungle_log, minecraft:acacia_log, minecraft:dark_oak_log, minecraft:oak_bark, minecraft:spruce_bark, minecraft:birch_bark, minecraft:jungle_bark, minecraft:acacia_bark, minecraft:dark_oak_bark |
|
minecraft:oak_logs | minecraft:oak_log, minecraft:oak_wood, minecraft:stripped_oak_log, minecraft:stripped_oak_wood |
|
minecraft:planks | minecraft:oak_planks, minecraft:spruce_planks, minecraft:birch_planks, minecraft:jungle_planks, minecraft:acacia_planks, minecraft:dark_oak_planks |
|
minecraft:rails | minecraft:rail, minecraft:powered_rail, minecraft:detector_rail, minecraft:activator_rail | - |
minecraft:sand | minecraft:sand, minecraft:red_sand |
|
minecraft:saplings | minecraft:oak_sapling, minecraft:spruce_sapling, minecraft:birch_sapling, minecraft:jungle_sapling, minecraft:acacia_sapling, minecraft:dark_oak_sapling |
|
minecraft:slabs | minecraft:stone_slab, minecraft:stone_brick_slab, minecraft:sandstone_slab, minecraft:acacia_slab, minecraft:birch_slab, minecraft:dark_oak_slab, minecraft:jungle_slab, minecraft:oak_slab, minecraft:spruce_slab, minecraft:purpur_slab, minecraft:quartz_slab, minecraft:red_sandstone_slab, minecraft:brick_slab, minecraft:cobblestone_slab, minecraft:nether_brick_slab, minecraft:petrified_oak_slab, minecraft:prismarine_slab, minecraft:prismarine_bricks_slab, minecraft:dark_prismarine_slab | - |
minecraft:spruce_logs | minecraft:spruce_log, minecraft:spruce_wood, minecraft:stripped_spruce_log, minecraft:stripped_spruce_wood |
|
minecraft:stairs | minecraft:oak_stairs, minecraft:cobblestone_stairs, minecraft:spruce_stairs, minecraft:sandstone_stairs, minecraft:acacia_stairs, minecraft:jungle_stairs, minecraft:birch_stairs, minecraft:dark_oak_stairs, minecraft:nether_brick_stairs, minecraft:stone_brick_stairs, minecraft:brick_stairs, minecraft:purpur_stairs, minecraft:quartz_stairs, minecraft:red_sandstone_stairs, minecraft:prismarine_bricks_stairs, minecraft:prismarine_stairs, minecraft:dark_prismarine_stairs | - |
minecraft:stone_bricks | minecraft:stone_bricks, minecraft:mossy_stone_bricks, minecraft:cracked_stone_bricks, minecraft:chiseled_stone_bricks |
|
minecraft:wooden_buttons | minecraft:oak_button, minecraft:spruce_button, minecraft:birch_button, minecraft:jungle_button, minecraft:acacia_button, minecraft:dark_oak_button |
|
minecraft:wooden_doors | minecraft:oak_door, minecraft:spruce_door, minecraft:birch_door, minecraft:jungle_door, minecraft:acacia_door, minecraft:dark_oak_door |
|
minecraft:wooden_pressure_plates | minecraft:oak_pressure_plate, minecraft:spruce_pressure_plate, minecraft:birch_pressure_plate, minecraft:jungle_pressure_plate, minecraft:acacia_pressure_plate, minecraft:dark_oak_pressure_plate |
|
minecraft:wooden_slabs | minecraft:oak_slab, minecraft:spruce_slab, minecraft:birch_slab, minecraft:jungle_slab, minecraft:acacia_slab, minecraft:dark_oak_slab |
|
minecraft:wooden_stairs | minecraft:oak_stair, minecraft:spruce_stair, minecraft:birch_stair, minecraft:jungle_stairs, minecraft:acacia_stairs, minecraft:dark_oak_stairs |
|
minecraft:wool | minecraft:white_wool, minecraft:orange_wool, minecraft:magenta_wool, minecraft:light_blue_wool, minecraft:yellow_wool, minecraft:lime_wool, minecraft:pink_wool, minecraft:gray_wool, minecraft:light_gray_wool, minecraft:cyan_wool, minecraft:purple_wool, minecraft:blue_wool, minecraft:brown_wool, minecraft:green_wool, minecraft:red_wool, minecraft:black_wool |
|
历史
Java版 | |||||
---|---|---|---|---|---|
1.13 | 17w49a | 为方块和物品添加了标签。 | |||
加入了原版方块标签minecraft:planks 和minecraft:wool 。 | |||||
加入了原版物品标签 minecraft:planks 和minecraft:wool 。 | |||||
17w49b | 函数现在可以被标记。 | ||||
有minecraft:tick 标签的函数现在从开始运行后的每一刻都运行。 | |||||
加入了原版方块标签minecraft:buttons 、minecraft:carpets 、minecraft:doors 、minecraft:flower_pots 、minecraft:logs 、minecraft:saplings 和minecraft:stone_bricks 。 | |||||
加入了原版物品标签 minecraft:buttons 、minecraft:carpets 、minecraft:doors 、minecraft:logs 、minecraft:saplings 和minecraft:stone_bricks 。 | |||||
17w50a | 加入了原版方块标签minecraft:wooden_buttons 和minecraft:wooden_doors 。
| ||||
加入了原版物品标签 minecraft:wooden_buttons 和minecraft:wooden_doors 。 | |||||
更新了原版方块和物品标签minecraft:buttons 和minecraft:doors ,分别包括minecraft:stone_button 和minecraft:iron_door | |||||
18w01a | 有minecraft:load 标签的函数将在(re)加载后运行一次。
| ||||
加入了原版方块标签 minecraft:anvil 。 | |||||
18w02a | 加入了原版方块标签 minecraft:enderman_holdable 。 | ||||
18w06a | 加入了原版方块标签minecraft:banners 、minecraft:wooden_pressure_plates 、minecraft:wooden_slabs 和minecraft:wooden_stairs 。
| ||||
加入了原版物品标签 minecraft:banners 、minecraft:boats 、minecraft:wooden_pressure_plates 、minecraft:wooden_slabs ,和minecraft:wooden_stairs 。 | |||||
18w07a | 加入了原版方块标签minecraft:slabs 、minecraft:stairs 和minecraft:water_hacked 。
| ||||
加入了方块和物品标签minecraft:acacia_logs 、minecraft:birch_logs 、minecraft:dark_oak_logs 、minecraft:jungle_logs 、minecraft:oak_logs ,和minecraft:spruce_logs | |||||
18w07b | 加入了方块标签 minecraft:waterlogged 。
| ||||
加入了方块和物品标签minecraft:rails 和minecraft:sand 。 | |||||
18w09a | 加入了原版方块和物品标签 minecraft:coral 。
| ||||
minecraft:water_hacked 标签现在包括箱子。 | |||||
18w10a | 加入了方块和物品标签 coral_plants 。
| ||||
waterlogged 方块标签现在包括珊瑚。 | |||||
18w10c | 移除了方块标签water_hacked 和waterlogged 。 | ||||
18w19a | 加入了方块标签 leaves 、液体标签water 和lava 、物品标签fishes 和leaves 。 | ||||
pre8 | 加入了方块标签 wall_corals 和impermeable 。 | ||||
1.13.1 | 18w31a | 加入了方块标签 underwater_bonemeals 。 |
你知道嗎
當液體同時附上water與lava標籤時會有些有趣的效果,如岩漿將岩漿變成黑曜石或單格水自動生成鵝卵石等。
漏洞
Template:Issue list
版本 | |||||||
---|---|---|---|---|---|---|---|
开发周期 |
| ||||||
技术 |
| ||||||
多人游戏 | |||||||
游戏订制 |