PocketMine-MP/src/data/bedrock/item/ItemSerializerDeserializerRegistrar.php

<?php

/*
 *
 *  ____            _        _   __  __ _                  __  __ ____
 * |  _ \ ___   ___| | _____| |_|  \/  (_)_ __   ___      |  \/  |  _ \
 * | |_) / _ \ / __| |/ / _ \ __| |\/| | | '_ \ / _ \_____| |\/| | |_) |
 * |  __/ (_) | (__|   <  __/ |_| |  | | | | | |  __/_____| |  | |  __/
 * |_|   \___/ \___|_|\_\___|\__|_|  |_|_|_| |_|\___|     |_|  |_|_|
 *
 * This program is free software: you can redistribute it and/or modify
 * it under the terms of the GNU Lesser General Public License as published by
 * the Free Software Foundation, either version 3 of the License, or
 * (at your option) any later version.
 *
 * @author PocketMine Team
 * @link http://www.pocketmine.net/
 *
 *
 */

declare(strict_types=1);

namespace pocketmine\data\bedrock\item;

use pocketmine\block\Bed;
use pocketmine\block\Block;
use pocketmine\block\MobHead;
use pocketmine\block\utils\DyeColor;
use pocketmine\block\utils\MobHeadType;
use pocketmine\block\VanillaBlocks as Blocks;
use pocketmine\data\bedrock\CompoundTypeIds;
use pocketmine\data\bedrock\DyeColorIdMap;
use pocketmine\data\bedrock\item\ItemTypeNames as Ids;
use pocketmine\data\bedrock\item\SavedItemData as Data;
use pocketmine\data\bedrock\MedicineTypeIdMap;
use pocketmine\data\bedrock\PotionTypeIdMap;
use pocketmine\data\bedrock\SuspiciousStewTypeIdMap;
use pocketmine\item\Banner;
use pocketmine\item\Dye;
use pocketmine\item\Item;
use pocketmine\item\Medicine;
use pocketmine\item\Potion;
use pocketmine\item\SplashPotion;
use pocketmine\item\SuspiciousStew;
use pocketmine\item\VanillaItems as Items;

final class ItemSerializerDeserializerRegistrar{

	public function __construct(
		private ?ItemDeserializer $deserializer,
		private ?ItemSerializer $serializer
	){
		$this->register1to1BlockMappings();
		$this->register1to1ItemMappings();
		$this->register1to1BlockWithMetaMappings();
		$this->register1to1ItemWithMetaMappings();
		$this->register1ToNItemMappings();
		$this->registerMiscItemMappings();
	}

	public function map1to1Item(string $id, Item $item) : void{
		$this->deserializer?->map($id, fn() => clone $item);
		$this->serializer?->map($item, fn() => new Data($id));
	}

	/**
	 * @phpstan-template TItem of Item
	 * @phpstan-param TItem                       $item
	 * @phpstan-param \Closure(TItem, int) : void $deserializeMeta
	 * @phpstan-param \Closure(TItem) : int       $serializeMeta
	 */
	public function map1to1ItemWithMeta(string $id, Item $item, \Closure $deserializeMeta, \Closure $serializeMeta) : void{
		$this->deserializer?->map($id, function(Data $data) use ($item, $deserializeMeta) : Item{
			$result = clone $item;
			$deserializeMeta($result, $data->getMeta());
			return $result;
		});
		$this->serializer?->map($item, function(Item $item) use ($id, $serializeMeta) : Data{
			/** @phpstan-var TItem $item */
			$meta = $serializeMeta($item);
			return new Data($id, $meta);
		});
	}

	public function map1to1Block(string $id, Block $block) : void{
		$this->deserializer?->mapBlock($id, fn() => $block);
		$this->serializer?->mapBlock($block, fn() => new Data($id));
	}

	/**
	 * @phpstan-template TBlock of Block
	 * @phpstan-param TBlock                       $block
	 * @phpstan-param \Closure(TBlock, int) : void $deserializeMeta
	 * @phpstan-param \Closure(TBlock) : int       $serializeMeta
	 */
	public function map1to1BlockWithMeta(string $id, Block $block, \Closure $deserializeMeta, \Closure $serializeMeta) : void{
		$this->deserializer?->mapBlock($id, function(Data $data) use ($block, $deserializeMeta) : Block{
			$result = clone $block;
			$deserializeMeta($result, $data->getMeta());
			return $result;
		});
		$this->serializer?->mapBlock($block, function(Block $block) use ($id, $serializeMeta) : Data{
			$meta = $serializeMeta($block);
			return new Data($id, $meta);
		});
	}

