数据包中的标签(Tag)允许玩家使用JSON文件将物品、方块、流体、实体类型和函数组合在一起。
用途
为了使用方块、物品、流体、实体类型或函数标签,JSON文件必须分别放置于数据包的data/(命名空间)/tags/blocks、data/(命名空间)/tags/items、data/(命名空间)/tags/fluids、data/(命名空间)/tags/entity_types或data/(命名空间)/tags/functions目录下。
游戏本身也使用了这些标签。原版方块标签被用于各种方块属性。原版物品标签被用于各种物品属性、原版进度文件与原版配方文件。原版实体类型标签被用于各种生物的属性。在#标签列表部分可以查看它们的用途。
但是并不存在原版函数标签,因为原版中不存在函数,不过游戏会读取minecraft命名空间下的特定函数标签。
文件结构
|
方块标签
方块标签可以在用命令测试方块时以#(命名空间ID)的形式调用。只要方块满足了该标签中定义的任何一个方块,命令就会测试通过。
物品标签
物品标签可以在用命令测试物品时以#(命名空间ID)的形式调用。也可以在配方或进度中用"tag": "(命名空间ID)"的格式使用。只要物品满足了该标签中定义的任何一个物品,测试就会通过。
实体类型标签
实体类型标签可以在type实体选择器参数以及战利品表条件中以#(命名空间ID)的形式使用。只要物品满足了该标签中定义的任何一个物品,测试就会通过。
函数标签
函数标签可以在/function命令中以#(命名空间):(路径)的形式调用。所有在该标签中指定的函数都会按照它们第一次出现的顺序执行。就算一个函数在标签以及子标签中被多次引用,它也只会被执行一次。
另外,所有在tick标签中标记的函数将会在每刻的开始执行,在load标签中标记的函数将会在服务器加载及重载后的第1刻开始执行1次。
JSON格式
- 根标签。
- replace:这个标签是否应该完全覆盖来自较低优先级数据包同命名空间下的同名标签。当设定为
false时则为为此标签进行补充。默认为false。 - values:一个物品、方块或函数列表。可以引用同类型的其他标签,但是不能循环引用。
- :一个物品、方块、流体、实体类型或函数的命名空间ID。格式应为
(命名空间):(名称)。 - :另一个同类型的标签的ID。格式应为
#(命名空间):(路径)。
- :一个物品、方块、流体、实体类型或函数的命名空间ID。格式应为
- replace:这个标签是否应该完全覆盖来自较低优先级数据包同命名空间下的同名标签。当设定为
标签列表
方块
| 标签名称 | 值 | 用途 |
|---|---|---|
| acacia_logs | acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood | - |
| 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、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 |
|
| 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 |
|
| 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 |
|
| wooden_doors | oak_door、spruce_door、birch_door、jungle_door、acacia_door、dark_oak_door |
|
| 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 | |
| water | water, flowing_water |
|
物品
| 标签名称 | Values | Usage |
|---|---|---|
| acacia_logs | acacia_log, acacia_wood, stripped_acacia_log, stripped_acacia_wood |
|
| 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 |
|
| birch_logs | birch_log, birch_wood, stripped_birch_log, stripped_birch_wood |
|
| boats | oak_boat, spruce_boat, birch_boat, jungle_boat, acacia_boat, dark_oak_boat |
|
| 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 |
|
| dark_oak_logs | dark_oak_log, dark_oak_wood, stripped_dark_oak_log, stripped_dark_oak_wood |
|
| doors | #wooden_doors, iron_door | - |
| fishes | cod, cooked_cod, salmon, cooked_salmon, pufferfish, tropical_fish |
|
| jungle_logs | jungle_log, jungle_wood, stripped_jungle_log, stripped_jungle_wood |
|
| 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 |
|
| oak_logs | oak_log, oak_wood, stripped_oak_log, stripped_oak_wood |
|
| 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_wood, stripped_spruce_log, stripped_spruce_wood |
|
| 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 |
|
| wooden_doors | oak_door, spruce_door, birch_door, jungle_door, acacia_door, dark_oak_door |
|
| 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 |
|
历史
| Java版 | |||||
|---|---|---|---|---|---|
| 1.13 | 17w49a | 为方块和物品添加了标签。 | |||
加入了原版方块标签planks和wool。 | |||||
加入了原版物品标签 planks和wool。 | |||||
| 17w49b | 函数现在可以被标记。 | ||||
有tick标签的函数现在从开始运行后的每一刻都运行。 | |||||
加入了原版方块标签buttons、carpets、doors、flower_pots、logs、saplings和stone_bricks。 | |||||
加入了原版物品标签 buttons、carpets、doors、logs、saplings和stone_bricks。 | |||||
| 17w50a | 加入了原版方块标签wooden_buttons和wooden_doors。
| ||||
加入了原版物品标签 wooden_buttons和wooden_doors。 | |||||
更新了原版方块和物品标签buttons和doors,分别包括stone_button和iron_door | |||||
| 18w01a | 有load标签的函数将在(re)加载后运行一次。
| ||||
加入了原版方块标签 anvil。 | |||||
| 18w02a | 加入了原版方块标签 enderman_holdable。 | ||||
| 18w06a | 加入了原版方块标签banners、wooden_pressure_plates、wooden_slabs和wooden_stairs。
| ||||
加入了原版物品标签 banners、boats、wooden_pressure_plates、wooden_slabs,和wooden_stairs。 | |||||
| 18w07a | 加入了原版方块标签slabs、stairs和water_hacked。
| ||||
加入了方块和物品标签acacia_logs、birch_logs、dark_oak_logs、jungle_logs、oak_logs,和spruce_logs | |||||
| 18w07b | 加入了方块标签 waterlogged。
| ||||
加入了方块和物品标签rails和sand。 | |||||
| 18w09a | 加入了原版方块和物品标签 coral。
| ||||
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
| 组件 |
| ||
|---|---|---|---|
| 数据包 | |||
| 教程 | |||
| 版本 | |||||||
|---|---|---|---|---|---|---|---|
| 开发周期 |
| ||||||
| 技术 |
| ||||||
| 多人游戏 | |||||||
| 游戏订制 | |||||||