* This class is mainly designed to support ItemStacks.
@@ -58,14 +57,14 @@ import java.util.regex.Pattern;
* XMaterial v1: https://www.spigotmc.org/threads/329630/
*
* @author Crypto Morin
- * @version 4.0.0
+ * @version 5.0.1
* @see Material
* @see ItemStack
*/
public enum XMaterial {
ACACIA_BOAT("BOAT_ACACIA"),
ACACIA_BUTTON("WOOD_BUTTON"),
- ACACIA_DOOR("ACACIA_DOOR_ITEM"),
+ ACACIA_DOOR("ACACIA_DOOR_ITEM", "ACACIA_DOOR"),
ACACIA_FENCE,
ACACIA_FENCE_GATE,
ACACIA_LEAVES("LEAVES_2"),
@@ -89,6 +88,7 @@ public enum XMaterial {
*/
AIR,
ALLIUM(2, "RED_ROSE"),
+ ANCIENT_DEBRIS("1.16"),
ANDESITE(5, "STONE"),
ANDESITE_SLAB,
ANDESITE_STAIRS,
@@ -105,6 +105,7 @@ public enum XMaterial {
BAMBOO_SAPLING("1.14"),
BARREL("1.14", "CHEST", ""),
BARRIER,
+ BASALT("1.16"),
BAT_SPAWN_EGG(65, "MONSTER_EGG"),
BEACON,
BEDROCK,
@@ -123,7 +124,7 @@ public enum XMaterial {
BELL("1.14"),
BIRCH_BOAT("BOAT_BIRCH"),
BIRCH_BUTTON("WOOD_BUTTON"),
- BIRCH_DOOR("BIRCH_DOOR_ITEM"),
+ BIRCH_DOOR("BIRCH_DOOR_ITEM", "BIRCH_DOOR"),
BIRCH_FENCE,
BIRCH_FENCE_GATE,
BIRCH_LEAVES(2, "LEAVES"),
@@ -137,8 +138,12 @@ public enum XMaterial {
BIRCH_TRAPDOOR("TRAP_DOOR"),
BIRCH_WALL_SIGN("SIGN_POST", "WALL_SIGN"),
BIRCH_WOOD(2, "LOG"),
+ BLACKSTONE("1.16"),
+ BLACKSTONE_SLAB("1.16"),
+ BLACKSTONE_STAIRS("1.16"),
+ BLACKSTONE_WALL("1.16"),
BLACK_BANNER("BANNER", "STANDING_BANNER"),
- BLACK_BED(15, "BED", "BED_BLOCK"),
+ BLACK_BED(15, "BED_BLOCK", "BED"),
BLACK_CARPET(15, "CARPET"),
BLACK_CONCRETE(15, "CONCRETE"),
BLACK_CONCRETE_POWDER(15, "CONCRETE_POWDER"),
@@ -154,8 +159,8 @@ public enum XMaterial {
BLAZE_POWDER,
BLAZE_ROD,
BLAZE_SPAWN_EGG(61, "MONSTER_EGG"),
- BLUE_BANNER(11, "BANNER", "STANDING_BANNER"),
- BLUE_BED(4, "BED", "BED_BLOCK"),
+ BLUE_BANNER(4, "BANNER", "STANDING_BANNER"),
+ BLUE_BED(11, "BED_BLOCK", "BED"),
BLUE_CARPET(11, "CARPET"),
BLUE_CONCRETE(11, "CONCRETE"),
BLUE_CONCRETE_POWDER(11, "CONCRETE_POWDER"),
@@ -166,8 +171,8 @@ public enum XMaterial {
BLUE_SHULKER_BOX,
BLUE_STAINED_GLASS(11, "STAINED_GLASS"),
BLUE_STAINED_GLASS_PANE(11, "THIN_GLASS", "STAINED_GLASS_PANE"),
- BLUE_TERRACOTTA(11, "STAINED_CLAY"),
- BLUE_WALL_BANNER(11, "WALL_BANNER"),
+ BLUE_TERRACOTTA(11, "HARD_CLAY", "STAINED_CLAY"),
+ BLUE_WALL_BANNER(4, "WALL_BANNER"),
BLUE_WOOL(11, "WOOL"),
BONE,
BONE_BLOCK,
@@ -188,7 +193,7 @@ public enum XMaterial {
BRICK_STAIRS,
BRICK_WALL,
BROWN_BANNER(3, "BANNER", "STANDING_BANNER"),
- BROWN_BED(12, "BED", "BED_BLOCK"),
+ BROWN_BED(12, "BED_BLOCK", "BED"),
BROWN_CARPET(12, "CARPET"),
BROWN_CONCRETE(12, "CONCRETE"),
BROWN_CONCRETE_POWDER(12, "CONCRETE_POWDER"),
@@ -225,6 +230,7 @@ public enum XMaterial {
*/
CAVE_AIR("AIR"),
CAVE_SPIDER_SPAWN_EGG(59, "MONSTER_EGG"),
+ CHAIN("1.16"),
CHAINMAIL_BOOTS,
CHAINMAIL_CHESTPLATE,
CHAINMAIL_HELMET,
@@ -236,6 +242,8 @@ public enum XMaterial {
CHICKEN("RAW_CHICKEN"),
CHICKEN_SPAWN_EGG(93, "MONSTER_EGG"),
CHIPPED_ANVIL(1, "ANVIL"),
+ CHISELED_NETHER_BRICKS(1, "NETHER_BRICKS"),
+ CHISELED_POLISHED_BLACKSTONE("1.16", "POLISHED_BLACKSTONE"),
CHISELED_QUARTZ_BLOCK(1, "QUARTZ_BLOCK"),
CHISELED_RED_SANDSTONE(1, "RED_SANDSTONE"),
CHISELED_SANDSTONE(1, "SANDSTONE"),
@@ -262,7 +270,14 @@ public enum XMaterial {
COD_SPAWN_EGG("1.13", "MONSTER_EGG", ""),
COMMAND_BLOCK("COMMAND"),
COMMAND_BLOCK_MINECART("COMMAND_MINECART"),
- COMPARATOR("REDSTONE_COMPARATOR", "REDSTONE_COMPARATOR_ON", "REDSTONE_COMPARATOR_OFF"),
+ /**
+ * Unlike redstone torch and redstone lamp... neither REDTONE_COMPARATOR_OFF nor REDSTONE_COMPARATOR_ON
+ * are items. REDSTONE_COMPARATOR is.
+ *
+ * @see #REDSTONE_TORCH
+ * @see #REDSTONE_LAMP
+ */
+ COMPARATOR("REDSTONE_COMPARATOR_OFF", "REDSTONE_COMPARATOR_ON", "REDSTONE_COMPARATOR"),
COMPASS,
COMPOSTER("1.14", "CAULDRON", ""),
CONDUIT("1.13", "BEACON"),
@@ -276,19 +291,38 @@ public enum XMaterial {
COOKIE,
CORNFLOWER(4, "1.14", "BLUE_DYE", ""),
COW_SPAWN_EGG(92, "MONSTER_EGG"),
+ CRACKED_NETHER_BRICKS(2, "NETHER_BRICKS"),
+ CRACKED_POLISHED_BLACKSTONE_BRICKS("1.16", "POLISHED_BLACKSTONE_BRICKS"),
CRACKED_STONE_BRICKS(2, "SMOOTH_BRICK"),
CRAFTING_TABLE("WORKBENCH"),
CREEPER_BANNER_PATTERN,
CREEPER_HEAD(4, "SKULL", "SKULL_ITEM"),
CREEPER_SPAWN_EGG(50, "MONSTER_EGG"),
CREEPER_WALL_HEAD(4, "SKULL", "SKULL_ITEM"),
+ CRIMSON_BUTTON("1.16"),
+ CRIMSON_DOOR("1.16"),
+ CRIMSON_FENCE("1.16"),
+ CRIMSON_FENCE_GATE("1.16"),
+ CRIMSON_FUNGUS("1.16"),
+ CRIMSON_HYPHAE("1.16"),
+ CRIMSON_NYLIUM("1.16"),
+ CRIMSON_PLANKS("1.16"),
+ CRIMSON_PRESSURE_PLATE("1.16"),
+ CRIMSON_ROOTS("1.16"),
+ CRIMSON_SIGN("1.16"),
+ CRIMSON_SLAB("1.16"),
+ CRIMSON_STAIRS("1.16"),
+ CRIMSON_STEM("1.16"),
+ CRIMSON_TRAPDOOR("1.16"),
+ CRIMSON_WALL_SIGN("1.16"),
CROSSBOW,
+ CRYING_OBSIDIAN("1.16"),
CUT_RED_SANDSTONE("1.13"),
CUT_RED_SANDSTONE_SLAB("STONE_SLAB2"),
CUT_SANDSTONE("1.13"),
CUT_SANDSTONE_SLAB("STEP"),
CYAN_BANNER(6, "BANNER", "STANDING_BANNER"),
- CYAN_BED(9, "BED", "BED_BLOCK"),
+ CYAN_BED(9, "BED_BLOCK", "BED"),
CYAN_CARPET(9, "CARPET"),
CYAN_CONCRETE(9, "CONCRETE"),
CYAN_CONCRETE_POWDER(9, "CONCRETE_POWDER"),
@@ -304,16 +338,16 @@ public enum XMaterial {
DANDELION("YELLOW_FLOWER"),
DARK_OAK_BOAT("BOAT_DARK_OAK"),
DARK_OAK_BUTTON("WOOD_BUTTON"),
- DARK_OAK_DOOR("DARK_OAK_DOOR_ITEM"),
+ DARK_OAK_DOOR("DARK_OAK_DOOR_ITEM", "DARK_OAK_DOOR"),
DARK_OAK_FENCE,
DARK_OAK_FENCE_GATE,
- DARK_OAK_LEAVES(1, "LEAVES", "LEAVES_2"),
+ DARK_OAK_LEAVES(4, "LEAVES", "LEAVES_2"),
DARK_OAK_LOG(1, "LOG", "LOG_2"),
DARK_OAK_PLANKS(5, "WOOD"),
DARK_OAK_PRESSURE_PLATE("WOOD_PLATE"),
DARK_OAK_SAPLING(5, "SAPLING"),
DARK_OAK_SIGN("SIGN"),
- DARK_OAK_SLAB("WOOD_STEP", "WOODEN_SLAB", "WOOD_DOUBLE_STEP"),
+ DARK_OAK_SLAB(5, "WOOD_STEP", "WOODEN_SLAB", "WOOD_DOUBLE_STEP"),
DARK_OAK_STAIRS,
DARK_OAK_TRAPDOOR("TRAP_DOOR"),
DARK_OAK_WALL_SIGN("SIGN_POST", "WALL_SIGN"),
@@ -395,7 +429,7 @@ public enum XMaterial {
END_ROD("1.9", "BLAZE_ROD", ""),
END_STONE("ENDER_STONE"),
END_STONE_BRICKS("END_BRICKS"),
- END_STONE_BRICK_SLAB(4, "STEP"),
+ END_STONE_BRICK_SLAB(6, "STEP"),
END_STONE_BRICK_STAIRS("SMOOTH_STAIRS"),
END_STONE_BRICK_WALL,
EVOKER_SPAWN_EGG(34, "MONSTER_EGG"),
@@ -403,7 +437,12 @@ public enum XMaterial {
FARMLAND("SOIL"),
FEATHER,
FERMENTED_SPIDER_EYE,
- FERN(2, "LONG_GRASS"),
+ FERN(1, "LONG_GRASS"),
+ /**
+ * For some reasons filled map items are really special.
+ * Their data value starts from 0 and every time a player
+ * creates a new map that maps data value increases.
+ */
FILLED_MAP("MAP"),
FIRE,
FIREWORK_ROCKET("FIREWORK"),
@@ -460,7 +499,7 @@ public enum XMaterial {
GRASS_PATH,
GRAVEL,
GRAY_BANNER(8, "BANNER", "STANDING_BANNER"),
- GRAY_BED(7, "BED", "BED_BLOCK"),
+ GRAY_BED(7, "BED_BLOCK", "BED"),
GRAY_CARPET(7, "CARPET"),
GRAY_CONCRETE(7, "CONCRETE"),
GRAY_CONCRETE_POWDER(7, "CONCRETE_POWDER"),
@@ -473,7 +512,7 @@ public enum XMaterial {
GRAY_WALL_BANNER(8, "WALL_BANNER"),
GRAY_WOOL(7, "WOOL"),
GREEN_BANNER(2, "BANNER", "STANDING_BANNER"),
- GREEN_BED(13, "BED", "BED_BLOCK"),
+ GREEN_BED(13, "BED_BLOCK", "BED"),
GREEN_CARPET(13, "CARPET"),
GREEN_CONCRETE(13, "CONCRETE"),
GREEN_CONCRETE_POWDER(13, "CONCRETE_POWDER"),
@@ -491,6 +530,7 @@ public enum XMaterial {
HAY_BLOCK,
HEART_OF_THE_SEA("1.13"),
HEAVY_WEIGHTED_PRESSURE_PLATE("IRON_PLATE"),
+ HOGLIN_SPAWN_EGG("1.16", "MONSTER_EGG"),
HONEYCOMB("1.15"),
HONEYCOMB_BLOCK("1.15"),
HONEY_BLOCK("1.15", "SLIME_BLOCK", ""),
@@ -534,7 +574,7 @@ public enum XMaterial {
JUKEBOX,
JUNGLE_BOAT("BOAT_JUNGLE"),
JUNGLE_BUTTON("WOOD_BUTTON"),
- JUNGLE_DOOR("JUNGLE_DOOR_ITEM"),
+ JUNGLE_DOOR("JUNGLE_DOOR_ITEM", "JUNGLE_DOOR"),
JUNGLE_FENCE,
JUNGLE_FENCE_GATE,
JUNGLE_LEAVES(3, "LEAVES"),
@@ -568,8 +608,8 @@ public enum XMaterial {
LEATHER_LEGGINGS,
LECTERN("1.14", "BOOKSHELF", ""),
LEVER,
- LIGHT_BLUE_BANNER(3, "BANNER", "STANDING_BANNER"),
- LIGHT_BLUE_BED(3, "BED", "BED_BLOCK"),
+ LIGHT_BLUE_BANNER(12, "BANNER", "STANDING_BANNER"),
+ LIGHT_BLUE_BED(3, "BED_BLOCK", "BED"),
LIGHT_BLUE_CARPET(3, "CARPET"),
LIGHT_BLUE_CONCRETE(3, "CONCRETE"),
LIGHT_BLUE_CONCRETE_POWDER(3, "CONCRETE_POWDER"),
@@ -582,16 +622,16 @@ public enum XMaterial {
LIGHT_BLUE_WALL_BANNER(12, "WALL_BANNER", "BANNER", "STANDING_BANNER"),
LIGHT_BLUE_WOOL(3, "WOOL"),
LIGHT_GRAY_BANNER(7, "BANNER", "STANDING_BANNER"),
- LIGHT_GRAY_BED(8, "BED", "BED_BLOCK"),
+ LIGHT_GRAY_BED(8, "BED_BLOCK", "BED"),
LIGHT_GRAY_CARPET(8, "CARPET"),
LIGHT_GRAY_CONCRETE(8, "CONCRETE"),
LIGHT_GRAY_CONCRETE_POWDER(8, "CONCRETE_POWDER"),
LIGHT_GRAY_DYE(7, "INK_SACK"),
/**
- * Renamed to SILVER_GLAZED_TERRACOTTA in 1.13
+ * Renamed to SILVER_GLAZED_TERRACOTTA in 1.12
* Renamed to LIGHT_GRAY_GLAZED_TERRACOTTA in 1.14
*/
- LIGHT_GRAY_GLAZED_TERRACOTTA(8, "1.12", "HARD_CLAY", "STAINED_CLAY", "LIGHT_GRAY_TERRACOTTA", "SILVER_GLAZED_TERRACOTTA"),
+ LIGHT_GRAY_GLAZED_TERRACOTTA("1.12", "HARD_CLAY", "STAINED_CLAY", "LIGHT_GRAY_TERRACOTTA", "SILVER_GLAZED_TERRACOTTA"),
LIGHT_GRAY_SHULKER_BOX("SILVER_SHULKER_BOX"),
LIGHT_GRAY_STAINED_GLASS(8, "STAINED_GLASS"),
LIGHT_GRAY_STAINED_GLASS_PANE(8, "THIN_GLASS", "STAINED_GLASS_PANE"),
@@ -603,7 +643,7 @@ public enum XMaterial {
LILY_OF_THE_VALLEY(15, "1.14", "WHITE_DYE", ""),
LILY_PAD("WATER_LILY"),
LIME_BANNER(10, "BANNER", "STANDING_BANNER"),
- LIME_BED(5, "BED", "BED_BLOCK"),
+ LIME_BED(5, "BED_BLOCK", "BED"),
LIME_CARPET(5, "CARPET"),
LIME_CONCRETE(5, "CONCRETE"),
LIME_CONCRETE_POWDER(5, "CONCRETE_POWDER"),
@@ -617,9 +657,10 @@ public enum XMaterial {
LIME_WOOL(5, "WOOL"),
LINGERING_POTION,
LLAMA_SPAWN_EGG(103, "MONSTER_EGG"),
+ LODESTONE("1.16"),
LOOM("1.14"),
MAGENTA_BANNER(13, "BANNER", "STANDING_BANNER"),
- MAGENTA_BED(2, "BED", "BED_BLOCK"),
+ MAGENTA_BED(2, "BED_BLOCK", "BED"),
MAGENTA_CARPET(2, "CARPET"),
MAGENTA_CONCRETE(2, "CONCRETE"),
MAGENTA_CONCRETE_POWDER(2, "CONCRETE_POWDER"),
@@ -634,6 +675,13 @@ public enum XMaterial {
MAGMA_BLOCK("1.10", "MAGMA"),
MAGMA_CREAM,
MAGMA_CUBE_SPAWN_EGG(62, "MONSTER_EGG"),
+ /**
+ * Adding this to the duplicated list will give you a filled map
+ * for 1.13+ versions and removing it from duplicated list will
+ * still give you a filled map in -1.12 versions.
+ * Since higher versions are our priority I'll keep 1.13+ support
+ * until I can come up with something to fix it.
+ */
MAP("EMPTY_MAP"),
MELON("MELON_BLOCK"),
MELON_SEEDS,
@@ -648,7 +696,7 @@ public enum XMaterial {
MOSSY_COBBLESTONE_STAIRS,
MOSSY_COBBLESTONE_WALL(1, "COBBLE_WALL", "COBBLESTONE_WALL"),
MOSSY_STONE_BRICKS(1, "SMOOTH_BRICK"),
- MOSSY_STONE_BRICK_SLAB(4, "STEP"),
+ MOSSY_STONE_BRICK_SLAB(5, "STEP"),
MOSSY_STONE_BRICK_STAIRS("SMOOTH_STAIRS"),
MOSSY_STONE_BRICK_WALL,
MOVING_PISTON("PISTON_BASE", "PISTON_MOVING_PIECE"),
@@ -671,15 +719,29 @@ public enum XMaterial {
MYCELIUM("MYCEL"),
NAME_TAG,
NAUTILUS_SHELL("1.13"),
+ NETHERITE_AXE("1.16"),
+ NETHERITE_BLOCK("1.16"),
+ NETHERITE_BOOTS("1.16"),
+ NETHERITE_CHESTPLATE("1.16"),
+ NETHERITE_HELMET("1.16"),
+ NETHERITE_HOE("1.16"),
+ NETHERITE_INGOT("1.16"),
+ NETHERITE_LEGGINGS("1.16"),
+ NETHERITE_PICKAXE("1.16"),
+ NETHERITE_SCRAP("1.16"),
+ NETHERITE_SHOVEL("1.16"),
+ NETHERITE_SWORD("1.16"),
NETHERRACK,
NETHER_BRICK("NETHER_BRICK_ITEM"),
NETHER_BRICKS("NETHER_BRICK"),
NETHER_BRICK_FENCE("NETHER_FENCE"),
- NETHER_BRICK_SLAB(4, "STEP"),
+ NETHER_BRICK_SLAB(6, "STEP"),
NETHER_BRICK_STAIRS,
NETHER_BRICK_WALL,
+ NETHER_GOLD_ORE("1.16"),
NETHER_PORTAL("PORTAL"),
NETHER_QUARTZ_ORE("QUARTZ_ORE"),
+ NETHER_SPROUTS("1.16"),
NETHER_STAR,
/**
* Just like mentioned in https://minecraft.gamepedia.com/Nether_Wart
@@ -709,7 +771,7 @@ public enum XMaterial {
OBSIDIAN,
OCELOT_SPAWN_EGG(98, "MONSTER_EGG"),
ORANGE_BANNER(14, "BANNER", "STANDING_BANNER"),
- ORANGE_BED(1, "BED", "BED_BLOCK"),
+ ORANGE_BED(1, "BED_BLOCK", "BED"),
ORANGE_CARPET(1, "CARPET"),
ORANGE_CONCRETE(1, "CONCRETE"),
ORANGE_CONCRETE_POWDER(1, "CONCRETE_POWDER"),
@@ -735,7 +797,7 @@ public enum XMaterial {
PIG_SPAWN_EGG(90, "MONSTER_EGG"),
PILLAGER_SPAWN_EGG("1.14"),
PINK_BANNER(9, "BANNER", "STANDING_BANNER"),
- PINK_BED(6, "BED", "BED_BLOCK"),
+ PINK_BED(6, "BED_BLOCK", "BED"),
PINK_CARPET(6, "CARPET"),
PINK_CONCRETE(6, "CONCRETE"),
PINK_CONCRETE_POWDER(6, "CONCRETE_POWDER"),
@@ -746,7 +808,7 @@ public enum XMaterial {
PINK_STAINED_GLASS_PANE(6, "THIN_GLASS", "STAINED_GLASS_PANE"),
PINK_TERRACOTTA(6, "HARD_CLAY", "STAINED_CLAY"),
PINK_TULIP(7, "RED_ROSE"),
- PINK_WALL_BANNER(14, "WALL_BANNER"),
+ PINK_WALL_BANNER(9, "WALL_BANNER"),
PINK_WOOL(6, "WOOL"),
PISTON("PISTON_BASE"),
PISTON_HEAD("PISTON_EXTENSION"),
@@ -758,6 +820,17 @@ public enum XMaterial {
POLISHED_ANDESITE(6, "STONE"),
POLISHED_ANDESITE_SLAB,
POLISHED_ANDESITE_STAIRS,
+ POLISHED_BASALT("1.16"),
+ POLISHED_BLACKSTONE("1.16"),
+ POLISHED_BLACKSTONE_BRICKS("1.16"),
+ POLISHED_BLACKSTONE_BRICK_SLAB("1.16"),
+ POLISHED_BLACKSTONE_BRICK_STAIRS("1.16"),
+ POLISHED_BLACKSTONE_BRICK_WALL("1.16"),
+ POLISHED_BLACKSTONE_BUTTON("1.16"),
+ POLISHED_BLACKSTONE_PRESSURE_PLATE("1.16"),
+ POLISHED_BLACKSTONE_SLAB("1.16"),
+ POLISHED_BLACKSTONE_STAIRS("1.16"),
+ POLISHED_BLACKSTONE_WALL("1.16"),
POLISHED_DIORITE(4, "STONE"),
POLISHED_DIORITE_SLAB,
POLISHED_DIORITE_STAIRS,
@@ -813,7 +886,7 @@ public enum XMaterial {
PUMPKIN_SEEDS,
PUMPKIN_STEM,
PURPLE_BANNER(5, "BANNER", "STANDING_BANNER"),
- PURPLE_BED(10, "BED", "BED_BLOCK"),
+ PURPLE_BED(10, "BED_BLOCK", "BED"),
PURPLE_CARPET(10, "CARPET"),
PURPLE_CONCRETE(10, "CONCRETE"),
PURPLE_CONCRETE_POWDER(10, "CONCRETE_POWDER"),
@@ -843,17 +916,34 @@ public enum XMaterial {
RAVAGER_SPAWN_EGG("1.14"),
REDSTONE,
REDSTONE_BLOCK,
- REDSTONE_LAMP("REDSTONE_LAMP_OFF", "REDSTONE_LAMP_ON"),
+ /**
+ * Unlike redstone torch, REDSTONE_LAMP_ON isn't an item.
+ * The name is just here on the list for matching.
+ *
+ * @see #REDSTONE_TORCH
+ */
+ REDSTONE_LAMP("REDSTONE_LAMP_ON", "REDSTONE_LAMP_OFF"),
REDSTONE_ORE("GLOWING_REDSTONE_ORE"),
- REDSTONE_TORCH("REDSTONE_TORCH_ON", "REDSTONE_TORCH_OFF"),
- REDSTONE_WALL_TORCH(1, "REDSTONE_TORCH_ON", "REDSTONE_TORCH_OFF"),
+ /**
+ * REDSTONE_TORCH_OFF isn't an item, but a block.
+ * But REDSTONE_TORCH_ON is the item.
+ * The name is just here on the list for matching.
+ */
+ REDSTONE_TORCH("REDSTONE_TORCH_OFF", "REDSTONE_TORCH_ON"),
+ REDSTONE_WALL_TORCH,
REDSTONE_WIRE,
RED_BANNER(1, "BANNER", "STANDING_BANNER"),
- RED_BED(14, "BED", "BED_BLOCK"),
+ /**
+ * Data value 14 or 0
+ */
+ RED_BED(0, "BED_BLOCK", "BED"),
RED_CARPET(14, "CARPET"),
RED_CONCRETE(14, "CONCRETE"),
RED_CONCRETE_POWDER(14, "CONCRETE_POWDER"),
- RED_DYE(1, "ROSE_RED"),
+ /**
+ * Data value 0 or 1?
+ */
+ RED_DYE(0, "INK_SACK", "ROSE_RED"),
RED_GLAZED_TERRACOTTA(14, "1.12", "HARD_CLAY", "STAINED_CLAY", "RED_TERRACOTTA"),
RED_MUSHROOM,
RED_MUSHROOM_BLOCK("RED_MUSHROOM", "HUGE_MUSHROOM_2"),
@@ -875,6 +965,7 @@ public enum XMaterial {
RED_WOOL(14, "WOOL"),
REPEATER("DIODE", "DIODE_BLOCK_ON", "DIODE_BLOCK_OFF"),
REPEATING_COMMAND_BLOCK("COMMAND", "COMMAND_REPEATING"),
+ RESPAWN_ANCHOR("1.16"),
ROSE_BUSH(4, "DOUBLE_PLANT"),
ROTTEN_FLESH,
SADDLE,
@@ -894,6 +985,7 @@ public enum XMaterial {
SHEARS,
SHEEP_SPAWN_EGG(91, "MONSTER_EGG"),
SHIELD,
+ SHROOMLIGHT("1.16"),
SHULKER_BOX("PURPLE_SHULKER_BOX"),
SHULKER_SHELL,
SHULKER_SPAWN_EGG(69, "MONSTER_EGG"),
@@ -922,7 +1014,13 @@ public enum XMaterial {
SNOW,
SNOWBALL("SNOW_BALL"),
SNOW_BLOCK,
+ SOUL_CAMPFIRE("1.16"),
+ SOUL_FIRE("1.16"),
+ SOUL_LANTERN("1.16"),
SOUL_SAND,
+ SOUL_SOIL("1.16"),
+ SOUL_TORCH("1.16"),
+ SOUL_WALL_TORCH("1.16"),
SPAWNER("MOB_SPAWNER"),
SPECTRAL_ARROW("1.9", "ARROW", ""),
SPIDER_EYE,
@@ -931,7 +1029,7 @@ public enum XMaterial {
SPONGE,
SPRUCE_BOAT("BOAT_SPRUCE"),
SPRUCE_BUTTON("WOOD_BUTTON"),
- SPRUCE_DOOR("SPRUCE_DOOR_ITEM"),
+ SPRUCE_DOOR("SPRUCE_DOOR_ITEM", "SPRUCE_DOOR"),
SPRUCE_FENCE,
SPRUCE_FENCE_GATE,
SPRUCE_LEAVES(1, "LEAVES"),
@@ -969,6 +1067,8 @@ public enum XMaterial {
STRIPPED_ACACIA_WOOD("LOG_2"),
STRIPPED_BIRCH_LOG(2, "LOG"),
STRIPPED_BIRCH_WOOD(2, "LOG"),
+ STRIPPED_CRIMSON_HYPHAE("1.16"),
+ STRIPPED_CRIMSON_STEM("1.16"),
STRIPPED_DARK_OAK_LOG("LOG"),
STRIPPED_DARK_OAK_WOOD("LOG"),
STRIPPED_JUNGLE_LOG(3, "LOG"),
@@ -977,6 +1077,8 @@ public enum XMaterial {
STRIPPED_OAK_WOOD("LOG"),
STRIPPED_SPRUCE_LOG(1, "LOG"),
STRIPPED_SPRUCE_WOOD(1, "LOG"),
+ STRIPPED_WARPED_HYPHAE("1.16"),
+ STRIPPED_WARPED_STEM("1.16"),
STRUCTURE_BLOCK,
/**
* Originally developers used barrier blocks for its purpose.
@@ -995,6 +1097,7 @@ public enum XMaterial {
SWEET_BERRY_BUSH("1.14", "GRASS", ""),
TALL_GRASS(2, "DOUBLE_PLANT"),
TALL_SEAGRASS(2, "1.13", "TALL_GRASS", ""),
+ TARGET("1.16"),
TERRACOTTA("HARD_CLAY"),
TIPPED_ARROW("1.9", "ARROW", ""),
TNT,
@@ -1016,6 +1119,8 @@ public enum XMaterial {
TURTLE_EGG("1.13", "EGG", ""),
TURTLE_HELMET("1.13", "IRON_HELMET", ""),
TURTLE_SPAWN_EGG("1.13", "CHICKEN_SPAWN_EGG", ""),
+ TWISTING_VINES("1.16"),
+ TWISTING_VINES_PLANT("1.16"),
VEX_SPAWN_EGG(35, "MONSTER_EGG"),
VILLAGER_SPAWN_EGG(120, "MONSTER_EGG"),
VINDICATOR_SPAWN_EGG(36, "MONSTER_EGG"),
@@ -1028,6 +1133,24 @@ public enum XMaterial {
VOID_AIR("AIR"),
WALL_TORCH("TORCH"),
WANDERING_TRADER_SPAWN_EGG("1.14", "VILLAGER_SPAWN_EGG", ""),
+ WARPED_BUTTON("1.16"),
+ WARPED_DOOR("1.16"),
+ WARPED_FENCE("1.16"),
+ WARPED_FENCE_GATE("1.16"),
+ WARPED_FUNGUS("1.16"),
+ WARPED_FUNGUS_ON_A_STICK("1.16"),
+ WARPED_HYPHAE("1.16"),
+ WARPED_NYLIUM("1.16"),
+ WARPED_PLANKS("1.16"),
+ WARPED_PRESSURE_PLATE("1.16"),
+ WARPED_ROOTS("1.16"),
+ WARPED_SIGN("1.16"),
+ WARPED_SLAB("1.16"),
+ WARPED_STAIRS("1.16"),
+ WARPED_STEM("1.16"),
+ WARPED_TRAPDOOR("1.16"),
+ WARPED_WALL_SIGN("1.16"),
+ WARPED_WART_BLOCK("1.16"),
/**
* This is used for blocks only.
* In 1.13- WATER will turn into STATIONARY_WATER after it finished spreading.
@@ -1037,6 +1160,8 @@ public enum XMaterial {
*/
WATER("STATIONARY_WATER"),
WATER_BUCKET,
+ WEEPING_VINES("1.16"),
+ WEEPING_VINES_PLANT("1.16"),
WET_SPONGE(1, "SPONGE"),
/**
* Wheat is a known material in pre-1.13
@@ -1045,16 +1170,16 @@ public enum XMaterial {
WHEAT("CROPS"),
WHEAT_SEEDS("SEEDS"),
WHITE_BANNER(15, "BANNER", "STANDING_BANNER"),
- WHITE_BED("BED", "BED_BLOCK"),
+ WHITE_BED("BED_BLOCK", "BED"),
WHITE_CARPET("CARPET"),
WHITE_CONCRETE("CONCRETE"),
WHITE_CONCRETE_POWDER("CONCRETE_POWDER"),
WHITE_DYE(15, "1.14", "INK_SACK", "BONE_MEAL"),
- WHITE_GLAZED_TERRACOTTA("1.12", "HARD_CLAY", "STAINED_CLAY", "WHITE_TERRACOTTA"),
+ WHITE_GLAZED_TERRACOTTA("1.12", "HARD_CLAY", "STAINED_CLAY"),
WHITE_SHULKER_BOX,
WHITE_STAINED_GLASS("STAINED_GLASS"),
WHITE_STAINED_GLASS_PANE("THIN_GLASS", "STAINED_GLASS_PANE"),
- WHITE_TERRACOTTA("HARD_CLAY", "TERRACOTTA"),
+ WHITE_TERRACOTTA("HARD_CLAY", "STAINED_CLAY", "TERRACOTTA"),
WHITE_TULIP(6, "RED_ROSE"),
WHITE_WALL_BANNER(15, "WALL_BANNER"),
WHITE_WOOL("WOOL"),
@@ -1072,7 +1197,7 @@ public enum XMaterial {
WRITABLE_BOOK("BOOK_AND_QUILL"),
WRITTEN_BOOK,
YELLOW_BANNER(11, "BANNER", "STANDING_BANNER"),
- YELLOW_BED(4, "BED", "BED_BLOCK"),
+ YELLOW_BED(4, "BED_BLOCK", "BED"),
YELLOW_CARPET(4, "CARPET"),
YELLOW_CONCRETE(4, "CONCRETE"),
YELLOW_CONCRETE_POWDER(4, "CONCRETE_POWDER"),
@@ -1086,10 +1211,11 @@ public enum XMaterial {
YELLOW_WOOL(4, "WOOL"),
ZOMBIE_HEAD(2, "SKULL", "SKULL_ITEM"),
ZOMBIE_HORSE_SPAWN_EGG(29, "MONSTER_EGG"),
- ZOMBIE_PIGMAN_SPAWN_EGG(57, "MONSTER_EGG"),
ZOMBIE_SPAWN_EGG(54, "MONSTER_EGG"),
ZOMBIE_VILLAGER_SPAWN_EGG(27, "MONSTER_EGG"),
- ZOMBIE_WALL_HEAD(2, "SKULL", "SKULL_ITEM");
+ ZOMBIE_WALL_HEAD(2, "SKULL", "SKULL_ITEM"),
+ PIGLIN_SPAWN_EGG(57, "MONSTER_EGG"),
+ ZOMBIFIED_PIGLIN_SPAWN_EGG(57, "MONSTER_EGG", "ZOMBIE_PIGMAN_SPAWN_EGG");
/**
@@ -1125,16 +1251,27 @@ public enum XMaterial {
* @since 3.0.0
*/
@SuppressWarnings("UnstableApiUsage")
- private static final ImmutableMap
- * Examples
- *
* Sounds are thread-safe. But this doesn't mean you should
@@ -58,10 +54,10 @@ import java.util.regex.Pattern;
* 1.8: http://docs.codelanx.com/Bukkit/1.8/org/bukkit/Sound.html
* Latest: https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Sound.html
* Basics: https://bukkit.org/threads/151517/
- * playSound command: https://minecraft.gamepedia.com/Commands/playsound
+ * play command: https://minecraft.gamepedia.com/Commands/play
*
* @author Crypto Morin
- * @version 2.2.0
+ * @version 3.0.0
* @see Sound
*/
public enum XSound {
@@ -303,9 +299,176 @@ public enum XSound {
ENTITY_BLAZE_HURT("BLAZE_HIT"),
ENTITY_BLAZE_SHOOT,
ENTITY_BOAT_PADDLE_LAND,
+ AMBIENT_BASALT_DELTAS_ADDITIONS,
+ AMBIENT_BASALT_DELTAS_LOOP,
+ AMBIENT_BASALT_DELTAS_MOOD,
+ AMBIENT_CRIMSON_FOREST_ADDITIONS,
+ AMBIENT_CRIMSON_FOREST_LOOP,
+ AMBIENT_CRIMSON_FOREST_MOOD,
+ AMBIENT_NETHER_WASTES_ADDITIONS,
+ AMBIENT_NETHER_WASTES_LOOP,
+ AMBIENT_NETHER_WASTES_MOOD,
+ AMBIENT_SOUL_SAND_VALLEY_ADDITIONS,
+ AMBIENT_SOUL_SAND_VALLEY_LOOP,
+ AMBIENT_SOUL_SAND_VALLEY_MOOD,
ENTITY_BOAT_PADDLE_WATER,
ENTITY_CAT_AMBIENT("CAT_MEOW"),
ENTITY_CAT_BEG_FOR_FOOD,
+ AMBIENT_WARPED_FOREST_ADDITIONS,
+ AMBIENT_WARPED_FOREST_LOOP,
+ AMBIENT_WARPED_FOREST_MOOD,
+ BLOCK_ANCIENT_DEBRIS_BREAK,
+ BLOCK_ANCIENT_DEBRIS_FALL,
+ BLOCK_ANCIENT_DEBRIS_HIT,
+ BLOCK_ANCIENT_DEBRIS_PLACE,
+ BLOCK_ANCIENT_DEBRIS_STEP,
+ BLOCK_BASALT_BREAK,
+ BLOCK_BASALT_FALL,
+ BLOCK_BASALT_HIT,
+ BLOCK_BASALT_PLACE,
+ BLOCK_BASALT_STEP,
+ BLOCK_BONE_BLOCK_BREAK,
+ BLOCK_BONE_BLOCK_FALL,
+ BLOCK_BONE_BLOCK_HIT,
+ BLOCK_BONE_BLOCK_PLACE,
+ BLOCK_BONE_BLOCK_STEP,
+ BLOCK_CHAIN_BREAK,
+ BLOCK_CHAIN_FALL,
+ BLOCK_CHAIN_HIT,
+ BLOCK_CHAIN_PLACE,
+ BLOCK_CHAIN_STEP,
+ BLOCK_FUNGUS_BREAK,
+ BLOCK_FUNGUS_FALL,
+ BLOCK_FUNGUS_HIT,
+ BLOCK_FUNGUS_PLACE,
+ BLOCK_FUNGUS_STEP,
+ BLOCK_LODESTONE_BREAK,
+ BLOCK_LODESTONE_FALL,
+ BLOCK_LODESTONE_HIT,
+ BLOCK_LODESTONE_PLACE,
+ BLOCK_LODESTONE_STEP,
+ BLOCK_NETHERITE_BLOCK_BREAK,
+ BLOCK_NETHERITE_BLOCK_FALL,
+ BLOCK_NETHERITE_BLOCK_HIT,
+ BLOCK_NETHERITE_BLOCK_PLACE,
+ BLOCK_NETHERITE_BLOCK_STEP,
+ BLOCK_NETHERRACK_BREAK,
+ BLOCK_NETHERRACK_FALL,
+ BLOCK_NETHERRACK_HIT,
+ BLOCK_NETHERRACK_PLACE,
+ BLOCK_NETHERRACK_STEP,
+ BLOCK_NETHER_BRICKS_BREAK,
+ BLOCK_NETHER_BRICKS_FALL,
+ BLOCK_NETHER_BRICKS_HIT,
+ BLOCK_NETHER_BRICKS_PLACE,
+ BLOCK_NETHER_BRICKS_STEP,
+ BLOCK_NETHER_GOLD_ORE_BREAK,
+ BLOCK_NETHER_GOLD_ORE_FALL,
+ BLOCK_NETHER_GOLD_ORE_HIT,
+ BLOCK_NETHER_GOLD_ORE_PLACE,
+ BLOCK_NETHER_GOLD_ORE_STEP,
+ BLOCK_NETHER_ORE_BREAK,
+ BLOCK_NETHER_ORE_FALL,
+ BLOCK_NETHER_ORE_HIT,
+ BLOCK_NETHER_ORE_PLACE,
+ BLOCK_NETHER_ORE_STEP,
+ BLOCK_NETHER_SPROUTS_BREAK,
+ BLOCK_NETHER_SPROUTS_FALL,
+ BLOCK_NETHER_SPROUTS_HIT,
+ BLOCK_NETHER_SPROUTS_PLACE,
+ BLOCK_NETHER_SPROUTS_STEP,
+ BLOCK_NYLIUM_BREAK,
+ BLOCK_NYLIUM_FALL,
+ BLOCK_NYLIUM_HIT,
+ BLOCK_NYLIUM_PLACE,
+ BLOCK_NYLIUM_STEP,
+ BLOCK_RESPAWN_ANCHOR_AMBIENT,
+ BLOCK_RESPAWN_ANCHOR_CHARGE,
+ BLOCK_RESPAWN_ANCHOR_DEPLETE,
+ BLOCK_RESPAWN_ANCHOR_SET_SPAWN,
+ BLOCK_ROOTS_BREAK,
+ BLOCK_ROOTS_FALL,
+ BLOCK_ROOTS_HIT,
+ BLOCK_ROOTS_PLACE,
+ BLOCK_ROOTS_STEP,
+ BLOCK_SHROOMLIGHT_BREAK,
+ BLOCK_SHROOMLIGHT_FALL,
+ BLOCK_SHROOMLIGHT_HIT,
+ BLOCK_SHROOMLIGHT_PLACE,
+ BLOCK_SHROOMLIGHT_STEP,
+ BLOCK_SMITHING_TABLE_USE,
+ BLOCK_SOUL_SAND_BREAK,
+ BLOCK_SOUL_SAND_FALL,
+ BLOCK_SOUL_SAND_HIT,
+ BLOCK_SOUL_SAND_PLACE,
+ BLOCK_SOUL_SAND_STEP,
+ BLOCK_SOUL_SOIL_BREAK,
+ BLOCK_SOUL_SOIL_FALL,
+ BLOCK_SOUL_SOIL_HIT,
+ BLOCK_SOUL_SOIL_PLACE,
+ BLOCK_SOUL_SOIL_STEP,
+ BLOCK_STEM_BREAK,
+ BLOCK_STEM_FALL,
+ BLOCK_STEM_HIT,
+ BLOCK_STEM_PLACE,
+ BLOCK_STEM_STEP,
+ BLOCK_VINE_STEP,
+ BLOCK_WART_BLOCK_BREAK,
+ BLOCK_WART_BLOCK_FALL,
+ BLOCK_WART_BLOCK_HIT,
+ BLOCK_WART_BLOCK_PLACE,
+ BLOCK_WART_BLOCK_STEP,
+ ENTITY_DONKEY_EAT,
+ ENTITY_FOX_TELEPORT,
+ ENTITY_HOGLIN_AMBIENT,
+ ENTITY_HOGLIN_ANGRY,
+ ENTITY_HOGLIN_ATTACK,
+ ENTITY_HOGLIN_CONVERTED_TO_ZOMBIFIED,
+ ENTITY_HOGLIN_DEATH,
+ ENTITY_HOGLIN_HURT,
+ ENTITY_HOGLIN_RETREAT,
+ ENTITY_HOGLIN_STEP,
+ ENTITY_MULE_EAT,
+ ENTITY_MULE_ANGRY,
+ ENTITY_PARROT_IMITATE_HOGLIN,
+ ENTITY_PARROT_IMITATE_PIGLIN,
+ ENTITY_PARROT_IMITATE_ZOGLIN,
+ ENTITY_PIGLIN_ADMIRING_ITEM,
+ ENTITY_PIGLIN_AMBIENT,
+ ENTITY_PIGLIN_ANGRY,
+ ENTITY_PIGLIN_CELEBRATE,
+ ENTITY_PIGLIN_CONVERTED_TO_ZOMBIFIED,
+ ENTITY_PIGLIN_DEATH,
+ ENTITY_PIGLIN_HURT,
+ ENTITY_PIGLIN_JEALOUS,
+ ENTITY_PIGLIN_RETREAT,
+ ENTITY_PIGLIN_STEP,
+ ENTITY_SNOW_GOLEM_SHEAR,
+ ENTITY_STRIDER_AMBIENT,
+ ENTITY_STRIDER_DEATH,
+ ENTITY_STRIDER_EAT,
+ ENTITY_STRIDER_HAPPY,
+ ENTITY_STRIDER_HURT,
+ ENTITY_STRIDER_RETREAT,
+ ENTITY_STRIDER_SADDLE,
+ ENTITY_STRIDER_STEP,
+ ENTITY_STRIDER_STEP_LAVA,
+ ENTITY_ZOGLIN_AMBIENT,
+ ENTITY_ZOGLIN_ANGRY,
+ ENTITY_ZOGLIN_ATTACK,
+ ENTITY_ZOGLIN_DEATH,
+ ENTITY_ZOGLIN_HURT,
+ ENTITY_ZOGLIN_STEP,
+ BLOCK_WEEPING_VINES_BREAK,
+ BLOCK_WEEPING_VINES_FALL,
+ BLOCK_WEEPING_VINES_HIT,
+ BLOCK_WEEPING_VINES_PLACE,
+ BLOCK_WEEPING_VINES_STEP,
+ BLOCK_GILDED_BLACKSTONE_BREAK,
+ BLOCK_GILDED_BLACKSTONE_FALL,
+ BLOCK_GILDED_BLACKSTONE_HIT,
+ BLOCK_GILDED_BLACKSTONE_PLACE,
+ BLOCK_GILDED_BLACKSTONE_STEP,
ENTITY_CAT_DEATH,
ENTITY_CAT_EAT,
ENTITY_CAT_HISS("CAT_HISS"),
@@ -568,7 +731,6 @@ public enum XSound {
ENTITY_PARROT_IMITATE_WITHER_SKELETON,
ENTITY_PARROT_IMITATE_WOLF,
ENTITY_PARROT_IMITATE_ZOMBIE,
- ENTITY_PARROT_IMITATE_ZOMBIE_PIGMAN,
ENTITY_PARROT_IMITATE_ZOMBIE_VILLAGER,
ENTITY_PARROT_STEP,
ENTITY_PHANTOM_AMBIENT,
@@ -787,10 +949,14 @@ public enum XSound {
ENTITY_ZOMBIE_HORSE_HURT("HORSE_ZOMBIE_HIT"),
ENTITY_ZOMBIE_HURT("ZOMBIE_HURT"),
ENTITY_ZOMBIE_INFECT("ZOMBIE_INFECT"),
- ENTITY_ZOMBIE_PIGMAN_AMBIENT("ZOMBIE_PIG_IDLE", "ENTITY_ZOMBIE_PIG_AMBIENT"),
- ENTITY_ZOMBIE_PIGMAN_ANGRY("ZOMBIE_PIG_ANGRY", "ENTITY_ZOMBIE_PIG_ANGRY"),
- ENTITY_ZOMBIE_PIGMAN_DEATH("ZOMBIE_PIG_DEATH", "ENTITY_ZOMBIE_PIG_DEATH"),
- ENTITY_ZOMBIE_PIGMAN_HURT("ZOMBIE_PIG_HURT", "ENTITY_ZOMBIE_PIG_HURT"),
+ ITEM_ARMOR_EQUIP_NETHERITE,
+ ITEM_LODESTONE_COMPASS_LOCK,
+ MUSIC_DISC_PIGSTEP,
+
+ ENTITY_ZOMBIFIED_PIGLIN_AMBIENT("ZOMBE_PIG_IDLE", "ENTITY_ZOMBIE_PIG_AMBIENT", "ENTITY_ZOMBIE_PIGMAN_AMBIENT"),
+ ENTITY_ZOMBIFIED_PIGLIN_ANGRY("ZOMBIE_PIG_ANGRY", "ENTITY_ZOMBIE_PIG_ANGRY", "ENTITY_ZOMBIE_PIGMAN_ANGRY"),
+ ENTITY_ZOMBIFIED_PIGLIN_DEATH("ZOMBIE_PIG_DEATH", "ENTITY_ZOMBIE_PIG_DEATH", "ENTITY_ZOMBIE_PIGMAN_DEATH"),
+ ENTITY_ZOMBIFIED_PIGLIN_HURT("ZOMBIE_PIG_HURT", "ENTITY_ZOMBIE_PIG_HURT", "ENTITY_ZOMBIE_PIGMAN_HURT"),
ENTITY_ZOMBIE_STEP("ZOMBIE_WALK"),
ENTITY_ZOMBIE_VILLAGER_AMBIENT,
ENTITY_ZOMBIE_VILLAGER_CONVERTED("ZOMBIE_UNFECT"),
@@ -866,7 +1032,12 @@ public enum XSound {
MUSIC_END,
MUSIC_GAME,
MUSIC_MENU,
- MUSIC_NETHER,
+ MUSIC_NETHER_BASALT_DELTAS("MUSIC_NETHER"),
+ PARTICLE_SOUL_ESCAPE,
+ MUSIC_NETHER_CRIMSON_FOREST,
+ MUSIC_NETHER_NETHER_WASTES,
+ MUSIC_NETHER_SOUL_SAND_VALLEY,
+ MUSIC_NETHER_WARPED_FOREST,
MUSIC_UNDER_WATER,
UI_BUTTON_CLICK("CLICK"),
UI_CARTOGRAPHY_TABLE_TAKE_RESULT,
@@ -891,7 +1062,7 @@ public enum XSound {
/**
* Guava (Google Core Libraries for Java)'s cache for performance and timed caches.
* Caches the parsed {@link Sound} objects instead of string. Because it has to go through catching exceptions again
- * since {@link Sound} class doesn't have a method like {@link org.bukkit.Material#getMaterial(String)}.
+ * since {@link Sound} class doesn't have a method like {@link Material#getMaterial(String)}.
* So caching these would be more efficient.
*
* @since 2.0.0
@@ -907,6 +1078,7 @@ public enum XSound {
* @since 1.0.0
*/
private static final Pattern FORMAT_PATTERN = Pattern.compile("\\d+|\\W+");
+ private static final Pattern DOUBLE_SPACE = Pattern.compile(" +");
private final String[] legacy;
XSound(String... legacy) {
@@ -975,18 +1147,50 @@ public enum XSound {
.orElseThrow(() -> new IllegalArgumentException("Unsupported Sound: " + sound.name()));
}
+ /**
+ * @see #play(Location, String)
+ * @since 1.0.0
+ */
+ @Nonnull
+ public static CompletableFuture
+ * It's strongly recommended to use this method while using it inside a loop.
+ * This can help to avoid parsing the sound properties multiple times.
+ * A simple usage of using it in a loop is:
+ *
* This will also ignore {@code none} and {@code null} strings.
*
- * Format: Sound, Volume, Pitch
* Examples:
*
*
- * {@code INK_SACK:1 -> RED_DYE}
- * {@code WOOL, 14 -> RED_WOOL}
- *
- *
- * @see #matchDefinedXMaterial(String, byte)
- * @see #matchXMaterial(ItemStack)
- * @since 2.0.0
- */
- @Nonnull
- public static Optional
- * Supports 1.8-1.15
* 1.13 and above as priority.
*
*
+ * Record record = XSound.parse(player, location, sound, false).join();
+ * // Loop:
+ * if (record != null) record.play();
+ *
+ * Format: [LOC:]Sound, [Volume], [Pitch]
+ * Where {@code LOC:} will play the sound at the location if a player is specified.
+ * A sound played at a location will be heard by everyone around.
* Comma separators are optional.
*
+ * LOC:ENTITY_PLAYER_BURP, 2.5f, 0.5
* ENTITY_PLAYER_BURP, 0.5, 1f
* BURP 0.5f 1
* MUSIC_END, 10f
@@ -994,27 +1198,32 @@ public enum XSound {
* null
*
*
- * @param player the player to play the sound to.
- * @param sound the string of the sound with volume and pitch (if needed).
- * @since 1.0.0
+ * @param player the only player to play the sound to if requested to do so.
+ * @param location the location to play the sound to.
+ * @param sound the string of the sound with volume and pitch (if needed).
+ * @param play if the sound should be played right away.
+ * @since 3.0.0
*/
- public static CompletableFuture