	/**
	 * @param Item[] $items
	 * @phpstan-param array<int, Item> $items
	 */
	public function map1ToNItem(string $id, array $items) : void{
		$this->deserializer?->map($id, function(Data $data) use ($items) : Item{
			$result = $items[$data->getMeta()] ?? null;
			if($result === null){
				throw new ItemTypeDeserializeException("Unhandled meta value " . $data->getMeta() . " for item ID " . $data->getName());
			}
			return clone $result;
		});
		foreach($items as $meta => $item){
			$this->serializer?->map($item, fn() => new Data($id, $meta));
		}
	}

	/**
	 * Registers mappings for item IDs which directly correspond to PocketMine-MP blockitems.
	 * Mappings here are only necessary when the item has a dedicated item ID; in these cases, the blockstate is not
	 * included in the itemstack, and the item ID may be different from the block ID.
	 */
	private function register1to1BlockMappings() : void{
		$this->map1to1Block(Ids::ACACIA_DOOR, Blocks::ACACIA_DOOR());
		$this->map1to1Block(Ids::BIRCH_DOOR, Blocks::BIRCH_DOOR());
		$this->map1to1Block(Ids::BREWING_STAND, Blocks::BREWING_STAND());
		$this->map1to1Block(Ids::CAKE, Blocks::CAKE());
		$this->map1to1Block(Ids::CAULDRON, Blocks::CAULDRON());
		$this->map1to1Block(Ids::CHAIN, Blocks::CHAIN());
		$this->map1to1Block(Ids::COMPARATOR, Blocks::REDSTONE_COMPARATOR());
		$this->map1to1Block(Ids::CRIMSON_DOOR, Blocks::CRIMSON_DOOR());
		$this->map1to1Block(Ids::DARK_OAK_DOOR, Blocks::DARK_OAK_DOOR());
		$this->map1to1Block(Ids::FLOWER_POT, Blocks::FLOWER_POT());
		$this->map1to1Block(Ids::FRAME, Blocks::ITEM_FRAME());
		$this->map1to1Block(Ids::GLOW_FRAME, Blocks::GLOWING_ITEM_FRAME());
		$this->map1to1Block(Ids::HOPPER, Blocks::HOPPER());
		$this->map1to1Block(Ids::IRON_DOOR, Blocks::IRON_DOOR());
		$this->map1to1Block(Ids::JUNGLE_DOOR, Blocks::JUNGLE_DOOR());
		$this->map1to1Block(Ids::MANGROVE_DOOR, Blocks::MANGROVE_DOOR());
		$this->map1to1Block(Ids::NETHER_WART, Blocks::NETHER_WART());
		$this->map1to1Block(Ids::REPEATER, Blocks::REDSTONE_REPEATER());
		$this->map1to1Block(Ids::SPRUCE_DOOR, Blocks::SPRUCE_DOOR());
		$this->map1to1Block(Ids::SUGAR_CANE, Blocks::SUGARCANE());
		$this->map1to1Block(Ids::WARPED_DOOR, Blocks::WARPED_DOOR());
		$this->map1to1Block(Ids::WOODEN_DOOR, Blocks::OAK_DOOR());
	}

	/**
	 * Registers mappings for item IDs which directly correspond to PocketMine-MP items.
	 */
	private function register1to1ItemMappings() : void{
		$this->map1to1Item(Ids::ACACIA_BOAT, Items::ACACIA_BOAT());
		$this->map1to1Item(Ids::ACACIA_SIGN, Items::ACACIA_SIGN());
		$this->map1to1Item(Ids::AMETHYST_SHARD, Items::AMETHYST_SHARD());
		$this->map1to1Item(Ids::APPLE, Items::APPLE());
		$this->map1to1Item(Ids::BAKED_POTATO, Items::BAKED_POTATO());
		$this->map1to1Item(Ids::BEEF, Items::RAW_BEEF());
		$this->map1to1Item(Ids::BEETROOT, Items::BEETROOT());
		$this->map1to1Item(Ids::BEETROOT_SEEDS, Items::BEETROOT_SEEDS());
		$this->map1to1Item(Ids::BEETROOT_SOUP, Items::BEETROOT_SOUP());
		$this->map1to1Item(Ids::BIRCH_BOAT, Items::BIRCH_BOAT());
		$this->map1to1Item(Ids::BIRCH_SIGN, Items::BIRCH_SIGN());
		$this->map1to1Item(Ids::BLAZE_POWDER, Items::BLAZE_POWDER());
		$this->map1to1Item(Ids::BLAZE_ROD, Items::BLAZE_ROD());
		$this->map1to1Item(Ids::BLEACH, Items::BLEACH());
		$this->map1to1Item(Ids::BONE, Items::BONE());
		$this->map1to1Item(Ids::BONE_MEAL, Items::BONE_MEAL());
		$this->map1to1Item(Ids::BOOK, Items::BOOK());
		$this->map1to1Item(Ids::BOW, Items::BOW());
		$this->map1to1Item(Ids::BOWL, Items::BOWL());
		$this->map1to1Item(Ids::BREAD, Items::BREAD());
		$this->map1to1Item(Ids::BRICK, Items::BRICK());
		$this->map1to1Item(Ids::BUCKET, Items::BUCKET());
		$this->map1to1Item(Ids::CARROT, Items::CARROT());
		$this->map1to1Item(Ids::CHAINMAIL_BOOTS, Items::CHAINMAIL_BOOTS());
		$this->map1to1Item(Ids::CHAINMAIL_CHESTPLATE, Items::CHAINMAIL_CHESTPLATE());
		$this->map1to1Item(Ids::CHAINMAIL_HELMET, Items::CHAINMAIL_HELMET());
		$this->map1to1Item(Ids::CHAINMAIL_LEGGINGS, Items::CHAINMAIL_LEGGINGS());
		$this->map1to1Item(Ids::CHARCOAL, Items::CHARCOAL());
		$this->map1to1Item(Ids::CHICKEN, Items::RAW_CHICKEN());
		$this->map1to1Item(Ids::CHORUS_FRUIT, Items::CHORUS_FRUIT());
		$this->map1to1Item(Ids::CLAY_BALL, Items::CLAY());
		$this->map1to1Item(Ids::CLOCK, Items::CLOCK());
		$this->map1to1Item(Ids::COAL, Items::COAL());
		$this->map1to1Item(Ids::COCOA_BEANS, Items::COCOA_BEANS());
		$this->map1to1Item(Ids::COD, Items::RAW_FISH());
		$this->map1to1Item(Ids::COMPASS, Items::COMPASS());
		$this->map1to1Item(Ids::COOKED_BEEF, Items::STEAK());
		$this->map1to1Item(Ids::COOKED_CHICKEN, Items::COOKED_CHICKEN());
		$this->map1to1Item(Ids::COOKED_COD, Items::COOKED_FISH());
		$this->map1to1Item(Ids::COOKED_MUTTON, Items::COOKED_MUTTON());
		$this->map1to1Item(Ids::COOKED_PORKCHOP, Items::COOKED_PORKCHOP());
		$this->map1to1Item(Ids::COOKED_RABBIT, Items::COOKED_RABBIT());
		$this->map1to1Item(Ids::COOKED_SALMON, Items::COOKED_SALMON());
		$this->map1to1Item(Ids::COOKIE, Items::COOKIE());
		$this->map1to1Item(Ids::COPPER_INGOT, Items::COPPER_INGOT());
		$this->map1to1Item(Ids::CRIMSON_SIGN, Items::CRIMSON_SIGN());
		$this->map1to1Item(Ids::DARK_OAK_BOAT, Items::DARK_OAK_BOAT());
		$this->map1to1Item(Ids::DARK_OAK_SIGN, Items::DARK_OAK_SIGN());
		$this->map1to1Item(Ids::DIAMOND, Items::DIAMOND());
		$this->map1to1Item(Ids::DIAMOND_AXE, Items::DIAMOND_AXE());
		$this->map1to1Item(Ids::DIAMOND_BOOTS, Items::DIAMOND_BOOTS());
		$this->map1to1Item(Ids::DIAMOND_CHESTPLATE, Items::DIAMOND_CHESTPLATE());
		$this->map1to1Item(Ids::DIAMOND_HELMET, Items::DIAMOND_HELMET());
		$this->map1to1Item(Ids::DIAMOND_HOE, Items::DIAMOND_HOE());
		$this->map1to1Item(Ids::DIAMOND_LEGGINGS, Items::DIAMOND_LEGGINGS());
		$this->map1to1Item(Ids::DIAMOND_PICKAXE, Items::DIAMOND_PICKAXE());
		$this->map1to1Item(Ids::DIAMOND_SHOVEL, Items::DIAMOND_SHOVEL());
		$this->map1to1Item(Ids::DIAMOND_SWORD, Items::DIAMOND_SWORD());
		$this->map1to1Item(Ids::DISC_FRAGMENT_5, Items::DISC_FRAGMENT_5());
		$this->map1to1Item(Ids::DRAGON_BREATH, Items::DRAGON_BREATH());
		$this->map1to1Item(Ids::DRIED_KELP, Items::DRIED_KELP());
		$this->map1to1Item(Ids::ECHO_SHARD, Items::ECHO_SHARD());
		$this->map1to1Item(Ids::EGG, Items::EGG());
		$this->map1to1Item(Ids::EMERALD, Items::EMERALD());
		$this->map1to1Item(Ids::ENCHANTED_GOLDEN_APPLE, Items::ENCHANTED_GOLDEN_APPLE());
		$this->map1to1Item(Ids::ENDER_PEARL, Items::ENDER_PEARL());
		$this->map1to1Item(Ids::EXPERIENCE_BOTTLE, Items::EXPERIENCE_BOTTLE());
		$this->map1to1Item(Ids::FEATHER, Items::FEATHER());
		$this->map1to1Item(Ids::FERMENTED_SPIDER_EYE, Items::FERMENTED_SPIDER_EYE());
		$this->map1to1Item(Ids::FIRE_CHARGE, Items::FIRE_CHARGE());
		$this->map1to1Item(Ids::FISHING_ROD, Items::FISHING_ROD());
		$this->map1to1Item(Ids::FLINT, Items::FLINT());
		$this->map1to1Item(Ids::FLINT_AND_STEEL, Items::FLINT_AND_STEEL());
		$this->map1to1Item(Ids::GHAST_TEAR, Items::GHAST_TEAR());
		$this->map1to1Item(Ids::GLASS_BOTTLE, Items::GLASS_BOTTLE());
		$this->map1to1Item(Ids::GLISTERING_MELON_SLICE, Items::GLISTERING_MELON());
		$this->map1to1Item(Ids::GLOW_BERRIES, Items::GLOW_BERRIES());
		$this->map1to1Item(Ids::GLOW_INK_SAC, Items::GLOW_INK_SAC());
		$this->map1to1Item(Ids::GLOWSTONE_DUST, Items::GLOWSTONE_DUST());
		$this->map1to1Item(Ids::GOLD_INGOT, Items::GOLD_INGOT());
		$this->map1to1Item(Ids::GOLD_NUGGET, Items::GOLD_NUGGET());
		$this->map1to1Item(Ids::GOLDEN_APPLE, Items::GOLDEN_APPLE());
		$this->map1to1Item(Ids::GOLDEN_AXE, Items::GOLDEN_AXE());
		$this->map1to1Item(Ids::GOLDEN_BOOTS, Items::GOLDEN_BOOTS());
		$this->map1to1Item(Ids::GOLDEN_CARROT, Items::GOLDEN_CARROT());
		$this->map1to1Item(Ids::GOLDEN_CHESTPLATE, Items::GOLDEN_CHESTPLATE());
		$this->map1to1Item(Ids::GOLDEN_HELMET, Items::GOLDEN_HELMET());
		$this->map1to1Item(Ids::GOLDEN_HOE, Items::GOLDEN_HOE());
		$this->map1to1Item(Ids::GOLDEN_LEGGINGS, Items::GOLDEN_LEGGINGS());
		$this->map1to1Item(Ids::GOLDEN_PICKAXE, Items::GOLDEN_PICKAXE());
		$this->map1to1Item(Ids::GOLDEN_SHOVEL, Items::GOLDEN_SHOVEL());
		$this->map1to1Item(Ids::GOLDEN_SWORD, Items::GOLDEN_SWORD());
		$this->map1to1Item(Ids::GUNPOWDER, Items::GUNPOWDER());
		$this->map1to1Item(Ids::HEART_OF_THE_SEA, Items::HEART_OF_THE_SEA());
		$this->map1to1Item(Ids::HONEY_BOTTLE, Items::HONEY_BOTTLE());
		$this->map1to1Item(Ids::HONEYCOMB, Items::HONEYCOMB());
		$this->map1to1Item(Ids::INK_SAC, Items::INK_SAC());
		$this->map1to1Item(Ids::IRON_AXE, Items::IRON_AXE());
		$this->map1to1Item(Ids::IRON_BOOTS, Items::IRON_BOOTS());
		$this->map1to1Item(Ids::IRON_CHESTPLATE, Items::IRON_CHESTPLATE());
		$this->map1to1Item(Ids::IRON_HELMET, Items::IRON_HELMET());
		$this->map1to1Item(Ids::IRON_HOE, Items::IRON_HOE());
		$this->map1to1Item(Ids::IRON_INGOT, Items::IRON_INGOT());
		$this->map1to1Item(Ids::IRON_LEGGINGS, Items::IRON_LEGGINGS());
		$this->map1to1Item(Ids::IRON_NUGGET, Items::IRON_NUGGET());
		$this->map1to1Item(Ids::IRON_PICKAXE, Items::IRON_PICKAXE());
		$this->map1to1Item(Ids::IRON_SHOVEL, Items::IRON_SHOVEL());
		$this->map1to1Item(Ids::IRON_SWORD, Items::IRON_SWORD());
		$this->map1to1Item(Ids::JUNGLE_BOAT, Items::JUNGLE_BOAT());
		$this->map1to1Item(Ids::JUNGLE_SIGN, Items::JUNGLE_SIGN());
		$this->map1to1Item(Ids::LAPIS_LAZULI, Items::LAPIS_LAZULI());
		$this->map1to1Item(Ids::LAVA_BUCKET, Items::LAVA_BUCKET());
		$this->map1to1Item(Ids::LEATHER, Items::LEATHER());
		$this->map1to1Item(Ids::LEATHER_BOOTS, Items::LEATHER_BOOTS());
		$this->map1to1Item(Ids::LEATHER_CHESTPLATE, Items::LEATHER_TUNIC());
		$this->map1to1Item(Ids::LEATHER_HELMET, Items::LEATHER_CAP());
		$this->map1to1Item(Ids::LEATHER_LEGGINGS, Items::LEATHER_PANTS());
		$this->map1to1Item(Ids::MAGMA_CREAM, Items::MAGMA_CREAM());
		$this->map1to1Item(Ids::MANGROVE_BOAT, Items::MANGROVE_BOAT());
		$this->map1to1Item(Ids::MANGROVE_SIGN, Items::MANGROVE_SIGN());
		$this->map1to1Item(Ids::MELON_SEEDS, Items::MELON_SEEDS());
		$this->map1to1Item(Ids::MELON_SLICE, Items::MELON());
		$this->map1to1Item(Ids::MILK_BUCKET, Items::MILK_BUCKET());
		$this->map1to1Item(Ids::MINECART, Items::MINECART());
		$this->map1to1Item(Ids::MUSHROOM_STEW, Items::MUSHROOM_STEW());
		$this->map1to1Item(Ids::MUSIC_DISC_11, Items::RECORD_11());
		$this->map1to1Item(Ids::MUSIC_DISC_13, Items::RECORD_13());
		$this->map1to1Item(Ids::MUSIC_DISC_5, Items::RECORD_5());
		$this->map1to1Item(Ids::MUSIC_DISC_BLOCKS, Items::RECORD_BLOCKS());
		$this->map1to1Item(Ids::MUSIC_DISC_CAT, Items::RECORD_CAT());
		$this->map1to1Item(Ids::MUSIC_DISC_CHIRP, Items::RECORD_CHIRP());
		$this->map1to1Item(Ids::MUSIC_DISC_FAR, Items::RECORD_FAR());
		$this->map1to1Item(Ids::MUSIC_DISC_MALL, Items::RECORD_MALL());
		$this->map1to1Item(Ids::MUSIC_DISC_MELLOHI, Items::RECORD_MELLOHI());
		$this->map1to1Item(Ids::MUSIC_DISC_OTHERSIDE, Items::RECORD_OTHERSIDE());
		$this->map1to1Item(Ids::MUSIC_DISC_PIGSTEP, Items::RECORD_PIGSTEP());
		$this->map1to1Item(Ids::MUSIC_DISC_STAL, Items::RECORD_STAL());
		$this->map1to1Item(Ids::MUSIC_DISC_STRAD, Items::RECORD_STRAD());
		$this->map1to1Item(Ids::MUSIC_DISC_WAIT, Items::RECORD_WAIT());
		$this->map1to1Item(Ids::MUSIC_DISC_WARD, Items::RECORD_WARD());
		$this->map1to1Item(Ids::MUTTON, Items::RAW_MUTTON());
		$this->map1to1Item(Ids::NAUTILUS_SHELL, Items::NAUTILUS_SHELL());
		$this->map1to1Item(Ids::NETHER_STAR, Items::NETHER_STAR());
		$this->map1to1Item(Ids::NETHERBRICK, Items::NETHER_BRICK());
		$this->map1to1Item(Ids::NETHERITE_AXE, Items::NETHERITE_AXE());
		$this->map1to1Item(Ids::NETHERITE_BOOTS, Items::NETHERITE_BOOTS());
		$this->map1to1Item(Ids::NETHERITE_CHESTPLATE, Items::NETHERITE_CHESTPLATE());
		$this->map1to1Item(Ids::NETHERITE_HELMET, Items::NETHERITE_HELMET());
		$this->map1to1Item(Ids::NETHERITE_HOE, Items::NETHERITE_HOE());
		$this->map1to1Item(Ids::NETHERITE_INGOT, Items::NETHERITE_INGOT());
		$this->map1to1Item(Ids::NETHERITE_LEGGINGS, Items::NETHERITE_LEGGINGS());
		$this->map1to1Item(Ids::NETHERITE_PICKAXE, Items::NETHERITE_PICKAXE());
		$this->map1to1Item(Ids::NETHERITE_SCRAP, Items::NETHERITE_SCRAP());
		$this->map1to1Item(Ids::NETHERITE_SHOVEL, Items::NETHERITE_SHOVEL());
		$this->map1to1Item(Ids::NETHERITE_SWORD, Items::NETHERITE_SWORD());
		$this->map1to1Item(Ids::OAK_BOAT, Items::OAK_BOAT());
		$this->map1to1Item(Ids::OAK_SIGN, Items::OAK_SIGN());
		$this->map1to1Item(Ids::PAINTING, Items::PAINTING());
		$this->map1to1Item(Ids::PAPER, Items::PAPER());
		$this->map1to1Item(Ids::PHANTOM_MEMBRANE, Items::PHANTOM_MEMBRANE());
		$this->map1to1Item(Ids::POISONOUS_POTATO, Items::POISONOUS_POTATO());
		$this->map1to1Item(Ids::POPPED_CHORUS_FRUIT, Items::POPPED_CHORUS_FRUIT());
		$this->map1to1Item(Ids::PORKCHOP, Items::RAW_PORKCHOP());
		$this->map1to1Item(Ids::POTATO, Items::POTATO());
		$this->map1to1Item(Ids::PRISMARINE_CRYSTALS, Items::PRISMARINE_CRYSTALS());
		$this->map1to1Item(Ids::PRISMARINE_SHARD, Items::PRISMARINE_SHARD());
		$this->map1to1Item(Ids::PUFFERFISH, Items::PUFFERFISH());
		$this->map1to1Item(Ids::PUMPKIN_PIE, Items::PUMPKIN_PIE());
		$this->map1to1Item(Ids::PUMPKIN_SEEDS, Items::PUMPKIN_SEEDS());
		$this->map1to1Item(Ids::QUARTZ, Items::NETHER_QUARTZ());
		$this->map1to1Item(Ids::RABBIT, Items::RAW_RABBIT());
		$this->map1to1Item(Ids::RABBIT_FOOT, Items::RABBIT_FOOT());
		$this->map1to1Item(Ids::RABBIT_HIDE, Items::RABBIT_HIDE());
		$this->map1to1Item(Ids::RABBIT_STEW, Items::RABBIT_STEW());
		$this->map1to1Item(Ids::RAW_COPPER, Items::RAW_COPPER());
		$this->map1to1Item(Ids::RAW_GOLD, Items::RAW_GOLD());
		$this->map1to1Item(Ids::RAW_IRON, Items::RAW_IRON());
		$this->map1to1Item(Ids::REDSTONE, Items::REDSTONE_DUST());
		$this->map1to1Item(Ids::ROTTEN_FLESH, Items::ROTTEN_FLESH());
		$this->map1to1Item(Ids::SALMON, Items::RAW_SALMON());
		$this->map1to1Item(Ids::SCUTE, Items::SCUTE());
		$this->map1to1Item(Ids::SHEARS, Items::SHEARS());
		$this->map1to1Item(Ids::SHULKER_SHELL, Items::SHULKER_SHELL());
		$this->map1to1Item(Ids::SLIME_BALL, Items::SLIMEBALL());
		$this->map1to1Item(Ids::SNOWBALL, Items::SNOWBALL());
		$this->map1to1Item(Ids::SPIDER_EYE, Items::SPIDER_EYE());
		$this->map1to1Item(Ids::SPRUCE_BOAT, Items::SPRUCE_BOAT());
		$this->map1to1Item(Ids::SPRUCE_SIGN, Items::SPRUCE_SIGN());
		$this->map1to1Item(Ids::SPYGLASS, Items::SPYGLASS());
		$this->map1to1Item(Ids::SQUID_SPAWN_EGG, Items::SQUID_SPAWN_EGG());
		$this->map1to1Item(Ids::STICK, Items::STICK());
		$this->map1to1Item(Ids::STONE_AXE, Items::STONE_AXE());
		$this->map1to1Item(Ids::STONE_HOE, Items::STONE_HOE());
		$this->map1to1Item(Ids::STONE_PICKAXE, Items::STONE_PICKAXE());
		$this->map1to1Item(Ids::STONE_SHOVEL, Items::STONE_SHOVEL());
		$this->map1to1Item(Ids::STONE_SWORD, Items::STONE_SWORD());
		$this->map1to1Item(Ids::STRING, Items::STRING());
		$this->map1to1Item(Ids::SUGAR, Items::SUGAR());
		$this->map1to1Item(Ids::SWEET_BERRIES, Items::SWEET_BERRIES());
		$this->map1to1Item(Ids::TOTEM_OF_UNDYING, Items::TOTEM());
		$this->map1to1Item(Ids::TROPICAL_FISH, Items::CLOWNFISH());
		$this->map1to1Item(Ids::TURTLE_HELMET, Items::TURTLE_HELMET());
		$this->map1to1Item(Ids::VILLAGER_SPAWN_EGG, Items::VILLAGER_SPAWN_EGG());
		$this->map1to1Item(Ids::WARPED_SIGN, Items::WARPED_SIGN());
		$this->map1to1Item(Ids::WATER_BUCKET, Items::WATER_BUCKET());
		$this->map1to1Item(Ids::WHEAT, Items::WHEAT());
		$this->map1to1Item(Ids::WHEAT_SEEDS, Items::WHEAT_SEEDS());
		$this->map1to1Item(Ids::WOODEN_AXE, Items::WOODEN_AXE());
		$this->map1to1Item(Ids::WOODEN_HOE, Items::WOODEN_HOE());
		$this->map1to1Item(Ids::WOODEN_PICKAXE, Items::WOODEN_PICKAXE());
		$this->map1to1Item(Ids::WOODEN_SHOVEL, Items::WOODEN_SHOVEL());
		$this->map1to1Item(Ids::WOODEN_SWORD, Items::WOODEN_SWORD());
		$this->map1to1Item(Ids::WRITABLE_BOOK, Items::WRITABLE_BOOK());
		$this->map1to1Item(Ids::WRITTEN_BOOK, Items::WRITTEN_BOOK());
		$this->map1to1Item(Ids::ZOMBIE_SPAWN_EGG, Items::ZOMBIE_SPAWN_EGG());
	}

	/**
	 * Registers mappings for item IDs which map to different PocketMine-MP item types, depending on their meta
	 * values.
	 * This can only be used if the target item type doesn't require any additional properties, since the items are
	 * indexed by their base type ID.
	 */
	private function register1ToNItemMappings() : void{
		$this->map1ToNItem(Ids::ARROW, [
			0 => Items::ARROW(),
			//TODO: tipped arrows
		]);
		$this->map1ToNItem(Ids::COMPOUND, [
			CompoundTypeIds::SALT => Items::CHEMICAL_SALT(),
			CompoundTypeIds::SODIUM_OXIDE => Items::CHEMICAL_SODIUM_OXIDE(),
			CompoundTypeIds::SODIUM_HYDROXIDE => Items::CHEMICAL_SODIUM_HYDROXIDE(),
			CompoundTypeIds::MAGNESIUM_NITRATE => Items::CHEMICAL_MAGNESIUM_NITRATE(),
			CompoundTypeIds::IRON_SULPHIDE => Items::CHEMICAL_IRON_SULPHIDE(),
			CompoundTypeIds::LITHIUM_HYDRIDE => Items::CHEMICAL_LITHIUM_HYDRIDE(),
			CompoundTypeIds::SODIUM_HYDRIDE => Items::CHEMICAL_SODIUM_HYDRIDE(),
			CompoundTypeIds::CALCIUM_BROMIDE => Items::CHEMICAL_CALCIUM_BROMIDE(),
			CompoundTypeIds::MAGNESIUM_OXIDE => Items::CHEMICAL_MAGNESIUM_OXIDE(),
			CompoundTypeIds::SODIUM_ACETATE => Items::CHEMICAL_SODIUM_ACETATE(),
			CompoundTypeIds::LUMINOL => Items::CHEMICAL_LUMINOL(),
			CompoundTypeIds::CHARCOAL => Items::CHEMICAL_CHARCOAL(),
			CompoundTypeIds::SUGAR => Items::CHEMICAL_SUGAR(),
			CompoundTypeIds::ALUMINIUM_OXIDE => Items::CHEMICAL_ALUMINIUM_OXIDE(),
			CompoundTypeIds::BORON_TRIOXIDE => Items::CHEMICAL_BORON_TRIOXIDE(),
			CompoundTypeIds::SOAP => Items::CHEMICAL_SOAP(),
			CompoundTypeIds::POLYETHYLENE => Items::CHEMICAL_POLYETHYLENE(),
			CompoundTypeIds::RUBBISH => Items::CHEMICAL_RUBBISH(),
			CompoundTypeIds::MAGNESIUM_SALTS => Items::CHEMICAL_MAGNESIUM_SALTS(),
			CompoundTypeIds::SULPHATE => Items::CHEMICAL_SULPHATE(),
			CompoundTypeIds::BARIUM_SULPHATE => Items::CHEMICAL_BARIUM_SULPHATE(),
			CompoundTypeIds::POTASSIUM_CHLORIDE => Items::CHEMICAL_POTASSIUM_CHLORIDE(),
			CompoundTypeIds::MERCURIC_CHLORIDE => Items::CHEMICAL_MERCURIC_CHLORIDE(),
			CompoundTypeIds::CERIUM_CHLORIDE => Items::CHEMICAL_CERIUM_CHLORIDE(),
			CompoundTypeIds::TUNGSTEN_CHLORIDE => Items::CHEMICAL_TUNGSTEN_CHLORIDE(),
			CompoundTypeIds::CALCIUM_CHLORIDE => Items::CHEMICAL_CALCIUM_CHLORIDE(),
			CompoundTypeIds::WATER => Items::CHEMICAL_WATER(),
			CompoundTypeIds::GLUE => Items::CHEMICAL_GLUE(),
			CompoundTypeIds::HYPOCHLORITE => Items::CHEMICAL_HYPOCHLORITE(),
			CompoundTypeIds::CRUDE_OIL => Items::CHEMICAL_CRUDE_OIL(),
			CompoundTypeIds::LATEX => Items::CHEMICAL_LATEX(),
			CompoundTypeIds::POTASSIUM_IODIDE => Items::CHEMICAL_POTASSIUM_IODIDE(),
			CompoundTypeIds::SODIUM_FLUORIDE => Items::CHEMICAL_SODIUM_FLUORIDE(),
			CompoundTypeIds::BENZENE => Items::CHEMICAL_BENZENE(),
			CompoundTypeIds::INK => Items::CHEMICAL_INK(),
			CompoundTypeIds::HYDROGEN_PEROXIDE => Items::CHEMICAL_HYDROGEN_PEROXIDE(),
			CompoundTypeIds::AMMONIA => Items::CHEMICAL_AMMONIA(),
			CompoundTypeIds::SODIUM_HYPOCHLORITE => Items::CHEMICAL_SODIUM_HYPOCHLORITE(),
		]);
	}

	/**
	 * Registers mappings for item IDs which map to single blockitems, and have meta values that alter their properties.
	 * TODO: try and make this less ugly; for the most part the logic is symmetrical, it's just difficult to write it
	 * in a unified manner.
	 */
	private function register1to1BlockWithMetaMappings() : void{
		$this->map1to1BlockWithMeta(
			Ids::BED,
			Blocks::BED(),
			function(Bed $block, int $meta) : void{
				$block->setColor(DyeColorIdMap::getInstance()->fromId($meta) ?? throw new ItemTypeDeserializeException("Unknown bed color ID $meta"));
			},
			fn(Bed $block) => DyeColorIdMap::getInstance()->toId($block->getColor())
		);
		$this->map1to1BlockWithMeta(
			Ids::SKULL,
			Blocks::MOB_HEAD(),
			function(MobHead $block, int $meta) : void{
				try{
					$skullType = MobHeadType::fromMagicNumber($meta);
				}catch(\InvalidArgumentException $e){
					throw new ItemTypeDeserializeException($e->getMessage(), 0, $e);
				}
				$block->setMobHeadType($skullType);
			},
			fn(MobHead $block) => $block->getMobHeadType()->getMagicNumber()
		);
	}

	/**
	 * Registers mappings for item IDs which map to single items, and have meta values that alter their properties.
	 * TODO: try and make this less ugly; for the most part the logic is symmetrical, it's just difficult to write it
	 * in a unified manner.
	 */
	private function register1to1ItemWithMetaMappings() : void{
		$this->map1to1ItemWithMeta(
			Ids::BANNER,
			Items::BANNER(),
			function(Banner $item, int $meta) : void{
				$item->setColor(DyeColorIdMap::getInstance()->fromInvertedId($meta) ?? throw new ItemTypeDeserializeException("Unknown banner meta $meta"));
			},
			fn(Banner $item) => DyeColorIdMap::getInstance()->toInvertedId($item->getColor())
		);
		$this->map1to1ItemWithMeta(
			Ids::MEDICINE,
			Items::MEDICINE(),
			function(Medicine $item, int $meta) : void{
				$item->setType(MedicineTypeIdMap::getInstance()->fromId($meta) ?? throw new ItemTypeDeserializeException("Unknown medicine type ID $meta"));
			},
			fn(Medicine $item) => MedicineTypeIdMap::getInstance()->toId($item->getType())
		);
		$this->map1to1ItemWithMeta(
			Ids::POTION,
			Items::POTION(),
			function(Potion $item, int $meta) : void{
				$item->setType(PotionTypeIdMap::getInstance()->fromId($meta) ?? throw new ItemTypeDeserializeException("Unknown potion type ID $meta"));
			},
			fn(Potion $item) => PotionTypeIdMap::getInstance()->toId($item->getType())
		);
		$this->map1to1ItemWithMeta(
			Ids::SPLASH_POTION,
			Items::SPLASH_POTION(),
			function(SplashPotion $item, int $meta) : void{
				$item->setType(PotionTypeIdMap::getInstance()->fromId($meta) ?? throw new ItemTypeDeserializeException("Unknown potion type ID $meta"));
			},
			fn(SplashPotion $item) => PotionTypeIdMap::getInstance()->toId($item->getType())
		);
		$this->map1to1ItemWithMeta(
			Ids::SUSPICIOUS_STEW,
			Items::SUSPICIOUS_STEW(),
			function(SuspiciousStew $item, int $meta) : void{
				$item->setType(SuspiciousStewTypeIdMap::getInstance()->fromId($meta) ?? throw new ItemTypeDeserializeException("Unknown suspicious stew type ID $meta"));
			},
			fn(SuspiciousStew $item) => SuspiciousStewTypeIdMap::getInstance()->toId($item->getType())
		);
	}

	/**
	 * Registers serializers and deserializers for items that don't fit any other pattern.
	 * Ideally we want to get rid of this completely, if possible.
	 *
	 * Most of these are single PocketMine-MP items which map to multiple IDs depending on their properties, which is
	 * complex to implement in a generic way.
	 */
	private function registerMiscItemMappings() : void{
		foreach(DyeColor::getAll() as $color){
			$id = DyeColorIdMap::getInstance()->toItemId($color);
			$this->deserializer?->map($id, fn() => Items::DYE()->setColor($color));
		}
		$this->serializer?->map(Items::DYE(), fn(Dye $item) => new Data(DyeColorIdMap::getInstance()->toItemId($item->getColor())));
	}
}