Release of PacketEvents 2.3.0

Fix reading/writing of JoinGame packet on 1.16/1.16.1

.github/workflows/gradle-publish.yml

@@ -13,16 +13,16 @@ jobs:
     steps:
       - uses: actions/checkout@v3
 
-      - name: Set up JDK 8
+      - name: Set up JDK 17
         uses: actions/setup-java@v3
         with:
-          java-version: '8'
+          java-version: '17'
           distribution: 'adopt'
           server-id: github # Value of the distributionManagement/repository/id field of the pom.xml
           settings-path: ${{ github.workspace }} # location for the settings.xml file
 
       - name: Build with Gradle
-        run: chmod +x gradlew && ./gradlew shadowJar
+        run: chmod +x gradlew && ./gradlew build
 
       - name: Upload build artifacts api
         uses: actions/upload-artifact@v3
@@ -52,4 +52,10 @@ jobs:
         uses: actions/upload-artifact@v3
         with:
           name: velocity-build
-          path: velocity/build/libs
+          path: velocity/build/libs
+
+      - name: Upload build artifacts fabric
+        uses: actions/upload-artifact@v3
+        with:
+          name: fabric-build
+          path: fabric/build/libs

README.md

@@ -13,6 +13,9 @@ our [Discord Server](https://discord.me/packetevents) for help.
 ### Setup
 [How to Setup PacketEvents](https://github.com/retrooper/packetevents/wiki/Depending-on-pre%E2%80%90built-PacketEvents)
 
+### Examples / How to use PacketEvents
+[Example repository](https://github.com/retrooper/packetevents-example)
+
 ### Sponsorships
 [![](https://www.ej-technologies.com/images/product_banners/jprofiler_small.png)](https://www.ej-technologies.com/products/jprofiler/overview.html)
 

api/build.gradle

@@ -1,3 +1,60 @@
+import com.github.retrooper.MappingCompressionTask
+
+// papermc repo + disableAutoTargetJvm needed for mockbukkit
+repositories {
+    maven { url 'https://repo.papermc.io/repository/maven-public/' }
+}
+
+java {
+    disableAutoTargetJvm()
+    sourceSets {
+        main {
+            resources {
+                srcDirs += ["$buildDir.canonicalPath/mappings/generated"]
+            }
+        }
+
+        test {
+            resources {
+                srcDirs += ["$buildDir.canonicalPath/mappings/generated"]
+            }
+        }
+    }
+}
+
 dependencies {
     compileOnly(adventureDependencies)
-}
+
+    testImplementation(adventureDependencies)
+    testImplementation(project(":netty-common"))
+    testImplementation("com.github.seeseemelk:MockBukkit-v1.20:3.9.0")
+    testImplementation("org.slf4j:slf4j-simple:2.0.7")
+    testImplementation("org.junit.jupiter:junit-jupiter-api:5.10.0")
+    testImplementation("org.junit.jupiter:junit-jupiter-engine:5.10.0")
+}
+
+test {
+    useJUnitPlatform()
+}
+
+task generateMapping(type: MappingCompressionTask) {
+    mappingsDir = rootDir.toPath().resolve("mappings")
+    outDir = project.buildDir.toPath().resolve("mappings/generated/assets/mappings")
+    outputs.upToDateWhen {
+        def gen_modified = project.buildDir.toPath().resolve("mappings/generated/assets/mappings").toFile().lastModified()
+        def list = []
+        project.rootProject.projectDir.toPath().resolve("mappings").toFile().eachFileRecurse(groovy.io.FileType.FILES) { file ->
+            list << file
+        }
+
+        for (File file : list) {
+            if (file.lastModified() > gen_modified) {
+                return false
+            }
+        }
+
+        return true
+    }
+}
+
+tasks.processResources.dependsOn(generateMapping)

api/src/main/java/com/github/retrooper/packetevents/PacketEventsAPI.java

@@ -38,7 +38,7 @@ public abstract class PacketEventsAPI<T> {
     private final Logger LOGGER = Logger.getLogger(PacketEventsAPI.class.getName());
     private static final LogManager LOG_MANAGER = new LogManager();
     //TODO UPDATE
-    private static final PEVersion VERSION = new PEVersion(2, 2, 0);
+    private static final PEVersion VERSION = new PEVersion(2, 3, 0);
     
     public EventManager getEventManager() {
         return EVENT_MANAGER;

api/src/main/java/com/github/retrooper/packetevents/event/EventManager.java

@@ -22,13 +22,13 @@ import com.github.retrooper.packetevents.PacketEvents;
 import com.github.retrooper.packetevents.exception.InvalidHandshakeException;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.Map;
-import java.util.Set;
+import java.util.*;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.logging.Level;
 
 public class EventManager {
-    private final Map<Byte, Set<PacketListenerCommon>> listenersMap = new ConcurrentHashMap<>();
+    private final Map<PacketListenerPriority, Set<PacketListenerCommon>> listenersMap =
+            Collections.synchronizedMap(new EnumMap<>(PacketListenerPriority.class));
 
     /**
      * Call the PacketEvent.
@@ -44,7 +44,7 @@ public class EventManager {
     }
 
     public void callEvent(PacketEvent event, @Nullable Runnable postCallListenerAction) {
-        for (byte priority = PacketListenerPriority.LOWEST.getId(); priority <= PacketListenerPriority.MONITOR.getId(); priority++) {
+        for (PacketListenerPriority priority : PacketListenerPriority.values()) {
             Set<PacketListenerCommon> listeners = listenersMap.get(priority);
             if (listeners != null) {
                 for (PacketListenerCommon listener : listeners) {
@@ -80,13 +80,12 @@ public class EventManager {
      * @param listener {@link PacketListenerCommon}
      */
     public PacketListenerCommon registerListener(PacketListenerCommon listener) {
-        byte priority = listener.getPriority().getId();
-        Set<PacketListenerCommon> listenerSet = listenersMap.get(priority);
+        Set<PacketListenerCommon> listenerSet = listenersMap.get(listener.getPriority());
         if (listenerSet == null) {
             listenerSet = ConcurrentHashMap.newKeySet();
         }
         listenerSet.add(listener);
-        listenersMap.put(priority, listenerSet);
+        listenersMap.put(listener.getPriority(), listenerSet);
         return listener;
     }
 
@@ -103,7 +102,7 @@ public class EventManager {
     }
 
     public void unregisterListener(PacketListenerCommon listener) {
-        Set<PacketListenerCommon> listenerSet = listenersMap.get(listener.getPriority().getId());
+        Set<PacketListenerCommon> listenerSet = listenersMap.get(listener.getPriority());
         if (listenerSet == null) return;
         listenerSet.remove(listener);
     }

api/src/main/java/com/github/retrooper/packetevents/manager/InternalPacketListener.java

@@ -27,21 +27,30 @@ import com.github.retrooper.packetevents.manager.protocol.ProtocolManager;
 import com.github.retrooper.packetevents.manager.server.ServerVersion;
 import com.github.retrooper.packetevents.protocol.ConnectionState;
 import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.protocol.nbt.NBTInt;
 import com.github.retrooper.packetevents.protocol.nbt.NBTList;
+import com.github.retrooper.packetevents.protocol.nbt.NBTString;
+import com.github.retrooper.packetevents.protocol.nbt.NBTType;
 import com.github.retrooper.packetevents.protocol.packettype.PacketType;
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.protocol.player.User;
 import com.github.retrooper.packetevents.protocol.player.UserProfile;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
 import com.github.retrooper.packetevents.wrapper.configuration.server.WrapperConfigServerRegistryData;
+import com.github.retrooper.packetevents.wrapper.configuration.server.WrapperConfigServerRegistryData.RegistryElement;
 import com.github.retrooper.packetevents.wrapper.handshaking.client.WrapperHandshakingClientHandshake;
 import com.github.retrooper.packetevents.wrapper.login.server.WrapperLoginServerLoginSuccess;
 import com.github.retrooper.packetevents.wrapper.play.server.WrapperPlayServerJoinGame;
 import com.github.retrooper.packetevents.wrapper.play.server.WrapperPlayServerRespawn;
 
 import java.net.InetSocketAddress;
+import java.util.List;
 
 public class InternalPacketListener extends PacketListenerAbstract {
 
+    private static final ResourceLocation DIMENSION_TYPE_REGISTRY_KEY =
+            ResourceLocation.minecraft("dimension_type");
+
     public InternalPacketListener() {
         this(PacketListenerPriority.LOWEST);
     }
@@ -89,10 +98,29 @@ public class InternalPacketListener extends PacketListenerAbstract {
 
             // Store world data
             NBTCompound registryDataTag = registryData.getRegistryData();
-            if (registryDataTag != null) {
-                NBTList<NBTCompound> list = registryDataTag
-                        .getCompoundTagOrNull("minecraft:dimension_type")
+            NBTList<NBTCompound> list = null;
+            if (registryDataTag != null) { // <1.20.5
+                list = registryDataTag
+                        .getCompoundTagOrNull(DIMENSION_TYPE_REGISTRY_KEY.toString())
                         .getCompoundListTagOrNull("value");
+            } else if (DIMENSION_TYPE_REGISTRY_KEY.equals(registryData.getRegistryKey())) { // >=1.20.5
+                // remap to legacy format
+                list = new NBTList<>(NBTType.COMPOUND);
+                List<RegistryElement> elements = registryData.getElements();
+                if (elements != null) {
+                    int i = 0;
+                    for (RegistryElement element : elements) {
+                        NBTCompound tag = new NBTCompound();
+                        tag.setTag("name", new NBTString(element.getId().toString()));
+                        tag.setTag("id", new NBTInt(i++));
+                        if (element.getData() != null) { // may be null because of known packs not being sent
+                            tag.setTag("element", element.getData());
+                        }
+                        list.addTag(tag);
+                    }
+                }
+            }
+            if (list != null) {
                 user.setWorldNBT(list);
             }
         }
@@ -110,18 +138,13 @@ public class InternalPacketListener extends PacketListenerAbstract {
             NBTCompound dimensionCodec = joinGame.getDimensionCodec();
             if (dimensionCodec != null) {
                 NBTList<NBTCompound> list = dimensionCodec
-                        .getCompoundTagOrNull("minecraft:dimension_type")
+                        .getCompoundTagOrNull(DIMENSION_TYPE_REGISTRY_KEY.toString())
                         .getCompoundListTagOrNull("value");
                 user.setWorldNBT(list);
             }
 
             // Update world height
-            NBTCompound dimension = user.getWorldNBT(joinGame.getDimension().getDimensionName());
-            if (dimension != null) {
-                NBTCompound worldNBT = dimension.getCompoundTagOrNull("element");
-                user.setMinWorldHeight(worldNBT.getNumberTagOrNull("min_y").getAsInt());
-                user.setTotalWorldHeight(worldNBT.getNumberTagOrNull("height").getAsInt());
-            }
+            user.switchDimensionType(joinGame.getServerVersion(), joinGame.getDimension());
         }
 
         // Respawn is used to switch dimensions
@@ -132,12 +155,7 @@ public class InternalPacketListener extends PacketListenerAbstract {
                 return; // Fixed world height, no tags are sent to the client
             }
 
-            NBTCompound dimension = user.getWorldNBT(respawn.getDimension().getDimensionName());
-            if (dimension != null) {
-                NBTCompound worldNBT = dimension.getCompoundTagOrNull("element"); // This is 1.17+, it always sends the world name
-                user.setMinWorldHeight(worldNBT.getNumberTagOrNull("min_y").getAsInt());
-                user.setTotalWorldHeight(worldNBT.getNumberTagOrNull("height").getAsInt());
-            }
+            user.switchDimensionType(respawn.getServerVersion(), respawn.getDimension());
         } else if (event.getPacketType() == PacketType.Play.Server.CONFIGURATION_START) {
             user.setEncoderState(ConnectionState.CONFIGURATION);
         } else if (event.getPacketType() == PacketType.Configuration.Server.CONFIGURATION_END) {

api/src/main/java/com/github/retrooper/packetevents/manager/server/ServerVersion.java

@@ -47,8 +47,8 @@ public enum ServerVersion {
     V_1_18(757), V_1_18_1(757), V_1_18_2(758),
     //1.19.1 and 1.19.2 have the same protocol version
     V_1_19(759), V_1_19_1(760), V_1_19_2(760), V_1_19_3(761), V_1_19_4(762),
-    //1.20 and 1.20.1 have the same protocol version. 1.20.3 and 1.20.4 have the same protocol version.
-    V_1_20(763), V_1_20_1(763), V_1_20_2(764), V_1_20_3(765), V_1_20_4(765),
+    //1.20 and 1.20.1 have the same protocol version. 1.20.3 and 1.20.4 have the same protocol version. 1.20.5 and 1.20.6 have the same protocol version
+    V_1_20(763), V_1_20_1(763), V_1_20_2(764), V_1_20_3(765), V_1_20_4(765), V_1_20_5(766), V_1_20_6(766),
     //TODO UPDATE Add server version constant
     ERROR(-1, true);
 

api/src/main/java/com/github/retrooper/packetevents/netty/buffer/ByteBufInputStream.java

@@ -18,6 +18,8 @@
 
 package com.github.retrooper.packetevents.netty.buffer;
 
+import com.github.retrooper.packetevents.exception.PacketProcessException;
+
 import java.io.*;
 //TODO give netty credit
 public class ByteBufInputStream extends InputStream implements DataInput {
@@ -204,7 +206,8 @@ public class ByteBufInputStream extends InputStream implements DataInput {
     }
 
     public String readUTF() throws IOException {
-        return DataInputStream.readUTF(this);
+        String text = DataInputStream.readUTF(this);
+        return text;
     }
 
     public int readUnsignedByte() throws IOException {
@@ -225,7 +228,14 @@ public class ByteBufInputStream extends InputStream implements DataInput {
         if (fieldSize < 0) {
             throw new IndexOutOfBoundsException("fieldSize cannot be a negative number");
         } else if (fieldSize > this.available()) {
-            throw new EOFException("fieldSize is too long! Length is " + fieldSize + ", but maximum is " + this.available());
+            int value = this.available();
+            String msg = "fieldSize is too long! Length is " + fieldSize + ", but maximum is " + value;
+            if (value == 0) {
+                throw new PacketProcessException(msg);
+            }
+            else {
+                throw new EOFException(msg);
+            }
         }
     }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/attribute/Attribute.java

@@ -0,0 +1,24 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2023 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.attribute;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+
+public interface Attribute extends MappedEntity {
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/attribute/AttributeOperation.java

@@ -0,0 +1,25 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.attribute;
+
+public enum AttributeOperation {
+    ADDITION,
+    MULTIPLY_BASE,
+    MULTIPLY_TOTAL,
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/attribute/Attributes.java

@@ -0,0 +1,106 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2023 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.attribute;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+import org.jetbrains.annotations.ApiStatus;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class Attributes {
+
+    private static final Map<String, Attribute> ATTRIBUTE_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, Attribute>> ATTRIBUTE_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("attribute/attribute_mappings");
+
+    public static Attribute define(String key) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        Attribute attribute = new Attribute() {
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return MappingHelper.getId(version, TYPES_BUILDER, data);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof Attribute) {
+                    return this.getName().equals(((Attribute) obj).getName());
+                }
+                return false;
+            }
+        };
+
+        MappingHelper.registerMapping(TYPES_BUILDER, ATTRIBUTE_MAP, ATTRIBUTE_ID_MAP, attribute);
+        return attribute;
+    }
+
+    // with minecraft:key
+    public static Attribute getByName(String name) {
+        return ATTRIBUTE_MAP.get(name);
+    }
+
+    public static Attribute getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, Attribute> idMap = ATTRIBUTE_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    public static final Attribute GENERIC_ARMOR = define("generic.armor");
+    public static final Attribute GENERIC_ARMOR_TOUGHNESS = define("generic.armor_toughness");
+    public static final Attribute GENERIC_ATTACK_DAMAGE = define("generic.attack_damage");
+    public static final Attribute GENERIC_ATTACK_KNOCKBACK = define("generic.attack_knockback");
+    public static final Attribute GENERIC_ATTACK_SPEED = define("generic.attack_speed");
+    public static final Attribute GENERIC_FLYING_SPEED = define("generic.flying_speed");
+    public static final Attribute GENERIC_FOLLOW_RANGE = define("generic.follow_range");
+    @ApiStatus.Obsolete // renamed in 1.20.5
+    public static final Attribute HORSE_JUMP_STRENGTH = define("horse.jump_strength");
+    public static final Attribute GENERIC_KNOCKBACK_RESISTANCE = define("generic.knockback_resistance");
+    public static final Attribute GENERIC_LUCK = define("generic.luck");
+    public static final Attribute GENERIC_MAX_HEALTH = define("generic.max_health");
+    public static final Attribute GENERIC_MOVEMENT_SPEED = define("generic.movement_speed");
+    public static final Attribute ZOMBIE_SPAWN_REINFORCEMENTS = define("zombie.spawn_reinforcements");
+
+    // Added in 1.20.2
+    public static final Attribute GENERIC_MAX_ABSORPTION = define("generic.max_absorption");
+
+    // added in 1.20.5
+    public static final Attribute PLAYER_BLOCK_BREAK_SPEED = define("player.block_break_speed");
+    public static final Attribute PLAYER_BLOCK_INTERACTION_RANGE = define("player.block_interaction_range");
+    public static final Attribute PLAYER_ENTITY_INTERACTION_RANGE = define("player.entity_interaction_range");
+    public static final Attribute GENERIC_FALL_DAMAGE_MULTIPLIER = define("generic.fall_damage_multiplier");
+    public static final Attribute GENERIC_GRAVITY = define("generic.gravity");
+    public static final Attribute GENERIC_JUMP_STRENGTH = define("generic.jump_strength");
+    public static final Attribute GENERIC_SAFE_FALL_DISTANCE = define("generic.safe_fall_distance");
+    public static final Attribute GENERIC_SCALE = define("generic.scale");
+    public static final Attribute GENERIC_STEP_HEIGHT = define("generic.step_height");
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/ChatTypes.java

@@ -20,8 +20,9 @@ package com.github.retrooper.packetevents.protocol.chat;
 
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.resources.ResourceLocation;
-import com.github.retrooper.packetevents.util.TypesBuilder;
-import com.github.retrooper.packetevents.util.TypesBuilderData;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
 
 import java.util.HashMap;
 import java.util.Map;
@@ -30,20 +31,11 @@ public class ChatTypes {
     private static final Map<String, ChatType> CHAT_TYPE_MAP = new HashMap<>();
     //Key - mappings version, value - map with chat type ids and chat types
     private static final Map<Byte, Map<Integer, ChatType>> CHAT_TYPE_ID_MAP = new HashMap<>();
-    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("chat/chat_type_mappings",
-            ClientVersion.V_1_18_2,
-            ClientVersion.V_1_19,
-            ClientVersion.V_1_19_1);
-
-    static {
-        TYPES_BUILDER.unloadFileMappings();
-    }
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("chat/chat_type_mappings");
 
     public static ChatType define(String key) {
         TypesBuilderData data = TYPES_BUILDER.define(key);
         ChatType chatType = new ChatType() {
-            private final int[] ids = data.getData();
-
             @Override
             public ResourceLocation getName() {
                 return data.getName();
@@ -51,16 +43,10 @@ public class ChatTypes {
 
             @Override
             public int getId(ClientVersion version) {
-                int index = TYPES_BUILDER.getDataIndex(version);
-                return ids[index];
+                return MappingHelper.getId(version, TYPES_BUILDER, data);
             }
         };
-        CHAT_TYPE_MAP.put(chatType.getName().toString(), chatType);
-        for (ClientVersion version : TYPES_BUILDER.getVersions()) {
-            int index = TYPES_BUILDER.getDataIndex(version);
-            Map<Integer, ChatType> typeIdMap = CHAT_TYPE_ID_MAP.computeIfAbsent((byte) index, k -> new HashMap<>());
-            typeIdMap.put(chatType.getId(version), chatType);
-        }
+        MappingHelper.registerMapping(TYPES_BUILDER, CHAT_TYPE_MAP, CHAT_TYPE_ID_MAP, chatType);
         return chatType;
     }
 
@@ -91,4 +77,8 @@ public class ChatTypes {
     public static final ChatType MSG_COMMAND = define("msg_command");
     @Deprecated
     public static final ChatType TEAM_MSG_COMMAND = define("team_msg_command");
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/Node.java

@@ -28,16 +28,16 @@ import java.util.Optional;
 public class Node {
     private byte flags;
     private List<Integer> children;
-    private Optional<Integer> redirectNodeIndex;
+    private int redirectNodeIndex;
     private Optional<String> name;
     private Optional<Integer> parserID;
     private Optional<List<Object>> properties;
     private Optional<ResourceLocation> suggestionsType;
 
-    public Node(byte flags, List<Integer> children, @Nullable Integer redirectNodeIndex, @Nullable String name, @Nullable Integer parserID, @Nullable List<Object> properties, @Nullable ResourceLocation suggestionsType) {
+    public Node(byte flags, List<Integer> children, int redirectNodeIndex, @Nullable String name, @Nullable Integer parserID, @Nullable List<Object> properties, @Nullable ResourceLocation suggestionsType) {
         this.flags = flags;
         this.children = children;
-        this.redirectNodeIndex = Optional.ofNullable(redirectNodeIndex);
+        this.redirectNodeIndex = redirectNodeIndex;
         this.name = Optional.ofNullable(name);
         this.parserID = Optional.ofNullable(parserID);
         this.properties = Optional.ofNullable(properties);
@@ -60,11 +60,11 @@ public class Node {
         this.children = children;
     }
 
-    public Optional<Integer> getRedirectNodeIndex() {
+    public int getRedirectNodeIndex() {
         return redirectNodeIndex;
     }
 
-    public void setRedirectNodeIndex(Optional<Integer> redirectNodeIndex) {
+    public void setRedirectNodeIndex(int redirectNodeIndex) {
         this.redirectNodeIndex = redirectNodeIndex;
     }
 

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/Parsers.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2022 retrooper and contributors
+ * Copyright (C) 2024 retrooper and contributors
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -16,171 +16,260 @@
  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  */
 
-
 package com.github.retrooper.packetevents.protocol.chat;
 
+import com.github.retrooper.packetevents.manager.server.ServerVersion;
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
 import com.github.retrooper.packetevents.wrapper.PacketWrapper;
 import org.jetbrains.annotations.Nullable;
 
+import java.util.ArrayList;
 import java.util.Arrays;
 import java.util.Collections;
+import java.util.HashMap;
 import java.util.List;
+import java.util.Map;
 import java.util.Optional;
 import java.util.function.BiConsumer;
 import java.util.function.Function;
 
 public class Parsers {
-    private static final List<Parser> parsers = Arrays.asList(
-            new Parser("brigadier:bool", null, null),
-            new Parser("brigadier:float",
-                    packetWrapper -> {
-                        byte flags = packetWrapper.readByte();
-                        float min = (flags & 0x01) != 0 ? packetWrapper.readFloat() : -Float.MAX_VALUE;
-                        float max = (flags & 0x02) != 0 ? packetWrapper.readFloat() : Float.MAX_VALUE;
-                        return Arrays.asList(flags, min, max);
-                    },
-                    (packetWrapper, properties) -> {
-                        byte flags = (byte) properties.get(0);
-                        packetWrapper.writeByte(flags);
-                        if ((flags & 0x01) != 0) packetWrapper.writeFloat((float) properties.get(1));
-                        if ((flags & 0x02) != 0) packetWrapper.writeFloat((float) properties.get(2));
-                    }
-            ),
-            new Parser("brigadier:double",
-                    packetWrapper -> {
-                        byte flags = packetWrapper.readByte();
-                        double min = (flags & 0x01) != 0 ? packetWrapper.readDouble() : -Double.MAX_VALUE;
-                        double max = (flags & 0x02) != 0 ? packetWrapper.readDouble() : Double.MAX_VALUE;
-                        return Arrays.asList(flags, min, max);
-                    },
-                    (packetWrapper, properties) -> {
-                        byte flags = (byte) properties.get(0);
-                        packetWrapper.writeByte(flags);
-                        if ((flags & 0x01) != 0) packetWrapper.writeDouble((double) properties.get(1));
-                        if ((flags & 0x02) != 0) packetWrapper.writeDouble((double) properties.get(2));
-                    }
-            ),
-            new Parser("brigadier:integer",
-                    packetWrapper -> {
-                        byte flags = packetWrapper.readByte();
-                        int min = (flags & 0x01) != 0 ? packetWrapper.readInt() : Integer.MIN_VALUE;
-                        int max = (flags & 0x02) != 0 ? packetWrapper.readInt() : Integer.MAX_VALUE;
-                        return Arrays.asList(flags, min, max);
-                    },
-                    (packetWrapper, properties) -> {
-                        byte flags = (byte) properties.get(0);
-                        packetWrapper.writeByte(flags);
-                        if ((flags & 0x01) != 0) packetWrapper.writeInt((int) properties.get(1));
-                        if ((flags & 0x02) != 0) packetWrapper.writeInt((int) properties.get(2));
-                    }
-            ),
-            new Parser("brigadier:long",
-                    packetWrapper -> {
-                        byte flags = packetWrapper.readByte();
-                        long min = (flags & 0x01) != 0 ? packetWrapper.readLong() : Long.MIN_VALUE;
-                        long max = (flags & 0x02) != 0 ? packetWrapper.readLong() : Long.MAX_VALUE;
-                        return Arrays.asList(flags, min, max);
-                    },
-                    (packetWrapper, properties) -> {
-                        byte flags = (byte) properties.get(0);
-                        packetWrapper.writeByte(flags);
-                        if ((flags & 0x01) != 0) packetWrapper.writeLong((long) properties.get(1));
-                        if ((flags & 0x02) != 0) packetWrapper.writeLong((long) properties.get(2));
-                    }
-            ),
-            new Parser("brigadier:string",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readVarInt()),
-                    (packetWrapper, properties) -> packetWrapper.writeVarInt((Integer) properties.get(0))
-            ),
-            new Parser("minecraft:entity",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readByte()),
-                    (packetWrapper, properties) -> packetWrapper.writeByte(((Byte) properties.get(0)).intValue())
-            ),
-            new Parser("minecraft:game_profile", null, null),
-            new Parser("minecraft:block_pos", null, null),
-            new Parser("minecraft:column_pos", null, null),
-            new Parser("minecraft:vec3", null, null),
-            new Parser("minecraft:vec2", null, null),
-            new Parser("minecraft:block_state", null, null),
-            new Parser("minecraft:block_predicate", null, null),
-            new Parser("minecraft:item_stack", null, null),
-            new Parser("minecraft:item_predicate", null, null),
-            new Parser("minecraft:color", null, null),
-            new Parser("minecraft:component", null, null),
-            new Parser("minecraft:style", null, null),
-            new Parser("minecraft:message", null, null),
-            new Parser("minecraft:nbt", null, null),
-            new Parser("minecraft:nbt_tag", null, null),
-            new Parser("minecraft:nbt_path", null, null),
-            new Parser("minecraft:objective", null, null),
-            new Parser("minecraft:objective_criteria", null, null),
-            new Parser("minecraft:operation", null, null),
-            new Parser("minecraft:particle", null, null),
-            new Parser("minecraft:angle", null, null),
-            new Parser("minecraft:rotation", null, null),
-            new Parser("minecraft:scoreboard_slot", null, null),
-            new Parser("minecraft:score_holder",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readByte()),
-                    (packetWrapper, properties) -> packetWrapper.writeByte(((Byte) properties.get(0)).intValue())
-            ),
-            new Parser("minecraft:swizzle", null, null),
-            new Parser("minecraft:team", null, null),
-            new Parser("minecraft:item_slot", null, null),
-            new Parser("minecraft:resource_location", null, null),
-            new Parser("minecraft:function", null, null),
-            new Parser("minecraft:entity_anchor", null, null),
-            new Parser("minecraft:int_range", null, null),
-            new Parser("minecraft:float_range", null, null),
-            new Parser("minecraft:dimension", null, null),
-            new Parser("minecraft:gamemode", null, null),
-            new Parser("minecraft:time",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readInt()),
-                    (packetWrapper, properties) -> packetWrapper.writeInt((int) properties.get(0))
-            ),
-            new Parser("minecraft:resource_or_tag",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
-                    (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
-            ),
-            new Parser("minecraft:resource_or_tag_key",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
-                    (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
-            ),
-            new Parser("minecraft:resource",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
-                    (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
-            ),
-            new Parser("minecraft:resource_key",
-                    packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
-                    (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
-            ),
-            new Parser("minecraft:template_mirror", null, null),
-            new Parser("minecraft:template_rotation", null, null),
-            new Parser("minecraft:heightmap", null, null),
-            new Parser("minecraft:uuid", null, null)
-    );
 
-    public static List<Parser> getParsers() {
-        return parsers;
+    private static final List<Parser> ALL_PARSERS = new ArrayList<>(); // support for old methods
+    private static final Map<String, Parser> PARSER_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, Parser>> PARSER_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("command/argument_parser_mappings");
+
+    public static Parser define(String key) {
+        return define(key, null, null);
     }
 
-    public static final class Parser {
-        private final String name; //not really needed, just for toString or something
-        private final Optional<Function<PacketWrapper<?>, List<Object>>> read;
-        private final Optional<BiConsumer<PacketWrapper<?>, List<Object>>> write;
+    public static Parser define(String key, @Nullable Reader reader, @Nullable Writer writer) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        Parser parser = new Parser(data, reader, writer);
 
+        ALL_PARSERS.add(parser);
+        MappingHelper.registerMapping(TYPES_BUILDER, PARSER_MAP, PARSER_ID_MAP, parser);
+        return parser;
+    }
+
+    // with key
+    public static Parser getByName(String name) {
+        return PARSER_MAP.get(name);
+    }
+
+    public static Parser getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, Parser> idMap = PARSER_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    public static List<Parser> getParsers() {
+        return Collections.unmodifiableList(ALL_PARSERS);
+    }
+
+    public static final Parser BRIGADIER_BOOL = define("brigadier:bool", null, null);
+    public static final Parser BRIGADIER_FLOAT = define("brigadier:float",
+            packetWrapper -> {
+                byte flags = packetWrapper.readByte();
+                float min = (flags & 0x01) != 0 ? packetWrapper.readFloat() : -Float.MAX_VALUE;
+                float max = (flags & 0x02) != 0 ? packetWrapper.readFloat() : Float.MAX_VALUE;
+                return Arrays.asList(flags, min, max);
+            },
+            (packetWrapper, properties) -> {
+                byte flags = (byte) properties.get(0);
+                packetWrapper.writeByte(flags);
+                if ((flags & 0x01) != 0) packetWrapper.writeFloat((float) properties.get(1));
+                if ((flags & 0x02) != 0) packetWrapper.writeFloat((float) properties.get(2));
+            }
+    );
+    public static final Parser BRIGADIER_DOUBLE = define("brigadier:double",
+            packetWrapper -> {
+                byte flags = packetWrapper.readByte();
+                double min = (flags & 0x01) != 0 ? packetWrapper.readDouble() : -Double.MAX_VALUE;
+                double max = (flags & 0x02) != 0 ? packetWrapper.readDouble() : Double.MAX_VALUE;
+                return Arrays.asList(flags, min, max);
+            },
+            (packetWrapper, properties) -> {
+                byte flags = (byte) properties.get(0);
+                packetWrapper.writeByte(flags);
+                if ((flags & 0x01) != 0) packetWrapper.writeDouble((double) properties.get(1));
+                if ((flags & 0x02) != 0) packetWrapper.writeDouble((double) properties.get(2));
+            }
+    );
+    public static final Parser BRIGADIER_INTEGER = define("brigadier:integer",
+            packetWrapper -> {
+                byte flags = packetWrapper.readByte();
+                int min = (flags & 0x01) != 0 ? packetWrapper.readInt() : Integer.MIN_VALUE;
+                int max = (flags & 0x02) != 0 ? packetWrapper.readInt() : Integer.MAX_VALUE;
+                return Arrays.asList(flags, min, max);
+            },
+            (packetWrapper, properties) -> {
+                byte flags = (byte) properties.get(0);
+                packetWrapper.writeByte(flags);
+                if ((flags & 0x01) != 0) packetWrapper.writeInt((int) properties.get(1));
+                if ((flags & 0x02) != 0) packetWrapper.writeInt((int) properties.get(2));
+            }
+    );
+    public static final Parser BRIGADIER_LONG = define("brigadier:long",
+            packetWrapper -> {
+                byte flags = packetWrapper.readByte();
+                long min = (flags & 0x01) != 0 ? packetWrapper.readLong() : Long.MIN_VALUE;
+                long max = (flags & 0x02) != 0 ? packetWrapper.readLong() : Long.MAX_VALUE;
+                return Arrays.asList(flags, min, max);
+            },
+            (packetWrapper, properties) -> {
+                byte flags = (byte) properties.get(0);
+                packetWrapper.writeByte(flags);
+                if ((flags & 0x01) != 0) packetWrapper.writeLong((long) properties.get(1));
+                if ((flags & 0x02) != 0) packetWrapper.writeLong((long) properties.get(2));
+            }
+    );
+    public static final Parser BRIGADIER_STRING = define("brigadier:string",
+            packetWrapper -> Collections.singletonList(packetWrapper.readVarInt()),
+            (packetWrapper, properties) -> packetWrapper.writeVarInt((Integer) properties.get(0))
+    );
+    public static final Parser ENTITY = define("entity",
+            packetWrapper -> Collections.singletonList(packetWrapper.readByte()),
+            (packetWrapper, properties) -> packetWrapper.writeByte(((Byte) properties.get(0)).intValue())
+    );
+    public static final Parser GAME_PROFILE = define("game_profile", null, null);
+    public static final Parser BLOCK_POS = define("block_pos", null, null);
+    public static final Parser COLUMN_POS = define("column_pos", null, null);
+    public static final Parser VEC3 = define("vec3", null, null);
+    public static final Parser VEC2 = define("vec2", null, null);
+    public static final Parser BLOCK_STATE = define("block_state", null, null);
+    public static final Parser BLOCK_PREDICATE = define("block_predicate", null, null);
+    public static final Parser ITEM_STACK = define("item_stack", null, null);
+    public static final Parser ITEM_PREDICATE = define("item_predicate", null, null);
+    public static final Parser COLOR = define("color", null, null);
+    public static final Parser COMPONENT = define("component", null, null);
+    public static final Parser STYLE = define("style", null, null);
+    public static final Parser MESSAGE = define("message", null, null);
+    public static final Parser NBT = define("nbt", null, null);
+    public static final Parser NBT_TAG = define("nbt_tag", null, null);
+    public static final Parser NBT_PATH = define("nbt_path", null, null);
+    public static final Parser OBJECTIVE = define("objective", null, null);
+    public static final Parser OBJECTIVE_CRITERIA = define("objective_criteria", null, null);
+    public static final Parser OPERATION = define("operation", null, null);
+    public static final Parser PARTICLE = define("particle", null, null);
+    public static final Parser ANGLE = define("angle", null, null);
+    public static final Parser ROTATION = define("rotation", null, null);
+    public static final Parser SCOREBOARD_SLOT = define("scoreboard_slot", null, null);
+    public static final Parser SCORE_HOLDER = define("score_holder",
+            packetWrapper -> Collections.singletonList(packetWrapper.readByte()),
+            (packetWrapper, properties) -> packetWrapper.writeByte(((Byte) properties.get(0)).intValue())
+    );
+    public static final Parser SWIZZLE = define("swizzle", null, null);
+    public static final Parser TEAM = define("team", null, null);
+    public static final Parser ITEM_SLOT = define("item_slot", null, null);
+    public static final Parser ITEM_SLOTS = define("item_slots", null, null);
+    public static final Parser RESOURCE_LOCATION = define("resource_location", null, null);
+    public static final Parser FUNCTION = define("function", null, null);
+    public static final Parser ENTITY_ANCHOR = define("entity_anchor", null, null);
+    public static final Parser INT_RANGE = define("int_range", null, null);
+    public static final Parser FLOAT_RANGE = define("float_range", null, null);
+    public static final Parser DIMENSION = define("dimension", null, null);
+    public static final Parser GAMEMODE = define("gamemode", null, null);
+    public static final Parser TIME = define("time",
+            wrapper -> Collections.singletonList(wrapper.getServerVersion()
+                    .isNewerThanOrEquals(ServerVersion.V_1_19_4) ? wrapper.readInt() : 0),
+            (wrapper, properties) -> {
+                if (wrapper.getServerVersion().isNewerThanOrEquals(ServerVersion.V_1_19_4)) {
+                    wrapper.writeInt((int) properties.get(0));
+                }
+            }
+    );
+    public static final Parser RESOURCE_OR_TAG = define("resource_or_tag",
+            packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
+            (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
+    );
+    public static final Parser RESOURCE_OR_TAG_KEY = define("resource_or_tag_key",
+            packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
+            (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
+    );
+    public static final Parser RESOURCE = define("resource",
+            packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
+            (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
+    );
+    public static final Parser RESOURCE_KEY = define("resource_key",
+            packetWrapper -> Collections.singletonList(packetWrapper.readIdentifier()),
+            (packetWrapper, properties) -> packetWrapper.writeIdentifier((ResourceLocation) properties.get(0))
+    );
+    public static final Parser TEMPLATE_MIRROR = define("template_mirror", null, null);
+    public static final Parser TEMPLATE_ROTATION = define("template_rotation", null, null);
+    public static final Parser HEIGHTMAP = define("heightmap", null, null);
+    public static final Parser LOOT_TABLE = define("loot_table", null, null);
+    public static final Parser LOOT_PREDICATE = define("loot_predicate", null, null);
+    public static final Parser LOOT_MODIFIER = define("loot_modifier", null, null);
+    public static final Parser UUID = define("uuid", null, null);
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+
+    @FunctionalInterface
+    public interface Reader extends Function<PacketWrapper<?>, List<Object>> {}
+
+    @FunctionalInterface
+    public interface Writer extends BiConsumer<PacketWrapper<?>, List<Object>> {}
+
+    public static final class Parser implements MappedEntity {
+
+        private final TypesBuilderData data;
+        private final Reader reader;
+        private final Writer writer;
+
+        @Deprecated
         public Parser(String name, @Nullable Function<PacketWrapper<?>, List<Object>> read, @Nullable BiConsumer<PacketWrapper<?>, List<Object>> write) {
-            this.name = name;
-            this.read = Optional.ofNullable(read);
-            this.write = Optional.ofNullable(write);
+            this(
+                    new TypesBuilderData(new ResourceLocation(name), new int[0]),
+                    read == null ? null : read::apply,
+                    write == null ? null : write::accept
+            );
         }
 
-        public Optional<List<Object>> readProperties(PacketWrapper<?> packetWrapper) {
-            return read.map(fn -> fn.apply(packetWrapper));
+        private Parser(TypesBuilderData data, @Nullable Reader reader, Writer writer) {
+            this.data = data;
+            this.reader = reader;
+            this.writer = writer;
         }
 
-        public void writeProperties(PacketWrapper<?> packetWrapper, List<Object> properties) {
-            write.ifPresent(fn -> fn.accept(packetWrapper, properties));
+        public Optional<List<Object>> readProperties(PacketWrapper<?> wrapper) {
+            if (this.reader != null) {
+                return Optional.of(this.reader.apply(wrapper));
+            }
+            return Optional.empty();
+        }
+
+        public void writeProperties(PacketWrapper<?> wrapper, List<Object> properties) {
+            if (this.writer != null) {
+                this.writer.accept(wrapper, properties);
+            }
+        }
+
+        @Override
+        public ResourceLocation getName() {
+            return this.data.getName();
+        }
+
+        @Override
+        public int getId(ClientVersion version) {
+            int index = TYPES_BUILDER.getDataIndex(version);
+            return this.data.getData()[index];
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (obj instanceof Parser) {
+                return this.getName().equals(((Parser) obj).getName());
+            }
+            return false;
         }
     }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/color/Color.java

@@ -0,0 +1,73 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.color;
+
+import net.kyori.adventure.util.RGBLike;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Range;
+
+public final class Color implements RGBLike {
+
+    private static final int BIT_MASK = 0xFF;
+
+    private final int red, green, blue;
+
+    public Color(@Range(from = 0L, to = 255L) int red, @Range(from = 0L, to = 255L) int green, @Range(from = 0L, to = 255L) int blue) {
+        this.red = red;
+        this.green = green;
+        this.blue = blue;
+    }
+
+    public Color(int rgb) {
+        this((rgb >> 16) & BIT_MASK, (rgb >> 8) & BIT_MASK, rgb & BIT_MASK);
+    }
+
+    public @NotNull Color withRed(@Range(from = 0L, to = 255L) int red) {
+        return new Color(red, green, blue);
+    }
+
+    public @NotNull Color withGreen(@Range(from = 0L, to = 255L) int green) {
+        return new Color(red, green, blue);
+    }
+
+    public @NotNull Color withBlue(@Range(from = 0L, to = 255L) int blue) {
+        return new Color(red, green, blue);
+    }
+
+    public int asRGB() {
+        int rgb = red;
+        rgb = (rgb << 8) + green;
+        return (rgb << 8) + blue;
+    }
+
+    @Override
+    public @Range(from = 0L, to = 255L) int red() {
+        return red;
+    }
+
+    @Override
+    public @Range(from = 0L, to = 255L) int green() {
+        return green;
+    }
+
+    @Override
+    public @Range(from = 0L, to = 255L) int blue() {
+        return blue;
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/color/DyeColor.java

@@ -0,0 +1,103 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.color;
+
+import net.kyori.adventure.util.RGBLike;
+import org.jetbrains.annotations.NotNull;
+
+public enum DyeColor implements RGBLike {
+    WHITE(new Color(0xf9fffe), new Color(0xffffff), new Color(0xf0f0f0), 8),
+
+    ORANGE(new Color(0xf9801d), new Color(0xff681f), new Color(0xeb8844), 15),
+
+    MAGENTA(new Color(0xc74ebd), new Color(0xff00ff), new Color(0xc354cd), 16),
+
+    LIGHT_BLUE(new Color(0x3ab3da), new Color(0x9ac0cd), new Color(0x6689d3), 17),
+
+    YELLOW(new Color(0xfed83d), new Color(0xffff00), new Color(0xdecf2a), 18),
+
+    LIME(new Color(0x80c71f), new Color(0xbfff00), new Color(0x41cd34), 19),
+
+    PINK(new Color(0xf38baa), new Color(0xff69b4), new Color(0xd88198), 20),
+
+    GRAY(new Color(0x474f52), new Color(0x808080), new Color(0x434343), 21),
+
+    LIGHT_GRAY(new Color(0x9d9d97), new Color(0xd3d3d3), new Color(0xababab), 22),
+
+    CYAN(new Color(0x169c9c), new Color(0xffff), new Color(0x287697), 23),
+
+    PURPLE(new Color(0x8932b8), new Color(0xa020f0), new Color(0x7b2fbe), 24),
+
+    BLUE(new Color(0x3c44aa), new Color(0xff), new Color(0x253192), 25),
+
+    BROWN(new Color(0x835432), new Color(0x8b4513), new Color(0x51301a), 26),
+
+    GREEN(new Color(0x5e7c16), new Color(0xff00), new Color(0x3b511a), 27),
+
+    RED(new Color(0xb02e26), new Color(0xff0000), new Color(0xb3312c), 28),
+
+    BLACK(new Color(0x1d1d21), new Color(0x0), new Color(0x1e1b1b), 29);
+
+    private final Color textureDiffuseColor;
+
+    private final Color textColor;
+
+    private final Color fireworkColor;
+
+    private final int mapColorId;
+
+    DyeColor(@NotNull Color textureDiffuseColor, @NotNull Color textColor,
+             @NotNull Color fireworkColor, int mapColorId) {
+        this.textureDiffuseColor = textureDiffuseColor;
+        this.textColor = textColor;
+        this.fireworkColor = fireworkColor;
+        this.mapColorId = mapColorId;
+    }
+
+    public @NotNull Color color() {
+        return this.textureDiffuseColor;
+    }
+
+    public @NotNull Color textColor() {
+        return this.textColor;
+    }
+
+    public @NotNull Color fireworkColor() {
+        return this.fireworkColor;
+    }
+
+    @Override
+    public int red() {
+        return this.textureDiffuseColor.red();
+    }
+
+    @Override
+    public int green() {
+        return this.textureDiffuseColor.green();
+    }
+
+    @Override
+    public int blue() {
+        return this.textureDiffuseColor.blue();
+    }
+
+    public int mapColorId() {
+        return this.mapColorId;
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/ComponentPredicate.java

@@ -0,0 +1,91 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component;
+
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Map;
+import java.util.Optional;
+import java.util.function.Predicate;
+
+public class ComponentPredicate implements Predicate<IComponentMap> {
+
+    private List<ComponentValue<?>> requiredComponents;
+
+    public ComponentPredicate(List<ComponentValue<?>> requiredComponents) {
+        this.requiredComponents = requiredComponents;
+    }
+
+    public static ComponentPredicate read(PacketWrapper<?> wrapper) {
+        List<ComponentValue<?>> components = wrapper.readList(ComponentValue::read);
+        return new ComponentPredicate(components);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ComponentPredicate predicate) {
+        wrapper.writeList(predicate.requiredComponents, ComponentValue::write);
+    }
+
+    public static ComponentPredicate emptyPredicate() {
+        return new ComponentPredicate(new ArrayList<>());
+    }
+
+    @SuppressWarnings("unchecked")
+    public static ComponentPredicate fromPatches(PatchableComponentMap components) {
+        Map<ComponentType<?>, Optional<?>> patches = components.getPatches();
+        List<ComponentValue<?>> values = new ArrayList<>(patches.size());
+        for (Map.Entry<ComponentType<?>, Optional<?>> patch : patches.entrySet()) {
+            if (patch.getValue().isPresent()) {
+                values.add(new ComponentValue<>(
+                        (ComponentType<Object>) patch.getKey(),
+                        patch.getValue().get()
+                ));
+            }
+        }
+        return new ComponentPredicate(values);
+    }
+
+    public PatchableComponentMap asPatches(StaticComponentMap base) {
+        PatchableComponentMap patched = new PatchableComponentMap(base);
+        for (ComponentValue<?> component : this.requiredComponents) {
+            patched.set(component);
+        }
+        return patched;
+    }
+
+    @Override
+    public boolean test(IComponentMap components) {
+        for (ComponentValue<?> component : this.requiredComponents) {
+            Optional<?> value = components.getOptional(component.getType());
+            if (!value.isPresent() || !component.getValue().equals(value.get())) {
+                return false;
+            }
+        }
+        return true;
+    }
+
+    public List<ComponentValue<?>> getRequiredComponents() {
+        return this.requiredComponents;
+    }
+
+    public void setRequiredComponents(List<ComponentValue<?>> requiredComponents) {
+        this.requiredComponents = requiredComponents;
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/ComponentType.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+public interface ComponentType<T> extends MappedEntity {
+
+    T read(PacketWrapper<?> wrapper);
+
+    void write(PacketWrapper<?> wrapper, T content);
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/ComponentTypes.java

@@ -0,0 +1,256 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component;
+
+import com.github.retrooper.packetevents.protocol.color.DyeColor;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ArmorTrim;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.BannerLayers;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.BundleContents;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ChargedProjectiles;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.DebugStickState;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.FireworkExplosion;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.FoodProperties;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemAdventurePredicate;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemAttributeModifiers;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemBees;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemBlockStateProperties;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemContainerContents;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemContainerLoot;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemDyeColor;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemEnchantments;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemFireworks;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemLock;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemLore;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemMapDecorations;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemMapPostProcessingState;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemPotionContents;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemProfile;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemRarity;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemRecipes;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemTool;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.LodestoneTracker;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.PotDecorations;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.SuspiciousStewEffects;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.WritableBookContent;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.WrittenBookContent;
+import com.github.retrooper.packetevents.protocol.item.instrument.Instrument;
+import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.Dummy;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.function.BiConsumer;
+import java.util.function.Function;
+
+public class ComponentTypes {
+
+    private static final Map<String, ComponentType<?>> COMPONENT_TYPE_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, ComponentType<?>>> COMPONENT_TYPE_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("item/item_component_mappings");
+
+    public static <T> ComponentType<T> define(String key) {
+        return define(key, null, null);
+    }
+
+    public static <T> ComponentType<T> define(String key, @Nullable Reader<T> reader, @Nullable Writer<T> writer) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        ComponentType<T> type = new ComponentType<T>() {
+            @Override
+            public T read(PacketWrapper<?> wrapper) {
+                return reader == null ? null : reader.apply(wrapper);
+            }
+
+            @Override
+            public void write(PacketWrapper<?> wrapper, T content) {
+                if (writer != null) {
+                    writer.accept(wrapper, content);
+                }
+            }
+
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return MappingHelper.getId(version, TYPES_BUILDER, data);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof ComponentType<?>) {
+                    return this.getName().equals(((ComponentType<?>) obj).getName());
+                }
+                return false;
+            }
+
+            @Override
+            public String toString() {
+                return "Component[" + this.getName() + "]";
+            }
+        };
+
+        MappingHelper.registerMapping(TYPES_BUILDER, COMPONENT_TYPE_MAP, COMPONENT_TYPE_ID_MAP, type);
+        return type;
+    }
+
+    // with key
+    public static ComponentType<?> getByName(String name) {
+        return COMPONENT_TYPE_MAP.get(name);
+    }
+
+    public static ComponentType<?> getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, ComponentType<?>> idMap = COMPONENT_TYPE_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    // item component types
+    public static final ComponentType<NBTCompound> CUSTOM_DATA = define("custom_data",
+            PacketWrapper::readNBT, PacketWrapper::writeNBT);
+    public static final ComponentType<Integer> MAX_STACK_SIZE = define("max_stack_size",
+            PacketWrapper::readVarInt, PacketWrapper::writeVarInt);
+    public static final ComponentType<Integer> MAX_DAMAGE = define("max_damage",
+            PacketWrapper::readVarInt, PacketWrapper::writeVarInt);
+    public static final ComponentType<Integer> DAMAGE = define("damage",
+            PacketWrapper::readVarInt, PacketWrapper::writeVarInt);
+    public static final ComponentType<Boolean> UNBREAKABLE = define("unbreakable",
+            PacketWrapper::readBoolean, PacketWrapper::writeBoolean);
+    public static final ComponentType<Component> CUSTOM_NAME = define("custom_name",
+            PacketWrapper::readComponent, PacketWrapper::writeComponent);
+    public static final ComponentType<Component> ITEM_NAME = define("item_name",
+            PacketWrapper::readComponent, PacketWrapper::writeComponent);
+    public static final ComponentType<ItemLore> LORE = define("lore",
+            ItemLore::read, ItemLore::write);
+    public static final ComponentType<ItemRarity> RARITY = define("rarity",
+            wrapper -> wrapper.readEnum(ItemRarity.values()), PacketWrapper::writeEnum);
+    public static final ComponentType<ItemEnchantments> ENCHANTMENTS = define("enchantments",
+            ItemEnchantments::read, ItemEnchantments::write);
+    public static final ComponentType<ItemAdventurePredicate> CAN_PLACE_ON = define("can_place_on",
+            ItemAdventurePredicate::read, ItemAdventurePredicate::write);
+    public static final ComponentType<ItemAdventurePredicate> CAN_BREAK = define("can_break",
+            ItemAdventurePredicate::read, ItemAdventurePredicate::write);
+    public static final ComponentType<ItemAttributeModifiers> ATTRIBUTE_MODIFIERS = define("attribute_modifiers",
+            ItemAttributeModifiers::read, ItemAttributeModifiers::write);
+    public static final ComponentType<Integer> CUSTOM_MODEL_DATA = define("custom_model_data",
+            PacketWrapper::readVarInt, PacketWrapper::writeVarInt);
+    public static final ComponentType<Dummy> HIDE_ADDITIONAL_TOOLTIP = define("hide_additional_tooltip",
+            Dummy::dummyRead, Dummy::dummyWrite);
+    public static final ComponentType<Dummy> HIDE_TOOLTIP = define("hide_tooltip",
+            Dummy::dummyRead, Dummy::dummyWrite);
+    public static final ComponentType<Integer> REPAIR_COST = define("repair_cost",
+            PacketWrapper::readVarInt, PacketWrapper::writeVarInt);
+    public static final ComponentType<Dummy> CREATIVE_SLOT_LOCK = define("creative_slot_lock",
+            Dummy::dummyRead, Dummy::dummyWrite);
+    public static final ComponentType<Boolean> ENCHANTMENT_GLINT_OVERRIDE = define("enchantment_glint_override",
+            PacketWrapper::readBoolean, PacketWrapper::writeBoolean);
+    public static final ComponentType<Dummy> INTANGIBLE_PROJECTILE = define("intangible_projectile",
+            Dummy::dummyReadNbt, Dummy::dummyWriteNbt);
+    public static final ComponentType<FoodProperties> FOOD = define("food",
+            FoodProperties::read, FoodProperties::write);
+    public static final ComponentType<Dummy> FIRE_RESISTANT = define("fire_resistant",
+            Dummy::dummyRead, Dummy::dummyWrite);
+    public static final ComponentType<ItemTool> TOOL = define("tool",
+            ItemTool::read, ItemTool::write);
+    public static final ComponentType<ItemEnchantments> STORED_ENCHANTMENTS = define("stored_enchantments",
+            ItemEnchantments::read, ItemEnchantments::write);
+    public static final ComponentType<ItemDyeColor> DYED_COLOR = define("dyed_color",
+            ItemDyeColor::read, ItemDyeColor::write);
+    public static final ComponentType<Integer> MAP_COLOR = define("map_color",
+            PacketWrapper::readInt, PacketWrapper::writeInt);
+    public static final ComponentType<Integer> MAP_ID = define("map_id",
+            PacketWrapper::readVarInt, PacketWrapper::writeVarInt);
+    public static final ComponentType<ItemMapDecorations> MAP_DECORATIONS = define("map_decorations",
+            ItemMapDecorations::read, ItemMapDecorations::write);
+    public static final ComponentType<ItemMapPostProcessingState> MAP_POST_PROCESSING = define("map_post_processing",
+            wrapper -> wrapper.readEnum(ItemMapPostProcessingState.values()), PacketWrapper::writeEnum);
+    public static final ComponentType<ChargedProjectiles> CHARGED_PROJECTILES = define("charged_projectiles",
+            ChargedProjectiles::read, ChargedProjectiles::write);
+    public static final ComponentType<BundleContents> BUNDLE_CONTENTS = define("bundle_contents",
+            BundleContents::read, BundleContents::write);
+    public static final ComponentType<ItemPotionContents> POTION_CONTENTS = define("potion_contents",
+            ItemPotionContents::read, ItemPotionContents::write);
+    public static final ComponentType<SuspiciousStewEffects> SUSPICIOUS_STEW_EFFECTS = define("suspicious_stew_effects",
+            SuspiciousStewEffects::read, SuspiciousStewEffects::write);
+    public static final ComponentType<WritableBookContent> WRITABLE_BOOK_CONTENT = define("writable_book_content",
+            WritableBookContent::read, WritableBookContent::write);
+    public static final ComponentType<WrittenBookContent> WRITTEN_BOOK_CONTENT = define("written_book_content",
+            WrittenBookContent::read, WrittenBookContent::write);
+    public static final ComponentType<ArmorTrim> TRIM = define("trim",
+            ArmorTrim::read, ArmorTrim::write);
+    public static final ComponentType<DebugStickState> DEBUG_STICK_STATE = define("debug_stick_state",
+            DebugStickState::read, DebugStickState::write);
+    public static final ComponentType<NBTCompound> ENTITY_DATA = define("entity_data",
+            PacketWrapper::readNBT, PacketWrapper::writeNBT);
+    public static final ComponentType<NBTCompound> BUCKET_ENTITY_DATA = define("bucket_entity_data",
+            PacketWrapper::readNBT, PacketWrapper::writeNBT);
+    public static final ComponentType<NBTCompound> BLOCK_ENTITY_DATA = define("block_entity_data",
+            PacketWrapper::readNBT, PacketWrapper::writeNBT);
+    public static final ComponentType<Instrument> INSTRUMENT = define("instrument",
+            Instrument::read, Instrument::write);
+    public static final ComponentType<Integer> OMINOUS_BOTTLE_AMPLIFIER = define("ominous_bottle_amplifier",
+            PacketWrapper::readVarInt, PacketWrapper::writeVarInt);
+    public static final ComponentType<ItemRecipes> RECIPES = define("recipes",
+            ItemRecipes::read, ItemRecipes::write);
+    public static final ComponentType<LodestoneTracker> LODESTONE_TRACKER = define("lodestone_tracker",
+            LodestoneTracker::read, LodestoneTracker::write);
+    public static final ComponentType<FireworkExplosion> FIREWORK_EXPLOSION = define("firework_explosion",
+            FireworkExplosion::read, FireworkExplosion::write);
+    public static final ComponentType<ItemFireworks> FIREWORKS = define("fireworks",
+            ItemFireworks::read, ItemFireworks::write);
+    public static final ComponentType<ItemProfile> PROFILE = define("profile",
+            ItemProfile::read, ItemProfile::write);
+    public static final ComponentType<ResourceLocation> NOTE_BLOCK_SOUND = define("note_block_sound",
+            PacketWrapper::readIdentifier, PacketWrapper::writeIdentifier);
+    public static final ComponentType<BannerLayers> BANNER_PATTERNS = define("banner_patterns",
+            BannerLayers::read, BannerLayers::write);
+    public static final ComponentType<DyeColor> BASE_COLOR = define("base_color",
+            wrapper -> wrapper.readEnum(DyeColor.values()), PacketWrapper::writeEnum);
+    public static final ComponentType<PotDecorations> POT_DECORATIONS = define("pot_decorations",
+            PotDecorations::read, PotDecorations::write);
+    public static final ComponentType<ItemContainerContents> CONTAINER = define("container",
+            ItemContainerContents::read, ItemContainerContents::write);
+    public static final ComponentType<ItemBlockStateProperties> BLOCK_STATE = define("block_state",
+            ItemBlockStateProperties::read, ItemBlockStateProperties::write);
+    public static final ComponentType<ItemBees> BEES = define("bees",
+            ItemBees::read, ItemBees::write);
+    public static final ComponentType<ItemLock> LOCK = define("lock",
+            ItemLock::read, ItemLock::write);
+    public static final ComponentType<ItemContainerLoot> CONTAINER_LOOT = define("container_loot",
+            ItemContainerLoot::read, ItemContainerLoot::write);
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+
+    @FunctionalInterface
+    public interface Reader<T> extends Function<PacketWrapper<?>, T> {}
+
+    @FunctionalInterface
+    public interface Writer<T> extends BiConsumer<PacketWrapper<?>, T> {}
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/ComponentValue.java

@@ -0,0 +1,76 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component;
+
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.Objects;
+
+public final class ComponentValue<T> {
+
+    private final ComponentType<T> type;
+    private final T value;
+
+    public ComponentValue(ComponentType<T> type, T value) {
+        this.type = type;
+        this.value = value;
+    }
+
+    public static ComponentValue<?> read(PacketWrapper<?> wrapper) {
+        ComponentType<?> type = wrapper.readMappedEntity(ComponentTypes::getById);
+        return read0(wrapper, type);
+    }
+
+    private static <T> ComponentValue<T> read0(PacketWrapper<?> wrapper, ComponentType<T> type) {
+        // additional method required here for proper handling because of how generics work
+        return new ComponentValue<>(type, type.read(wrapper));
+    }
+
+    public static <T> void write(PacketWrapper<?> wrapper, ComponentValue<T> value) {
+        wrapper.writeMappedEntity(value.type);
+        value.type.write(wrapper, value.value);
+    }
+
+    public ComponentType<T> getType() {
+        return this.type;
+    }
+
+    public T getValue() {
+        return this.value;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ComponentValue)) return false;
+        ComponentValue<?> that = (ComponentValue<?>) obj;
+        if (!this.type.equals(that.type)) return false;
+        return this.value.equals(that.value);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.type, this.value);
+    }
+
+    @Override
+    public String toString() {
+        return "ComponentValue{type=" + this.type + ", value=" + this.value + '}';
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/IComponentMap.java

@@ -0,0 +1,58 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component;
+
+import org.jetbrains.annotations.Contract;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Optional;
+
+public interface IComponentMap {
+
+    default <T> Optional<T> getOptional(ComponentType<T> type) {
+        return Optional.ofNullable(this.get(type));
+    }
+
+    boolean has(ComponentType<?> type);
+
+    @Contract("_, !null -> !null")
+    default <T> @Nullable T getOr(ComponentType<T> type, @Nullable T otherValue) {
+        T value = this.get(type);
+        if (value != null) {
+            return value;
+        }
+        return otherValue;
+    }
+
+    <T> @Nullable T get(ComponentType<T> type);
+
+    default <T> void set(ComponentValue<T> component) {
+        this.set(component.getType(), component.getValue());
+    }
+
+    default <T> void set(ComponentType<T> type, @Nullable T value) {
+        this.set(type, Optional.ofNullable(value));
+    }
+
+    default <T> void unset(ComponentType<T> type) {
+        this.set(type, Optional.empty());
+    }
+
+    <T> void set(ComponentType<T> type, Optional<T> value);
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/PatchableComponentMap.java

@@ -0,0 +1,103 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component;
+
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Objects;
+import java.util.Optional;
+
+public class PatchableComponentMap implements IComponentMap {
+
+    public static final PatchableComponentMap EMPTY = new PatchableComponentMap(
+            Collections.emptyMap(), Collections.emptyMap());
+
+    private final Map<ComponentType<?>, ?> base;
+    private final Map<ComponentType<?>, Optional<?>> patches;
+
+    public PatchableComponentMap(StaticComponentMap base) {
+        this(base.getDelegate(), new HashMap<>());
+    }
+
+    public PatchableComponentMap(Map<ComponentType<?>, ?> base) {
+        this(base, new HashMap<>());
+    }
+
+    public PatchableComponentMap(
+            StaticComponentMap base,
+            Map<ComponentType<?>, Optional<?>> patches
+    ) {
+        this(base.getDelegate(), patches);
+    }
+
+    public PatchableComponentMap(
+            Map<ComponentType<?>, ?> base,
+            Map<ComponentType<?>, Optional<?>> patches
+    ) {
+        this.base = Collections.unmodifiableMap(new HashMap<>(base));
+        this.patches = patches;
+    }
+
+    @SuppressWarnings("unchecked") // no
+    @Override
+    public <T> @Nullable T get(ComponentType<T> type) {
+        Optional<?> patched = this.patches.get(type);
+        if (patched != null) {
+            return (T) patched.orElse(null);
+        }
+        return (T) this.base.get(type);
+    }
+
+    @Override
+    public <T> void set(ComponentType<T> type, Optional<T> value) {
+        Object baseVal = this.base.get(type);
+        T newVal = value.orElse(null);
+        if (Objects.equals(baseVal, newVal)) {
+            this.patches.remove(type); // fallback to base
+        } else {
+            this.patches.put(type, value);
+        }
+    }
+
+    @Override
+    public boolean has(ComponentType<?> type) {
+        Optional<?> patched = this.patches.get(type);
+        return patched != null ? patched.isPresent() : this.base.containsKey(type);
+    }
+
+    public PatchableComponentMap copy() {
+        return new PatchableComponentMap(this.base, new HashMap<>(this.patches));
+    }
+
+    public Map<ComponentType<?>, ?> getBase() {
+        return this.base;
+    }
+
+    public Map<ComponentType<?>, Optional<?>> getPatches() {
+        return this.patches;
+    }
+
+    @Override
+    public String toString() {
+        return "PatchableComponentMap{base=" + this.base + ", patches=" + this.patches + '}';
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/StaticComponentMap.java

@@ -0,0 +1,121 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component;
+
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemAttributeModifiers;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemEnchantments;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemLore;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemRarity;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Optional;
+
+public class StaticComponentMap implements IComponentMap {
+
+    public static final StaticComponentMap EMPTY = new StaticComponentMap(Collections.emptyMap());
+    public static final StaticComponentMap SHARED_ITEM_COMPONENTS = builder()
+            .set(ComponentTypes.MAX_STACK_SIZE, 64)
+            .set(ComponentTypes.LORE, ItemLore.EMPTY)
+            .set(ComponentTypes.ENCHANTMENTS, ItemEnchantments.EMPTY)
+            .set(ComponentTypes.REPAIR_COST, 0)
+            .set(ComponentTypes.ATTRIBUTE_MODIFIERS, ItemAttributeModifiers.EMPTY)
+            .set(ComponentTypes.RARITY, ItemRarity.COMMON)
+            .build();
+
+    private final boolean empty;
+    private final Map<ComponentType<?>, ?> delegate;
+
+    public StaticComponentMap(Map<ComponentType<?>, ?> delegate) {
+        this.empty = delegate.isEmpty();
+        this.delegate = this.empty ? Collections.emptyMap()
+                : Collections.unmodifiableMap(new HashMap<>(delegate));
+    }
+
+    public static Builder builder() {
+        return new Builder();
+    }
+
+    @Override
+    public boolean has(ComponentType<?> type) {
+        return !this.empty && this.delegate.containsKey(type);
+    }
+
+    @SuppressWarnings("unchecked") // no
+    @Override
+    public <T> @Nullable T get(ComponentType<T> type) {
+        return this.empty ? null : (T) this.delegate.get(type);
+    }
+
+    @Override
+    public <T> void set(ComponentType<T> type, Optional<T> value) {
+        throw new UnsupportedOperationException();
+    }
+
+    public StaticComponentMap merge(StaticComponentMap prioritizedMap) {
+        return builder().setAll(this).setAll(prioritizedMap).build();
+    }
+
+    public Map<ComponentType<?>, ?> getDelegate() {
+        return this.delegate;
+    }
+
+    public boolean isEmpty() {
+        return this.empty;
+    }
+
+    public static class Builder {
+
+        private final Map<ComponentType<?>, Object> map = new HashMap<>();
+
+        public Builder() {
+        }
+
+        public StaticComponentMap build() {
+            return new StaticComponentMap(this.map);
+        }
+
+        public Builder setAll(StaticComponentMap map) {
+            return this.setAll(map.getDelegate());
+        }
+
+        @SuppressWarnings("unchecked")
+        public Builder setAll(Map<ComponentType<?>, ?> map) {
+            for (Map.Entry<ComponentType<?>, ?> entry : map.entrySet()) {
+                this.set((ComponentType<Object>) entry.getKey(), entry.getValue());
+            }
+            return this;
+        }
+
+        public <T> Builder set(ComponentType<T> type, Optional<T> value) {
+            return this.set(type, value.orElse(null));
+        }
+
+        public <T> Builder set(ComponentType<T> type, @Nullable T value) {
+            if (value == null) {
+                this.map.remove(type);
+            } else {
+                this.map.put(type, value);
+            }
+            return this;
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ArmorTrim.java

@@ -0,0 +1,90 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.item.trimmaterial.TrimMaterial;
+import com.github.retrooper.packetevents.protocol.item.trimpattern.TrimPattern;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.Objects;
+
+public class ArmorTrim {
+
+    private TrimMaterial material;
+    private TrimPattern pattern;
+    private boolean showInTooltip;
+
+    public ArmorTrim(TrimMaterial material, TrimPattern pattern, boolean showInTooltip) {
+        this.material = material;
+        this.pattern = pattern;
+        this.showInTooltip = showInTooltip;
+    }
+
+    public static ArmorTrim read(PacketWrapper<?> wrapper) {
+        TrimMaterial material = TrimMaterial.read(wrapper);
+        TrimPattern pattern = TrimPattern.read(wrapper);
+        boolean showInTooltip = wrapper.readBoolean();
+        return new ArmorTrim(material, pattern, showInTooltip);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ArmorTrim trim) {
+        TrimMaterial.write(wrapper, trim.material);
+        TrimPattern.write(wrapper, trim.pattern);
+        wrapper.writeBoolean(trim.showInTooltip);
+    }
+
+    public TrimMaterial getMaterial() {
+        return this.material;
+    }
+
+    public void setMaterial(TrimMaterial material) {
+        this.material = material;
+    }
+
+    public TrimPattern getPattern() {
+        return this.pattern;
+    }
+
+    public void setPattern(TrimPattern pattern) {
+        this.pattern = pattern;
+    }
+
+    public boolean isShowInTooltip() {
+        return this.showInTooltip;
+    }
+
+    public void setShowInTooltip(boolean showInTooltip) {
+        this.showInTooltip = showInTooltip;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ArmorTrim)) return false;
+        ArmorTrim armorTrim = (ArmorTrim) obj;
+        if (this.showInTooltip != armorTrim.showInTooltip) return false;
+        if (!this.material.equals(armorTrim.material)) return false;
+        return this.pattern.equals(armorTrim.pattern);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.material, this.pattern, this.showInTooltip);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/BannerLayers.java

@@ -0,0 +1,123 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.color.DyeColor;
+import com.github.retrooper.packetevents.protocol.item.banner.BannerPattern;
+import com.github.retrooper.packetevents.protocol.item.banner.BannerPatterns;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class BannerLayers {
+
+    private List<Layer> layers;
+
+    public BannerLayers(List<Layer> layers) {
+        this.layers = layers;
+    }
+
+    public static BannerLayers read(PacketWrapper<?> wrapper) {
+        List<Layer> layers = wrapper.readList(Layer::read);
+        return new BannerLayers(layers);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, BannerLayers patterns) {
+        wrapper.writeList(patterns.layers, Layer::write);
+    }
+
+    public void addLayer(Layer layer) {
+        this.layers.add(layer);
+    }
+
+    public List<Layer> getLayers() {
+        return this.layers;
+    }
+
+    public void setLayers(List<Layer> layers) {
+        this.layers = layers;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof BannerLayers)) return false;
+        BannerLayers that = (BannerLayers) obj;
+        return this.layers.equals(that.layers);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.layers);
+    }
+
+    public static class Layer {
+
+        private BannerPattern pattern;
+        private DyeColor color;
+
+        public Layer(BannerPattern pattern, DyeColor color) {
+            this.pattern = pattern;
+            this.color = color;
+        }
+
+        public static Layer read(PacketWrapper<?> wrapper) {
+            BannerPattern pattern = wrapper.readMappedEntityOrDirect(
+                    BannerPatterns::getById, BannerPattern::readDirect);
+            DyeColor color = wrapper.readEnum(DyeColor.values());
+            return new Layer(pattern, color);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, Layer layer) {
+            wrapper.writeMappedEntityOrDirect(layer.pattern, BannerPattern::writeDirect);
+            wrapper.writeEnum(layer.color);
+        }
+
+        public BannerPattern getPattern() {
+            return this.pattern;
+        }
+
+        public void setPattern(BannerPattern pattern) {
+            this.pattern = pattern;
+        }
+
+        public DyeColor getColor() {
+            return this.color;
+        }
+
+        public void setColor(DyeColor color) {
+            this.color = color;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof Layer)) return false;
+            Layer layer = (Layer) obj;
+            if (!this.pattern.equals(layer.pattern)) return false;
+            return this.color == layer.color;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.pattern, this.color);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/BundleContents.java

@@ -0,0 +1,68 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.item.ItemStack;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class BundleContents {
+
+    private List<ItemStack> items;
+
+    public BundleContents(List<ItemStack> items) {
+        this.items = items;
+    }
+
+    public static BundleContents read(PacketWrapper<?> wrapper) {
+        List<ItemStack> items = wrapper.readList(PacketWrapper::readPresentItemStack);
+        return new BundleContents(items);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, BundleContents projectiles) {
+        wrapper.writeList(projectiles.items, PacketWrapper::writePresentItemStack);
+    }
+
+    public void addItem(ItemStack itemStack) {
+        this.items.add(itemStack);
+    }
+
+    public List<ItemStack> getItems() {
+        return this.items;
+    }
+
+    public void setItems(List<ItemStack> items) {
+        this.items = items;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof BundleContents)) return false;
+        BundleContents that = (BundleContents) obj;
+        return this.items.equals(that.items);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.items);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ChargedProjectiles.java

@@ -0,0 +1,68 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.item.ItemStack;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class ChargedProjectiles {
+
+    private List<ItemStack> items;
+
+    public ChargedProjectiles(List<ItemStack> items) {
+        this.items = items;
+    }
+
+    public static ChargedProjectiles read(PacketWrapper<?> wrapper) {
+        List<ItemStack> items = wrapper.readList(PacketWrapper::readPresentItemStack);
+        return new ChargedProjectiles(items);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ChargedProjectiles projectiles) {
+        wrapper.writeList(projectiles.items, PacketWrapper::writePresentItemStack);
+    }
+
+    public void addItem(ItemStack itemStack) {
+        this.items.add(itemStack);
+    }
+
+    public List<ItemStack> getItems() {
+        return this.items;
+    }
+
+    public void setItems(List<ItemStack> items) {
+        this.items = items;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ChargedProjectiles)) return false;
+        ChargedProjectiles that = (ChargedProjectiles) obj;
+        return this.items.equals(that.items);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.items);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/DebugStickState.java

@@ -0,0 +1,93 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.nbt.NBT;
+import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.protocol.nbt.NBTString;
+import com.github.retrooper.packetevents.protocol.world.states.type.StateType;
+import com.github.retrooper.packetevents.protocol.world.states.type.StateTypes;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Objects;
+
+public class DebugStickState {
+
+    private Map<StateType, String> properties;
+
+    public DebugStickState(Map<StateType, String> properties) {
+        this.properties = properties;
+    }
+
+    public static DebugStickState read(PacketWrapper<?> wrapper) {
+        NBTCompound compound = wrapper.readNBT();
+        Map<StateType, String> properties = new HashMap<>(compound.size());
+        for (Map.Entry<String, NBT> tag : compound.getTags().entrySet()) {
+            StateType stateType = StateTypes.getByName(tag.getKey());
+            String property = ((NBTString) tag.getValue()).getValue();
+            properties.put(stateType, property);
+        }
+        return new DebugStickState(properties);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, DebugStickState state) {
+        NBTCompound compound = new NBTCompound();
+        for (Map.Entry<StateType, String> property : state.properties.entrySet()) {
+            compound.setTag(property.getKey().getName(),
+                    new NBTString(property.getValue()));
+        }
+        wrapper.writeNBT(compound);
+    }
+
+    public @Nullable String getProperty(StateType stateType) {
+        return this.properties.get(stateType);
+    }
+
+    public void setProperty(StateType stateType, @Nullable String property) {
+        if (property != null) {
+            this.properties.put(stateType, property);
+        } else {
+            this.properties.remove(stateType);
+        }
+    }
+
+    public Map<StateType, String> getProperties() {
+        return this.properties;
+    }
+
+    public void setProperties(Map<StateType, String> properties) {
+        this.properties = properties;
+    }
+
+    @Override
+    public boolean equals(Object o) {
+        if (this == o) return true;
+        if (!(o instanceof DebugStickState)) return false;
+        DebugStickState that = (DebugStickState) o;
+        return this.properties.equals(that.properties);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.properties);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/FireworkExplosion.java

@@ -0,0 +1,134 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class FireworkExplosion {
+
+    private Shape shape;
+    private List<Integer> colors;
+    private List<Integer> fadeColors;
+    private boolean hasTrail;
+    private boolean hasTwinkle;
+
+    public FireworkExplosion(
+            Shape shape, List<Integer> colors, List<Integer> fadeColors,
+            boolean hasTrail, boolean hasTwinkle
+    ) {
+        this.shape = shape;
+        this.colors = colors;
+        this.fadeColors = fadeColors;
+        this.hasTrail = hasTrail;
+        this.hasTwinkle = hasTwinkle;
+    }
+
+    public static FireworkExplosion read(PacketWrapper<?> wrapper) {
+        Shape shape = wrapper.readEnum(Shape.values());
+        List<Integer> colors = wrapper.readList(PacketWrapper::readInt);
+        List<Integer> fadeColors = wrapper.readList(PacketWrapper::readInt);
+        boolean hasTrail = wrapper.readBoolean();
+        boolean hasTwinkle = wrapper.readBoolean();
+        return new FireworkExplosion(shape, colors, fadeColors, hasTrail, hasTwinkle);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, FireworkExplosion explosion) {
+        wrapper.writeEnum(explosion.shape);
+        wrapper.writeList(explosion.colors, PacketWrapper::writeInt);
+        wrapper.writeList(explosion.fadeColors, PacketWrapper::writeInt);
+        wrapper.writeBoolean(explosion.hasTrail);
+        wrapper.writeBoolean(explosion.hasTwinkle);
+    }
+
+    public Shape getShape() {
+        return this.shape;
+    }
+
+    public void setShape(Shape shape) {
+        this.shape = shape;
+    }
+
+    public void addColor(int color) {
+        this.colors.add(color);
+    }
+
+    public List<Integer> getColors() {
+        return this.colors;
+    }
+
+    public void setColors(List<Integer> colors) {
+        this.colors = colors;
+    }
+
+    public void addFadeColor(int color) {
+        this.fadeColors.add(color);
+    }
+
+    public List<Integer> getFadeColors() {
+        return this.fadeColors;
+    }
+
+    public void setFadeColors(List<Integer> fadeColors) {
+        this.fadeColors = fadeColors;
+    }
+
+    public boolean isHasTrail() {
+        return this.hasTrail;
+    }
+
+    public void setHasTrail(boolean hasTrail) {
+        this.hasTrail = hasTrail;
+    }
+
+    public boolean isHasTwinkle() {
+        return this.hasTwinkle;
+    }
+
+    public void setHasTwinkle(boolean hasTwinkle) {
+        this.hasTwinkle = hasTwinkle;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof FireworkExplosion)) return false;
+        FireworkExplosion that = (FireworkExplosion) obj;
+        if (this.hasTrail != that.hasTrail) return false;
+        if (this.hasTwinkle != that.hasTwinkle) return false;
+        if (this.shape != that.shape) return false;
+        if (!this.colors.equals(that.colors)) return false;
+        return this.fadeColors.equals(that.fadeColors);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.shape, this.colors, this.fadeColors, this.hasTrail, this.hasTwinkle);
+    }
+
+    public enum Shape {
+        SMALL_BALL,
+        LARGE_BALL,
+        STAR,
+        CREEPER,
+        BURST,
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/FoodProperties.java

@@ -0,0 +1,174 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.potion.PotionEffect;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class FoodProperties {
+
+    private int nutrition;
+    private float saturation;
+    private boolean canAlwaysEat;
+    private float eatSeconds;
+    private List<PossibleEffect> effects;
+
+    public FoodProperties(int nutrition, float saturation, boolean canAlwaysEat, float eatSeconds, List<PossibleEffect> effects) {
+        this.nutrition = nutrition;
+        this.saturation = saturation;
+        this.canAlwaysEat = canAlwaysEat;
+        this.eatSeconds = eatSeconds;
+        this.effects = effects;
+    }
+
+    public static FoodProperties read(PacketWrapper<?> wrapper) {
+        int nutrition = wrapper.readVarInt();
+        float saturation = wrapper.readFloat();
+        boolean canAlwaysEat = wrapper.readBoolean();
+        float eatSeconds = wrapper.readFloat();
+        List<PossibleEffect> effects = wrapper.readList(PossibleEffect::read);
+        return new FoodProperties(nutrition, saturation, canAlwaysEat, eatSeconds, effects);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, FoodProperties props) {
+        wrapper.writeVarInt(props.nutrition);
+        wrapper.writeFloat(props.saturation);
+        wrapper.writeBoolean(props.canAlwaysEat);
+        wrapper.writeFloat(props.eatSeconds);
+        wrapper.writeList(props.effects, PossibleEffect::write);
+    }
+
+    public int getNutrition() {
+        return this.nutrition;
+    }
+
+    public void setNutrition(int nutrition) {
+        this.nutrition = nutrition;
+    }
+
+    public float getSaturation() {
+        return this.saturation;
+    }
+
+    public void setSaturation(float saturation) {
+        this.saturation = saturation;
+    }
+
+    public boolean isCanAlwaysEat() {
+        return this.canAlwaysEat;
+    }
+
+    public void setCanAlwaysEat(boolean canAlwaysEat) {
+        this.canAlwaysEat = canAlwaysEat;
+    }
+
+    public float getEatSeconds() {
+        return this.eatSeconds;
+    }
+
+    public void setEatSeconds(float eatSeconds) {
+        this.eatSeconds = eatSeconds;
+    }
+
+    public void addEffect(PossibleEffect effect) {
+        this.effects.add(effect);
+    }
+
+    public List<PossibleEffect> getEffects() {
+        return this.effects;
+    }
+
+    public void setEffects(List<PossibleEffect> effects) {
+        this.effects = effects;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof FoodProperties)) return false;
+        FoodProperties that = (FoodProperties) obj;
+        if (this.nutrition != that.nutrition) return false;
+        if (Float.compare(that.saturation, this.saturation) != 0) return false;
+        if (this.canAlwaysEat != that.canAlwaysEat) return false;
+        if (Float.compare(that.eatSeconds, this.eatSeconds) != 0) return false;
+        return this.effects.equals(that.effects);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.nutrition, this.saturation, this.canAlwaysEat, this.eatSeconds, this.effects);
+    }
+
+    public static class PossibleEffect {
+
+        private PotionEffect effect;
+        private float probability;
+
+        public PossibleEffect(PotionEffect effect, float probability) {
+            this.effect = effect;
+            this.probability = probability;
+        }
+
+        public static PossibleEffect read(PacketWrapper<?> wrapper) {
+            PotionEffect effect = PotionEffect.read(wrapper);
+            float probability = wrapper.readFloat();
+            return new PossibleEffect(effect, probability);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, PossibleEffect effect) {
+            PotionEffect.write(wrapper, effect.effect);
+            wrapper.writeFloat(effect.probability);
+        }
+
+        public PotionEffect getEffect() {
+            return this.effect;
+        }
+
+        public void setEffect(PotionEffect effect) {
+            this.effect = effect;
+        }
+
+        public float getProbability() {
+            return this.probability;
+        }
+
+        public void setProbability(float probability) {
+            this.probability = probability;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof PossibleEffect)) return false;
+            PossibleEffect that = (PossibleEffect) obj;
+            if (Float.compare(that.probability, this.probability) != 0) return false;
+            return this.effect.equals(that.effect);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.effect, this.probability);
+        }
+    }
+}
+
+

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemAdventurePredicate.java

@@ -0,0 +1,329 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntitySet;
+import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.protocol.world.states.type.StateType;
+import com.github.retrooper.packetevents.protocol.world.states.type.StateTypes;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.Objects;
+
+// why do I have to implement this mess, I just want to deserialize items
+public class ItemAdventurePredicate {
+
+    private List<BlockPredicate> predicates;
+    private boolean showInTooltip;
+
+    public ItemAdventurePredicate(List<BlockPredicate> predicates, boolean showInTooltip) {
+        this.predicates = predicates;
+        this.showInTooltip = showInTooltip;
+    }
+
+    public static ItemAdventurePredicate read(PacketWrapper<?> wrapper) {
+        List<BlockPredicate> predicates = wrapper.readList(BlockPredicate::read);
+        boolean showInTooltip = wrapper.readBoolean();
+        return new ItemAdventurePredicate(predicates, showInTooltip);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemAdventurePredicate predicate) {
+        wrapper.writeList(predicate.predicates, BlockPredicate::write);
+        wrapper.writeBoolean(predicate.showInTooltip);
+    }
+
+    public void addPredicate(BlockPredicate predicate) {
+        this.predicates.add(predicate);
+    }
+
+    public List<BlockPredicate> getPredicates() {
+        return this.predicates;
+    }
+
+    public void setPredicates(List<BlockPredicate> predicates) {
+        this.predicates = predicates;
+    }
+
+    public boolean isShowInTooltip() {
+        return this.showInTooltip;
+    }
+
+    public void setShowInTooltip(boolean showInTooltip) {
+        this.showInTooltip = showInTooltip;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemAdventurePredicate)) return false;
+        ItemAdventurePredicate that = (ItemAdventurePredicate) obj;
+        if (this.showInTooltip != that.showInTooltip) return false;
+        return this.predicates.equals(that.predicates);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.predicates, this.showInTooltip);
+    }
+
+    public static class BlockPredicate {
+
+        private @Nullable MappedEntitySet<StateType.Mapped> blocks;
+        private @Nullable List<PropertyMatcher> properties;
+        private @Nullable NBTCompound nbt;
+
+        public BlockPredicate(
+                @Nullable MappedEntitySet<StateType.Mapped> blocks,
+                @Nullable List<PropertyMatcher> properties,
+                @Nullable NBTCompound nbt
+        ) {
+            this.blocks = blocks;
+            this.properties = properties;
+            this.nbt = nbt;
+        }
+
+        public static BlockPredicate read(PacketWrapper<?> wrapper) {
+            MappedEntitySet<StateType.Mapped> blocks = wrapper.readOptional(
+                    ew -> MappedEntitySet.read(ew, StateTypes::getMappedById));
+            List<PropertyMatcher> properties = wrapper.readList(PropertyMatcher::read);
+            NBTCompound nbt = wrapper.readNBT();
+            return new BlockPredicate(blocks, properties, nbt);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, BlockPredicate predicate) {
+            wrapper.writeOptional(predicate.blocks, MappedEntitySet::write);
+            wrapper.writeOptional(predicate.properties,
+                    (ew, val) -> ew.writeList(val, PropertyMatcher::write));
+            wrapper.writeOptional(predicate.nbt, PacketWrapper::writeNBT);
+        }
+
+        public @Nullable MappedEntitySet<StateType.Mapped> getBlocks() {
+            return this.blocks;
+        }
+
+        public void setBlocks(@Nullable MappedEntitySet<StateType.Mapped> blocks) {
+            this.blocks = blocks;
+        }
+
+        public void addProperty(PropertyMatcher propertyMatcher) {
+            if (this.properties == null) {
+                this.properties = new ArrayList<>(4);
+            }
+            this.properties.add(propertyMatcher);
+        }
+
+        public @Nullable List<PropertyMatcher> getProperties() {
+            return this.properties;
+        }
+
+        public void setProperties(@Nullable List<PropertyMatcher> properties) {
+            this.properties = properties;
+        }
+
+        public @Nullable NBTCompound getNbt() {
+            return this.nbt;
+        }
+
+        public void setNbt(@Nullable NBTCompound nbt) {
+            this.nbt = nbt;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof BlockPredicate)) return false;
+            BlockPredicate that = (BlockPredicate) obj;
+            if (!Objects.equals(this.blocks, that.blocks)) return false;
+            if (!Objects.equals(this.properties, that.properties)) return false;
+            return Objects.equals(this.nbt, that.nbt);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.blocks, this.properties, this.nbt);
+        }
+    }
+
+    public static class PropertyMatcher {
+
+        private String name;
+        private ValueMatcher matcher;
+
+        public PropertyMatcher(String name, ValueMatcher matcher) {
+            this.name = name;
+            this.matcher = matcher;
+        }
+
+        public static PropertyMatcher read(PacketWrapper<?> wrapper) {
+            String name = wrapper.readString();
+            ValueMatcher matcher = ValueMatcher.read(wrapper);
+            return new PropertyMatcher(name, matcher);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, PropertyMatcher matcher) {
+            wrapper.writeString(matcher.name);
+            ValueMatcher.write(wrapper, matcher.matcher);
+        }
+
+        public String getName() {
+            return this.name;
+        }
+
+        public void setName(String name) {
+            this.name = name;
+        }
+
+        public ValueMatcher getMatcher() {
+            return this.matcher;
+        }
+
+        public void setMatcher(ValueMatcher matcher) {
+            this.matcher = matcher;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof PropertyMatcher)) return false;
+            PropertyMatcher that = (PropertyMatcher) obj;
+            if (!this.name.equals(that.name)) return false;
+            return this.matcher.equals(that.matcher);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.name, this.matcher);
+        }
+    }
+
+    public interface ValueMatcher {
+
+        static ValueMatcher read(PacketWrapper<?> wrapper) {
+            if (wrapper.readBoolean()) {
+                return ExactValueMatcher.read(wrapper);
+            }
+            return RangedValueMatcher.read(wrapper);
+        }
+
+        static void write(PacketWrapper<?> wrapper, ValueMatcher matcher) {
+            if (matcher instanceof ExactValueMatcher) {
+                wrapper.writeBoolean(true);
+                ExactValueMatcher.write(wrapper, (ExactValueMatcher) matcher);
+            } else if (matcher instanceof RangedValueMatcher) {
+                wrapper.writeBoolean(false);
+                RangedValueMatcher.write(wrapper, (RangedValueMatcher) matcher);
+            } else {
+                throw new IllegalArgumentException("Illegal matcher implementation: " + matcher);
+            }
+        }
+    }
+
+    public static class ExactValueMatcher implements ValueMatcher {
+
+        private String value;
+
+        public ExactValueMatcher(String value) {
+            this.value = value;
+        }
+
+        public static ExactValueMatcher read(PacketWrapper<?> wrapper) {
+            return new ExactValueMatcher(wrapper.readString());
+        }
+
+        public static void write(PacketWrapper<?> wrapper, ExactValueMatcher matcher) {
+            wrapper.writeString(matcher.value);
+        }
+
+        public String getValue() {
+            return this.value;
+        }
+
+        public void setValue(String value) {
+            this.value = value;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof ExactValueMatcher)) return false;
+            ExactValueMatcher that = (ExactValueMatcher) obj;
+            return this.value.equals(that.value);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hashCode(this.value);
+        }
+    }
+
+    public static class RangedValueMatcher implements ValueMatcher {
+
+        private @Nullable String minValue;
+        private @Nullable String maxValue;
+
+        public RangedValueMatcher(@Nullable String minValue, @Nullable String maxValue) {
+            this.minValue = minValue;
+            this.maxValue = maxValue;
+        }
+
+        public static RangedValueMatcher read(PacketWrapper<?> wrapper) {
+            String minValue = wrapper.readOptional(PacketWrapper::readString);
+            String maxValue = wrapper.readOptional(PacketWrapper::readString);
+            return new RangedValueMatcher(minValue, maxValue);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, RangedValueMatcher matcher) {
+            wrapper.writeOptional(matcher.minValue, PacketWrapper::writeString);
+            wrapper.writeOptional(matcher.maxValue, PacketWrapper::writeString);
+        }
+
+        public @Nullable String getMinValue() {
+            return this.minValue;
+        }
+
+        public void setMinValue(@Nullable String minValue) {
+            this.minValue = minValue;
+        }
+
+        public @Nullable String getMaxValue() {
+            return this.maxValue;
+        }
+
+        public void setMaxValue(@Nullable String maxValue) {
+            this.maxValue = maxValue;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof RangedValueMatcher)) return false;
+            RangedValueMatcher that = (RangedValueMatcher) obj;
+            if (!Objects.equals(this.minValue, that.minValue)) return false;
+            return Objects.equals(this.maxValue, that.maxValue);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.minValue, this.maxValue);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemAttributeModifiers.java

@@ -0,0 +1,264 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.attribute.Attribute;
+import com.github.retrooper.packetevents.protocol.attribute.AttributeOperation;
+import com.github.retrooper.packetevents.protocol.attribute.Attributes;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+import java.util.UUID;
+
+public class ItemAttributeModifiers {
+
+    public static final ItemAttributeModifiers EMPTY = new ItemAttributeModifiers(
+            Collections.emptyList(), true) {
+        @Override
+        public void setShowInTooltip(boolean showInTooltip) {
+            throw new UnsupportedOperationException();
+        }
+    };
+
+    private List<ModifierEntry> modifiers;
+    private boolean showInTooltip;
+
+    public ItemAttributeModifiers(List<ModifierEntry> modifiers, boolean showInTooltip) {
+        this.modifiers = modifiers;
+        this.showInTooltip = showInTooltip;
+    }
+
+    public static ItemAttributeModifiers read(PacketWrapper<?> wrapper) {
+        List<ModifierEntry> modifiers = wrapper.readList(ModifierEntry::read);
+        boolean showInTooltip = wrapper.readBoolean();
+        return new ItemAttributeModifiers(modifiers, showInTooltip);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemAttributeModifiers modifiers) {
+        wrapper.writeList(modifiers.modifiers, ModifierEntry::write);
+        wrapper.writeBoolean(modifiers.showInTooltip);
+    }
+
+    public void addModifier(ModifierEntry modifier) {
+        this.modifiers.add(modifier);
+    }
+
+    public List<ModifierEntry> getModifiers() {
+        return this.modifiers;
+    }
+
+    public void setModifiers(List<ModifierEntry> modifiers) {
+        this.modifiers = modifiers;
+    }
+
+    public boolean isShowInTooltip() {
+        return this.showInTooltip;
+    }
+
+    public void setShowInTooltip(boolean showInTooltip) {
+        this.showInTooltip = showInTooltip;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemAttributeModifiers)) return false;
+        ItemAttributeModifiers that = (ItemAttributeModifiers) obj;
+        if (this.showInTooltip != that.showInTooltip) return false;
+        return this.modifiers.equals(that.modifiers);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.modifiers, this.showInTooltip);
+    }
+
+    @Override
+    public String toString() {
+        return "ItemAttributeModifiers{modifiers=" + this.modifiers + ", showInTooltip=" + this.showInTooltip + '}';
+    }
+
+    public static class ModifierEntry {
+
+        private Attribute attribute;
+        private Modifier modifier;
+        private EquipmentSlotGroup slotGroup;
+
+        public ModifierEntry(Attribute attribute, Modifier modifier, EquipmentSlotGroup slotGroup) {
+            this.attribute = attribute;
+            this.modifier = modifier;
+            this.slotGroup = slotGroup;
+        }
+
+        public static ModifierEntry read(PacketWrapper<?> wrapper) {
+            Attribute attribute = wrapper.readMappedEntity(Attributes::getById);
+            Modifier modifier = Modifier.read(wrapper);
+            EquipmentSlotGroup slot = wrapper.readEnum(EquipmentSlotGroup.values());
+            return new ModifierEntry(attribute, modifier, slot);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, ModifierEntry entry) {
+            wrapper.writeMappedEntity(entry.attribute);
+            Modifier.write(wrapper, entry.modifier);
+            wrapper.writeEnum(entry.slotGroup);
+        }
+
+        public Attribute getAttribute() {
+            return this.attribute;
+        }
+
+        public void setAttribute(Attribute attribute) {
+            this.attribute = attribute;
+        }
+
+        public Modifier getModifier() {
+            return this.modifier;
+        }
+
+        public void setModifier(Modifier modifier) {
+            this.modifier = modifier;
+        }
+
+        public EquipmentSlotGroup getSlotGroup() {
+            return this.slotGroup;
+        }
+
+        public void setSlotGroup(EquipmentSlotGroup slotGroup) {
+            this.slotGroup = slotGroup;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof ModifierEntry)) return false;
+            ModifierEntry that = (ModifierEntry) obj;
+            if (!this.attribute.equals(that.attribute)) return false;
+            if (!this.modifier.equals(that.modifier)) return false;
+            return this.slotGroup == that.slotGroup;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.attribute, this.modifier, this.slotGroup);
+        }
+
+        @Override
+        public String toString() {
+            return "ModifierEntry{attribute=" + this.attribute + ", modifier=" + this.modifier + ", slotGroup=" + this.slotGroup + '}';
+        }
+    }
+
+    public static class Modifier {
+
+        private UUID id;
+        private String name;
+        private double value;
+        private AttributeOperation operation;
+
+        public Modifier(UUID id, String name, double value, AttributeOperation operation) {
+            this.id = id;
+            this.name = name;
+            this.value = value;
+            this.operation = operation;
+        }
+
+        public static Modifier read(PacketWrapper<?> wrapper) {
+            UUID id = wrapper.readUUID();
+            String name = wrapper.readString();
+            double value = wrapper.readDouble();
+            AttributeOperation operation = wrapper.readEnum(AttributeOperation.values());
+            return new Modifier(id, name, value, operation);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, Modifier modifier) {
+            wrapper.writeUUID(modifier.id);
+            wrapper.writeString(modifier.name);
+            wrapper.writeDouble(modifier.value);
+            wrapper.writeEnum(modifier.operation);
+        }
+
+        public UUID getId() {
+            return this.id;
+        }
+
+        public void setId(UUID id) {
+            this.id = id;
+        }
+
+        public String getName() {
+            return this.name;
+        }
+
+        public void setName(String name) {
+            this.name = name;
+        }
+
+        public double getValue() {
+            return this.value;
+        }
+
+        public void setValue(double value) {
+            this.value = value;
+        }
+
+        public AttributeOperation getOperation() {
+            return this.operation;
+        }
+
+        public void setOperation(AttributeOperation operation) {
+            this.operation = operation;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof Modifier)) return false;
+            Modifier modifier = (Modifier) obj;
+            if (Double.compare(modifier.value, this.value) != 0) return false;
+            if (!this.id.equals(modifier.id)) return false;
+            if (!this.name.equals(modifier.name)) return false;
+            return this.operation == modifier.operation;
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.id, this.name, this.value, this.operation);
+        }
+
+        @Override
+        public String toString() {
+            return "Modifier{id=" + this.id + ", name='" + this.name + '\'' + ", value=" + this.value + ", operation=" + this.operation + '}';
+        }
+    }
+
+    public enum EquipmentSlotGroup {
+        ANY,
+        MAINHAND,
+        OFFHAND,
+        HAND,
+        FEET,
+        LEGS,
+        CHEST,
+        HEAD,
+        ARMOR,
+        BODY,
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemBees.java

@@ -0,0 +1,133 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class ItemBees {
+
+    private List<BeeEntry> bees;
+
+    public ItemBees(List<BeeEntry> bees) {
+        this.bees = bees;
+    }
+
+    public static ItemBees read(PacketWrapper<?> wrapper) {
+        List<BeeEntry> bees = wrapper.readList(BeeEntry::read);
+        return new ItemBees(bees);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemBees bees) {
+        wrapper.writeList(bees.bees, BeeEntry::write);
+    }
+
+    public void addBee(BeeEntry bee) {
+        this.bees.add(bee);
+    }
+
+    public List<BeeEntry> getBees() {
+        return this.bees;
+    }
+
+    public void setBees(List<BeeEntry> bees) {
+        this.bees = bees;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemBees)) return false;
+        ItemBees itemBees = (ItemBees) obj;
+        return this.bees.equals(itemBees.bees);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.bees);
+    }
+
+    public static class BeeEntry {
+
+        private NBTCompound entityData;
+        private int ticksInHive;
+        private int minTicksInHive;
+
+        public BeeEntry(NBTCompound entityData, int ticksInHive, int minTicksInHive) {
+            this.entityData = entityData;
+            this.ticksInHive = ticksInHive;
+            this.minTicksInHive = minTicksInHive;
+        }
+
+        public static BeeEntry read(PacketWrapper<?> wrapper) {
+            NBTCompound entityData = wrapper.readNBT();
+            int ticksInHive = wrapper.readVarInt();
+            int minTicksInHive = wrapper.readVarInt();
+            return new BeeEntry(entityData, ticksInHive, minTicksInHive);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, BeeEntry bee) {
+            wrapper.writeNBT(bee.entityData);
+            wrapper.writeVarInt(bee.ticksInHive);
+            wrapper.writeVarInt(bee.minTicksInHive);
+        }
+
+        public NBTCompound getEntityData() {
+            return this.entityData;
+        }
+
+        public void setEntityData(NBTCompound entityData) {
+            this.entityData = entityData;
+        }
+
+        public int getTicksInHive() {
+            return this.ticksInHive;
+        }
+
+        public void setTicksInHive(int ticksInHive) {
+            this.ticksInHive = ticksInHive;
+        }
+
+        public int getMinTicksInHive() {
+            return this.minTicksInHive;
+        }
+
+        public void setMinTicksInHive(int minTicksInHive) {
+            this.minTicksInHive = minTicksInHive;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof BeeEntry)) return false;
+            BeeEntry beeEntry = (BeeEntry) obj;
+            if (this.ticksInHive != beeEntry.ticksInHive) return false;
+            if (this.minTicksInHive != beeEntry.minTicksInHive) return false;
+            return this.entityData.equals(beeEntry.entityData);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.entityData, this.ticksInHive, this.minTicksInHive);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemBlockStateProperties.java

@@ -0,0 +1,100 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.world.states.type.StateValue;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+import java.util.Objects;
+
+public class ItemBlockStateProperties {
+
+    private Map<String, String> properties;
+
+    public ItemBlockStateProperties(Map<String, String> properties) {
+        this.properties = properties;
+    }
+
+    public static ItemBlockStateProperties read(PacketWrapper<?> wrapper) {
+        Map<String, String> properties = wrapper.readMap(
+                PacketWrapper::readString, PacketWrapper::readString);
+        return new ItemBlockStateProperties(properties);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemBlockStateProperties props) {
+        wrapper.writeMap(props.properties,
+                PacketWrapper::writeString,
+                PacketWrapper::writeString);
+    }
+
+    public @Nullable Object getProperty(StateValue stateValue) {
+        String value = this.getProperty(stateValue.getName());
+        if (value != null) {
+            return stateValue.getParser().apply(value);
+        }
+        return null;
+    }
+
+    public @Nullable String getProperty(String key) {
+        return this.properties.get(key);
+    }
+
+    public void setProperty(StateValue stateValue, @Nullable Object value) {
+        this.setProperty(stateValue.getName(), value == null ? null : value.toString());
+    }
+
+    public void setProperty(String key, @Nullable String value) {
+        if (value == null) {
+            this.properties.remove(key);
+        } else {
+            this.properties.put(key, value);
+        }
+    }
+
+    public void unsetProperty(StateValue stateValue) {
+        this.unsetProperty(stateValue.getName());
+    }
+
+    public void unsetProperty(String key) {
+        this.setProperty(key, null);
+    }
+
+    public Map<String, String> getProperties() {
+        return this.properties;
+    }
+
+    public void setProperties(Map<String, String> properties) {
+        this.properties = properties;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemBlockStateProperties)) return false;
+        ItemBlockStateProperties that = (ItemBlockStateProperties) obj;
+        return this.properties.equals(that.properties);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.properties);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemContainerContents.java

@@ -0,0 +1,68 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.item.ItemStack;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class ItemContainerContents {
+
+    private List<ItemStack> items;
+
+    public ItemContainerContents(List<ItemStack> items) {
+        this.items = items;
+    }
+
+    public static ItemContainerContents read(PacketWrapper<?> wrapper) {
+        List<ItemStack> items = wrapper.readList(PacketWrapper::readItemStack);
+        return new ItemContainerContents(items);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemContainerContents contents) {
+        wrapper.writeList(contents.items, PacketWrapper::writeItemStack);
+    }
+
+    public void addItem(ItemStack itemStack) {
+        this.items.add(itemStack);
+    }
+
+    public List<ItemStack> getItems() {
+        return this.items;
+    }
+
+    public void setItems(List<ItemStack> items) {
+        this.items = items;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemContainerContents)) return false;
+        ItemContainerContents that = (ItemContainerContents) obj;
+        return this.items.equals(that.items);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.items);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemContainerLoot.java

@@ -0,0 +1,86 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.protocol.nbt.NBTLong;
+import com.github.retrooper.packetevents.protocol.nbt.NBTNumber;
+import com.github.retrooper.packetevents.protocol.nbt.NBTString;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.Objects;
+
+public class ItemContainerLoot {
+
+    private ResourceLocation lootTable;
+    private long seed;
+
+    public ItemContainerLoot(ResourceLocation lootTable, long seed) {
+        this.lootTable = lootTable;
+        this.seed = seed;
+    }
+
+    public static ItemContainerLoot read(PacketWrapper<?> wrapper) {
+        NBTCompound compound = wrapper.readNBT();
+        ResourceLocation lootTable = new ResourceLocation(compound.getStringTagValueOrThrow("loot_table"));
+        NBTNumber seedTag = compound.getNumberTagOrNull("seed");
+        long seed = seedTag == null ? 0L : seedTag.getAsLong();
+        return new ItemContainerLoot(lootTable, seed);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemContainerLoot loot) {
+        NBTCompound compound = new NBTCompound();
+        compound.setTag("loot_table", new NBTString(loot.lootTable.toString()));
+        if (loot.seed != 0L) {
+            compound.setTag("seed", new NBTLong(loot.seed));
+        }
+        wrapper.writeNBT(compound);
+    }
+
+    public ResourceLocation getLootTable() {
+        return this.lootTable;
+    }
+
+    public void setLootTable(ResourceLocation lootTable) {
+        this.lootTable = lootTable;
+    }
+
+    public long getSeed() {
+        return this.seed;
+    }
+
+    public void setSeed(long seed) {
+        this.seed = seed;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemContainerLoot)) return false;
+        ItemContainerLoot that = (ItemContainerLoot) obj;
+        if (this.seed != that.seed) return false;
+        return this.lootTable.equals(that.lootTable);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.lootTable, this.seed);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemDyeColor.java

@@ -0,0 +1,75 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.Objects;
+
+public class ItemDyeColor {
+
+    private int rgb;
+    private boolean showInTooltip;
+
+    public ItemDyeColor(int rgb, boolean showInTooltip) {
+        this.rgb = rgb;
+        this.showInTooltip = showInTooltip;
+    }
+
+    public static ItemDyeColor read(PacketWrapper<?> wrapper) {
+        int rgb = wrapper.readInt();
+        boolean showInTooltip = wrapper.readBoolean();
+        return new ItemDyeColor(rgb, showInTooltip);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemDyeColor color) {
+        wrapper.writeInt(color.rgb);
+        wrapper.writeBoolean(color.showInTooltip);
+    }
+
+    public int getRgb() {
+        return this.rgb;
+    }
+
+    public void setRgb(int rgb) {
+        this.rgb = rgb;
+    }
+
+    public boolean isShowInTooltip() {
+        return this.showInTooltip;
+    }
+
+    public void setShowInTooltip(boolean showInTooltip) {
+        this.showInTooltip = showInTooltip;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemDyeColor)) return false;
+        ItemDyeColor that = (ItemDyeColor) obj;
+        if (this.rgb != that.rgb) return false;
+        return this.showInTooltip == that.showInTooltip;
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.rgb, this.showInTooltip);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemEnchantments.java

@@ -0,0 +1,127 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.item.enchantment.type.EnchantmentType;
+import com.github.retrooper.packetevents.protocol.item.enchantment.type.EnchantmentTypes;
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.Collections;
+import java.util.Iterator;
+import java.util.Map;
+import java.util.Objects;
+
+public class ItemEnchantments implements Iterable<Map.Entry<EnchantmentType, Integer>> {
+
+    public static final ItemEnchantments EMPTY = new ItemEnchantments(
+            Collections.emptyMap(), true) {
+        @Override
+        public void setShowInTooltip(boolean showInTooltip) {
+            throw new UnsupportedOperationException();
+        }
+    };
+
+    private Map<EnchantmentType, Integer> enchantments;
+    private boolean showInTooltip;
+
+    public ItemEnchantments(Map<EnchantmentType, Integer> enchantments, boolean showInTooltip) {
+        this.enchantments = Collections.unmodifiableMap(enchantments);
+        this.showInTooltip = showInTooltip;
+    }
+
+    public static ItemEnchantments read(PacketWrapper<?> wrapper) {
+        ClientVersion version = wrapper.getServerVersion().toClientVersion();
+        Map<EnchantmentType, Integer> enchantments = wrapper.readMap(
+                ew -> EnchantmentTypes.getById(version, ew.readVarInt()),
+                PacketWrapper::readVarInt
+        );
+        boolean showInTooltip = wrapper.readBoolean();
+        return new ItemEnchantments(enchantments, showInTooltip);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemEnchantments enchantments) {
+        ClientVersion version = wrapper.getServerVersion().toClientVersion();
+        wrapper.writeMap(enchantments.getEnchantments(),
+                (ew, enchantment) -> ew.writeVarInt(enchantment.getId(version)),
+                PacketWrapper::writeVarInt
+        );
+        wrapper.writeBoolean(enchantments.isShowInTooltip());
+    }
+
+    public int getEnchantmentLevel(EnchantmentType enchantment) {
+        return this.enchantments.getOrDefault(enchantment, 0);
+    }
+
+    public void setEnchantmentLevel(EnchantmentType enchantment, int level) {
+        if (level == 0) {
+            this.enchantments.remove(enchantment);
+        } else {
+            this.enchantments.put(enchantment, level);
+        }
+    }
+
+    public boolean isEmpty() {
+        return this.getEnchantmentCount() < 1;
+    }
+
+    public int getEnchantmentCount() {
+        return this.enchantments.size();
+    }
+
+    public Map<EnchantmentType, Integer> getEnchantments() {
+        return this.enchantments;
+    }
+
+    public void setEnchantments(Map<EnchantmentType, Integer> enchantments) {
+        this.enchantments = enchantments;
+    }
+
+    public boolean isShowInTooltip() {
+        return this.showInTooltip;
+    }
+
+    public void setShowInTooltip(boolean showInTooltip) {
+        this.showInTooltip = showInTooltip;
+    }
+
+    @Override
+    public Iterator<Map.Entry<EnchantmentType, Integer>> iterator() {
+        return this.enchantments.entrySet().iterator();
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemEnchantments)) return false;
+        ItemEnchantments that = (ItemEnchantments) obj;
+        if (this.showInTooltip != that.showInTooltip) return false;
+        return this.enchantments.equals(that.enchantments);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.enchantments, this.showInTooltip);
+    }
+
+    @Override
+    public String toString() {
+        return "ItemEnchantments{enchantments=" + this.enchantments + ", showInTooltip=" + this.showInTooltip + '}';
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemFireworks.java

@@ -0,0 +1,80 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class ItemFireworks {
+
+    private int flightDuration;
+    private List<FireworkExplosion> explosions;
+
+    public ItemFireworks(int flightDuration, List<FireworkExplosion> explosions) {
+        this.flightDuration = flightDuration;
+        this.explosions = explosions;
+    }
+
+    public static ItemFireworks read(PacketWrapper<?> wrapper) {
+        int flightDuration = wrapper.readVarInt();
+        List<FireworkExplosion> explosions = wrapper.readList(FireworkExplosion::read);
+        return new ItemFireworks(flightDuration, explosions);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemFireworks fireworks) {
+        wrapper.writeVarInt(fireworks.flightDuration);
+        wrapper.writeList(fireworks.explosions, FireworkExplosion::write);
+    }
+
+    public int getFlightDuration() {
+        return this.flightDuration;
+    }
+
+    public void setFlightDuration(int flightDuration) {
+        this.flightDuration = flightDuration;
+    }
+
+    public void addExplosion(FireworkExplosion explosion) {
+        this.explosions.add(explosion);
+    }
+
+    public List<FireworkExplosion> getExplosions() {
+        return this.explosions;
+    }
+
+    public void setExplosions(List<FireworkExplosion> explosions) {
+        this.explosions = explosions;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemFireworks)) return false;
+        ItemFireworks that = (ItemFireworks) obj;
+        if (this.flightDuration != that.flightDuration) return false;
+        return this.explosions.equals(that.explosions);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.flightDuration, this.explosions);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemLock.java

@@ -0,0 +1,63 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.nbt.NBTString;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.Objects;
+
+public class ItemLock {
+
+    private String code;
+
+    public ItemLock(String code) {
+        this.code = code;
+    }
+
+    public static ItemLock read(PacketWrapper<?> wrapper) {
+        NBTString codeTag = (NBTString) wrapper.readNBTRaw();
+        return new ItemLock(codeTag.getValue());
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemLock lock) {
+        wrapper.writeNBTRaw(new NBTString(lock.code));
+    }
+
+    public String getCode() {
+        return this.code;
+    }
+
+    public void setCode(String code) {
+        this.code = code;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemLock)) return false;
+        ItemLock itemLock = (ItemLock) obj;
+        return this.code.equals(itemLock.code);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.code);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemLore.java

@@ -0,0 +1,76 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+
+import java.util.Collections;
+import java.util.List;
+import java.util.Objects;
+
+public class ItemLore {
+
+    public static final ItemLore EMPTY = new ItemLore(Collections.emptyList());
+
+    private List<Component> lines;
+
+    public ItemLore(List<Component> lines) {
+        this.lines = lines;
+    }
+
+    public static ItemLore read(PacketWrapper<?> wrapper) {
+        List<Component> lines = wrapper.readList(PacketWrapper::readComponent);
+        return new ItemLore(lines);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemLore lore) {
+        wrapper.writeList(lore.lines, PacketWrapper::writeComponent);
+    }
+
+    public void addLine(Component line) {
+        this.lines.add(line);
+    }
+
+    public List<Component> getLines() {
+        return this.lines;
+    }
+
+    public void setLines(List<Component> lines) {
+        this.lines = lines;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemLore)) return false;
+        ItemLore itemLore = (ItemLore) obj;
+        return this.lines.equals(itemLore.lines);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.lines);
+    }
+
+    @Override
+    public String toString() {
+        return "ItemLore{lines=" + this.lines + '}';
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemMapDecorations.java

@@ -0,0 +1,176 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.item.mapdecoration.MapDecorationType;
+import com.github.retrooper.packetevents.protocol.item.mapdecoration.MapDecorationTypes;
+import com.github.retrooper.packetevents.protocol.nbt.NBT;
+import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.protocol.nbt.NBTDouble;
+import com.github.retrooper.packetevents.protocol.nbt.NBTFloat;
+import com.github.retrooper.packetevents.protocol.nbt.NBTString;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.ApiStatus;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Objects;
+
+public class ItemMapDecorations {
+
+    private Map<String, Decoration> decorations;
+
+    public ItemMapDecorations(Map<String, Decoration> decorations) {
+        this.decorations = decorations;
+    }
+
+    public static ItemMapDecorations read(PacketWrapper<?> wrapper) {
+        NBTCompound compound = wrapper.readNBT();
+        Map<String, Decoration> decorations = new HashMap<>(compound.size());
+        for (Map.Entry<String, NBT> tag : compound.getTags().entrySet()) {
+            Decoration decoration = Decoration.readCompound((NBTCompound) tag.getValue());
+            decorations.put(tag.getKey(), decoration);
+        }
+        return new ItemMapDecorations(decorations);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemMapDecorations decorations) {
+        NBTCompound compound = new NBTCompound();
+        for (Map.Entry<String, Decoration> decoration : decorations.decorations.entrySet()) {
+            NBTCompound entry = new NBTCompound();
+            Decoration.writeCompound(entry, decoration.getValue());
+            compound.setTag(decoration.getKey(), entry);
+        }
+        wrapper.writeNBT(compound);
+    }
+
+    public @Nullable Decoration getDecoration(String key) {
+        return this.decorations.get(key);
+    }
+
+    public void setDecoration(String key, @Nullable Decoration decoration) {
+        if (decoration != null) {
+            this.decorations.put(key, decoration);
+        } else {
+            this.decorations.remove(key);
+        }
+    }
+
+    public Map<String, Decoration> getDecorations() {
+        return this.decorations;
+    }
+
+    public void setDecorations(Map<String, Decoration> decorations) {
+        this.decorations = decorations;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemMapDecorations)) return false;
+        ItemMapDecorations that = (ItemMapDecorations) obj;
+        return this.decorations.equals(that.decorations);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.decorations);
+    }
+
+    public static final class Decoration {
+
+        private MapDecorationType type;
+        private double x;
+        private double z;
+        private float rotation;
+
+        public Decoration(MapDecorationType type, double x, double z, float rotation) {
+            this.type = type;
+            this.x = x;
+            this.z = z;
+            this.rotation = rotation;
+        }
+
+        @ApiStatus.Internal
+        public static Decoration readCompound(NBTCompound compound) {
+            MapDecorationType type = MapDecorationTypes.getByName(compound.getStringTagValueOrThrow("type"));
+            double x = compound.getNumberTagOrThrow("x").getAsDouble();
+            double z = compound.getNumberTagOrThrow("z").getAsDouble();
+            float rotation = compound.getNumberTagOrThrow("rotation").getAsFloat();
+            return new Decoration(type, x, z, rotation);
+        }
+
+        @ApiStatus.Internal
+        public static void writeCompound(NBTCompound compound, Decoration decoration) {
+            compound.setTag("type", new NBTString(decoration.type.getName().toString()));
+            compound.setTag("x", new NBTDouble(decoration.x));
+            compound.setTag("z", new NBTDouble(decoration.z));
+            compound.setTag("float", new NBTFloat(decoration.rotation));
+        }
+
+        public MapDecorationType getType() {
+            return this.type;
+        }
+
+        public void setType(MapDecorationType type) {
+            this.type = type;
+        }
+
+        public double getX() {
+            return this.x;
+        }
+
+        public void setX(double x) {
+            this.x = x;
+        }
+
+        public double getZ() {
+            return this.z;
+        }
+
+        public void setZ(double z) {
+            this.z = z;
+        }
+
+        public float getRotation() {
+            return this.rotation;
+        }
+
+        public void setRotation(float rotation) {
+            this.rotation = rotation;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof Decoration)) return false;
+            Decoration that = (Decoration) obj;
+            if (Double.compare(that.x, this.x) != 0) return false;
+            if (Double.compare(that.z, this.z) != 0) return false;
+            if (Float.compare(that.rotation, this.rotation) != 0) return false;
+            return this.type.equals(that.type);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.type, this.x, this.z, this.rotation);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemMapPostProcessingState.java

@@ -0,0 +1,24 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+public enum ItemMapPostProcessingState {
+    LOCKED,
+    SCALED,
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemPotionContents.java

@@ -0,0 +1,101 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.potion.Potion;
+import com.github.retrooper.packetevents.protocol.potion.PotionEffect;
+import com.github.retrooper.packetevents.protocol.potion.Potions;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Objects;
+
+public class ItemPotionContents {
+
+    private @Nullable Potion potion;
+    private @Nullable Integer customColor;
+    private List<PotionEffect> customEffects;
+
+    public ItemPotionContents(
+            @Nullable Potion potion,
+            @Nullable Integer customColor,
+            List<PotionEffect> customEffects
+    ) {
+        this.potion = potion;
+        this.customColor = customColor;
+        this.customEffects = customEffects;
+    }
+
+    public static ItemPotionContents read(PacketWrapper<?> wrapper) {
+        Potion potionId = wrapper.readOptional(ew -> ew.readMappedEntity(Potions::getById));
+        Integer customColor = wrapper.readOptional(PacketWrapper::readInt);
+        List<PotionEffect> customEffects = wrapper.readList(PotionEffect::read);
+        return new ItemPotionContents(potionId, customColor, customEffects);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemPotionContents contents) {
+        wrapper.writeOptional(contents.potion, PacketWrapper::writeMappedEntity);
+        wrapper.writeOptional(contents.customColor, PacketWrapper::writeInt);
+        wrapper.writeList(contents.customEffects, PotionEffect::write);
+    }
+
+    public @Nullable Potion getPotion() {
+        return this.potion;
+    }
+
+    public void setPotion(@Nullable Potion potion) {
+        this.potion = potion;
+    }
+
+    public @Nullable Integer getCustomColor() {
+        return this.customColor;
+    }
+
+    public void setCustomColor(@Nullable Integer customColor) {
+        this.customColor = customColor;
+    }
+
+    private void addCustomEffect(PotionEffect effect) {
+        this.customEffects.add(effect);
+    }
+
+    public List<PotionEffect> getCustomEffects() {
+        return this.customEffects;
+    }
+
+    public void setCustomEffects(List<PotionEffect> customEffects) {
+        this.customEffects = customEffects;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemPotionContents)) return false;
+        ItemPotionContents that = (ItemPotionContents) obj;
+        if (!Objects.equals(this.potion, that.potion)) return false;
+        if (!Objects.equals(this.customColor, that.customColor)) return false;
+        return this.customEffects.equals(that.customEffects);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.potion, this.customColor, this.customEffects);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemProfile.java

@@ -0,0 +1,165 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Objects;
+import java.util.UUID;
+
+public class ItemProfile {
+
+    private @Nullable String name;
+    private @Nullable UUID id;
+    private List<Property> properties;
+
+    public ItemProfile(
+            @Nullable String name,
+            @Nullable UUID id,
+            List<Property> properties
+    ) {
+        this.name = name;
+        this.id = id;
+        this.properties = properties;
+    }
+
+    public static ItemProfile read(PacketWrapper<?> wrapper) {
+        String name = wrapper.readOptional(ew -> ew.readString(16));
+        UUID id = wrapper.readOptional(PacketWrapper::readUUID);
+        List<Property> properties = wrapper.readList(Property::read);
+        return new ItemProfile(name, id, properties);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemProfile profile) {
+        wrapper.writeOptional(profile.name, (ew, name) -> ew.writeString(name, 16));
+        wrapper.writeOptional(profile.id, PacketWrapper::writeUUID);
+        wrapper.writeList(profile.properties, Property::write);
+    }
+
+    public @Nullable String getName() {
+        return this.name;
+    }
+
+    public void setName(@Nullable String name) {
+        this.name = name;
+    }
+
+    public @Nullable UUID getId() {
+        return this.id;
+    }
+
+    public void setId(@Nullable UUID id) {
+        this.id = id;
+    }
+
+    public void addProperty(Property property) {
+        this.properties.add(property);
+    }
+
+    public List<Property> getProperties() {
+        return this.properties;
+    }
+
+    public void setProperties(List<Property> properties) {
+        this.properties = properties;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemProfile)) return false;
+        ItemProfile that = (ItemProfile) obj;
+        if (!Objects.equals(this.name, that.name)) return false;
+        if (!Objects.equals(this.id, that.id)) return false;
+        return this.properties.equals(that.properties);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.name, this.id, this.properties);
+    }
+
+    public static class Property {
+
+        private String name;
+        private String value;
+        private @Nullable String signature;
+
+        public Property(String name, String value, @Nullable String signature) {
+            this.name = name;
+            this.value = value;
+            this.signature = signature;
+        }
+
+        public static Property read(PacketWrapper<?> wrapper) {
+            String name = wrapper.readString(64);
+            String value = wrapper.readString(32767);
+            String signature = wrapper.readOptional(ew -> ew.readString(1024));
+            return new Property(name, value, signature);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, Property property) {
+            wrapper.writeString(property.name, 64);
+            wrapper.writeString(property.value, 32767);
+            wrapper.writeOptional(property.signature,
+                    (ew, signature) -> ew.writeString(signature, 1024));
+        }
+
+        public String getName() {
+            return this.name;
+        }
+
+        public void setName(String name) {
+            this.name = name;
+        }
+
+        public String getValue() {
+            return this.value;
+        }
+
+        public void setValue(String value) {
+            this.value = value;
+        }
+
+        public @Nullable String getSignature() {
+            return this.signature;
+        }
+
+        public void setSignature(@Nullable String signature) {
+            this.signature = signature;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof Property)) return false;
+            Property property = (Property) obj;
+            if (!this.name.equals(property.name)) return false;
+            if (!this.value.equals(property.value)) return false;
+            return Objects.equals(this.signature, property.signature);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.name, this.value, this.signature);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemRarity.java

@@ -0,0 +1,26 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+public enum ItemRarity {
+    COMMON,
+    UNCOMMON,
+    RARE,
+    EPIC,
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemRecipes.java

@@ -0,0 +1,72 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class ItemRecipes {
+
+    private List<ResourceLocation> recipes;
+
+    public ItemRecipes(List<ResourceLocation> recipes) {
+        this.recipes = recipes;
+    }
+
+    public static ItemRecipes read(PacketWrapper<?> wrapper) {
+        List<ResourceLocation> recipes = wrapper.readList(PacketWrapper::readIdentifier);
+        return new ItemRecipes(recipes);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemRecipes recipes) {
+        wrapper.writeList(recipes.recipes, PacketWrapper::writeIdentifier);
+    }
+
+    public void addRecipe(ResourceLocation recipeKey) {
+        this.recipes.add(recipeKey);
+    }
+
+    public void removeRecipe(ResourceLocation recipeKey) {
+        this.recipes.remove(recipeKey);
+    }
+
+    public List<ResourceLocation> getRecipes() {
+        return this.recipes;
+    }
+
+    public void setRecipes(List<ResourceLocation> recipes) {
+        this.recipes = recipes;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemRecipes)) return false;
+        ItemRecipes that = (ItemRecipes) obj;
+        return this.recipes.equals(that.recipes);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.recipes);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/ItemTool.java

@@ -0,0 +1,166 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntitySet;
+import com.github.retrooper.packetevents.protocol.world.states.type.StateType;
+import com.github.retrooper.packetevents.protocol.world.states.type.StateTypes;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Objects;
+
+public class ItemTool {
+
+    private List<Rule> rules;
+    private float defaultMiningSpeed;
+    private int damagePerBlock;
+
+    public ItemTool(List<Rule> rules, float defaultMiningSpeed, int damagePerBlock) {
+        this.rules = rules;
+        this.defaultMiningSpeed = defaultMiningSpeed;
+        this.damagePerBlock = damagePerBlock;
+    }
+
+    public static ItemTool read(PacketWrapper<?> wrapper) {
+        List<Rule> rules = wrapper.readList(Rule::read);
+        float defaultMiningSpeed = wrapper.readFloat();
+        int damagePerBlock = wrapper.readVarInt();
+        return new ItemTool(rules, defaultMiningSpeed, damagePerBlock);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, ItemTool tool) {
+        wrapper.writeList(tool.rules, Rule::write);
+        wrapper.writeFloat(tool.defaultMiningSpeed);
+        wrapper.writeVarInt(tool.damagePerBlock);
+    }
+
+    public void addRule(Rule rule) {
+        this.rules.add(rule);
+    }
+
+    public List<Rule> getRules() {
+        return this.rules;
+    }
+
+    public void setRules(List<Rule> rules) {
+        this.rules = rules;
+    }
+
+    public float getDefaultMiningSpeed() {
+        return this.defaultMiningSpeed;
+    }
+
+    public void setDefaultMiningSpeed(float defaultMiningSpeed) {
+        this.defaultMiningSpeed = defaultMiningSpeed;
+    }
+
+    public int getDamagePerBlock() {
+        return this.damagePerBlock;
+    }
+
+    public void setDamagePerBlock(int damagePerBlock) {
+        this.damagePerBlock = damagePerBlock;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof ItemTool)) return false;
+        ItemTool itemTool = (ItemTool) obj;
+        if (Float.compare(itemTool.defaultMiningSpeed, this.defaultMiningSpeed) != 0) return false;
+        if (this.damagePerBlock != itemTool.damagePerBlock) return false;
+        return this.rules.equals(itemTool.rules);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.rules, this.defaultMiningSpeed, this.damagePerBlock);
+    }
+
+    public static class Rule {
+
+        private MappedEntitySet<StateType.Mapped> blocks;
+        private @Nullable Float speed;
+        private @Nullable Boolean correctForDrops;
+
+        public Rule(
+                MappedEntitySet<StateType.Mapped> blocks,
+                @Nullable Float speed,
+                @Nullable Boolean correctForDrops
+        ) {
+            this.blocks = blocks;
+            this.speed = speed;
+            this.correctForDrops = correctForDrops;
+        }
+
+        public static Rule read(PacketWrapper<?> wrapper) {
+            MappedEntitySet<StateType.Mapped> blocks = MappedEntitySet.read(wrapper, StateTypes::getMappedById);
+            Float speed = wrapper.readOptional(PacketWrapper::readFloat);
+            Boolean correctForDrops = wrapper.readOptional(PacketWrapper::readBoolean);
+            return new Rule(blocks, speed, correctForDrops);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, Rule rule) {
+            MappedEntitySet.write(wrapper, rule.blocks);
+            wrapper.writeOptional(rule.speed, PacketWrapper::writeFloat);
+            wrapper.writeOptional(rule.correctForDrops, PacketWrapper::writeBoolean);
+        }
+
+        public MappedEntitySet<StateType.Mapped> getBlocks() {
+            return this.blocks;
+        }
+
+        public void setBlocks(MappedEntitySet<StateType.Mapped> blocks) {
+            this.blocks = blocks;
+        }
+
+        public @Nullable Float getSpeed() {
+            return this.speed;
+        }
+
+        public void setSpeed(@Nullable Float speed) {
+            this.speed = speed;
+        }
+
+        public @Nullable Boolean getCorrectForDrops() {
+            return this.correctForDrops;
+        }
+
+        public void setCorrectForDrops(@Nullable Boolean correctForDrops) {
+            this.correctForDrops = correctForDrops;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof Rule)) return false;
+            Rule rule = (Rule) obj;
+            if (!this.blocks.equals(rule.blocks)) return false;
+            if (!Objects.equals(this.speed, rule.speed)) return false;
+            return Objects.equals(this.correctForDrops, rule.correctForDrops);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.blocks, this.speed, this.correctForDrops);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/LodestoneTracker.java

@@ -0,0 +1,77 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.world.WorldBlockPosition;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Objects;
+
+public class LodestoneTracker {
+
+    private @Nullable WorldBlockPosition target;
+    private boolean tracked;
+
+    public LodestoneTracker(@Nullable WorldBlockPosition target, boolean tracked) {
+        this.target = target;
+        this.tracked = tracked;
+    }
+
+    public static LodestoneTracker read(PacketWrapper<?> wrapper) {
+        WorldBlockPosition target = wrapper.readOptional(PacketWrapper::readWorldBlockPosition);
+        boolean tracked = wrapper.readBoolean();
+        return new LodestoneTracker(target, tracked);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, LodestoneTracker tracker) {
+        wrapper.writeOptional(tracker.target, PacketWrapper::writeWorldBlockPosition);
+        wrapper.writeBoolean(tracker.tracked);
+    }
+
+    public @Nullable WorldBlockPosition getTarget() {
+        return this.target;
+    }
+
+    public void setTarget(@Nullable WorldBlockPosition target) {
+        this.target = target;
+    }
+
+    public boolean isTracked() {
+        return this.tracked;
+    }
+
+    public void setTracked(boolean tracked) {
+        this.tracked = tracked;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof LodestoneTracker)) return false;
+        LodestoneTracker that = (LodestoneTracker) obj;
+        if (this.tracked != that.tracked) return false;
+        return Objects.equals(this.target, that.target);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.target, this.tracked);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/PotDecorations.java

@@ -0,0 +1,125 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.item.type.ItemType;
+import com.github.retrooper.packetevents.protocol.item.type.ItemTypes;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayDeque;
+import java.util.Arrays;
+import java.util.List;
+import java.util.Objects;
+import java.util.Queue;
+
+public class PotDecorations {
+
+    private @Nullable ItemType back;
+    private @Nullable ItemType left;
+    private @Nullable ItemType right;
+    private @Nullable ItemType front;
+
+    private PotDecorations(Queue<ItemType> items) {
+        this(items.poll(), items.poll(), items.poll(), items.poll());
+    }
+
+    public PotDecorations(
+            @Nullable ItemType back,
+            @Nullable ItemType left,
+            @Nullable ItemType right,
+            @Nullable ItemType front
+    ) {
+        this.back = back;
+        this.left = left;
+        this.right = right;
+        this.front = front;
+    }
+
+    private List<ItemType> asList() {
+        return Arrays.asList(this.back, this.left, this.right, this.front);
+    }
+
+    private static @Nullable ItemType readItem(PacketWrapper<?> wrapper) {
+        ItemType type = wrapper.readMappedEntity(ItemTypes::getById);
+        return type == ItemTypes.BRICK ? null : type;
+    }
+
+    public static PotDecorations read(PacketWrapper<?> wrapper) {
+        Queue<ItemType> items = wrapper.<ItemType, Queue<ItemType>>readCollection(
+                ArrayDeque::new, PotDecorations::readItem);
+        return new PotDecorations(items);
+    }
+
+    private static void writeItem(PacketWrapper<?> wrapper, @Nullable ItemType type) {
+        wrapper.writeMappedEntity(type == null ? ItemTypes.BRICK : type);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, PotDecorations decorations) {
+        wrapper.writeList(decorations.asList(), PotDecorations::writeItem);
+    }
+
+    public @Nullable ItemType getBack() {
+        return this.back;
+    }
+
+    public void setBack(@Nullable ItemType back) {
+        this.back = back;
+    }
+
+    public @Nullable ItemType getLeft() {
+        return this.left;
+    }
+
+    public void setLeft(@Nullable ItemType left) {
+        this.left = left;
+    }
+
+    public @Nullable ItemType getRight() {
+        return this.right;
+    }
+
+    public void setRight(@Nullable ItemType right) {
+        this.right = right;
+    }
+
+    public @Nullable ItemType getFront() {
+        return this.front;
+    }
+
+    public void setFront(@Nullable ItemType front) {
+        this.front = front;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof PotDecorations)) return false;
+        PotDecorations that = (PotDecorations) obj;
+        if (!Objects.equals(this.back, that.back)) return false;
+        if (!Objects.equals(this.left, that.left)) return false;
+        if (!Objects.equals(this.right, that.right)) return false;
+        return Objects.equals(this.front, that.front);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.back, this.left, this.right, this.front);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/SuspiciousStewEffects.java

@@ -0,0 +1,121 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.protocol.potion.PotionType;
+import com.github.retrooper.packetevents.protocol.potion.PotionTypes;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+import java.util.List;
+import java.util.Objects;
+
+public class SuspiciousStewEffects {
+
+    private List<EffectEntry> effects;
+
+    public SuspiciousStewEffects(List<EffectEntry> effects) {
+        this.effects = effects;
+    }
+
+    public static SuspiciousStewEffects read(PacketWrapper<?> wrapper) {
+        List<EffectEntry> effects = wrapper.readList(EffectEntry::read);
+        return new SuspiciousStewEffects(effects);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, SuspiciousStewEffects effects) {
+        wrapper.writeList(effects.effects, EffectEntry::write);
+    }
+
+    public void addEffect(EffectEntry effect) {
+        this.effects.add(effect);
+    }
+
+    public List<EffectEntry> getEffects() {
+        return this.effects;
+    }
+
+    public void setEffects(List<EffectEntry> effects) {
+        this.effects = effects;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof SuspiciousStewEffects)) return false;
+        SuspiciousStewEffects that = (SuspiciousStewEffects) obj;
+        return this.effects.equals(that.effects);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.effects);
+    }
+
+    public static class EffectEntry {
+
+        private PotionType type;
+        private int duration;
+
+        public EffectEntry(PotionType type, int duration) {
+            this.type = type;
+            this.duration = duration;
+        }
+
+        public static EffectEntry read(PacketWrapper<?> wrapper) {
+            PotionType type = wrapper.readMappedEntity(PotionTypes::getById);
+            int duration = wrapper.readVarInt();
+            return new EffectEntry(type, duration);
+        }
+
+        public static void write(PacketWrapper<?> wrapper, EffectEntry effect) {
+            wrapper.writeMappedEntity(effect.type);
+            wrapper.writeVarInt(effect.duration);
+        }
+
+        public PotionType getType() {
+            return this.type;
+        }
+
+        public void setType(PotionType type) {
+            this.type = type;
+        }
+
+        public int getDuration() {
+            return this.duration;
+        }
+
+        public void setDuration(int duration) {
+            this.duration = duration;
+        }
+
+        @Override
+        public boolean equals(Object obj) {
+            if (this == obj) return true;
+            if (!(obj instanceof EffectEntry)) return false;
+            EffectEntry that = (EffectEntry) obj;
+            if (this.duration != that.duration) return false;
+            return this.type.equals(that.type);
+        }
+
+        @Override
+        public int hashCode() {
+            return Objects.hash(this.type, this.duration);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/WritableBookContent.java

@@ -0,0 +1,75 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.util.Filterable;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Objects;
+
+public class WritableBookContent {
+
+    private List<Filterable<String>> pages;
+
+    public WritableBookContent(List<Filterable<String>> pages) {
+        this.pages = pages;
+    }
+
+    public static WritableBookContent read(PacketWrapper<?> wrapper) {
+        List<Filterable<String>> pages = wrapper.readList(ew -> Filterable.read(
+                ew, eew -> eew.readString(1024)));
+        return new WritableBookContent(pages);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, WritableBookContent content) {
+        wrapper.writeList(content.pages, (ew, page) -> Filterable.write(
+                ew, page, (eew, text) -> eew.writeString(text, 1024)));
+    }
+
+    public @Nullable Filterable<String> getPage(int index) {
+        return index >= 0 && index < this.pages.size() ? this.pages.get(index) : null;
+    }
+
+    public void addPage(Filterable<String> page) {
+        this.pages.add(page);
+    }
+
+    public List<Filterable<String>> getPages() {
+        return this.pages;
+    }
+
+    public void setPages(List<Filterable<String>> pages) {
+        this.pages = pages;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof WritableBookContent)) return false;
+        WritableBookContent that = (WritableBookContent) obj;
+        return this.pages.equals(that.pages);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hashCode(this.pages);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/component/builtin/item/WrittenBookContent.java

@@ -0,0 +1,131 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.component.builtin.item;
+
+import com.github.retrooper.packetevents.util.Filterable;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Objects;
+
+public class WrittenBookContent {
+
+    private Filterable<String> title;
+    private String author;
+    private int generation;
+    private List<Filterable<Component>> pages;
+    private boolean resolved;
+
+    public WrittenBookContent(
+            Filterable<String> title, String author, int generation,
+            List<Filterable<Component>> pages, boolean resolved
+    ) {
+        this.title = title;
+        this.author = author;
+        this.generation = generation;
+        this.pages = pages;
+        this.resolved = resolved;
+    }
+
+    public static WrittenBookContent read(PacketWrapper<?> wrapper) {
+        Filterable<String> title = Filterable.read(wrapper, ew -> ew.readString(32));
+        String author = wrapper.readString();
+        int generation = wrapper.readVarInt();
+        List<Filterable<Component>> pages = wrapper.readList(ew -> Filterable.read(
+                ew, PacketWrapper::readComponent));
+        boolean resolved = wrapper.readBoolean();
+        return new WrittenBookContent(title, author, generation, pages, resolved);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, WrittenBookContent content) {
+        Filterable.write(wrapper, content.title, (ew, text) -> ew.writeString(text, 32));
+        wrapper.writeString(content.author);
+        wrapper.writeVarInt(content.generation);
+        wrapper.writeList(content.pages, (ew, page) -> Filterable.write(
+                ew, page, PacketWrapper::writeComponent));
+        wrapper.writeBoolean(content.resolved);
+    }
+
+    public Filterable<String> getTitle() {
+        return this.title;
+    }
+
+    public void setTitle(Filterable<String> title) {
+        this.title = title;
+    }
+
+    public String getAuthor() {
+        return this.author;
+    }
+
+    public void setAuthor(String author) {
+        this.author = author;
+    }
+
+    public int getGeneration() {
+        return this.generation;
+    }
+
+    public void setGeneration(int generation) {
+        this.generation = generation;
+    }
+
+    public @Nullable Filterable<Component> getPage(int index) {
+        return index >= 0 && index < this.pages.size() ? this.pages.get(index) : null;
+    }
+
+    public void addPage(Filterable<Component> page) {
+        this.pages.add(page);
+    }
+
+    public List<Filterable<Component>> getPages() {
+        return this.pages;
+    }
+
+    public void setPages(List<Filterable<Component>> pages) {
+        this.pages = pages;
+    }
+
+    public boolean isResolved() {
+        return this.resolved;
+    }
+
+    public void setResolved(boolean resolved) {
+        this.resolved = resolved;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof WrittenBookContent)) return false;
+        WrittenBookContent that = (WrittenBookContent) obj;
+        if (this.generation != that.generation) return false;
+        if (this.resolved != that.resolved) return false;
+        if (!this.title.equals(that.title)) return false;
+        if (!this.author.equals(that.author)) return false;
+        return this.pages.equals(that.pages);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.title, this.author, this.generation, this.pages, this.resolved);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/entity/armadillo/ArmadilloState.java

@@ -0,0 +1,27 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2023 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.entity.armadillo;
+
+public enum ArmadilloState {
+
+    IDLE,
+    ROLLING,
+    SCARED,
+    UNROLLING,
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/entity/data/EntityDataTypes.java

@@ -20,27 +20,27 @@ package com.github.retrooper.packetevents.protocol.entity.data;
 
 import com.github.retrooper.packetevents.PacketEvents;
 import com.github.retrooper.packetevents.manager.server.ServerVersion;
+import com.github.retrooper.packetevents.protocol.entity.armadillo.ArmadilloState;
 import com.github.retrooper.packetevents.protocol.entity.pose.EntityPose;
 import com.github.retrooper.packetevents.protocol.entity.sniffer.SnifferState;
 import com.github.retrooper.packetevents.protocol.entity.villager.VillagerData;
 import com.github.retrooper.packetevents.protocol.item.ItemStack;
 import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
 import com.github.retrooper.packetevents.protocol.particle.Particle;
-import com.github.retrooper.packetevents.protocol.particle.type.ParticleType;
-import com.github.retrooper.packetevents.protocol.particle.type.ParticleTypes;
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.protocol.world.BlockFace;
 import com.github.retrooper.packetevents.protocol.world.WorldBlockPosition;
 import com.github.retrooper.packetevents.resources.ResourceLocation;
 import com.github.retrooper.packetevents.util.Quaternion4f;
-import com.github.retrooper.packetevents.util.TypesBuilder;
-import com.github.retrooper.packetevents.util.TypesBuilderData;
 import com.github.retrooper.packetevents.util.Vector3f;
 import com.github.retrooper.packetevents.util.Vector3i;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
 import com.github.retrooper.packetevents.wrapper.PacketWrapper;
 import net.kyori.adventure.text.Component;
 
 import java.util.HashMap;
+import java.util.List;
 import java.util.Map;
 import java.util.Optional;
 import java.util.UUID;
@@ -55,15 +55,7 @@ public class EntityDataTypes {
 
     private static final Map<String, EntityDataType<?>> ENTITY_DATA_TYPE_MAP = new HashMap<>();
     private static final Map<Byte, Map<Integer, EntityDataType<?>>> ENTITY_DATA_TYPE_ID_MAP = new HashMap<>();
-    protected static final TypesBuilder TYPES_BUILDER = new TypesBuilder("entity/entity_data_type_mappings",
-            ClientVersion.V_1_8,
-            ClientVersion.V_1_9,
-            ClientVersion.V_1_11,
-            ClientVersion.V_1_13,
-            ClientVersion.V_1_14,
-            ClientVersion.V_1_19,
-            ClientVersion.V_1_19_3,
-            ClientVersion.V_1_19_4);
+    protected static final TypesBuilder TYPES_BUILDER = new TypesBuilder("entity/entity_data_type_mappings");
 
     public static final EntityDataType<Byte> BYTE = define("byte", PacketWrapper::readByte, PacketWrapper::writeByte);
 
@@ -153,14 +145,7 @@ public class EntityDataTypes {
 
     public static final EntityDataType<NBTCompound> NBT = define("nbt", PacketWrapper::readNBT, PacketWrapper::writeNBT);
 
-    public static final EntityDataType<Particle> PARTICLE = define("particle", wrapper -> {
-        int id = wrapper.readVarInt();
-        ParticleType type = ParticleTypes.getById(PacketEvents.getAPI().getServerManager().getVersion().toClientVersion(), id);
-        return new Particle(type, type.readDataFunction().apply(wrapper));
-    }, (wrapper, particle) -> {
-        wrapper.writeVarInt(particle.getType().getId(PacketEvents.getAPI().getServerManager().getVersion().toClientVersion()));
-        particle.getType().writeDataFunction().accept(wrapper, particle.getData());
-    });
+    public static final EntityDataType<Particle<?>> PARTICLE = define("particle", Particle::read, Particle::write);
 
     public static final EntityDataType<VillagerData> VILLAGER_DATA = define("villager_data", PacketWrapper::readVillagerData, PacketWrapper::writeVillagerData);
 
@@ -194,7 +179,6 @@ public class EntityDataTypes {
         return SnifferState.values()[id];
     }, (PacketWrapper<?> wrapper, SnifferState value) -> wrapper.writeVarInt(value.ordinal()));
 
-
     public static final EntityDataType<Vector3f> VECTOR3F = define("vector3f",
             (PacketWrapper<?> wrapper) -> new Vector3f(wrapper.readFloat(), wrapper.readFloat(), wrapper.readFloat()),
             (PacketWrapper<?> wrapper, Vector3f value) -> {
@@ -212,6 +196,20 @@ public class EntityDataTypes {
                 wrapper.writeFloat(value.getW());
             });
 
+    // Added in 1.20.5
+    public static final EntityDataType<ArmadilloState> ARMADILLO_STATE = define("armadillo_state",
+            (PacketWrapper<?> wrapper) -> ArmadilloState.values()[wrapper.readVarInt()],
+            (PacketWrapper<?> wrapper, ArmadilloState value) -> wrapper.writeVarInt(value.ordinal())
+    );
+
+    public static final EntityDataType<List<Particle<?>>> PARTICLES = define("particles",
+            wrapper -> wrapper.readList(Particle::read),
+            (wrapper, particles) -> wrapper.writeList(particles, Particle::write)
+    );
+
+    public static final EntityDataType<Integer> WOLF_VARIANT =
+            define("wolf_variant_type", readIntDeserializer(), writeIntSerializer());
+
     public static EntityDataType<?> getById(ClientVersion version, int id) {
         int index = TYPES_BUILDER.getDataIndex(version);
         Map<Integer, EntityDataType<?>> typeIdMap = ENTITY_DATA_TYPE_ID_MAP.get((byte) index);
@@ -367,4 +365,8 @@ public class EntityDataTypes {
         }
     }
 
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/entity/pose/EntityPose.java

@@ -35,7 +35,11 @@ public enum EntityPose {
     ROARING,
     SNIFFING,
     EMERGING,
-    DIGGING;
+    DIGGING,
+    //Added in 1.20.4
+    SLIDING,
+    SHOOTING,
+    INHALING;
 
    public int getId(ClientVersion version) {
        if (this == DYING && version.isOlderThan(ClientVersion.V_1_17)) {

api/src/main/java/com/github/retrooper/packetevents/protocol/entity/type/EntityTypes.java

@@ -20,8 +20,8 @@ package com.github.retrooper.packetevents.protocol.entity.type;
 
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.resources.ResourceLocation;
-import com.github.retrooper.packetevents.util.TypesBuilder;
-import com.github.retrooper.packetevents.util.TypesBuilderData;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.HashMap;
@@ -33,33 +33,8 @@ public class EntityTypes {
     //Key - mappings version, value - map with entity type ids and entity types
     private static final Map<Byte, Map<Integer, EntityType>> ENTITY_TYPE_ID_MAP = new HashMap<>();
     private static final Map<Byte, Map<Integer, EntityType>> LEGACY_ENTITY_TYPE_ID_MAP = new HashMap<>();
-    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("entity/entity_type_mappings",
-            ClientVersion.V_1_10,
-            ClientVersion.V_1_11,
-            ClientVersion.V_1_12,
-            ClientVersion.V_1_13,
-            ClientVersion.V_1_14,
-            ClientVersion.V_1_15,
-            ClientVersion.V_1_16,
-            ClientVersion.V_1_16_2,
-            ClientVersion.V_1_17,
-            ClientVersion.V_1_19,
-            ClientVersion.V_1_19_3,
-            ClientVersion.V_1_19_4,
-            ClientVersion.V_1_20_3);
-    private static final TypesBuilder LEGACY_TYPES_BUILDER = new TypesBuilder("entity/legacy_entity_type_mappings",
-            ClientVersion.V_1_8,
-            ClientVersion.V_1_9,
-            ClientVersion.V_1_10,
-            ClientVersion.V_1_11,
-            ClientVersion.V_1_12,
-            ClientVersion.V_1_13);
-
-
-    static {
-        TYPES_BUILDER.unloadFileMappings();
-        LEGACY_TYPES_BUILDER.unloadFileMappings();
-    }
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("entity/entity_type_mappings");
+    private static final TypesBuilder LEGACY_TYPES_BUILDER = new TypesBuilder("entity/legacy_entity_type_mappings");
 
     public static EntityType define(String key, @Nullable EntityType parent) {
         TypesBuilderData data = TYPES_BUILDER.define(key);
@@ -313,5 +288,17 @@ public class EntityTypes {
 
     // Added in 1.20.3
     public static final EntityType BREEZE = define("breeze", ABSTRACT_MONSTER);
-    public static final EntityType WIND_CHARGE = define("wind_charge", PROJECTILE_ABSTRACT);
+    public static final EntityType ABSTRACT_WIND_CHARGE = define("abstract_wind_charge", PROJECTILE_ABSTRACT);
+    public static final EntityType WIND_CHARGE = define("wind_charge", ABSTRACT_WIND_CHARGE);
+
+    // Added in 1.20.5
+    public static final EntityType ARMADILLO = define("armadillo", ABSTRACT_ANIMAL);
+    public static final EntityType BOGGED = define("bogged", ABSTRACT_SKELETON);
+    public static final EntityType BREEZE_WIND_CHARGE = define("breeze_wind_charge", ABSTRACT_WIND_CHARGE);
+    public static final EntityType OMINOUS_ITEM_SPAWNER = define("ominous_item_spawner", ENTITY);
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+        LEGACY_TYPES_BUILDER.unloadFileMappings();
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/entity/villager/VillagerData.java

@@ -18,16 +18,23 @@
 
 package com.github.retrooper.packetevents.protocol.entity.villager;
 
+import com.github.retrooper.packetevents.protocol.entity.villager.level.VillagerLevel;
 import com.github.retrooper.packetevents.protocol.entity.villager.profession.VillagerProfession;
 import com.github.retrooper.packetevents.protocol.entity.villager.profession.VillagerProfessions;
 import com.github.retrooper.packetevents.protocol.entity.villager.type.VillagerType;
 import com.github.retrooper.packetevents.protocol.entity.villager.type.VillagerTypes;
+import org.jetbrains.annotations.Nullable;
 
 public class VillagerData {
+
     private VillagerType type;
     private VillagerProfession profession;
     private int level;
 
+    public VillagerData(VillagerType type, VillagerProfession profession, VillagerLevel level) {
+        this(type, profession, level.getId());
+    }
+
     public VillagerData(VillagerType type, VillagerProfession profession, int level) {
         this.type = type;
         this.profession = profession;
@@ -55,10 +62,18 @@ public class VillagerData {
     }
 
     public int getLevel() {
-        return level;
+        return this.level;
+    }
+
+    public @Nullable VillagerLevel getVillagerLevel() {
+        return VillagerLevel.getById(this.level);
     }
 
     public void setLevel(int level) {
         this.level = level;
     }
+
+    public void setLevel(VillagerLevel level) {
+        this.level = level.getId();
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/entity/villager/level/VillagerLevel.java

@@ -0,0 +1,44 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.entity.villager.level;
+
+import org.jetbrains.annotations.Nullable;
+
+public enum VillagerLevel {
+
+    NOVICE,
+    APPRENTICE,
+    JOURNEYMAN,
+    EXPERT,
+    MASTER;
+
+    private static final VillagerLevel[] VALUES = values();
+
+    public static @Nullable VillagerLevel getById(int id) {
+        if (id >= 1 && id <= VALUES.length) {
+            return VALUES[id - 1];
+        }
+        return null;
+    }
+
+    public int getId() {
+        return this.ordinal() + 1;
+    }
+}
+

api/src/main/java/com/github/retrooper/packetevents/protocol/entity/villager/profession/VillagerProfessions.java

@@ -19,7 +19,6 @@
 package com.github.retrooper.packetevents.protocol.entity.villager.profession;
 
 import com.github.retrooper.packetevents.resources.ResourceLocation;
-import com.github.retrooper.packetevents.util.TypesBuilder;
 
 import java.util.HashMap;
 import java.util.Map;
@@ -50,7 +49,6 @@ public class VillagerProfessions {
         return VILLAGER_PROFESSION_ID_MAP.get((byte)id);
     }
 
-
     public static VillagerProfession getByName(String name) {
         return VILLAGER_PROFESSION_MAP.get(name);
     }

api/src/main/java/com/github/retrooper/packetevents/protocol/item/ItemStack.java

@@ -18,18 +18,36 @@
 
 package com.github.retrooper.packetevents.protocol.item;
 
+import com.github.retrooper.packetevents.protocol.component.ComponentType;
+import com.github.retrooper.packetevents.protocol.component.ComponentTypes;
+import com.github.retrooper.packetevents.protocol.component.PatchableComponentMap;
+import com.github.retrooper.packetevents.protocol.component.builtin.item.ItemEnchantments;
 import com.github.retrooper.packetevents.protocol.item.enchantment.Enchantment;
 import com.github.retrooper.packetevents.protocol.item.enchantment.type.EnchantmentType;
 import com.github.retrooper.packetevents.protocol.item.enchantment.type.EnchantmentTypes;
 import com.github.retrooper.packetevents.protocol.item.type.ItemType;
 import com.github.retrooper.packetevents.protocol.item.type.ItemTypes;
-import com.github.retrooper.packetevents.protocol.nbt.*;
+import com.github.retrooper.packetevents.protocol.nbt.NBTCompound;
+import com.github.retrooper.packetevents.protocol.nbt.NBTInt;
+import com.github.retrooper.packetevents.protocol.nbt.NBTList;
+import com.github.retrooper.packetevents.protocol.nbt.NBTShort;
+import com.github.retrooper.packetevents.protocol.nbt.NBTString;
+import com.github.retrooper.packetevents.protocol.nbt.NBTType;
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.ArrayList;
+import java.util.HashMap;
 import java.util.List;
+import java.util.Map;
 import java.util.Objects;
+import java.util.Optional;
+
+import static com.github.retrooper.packetevents.protocol.component.ComponentTypes.DAMAGE;
+import static com.github.retrooper.packetevents.protocol.component.ComponentTypes.ENCHANTMENTS;
+import static com.github.retrooper.packetevents.protocol.component.ComponentTypes.MAX_DAMAGE;
+import static com.github.retrooper.packetevents.protocol.component.ComponentTypes.MAX_STACK_SIZE;
+import static com.github.retrooper.packetevents.protocol.component.ComponentTypes.STORED_ENCHANTMENTS;
 
 public class ItemStack {
     public static final ItemStack EMPTY = new ItemStack(ItemTypes.AIR, 0, new NBTCompound(), 0);
@@ -37,20 +55,35 @@ public class ItemStack {
     private int amount;
     @Nullable
     private NBTCompound nbt;
+    @Nullable // lazy loaded
+    private PatchableComponentMap components; // Added in 1.20.5
     private int legacyData = -1;
 
     private boolean cachedIsEmpty = false;
 
     private ItemStack(ItemType type, int amount, @Nullable NBTCompound nbt, int legacyData) {
+        this(type, amount, nbt, null, legacyData);
+    }
+
+    private ItemStack(
+            ItemType type,
+            int amount,
+            @Nullable NBTCompound nbt,
+            @Nullable PatchableComponentMap components,
+            int legacyData
+    ) {
         this.type = type;
         this.amount = amount;
         this.nbt = nbt;
+        this.components = components;
         this.legacyData = legacyData;
         updateCachedEmptyStatus();
     }
 
     public int getMaxStackSize() {
-        return getType().getMaxAmount();
+        return this.getComponentOr(MAX_STACK_SIZE,
+                // fallback to legacy specified max stack size
+                this.getType().getMaxAmount());
     }
 
     public boolean isStackable() {
@@ -58,11 +91,9 @@ public class ItemStack {
     }
 
     public boolean isDamageableItem() {
-        if (!this.cachedIsEmpty && this.getType().getMaxDurability() > 0) {
-            NBTCompound tag = this.getNBT();
-            return tag == null || !tag.getBoolean("Unbreakable");
-        }
-        return false;
+        return !this.cachedIsEmpty && this.getMaxDamage() > 0
+                && (this.nbt == null || !this.nbt.getBoolean("Unbreakable"))
+                && !this.getComponentOr(ComponentTypes.UNBREAKABLE, false);
     }
 
     public boolean isDamaged() {
@@ -70,17 +101,27 @@ public class ItemStack {
     }
 
     public int getDamageValue() {
-        if (nbt == null) return 0;
-        NBTInt damage = this.nbt.getTagOfTypeOrNull("Damage", NBTInt.class);
-        return damage == null ? 0 : damage.getAsInt();
+        if (this.nbt != null) {
+            NBTInt damage = this.nbt.getTagOfTypeOrNull("Damage", NBTInt.class);
+            if (damage != null) {
+                return damage.getAsInt();
+            }
+        }
+        return this.getComponentOr(DAMAGE, 0);
     }
 
     public void setDamageValue(int damage) {
-        this.getOrCreateTag().setTag("Damage", new NBTInt(Math.max(0, damage)));
+        int cappedDamage = Math.max(0, damage);
+        // set in legacy nbt
+        this.getOrCreateTag().setTag("Damage", new NBTInt(cappedDamage));
+        // set in components
+        this.setComponent(DAMAGE, cappedDamage);
     }
 
     public int getMaxDamage() {
-        return this.getType().getMaxDurability();
+        return this.getComponentOr(MAX_DAMAGE,
+                // fallback to legacy specified max durability
+                this.getType().getMaxDurability());
     }
 
     public NBTCompound getOrCreateTag() {
@@ -125,7 +166,12 @@ public class ItemStack {
     }
 
     public ItemStack copy() {
-        return cachedIsEmpty ? EMPTY : new ItemStack(type, amount, nbt == null ? null : nbt.copy(), legacyData);
+        return cachedIsEmpty ? EMPTY : new ItemStack(
+                type, amount,
+                nbt == null ? null : nbt.copy(),
+                components == null ? null : components.copy(),
+                legacyData
+        );
     }
 
     @Nullable
@@ -137,6 +183,58 @@ public class ItemStack {
         this.nbt = nbt;
     }
 
+    public <T> T getComponentOr(ComponentType<T> type, T otherValue) {
+        if (this.hasComponentPatches()) {
+            return this.getComponents().getOr(type, otherValue);
+        }
+        return this.getType().getComponents().getOr(type, otherValue);
+    }
+
+    public <T> Optional<T> getComponent(ComponentType<T> type) {
+        if (this.hasComponentPatches()) {
+            return this.getComponents().getOptional(type);
+        }
+        return this.getType().getComponents().getOptional(type);
+    }
+
+    public <T> void setComponent(ComponentType<T> type, T value) {
+        this.getComponents().set(type, value);
+    }
+
+    public <T> void unsetComponent(ComponentType<T> type) {
+        this.getComponents().unset(type);
+    }
+
+    public <T> void setComponent(ComponentType<T> type, Optional<T> value) {
+        this.getComponents().set(type, value);
+    }
+
+    public boolean hasComponent(ComponentType<?> type) {
+        if (this.hasComponentPatches()) {
+            return this.getComponents().has(type);
+        }
+        return this.getType().getComponents().has(type);
+    }
+
+    public boolean hasComponentPatches() {
+        return this.components != null && !this.components.getPatches().isEmpty();
+    }
+
+    public PatchableComponentMap getComponents() {
+        if (this.components == null) { // lazy load on access
+            this.components = new PatchableComponentMap(
+                    this.type.getComponents(), new HashMap<>(4));
+        }
+        return this.components;
+    }
+
+    /**
+     * @param components if set null will reset to components of {@link ItemType}
+     */
+    public void setComponents(@Nullable PatchableComponentMap components) {
+        this.components = components;
+    }
+
     public int getLegacyData() {
         return legacyData;
     }
@@ -152,47 +250,101 @@ public class ItemStack {
     }
 
     public boolean isEnchanted(ClientVersion version) {
-        String tagName = getEnchantmentsTagName(version);
-        return !isEmpty() && this.nbt != null && this.nbt.getCompoundListTagOrNull(tagName) != null && !this.nbt.getCompoundListTagOrNull(tagName).getTags().isEmpty();
-    }
-
-    private List<Enchantment> getEnchantments(@Nullable NBTCompound nbt, ClientVersion version) {
-        String tagName = getEnchantmentsTagName(version);
-
-        if (nbt == null || nbt.getCompoundListTagOrNull(tagName) == null)
-            return new ArrayList<>(0);
-
-        NBTList<NBTCompound> nbtList = nbt.getCompoundListTagOrNull(tagName);
-        List<NBTCompound> compounds = nbtList.getTags();
-        List<Enchantment> enchantments = new ArrayList<>(compounds.size());
-
-        for (NBTCompound compound : compounds) {
-            EnchantmentType type = getEnchantmentTypeFromTag(compound, version);
-
-            if (type != null) {
-                NBTShort levelTag = compound.getTagOfTypeOrNull("lvl", NBTShort.class);
-                int level = levelTag.getAsInt();
-                Enchantment enchantment = Enchantment.builder().type(type).level(level).build();
-                enchantments.add(enchantment);
-            }
+        if (this.isEmpty()) {
+            return false;
         }
-
-        return enchantments;
+        // check for components
+        if (!this.getComponentOr(ENCHANTMENTS, ItemEnchantments.EMPTY).isEmpty()
+                || !this.getComponentOr(STORED_ENCHANTMENTS, ItemEnchantments.EMPTY).isEmpty()) {
+            return true;
+        }
+        // check for legacy nbt
+        if (this.nbt != null) {
+            String tagName = this.getEnchantmentsTagName(version);
+            NBTList<NBTCompound> enchantments = this.nbt.getCompoundListTagOrNull(tagName);
+            return enchantments != null && !enchantments.getTags().isEmpty();
+        }
+        return false;
     }
 
     public List<Enchantment> getEnchantments(ClientVersion version) {
-        return getEnchantments(this.nbt, version);
+        if (this.isEmpty()) {
+            return new ArrayList<>(0);
+        }
+
+        // check for components
+        Optional<ItemEnchantments> optEnchantments = this.getComponent(ENCHANTMENTS);
+        Optional<ItemEnchantments> optStoredEnchantments = this.getComponent(STORED_ENCHANTMENTS);
+        if (optEnchantments.isPresent() || optStoredEnchantments.isPresent()) {
+            ItemEnchantments enchantments = optEnchantments.orElse(ItemEnchantments.EMPTY);
+            ItemEnchantments storedEnchantments = optStoredEnchantments.orElse(ItemEnchantments.EMPTY);
+            List<Enchantment> enchantmentsList = new ArrayList<>(
+                    enchantments.getEnchantmentCount() + storedEnchantments.getEnchantmentCount());
+            for (Map.Entry<EnchantmentType, Integer> enchantment : enchantments) {
+                enchantmentsList.add(new Enchantment(enchantment.getKey(), enchantment.getValue()));
+            }
+            for (Map.Entry<EnchantmentType, Integer> enchantment : storedEnchantments) {
+                enchantmentsList.add(new Enchantment(enchantment.getKey(), enchantment.getValue()));
+            }
+            return enchantmentsList;
+        }
+
+        // check for legacy nbt
+        if (this.nbt != null) {
+            String tagName = this.getEnchantmentsTagName(version);
+            NBTList<NBTCompound> nbtList = this.nbt.getCompoundListTagOrNull(tagName);
+            if (nbtList != null) {
+                List<NBTCompound> compounds = nbtList.getTags();
+                List<Enchantment> enchantments = new ArrayList<>(compounds.size());
+
+                for (NBTCompound compound : compounds) {
+                    EnchantmentType type = getEnchantmentTypeFromTag(compound, version);
+
+                    if (type != null) {
+                        NBTShort levelTag = compound.getTagOfTypeOrNull("lvl", NBTShort.class);
+                        int level = levelTag.getAsInt();
+                        Enchantment enchantment = Enchantment.builder().type(type).level(level).build();
+                        enchantments.add(enchantment);
+                    }
+                }
+                return enchantments;
+            }
+        }
+
+        return new ArrayList<>(0);
     }
 
     public int getEnchantmentLevel(EnchantmentType enchantment, ClientVersion version) {
-        if (isEnchanted(version)) {
-            // isEnchanted() is true, so we can assume that nbt is not null
-            assert nbt != null;
-            String tagName = getEnchantmentsTagName(version);
-            for (NBTCompound base : nbt.getCompoundListTagOrNull(tagName).getTags()) {
-                EnchantmentType type = getEnchantmentTypeFromTag(base, version);
-                if (enchantment == type) {
-                    return base.getTagOfTypeOrNull("lvl", NBTShort.class).getAsInt();
+        if (this.isEmpty()) {
+            return 0;
+        }
+
+        // check for components
+        Optional<ItemEnchantments> optEnchantments = this.getComponent(ENCHANTMENTS);
+        if (optEnchantments.isPresent()) {
+            int level = optEnchantments.get().getEnchantmentLevel(enchantment);
+            if (level > 0) {
+                return level;
+            }
+        }
+        Optional<ItemEnchantments> optStoredEnchantments = this.getComponent(STORED_ENCHANTMENTS);
+        if (optStoredEnchantments.isPresent()) {
+            int level = optStoredEnchantments.get().getEnchantmentLevel(enchantment);
+            if (level > 0) {
+                return level;
+            }
+        }
+
+        if (this.nbt != null) {
+            String tagName = this.getEnchantmentsTagName(version);
+            NBTList<NBTCompound> nbtList = this.nbt.getCompoundListTagOrNull(tagName);
+            if (nbtList != null) {
+                for (NBTCompound base : nbtList.getTags()) {
+                    EnchantmentType type = getEnchantmentTypeFromTag(base, version);
+                    if (enchantment == type) {
+                        NBTShort nbtShort = base.getTagOfTypeOrNull("lvl", NBTShort.class);
+                        return nbtShort != null ? nbtShort.getAsInt() : 0;
+                    }
                 }
             }
         }
@@ -200,8 +352,7 @@ public class ItemStack {
         return 0;
     }
 
-    @Nullable
-    private static EnchantmentType getEnchantmentTypeFromTag(NBTCompound tag, ClientVersion version) {
+    private static @Nullable EnchantmentType getEnchantmentTypeFromTag(NBTCompound tag, ClientVersion version) {
         if (version.isNewerThanOrEquals(ClientVersion.V_1_13)) {
             String id = tag.getStringTagValueOrNull("id");
             return EnchantmentTypes.getByName(id);
@@ -212,6 +363,7 @@ public class ItemStack {
     }
 
     public void setEnchantments(List<Enchantment> enchantments, ClientVersion version) {
+        // set in legacy nbt
         nbt = getOrCreateTag(); // Create tag if null
         String tagName = getEnchantmentsTagName(version);
         if (enchantments.isEmpty()) {
@@ -235,8 +387,20 @@ public class ItemStack {
             assert nbt != null; // NBT was created in getOrCreateTag()
             nbt.setTag(tagName, new NBTList<>(NBTType.COMPOUND, list));
         }
+
+        // set in components
+        Map<EnchantmentType, Integer> enchantmentsMap = new HashMap<>(enchantments.size());
+        for (Enchantment enchantment : enchantments) {
+            enchantmentsMap.put(enchantment.getType(), enchantment.getLevel());
+        }
+        ComponentType<ItemEnchantments> componentType = this.type == ItemTypes.ENCHANTED_BOOK
+                ? STORED_ENCHANTMENTS : ENCHANTMENTS;
+        Optional<ItemEnchantments> prevEnchantments = this.getComponent(componentType);
+        boolean showInTooltip = prevEnchantments.map(ItemEnchantments::isShowInTooltip).orElse(true);
+        this.setComponent(componentType, new ItemEnchantments(enchantmentsMap, showInTooltip));
     }
 
+    @Deprecated
     public String getEnchantmentsTagName(ClientVersion version) {
         String tagName = version.isNewerThanOrEquals(ClientVersion.V_1_13) ? "Enchantments" : "ench";
         if (type == ItemTypes.ENCHANTED_BOOK) {
@@ -254,7 +418,10 @@ public class ItemStack {
     }
 
     public static boolean isSameItemSameTags(ItemStack stack, ItemStack otherStack) {
-        return stack.is(otherStack.getType()) && ItemStack.tagMatches(stack, otherStack);
+        return stack.is(otherStack.getType())
+                && (stack.isEmpty() && otherStack.isEmpty()
+                || (ItemStack.tagMatches(stack, otherStack)
+                && Objects.equals(stack.components, otherStack.components)));
     }
 
     public static boolean tagMatches(ItemStack left, ItemStack right) {
@@ -267,7 +434,8 @@ public class ItemStack {
         if (right == null) {
             return left.isEmpty();
         }
-        return Objects.equals(left.nbt, right.nbt);
+        return Objects.equals(left.nbt, right.nbt)
+                && Objects.equals(left.components, right.components);
     }
 
     @Override
@@ -279,6 +447,7 @@ public class ItemStack {
             return getType().equals(itemStack.getType())
                     && amount == itemStack.amount
                     && Objects.equals(nbt, itemStack.nbt)
+                    && Objects.equals(components, itemStack.components)
                     && legacyData == itemStack.legacyData;
         }
         return false;
@@ -292,7 +461,8 @@ public class ItemStack {
             String identifier = type == null ? "null" : type.getName().toString();
             int maxAmount = getType().getMaxAmount();
             return "ItemStack[type=" + identifier + ", amount=" + amount + "/" + maxAmount
-                    + ", nbt tag names: " + (nbt != null ? nbt.getTagNames() : "[null]") + ", legacyData=" + legacyData + "]";
+                    + ", nbt tag names: " + (nbt != null ? nbt.getTagNames() : "[null]")
+                    + ", legacyData=" + legacyData + ", components=" + components + "]";
         }
     }
 
@@ -308,6 +478,7 @@ public class ItemStack {
         private ItemType type;
         private int amount = 1;
         private NBTCompound nbt = null;
+        private PatchableComponentMap components = null;
         private int legacyData = -1;
 
         public Builder type(ItemType type) {
@@ -325,13 +496,18 @@ public class ItemStack {
             return this;
         }
 
+        public Builder components(@Nullable PatchableComponentMap components) {
+            this.components = components;
+            return this;
+        }
+
         public Builder legacyData(int legacyData) {
             this.legacyData = legacyData;
             return this;
         }
 
         public ItemStack build() {
-            return new ItemStack(type, amount, nbt, legacyData);
+            return new ItemStack(type, amount, nbt, components, legacyData);
         }
 
     }

api/src/main/java/com/github/retrooper/packetevents/protocol/item/armormaterial/ArmorMaterial.java

@@ -0,0 +1,24 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.armormaterial;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+
+public interface ArmorMaterial extends MappedEntity {
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/armormaterial/ArmorMaterials.java

@@ -0,0 +1,90 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.armormaterial;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class ArmorMaterials {
+
+    private static final Map<String, ArmorMaterial> MATERIAL_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, ArmorMaterial>> MATERIAL_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("item/item_armor_material_mappings");
+
+    public static ArmorMaterial define(String key) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        ArmorMaterial instrument = new ArmorMaterial() {
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return TYPES_BUILDER.getDataIndex(version);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof ArmorMaterial) {
+                    return getName().equals(((ArmorMaterial) obj).getName());
+                }
+                return false;
+            }
+        };
+        MappingHelper.registerMapping(TYPES_BUILDER, MATERIAL_MAP, MATERIAL_ID_MAP, instrument);
+        return instrument;
+    }
+
+    // with key
+    public static ArmorMaterial getByName(String name) {
+        return MATERIAL_MAP.get(name);
+    }
+
+    public static ArmorMaterial getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, ArmorMaterial> idMap = MATERIAL_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    public static final ArmorMaterial LEATHER = define("leather");
+    public static final ArmorMaterial CHAINMAIL = define("chainmail");
+    public static final ArmorMaterial IRON = define("iron");
+    public static final ArmorMaterial GOLD = define("gold");
+    public static final ArmorMaterial DIAMOND = define("diamond");
+
+    // Added with 1.13
+    public static final ArmorMaterial TURTLE = define("turtle");
+
+    // Added with 1.16
+    public static final ArmorMaterial NETHERITE = define("netherite");
+
+    // Added with 1.20.5
+    public static final ArmorMaterial ARMADILLO = define("armadillo");
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/banner/BannerPattern.java

@@ -0,0 +1,41 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.banner;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+public interface BannerPattern extends MappedEntity {
+
+    ResourceLocation getAssetId();
+
+    String getTranslationKey();
+
+    static BannerPattern readDirect(PacketWrapper<?> wrapper) {
+        ResourceLocation assetId = wrapper.readIdentifier();
+        String translationKey = wrapper.readString();
+        return new StaticBannerPattern(assetId, translationKey);
+    }
+
+    static void writeDirect(PacketWrapper<?> wrapper, BannerPattern pattern) {
+        wrapper.writeIdentifier(pattern.getAssetId());
+        wrapper.writeString(pattern.getTranslationKey());
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/banner/BannerPatterns.java

@@ -0,0 +1,133 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.banner;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class BannerPatterns {
+
+    private static final Map<String, BannerPattern> PATTERN_TYPE_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, BannerPattern>> PATTERN_TYPE_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("item/item_banner_pattern_mappings");
+
+    public static BannerPattern define(String key) {
+        ResourceLocation assetId = ResourceLocation.minecraft(key);
+        String translationKey = "block.minecraft.banner." + key;
+        return define(key, assetId, translationKey);
+    }
+
+    public static BannerPattern define(String key, ResourceLocation assetId, String translationKey) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        BannerPattern pattern = new BannerPattern() {
+            @Override
+            public ResourceLocation getAssetId() {
+                return assetId;
+            }
+
+            @Override
+            public String getTranslationKey() {
+                return translationKey;
+            }
+
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return TYPES_BUILDER.getDataIndex(version);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof BannerPattern) {
+                    return getName().equals(((BannerPattern) obj).getName());
+                }
+                return false;
+            }
+        };
+        MappingHelper.registerMapping(TYPES_BUILDER, PATTERN_TYPE_MAP, PATTERN_TYPE_ID_MAP, pattern);
+        return pattern;
+    }
+
+    // with key
+    public static BannerPattern getByName(String name) {
+        return PATTERN_TYPE_MAP.get(name);
+    }
+
+    public static BannerPattern getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, BannerPattern> idMap = PATTERN_TYPE_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    public static final BannerPattern SQUARE_BOTTOM_LEFT = define("square_bottom_left");
+    public static final BannerPattern STRIPE_BOTTOM = define("stripe_bottom");
+    public static final BannerPattern CREEPER = define("creeper");
+    public static final BannerPattern HALF_HORIZONTAL = define("half_horizontal");
+    public static final BannerPattern STRIPE_MIDDLE = define("stripe_middle");
+    public static final BannerPattern BASE = define("base");
+    public static final BannerPattern DIAGONAL_UP_RIGHT = define("diagonal_up_right");
+    public static final BannerPattern HALF_HORIZONTAL_BOTTOM = define("half_horizontal_bottom");
+    public static final BannerPattern SMALL_STRIPES = define("small_stripes");
+    public static final BannerPattern GRADIENT_UP = define("gradient_up");
+    public static final BannerPattern CIRCLE = define("circle");
+    public static final BannerPattern STRIPE_DOWNLEFT = define("stripe_downleft");
+    public static final BannerPattern RHOMBUS = define("rhombus");
+    public static final BannerPattern TRIANGLES_BOTTOM = define("triangles_bottom");
+    public static final BannerPattern STRIPE_CENTER = define("stripe_center");
+    public static final BannerPattern SQUARE_BOTTOM_RIGHT = define("square_bottom_right");
+    public static final BannerPattern DIAGONAL_RIGHT = define("diagonal_right");
+    public static final BannerPattern MOJANG = define("mojang");
+    public static final BannerPattern STRIPE_LEFT = define("stripe_left");
+    public static final BannerPattern SQUARE_TOP_LEFT = define("square_top_left");
+    public static final BannerPattern TRIANGLE_BOTTOM = define("triangle_bottom");
+    public static final BannerPattern SKULL = define("skull");
+    public static final BannerPattern SQUARE_TOP_RIGHT = define("square_top_right");
+    public static final BannerPattern GLOBE = define("globe");
+    public static final BannerPattern STRIPE_TOP = define("stripe_top");
+    public static final BannerPattern CROSS = define("cross");
+    public static final BannerPattern BRICKS = define("bricks");
+    public static final BannerPattern HALF_VERTICAL = define("half_vertical");
+    public static final BannerPattern STRIPE_DOWNRIGHT = define("stripe_downright");
+    public static final BannerPattern TRIANGLES_TOP = define("triangles_top");
+    public static final BannerPattern STRIPE_RIGHT = define("stripe_right");
+    public static final BannerPattern DIAGONAL_UP_LEFT = define("diagonal_up_left");
+    public static final BannerPattern HALF_VERTICAL_RIGHT = define("half_vertical_right");
+    public static final BannerPattern TRIANGLE_TOP = define("triangle_top");
+    public static final BannerPattern FLOWER = define("flower");
+    public static final BannerPattern STRAIGHT_CROSS = define("straight_cross");
+    public static final BannerPattern GRADIENT = define("gradient");
+    public static final BannerPattern CURLY_BORDER = define("curly_border");
+    public static final BannerPattern BORDER = define("border");
+    public static final BannerPattern PIGLIN = define("piglin");
+    public static final BannerPattern DIAGONAL_LEFT = define("diagonal_left");
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/banner/StaticBannerPattern.java

@@ -0,0 +1,74 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.banner;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+
+import java.util.Objects;
+
+public class StaticBannerPattern implements BannerPattern {
+
+    private final ResourceLocation assetId;
+    private final String translationKey;
+
+    public StaticBannerPattern(ResourceLocation assetId, String translationKey) {
+        this.assetId = assetId;
+        this.translationKey = translationKey;
+    }
+
+    @Override
+    public ResourceLocation getAssetId() {
+        return this.assetId;
+    }
+
+    @Override
+    public String getTranslationKey() {
+        return this.translationKey;
+    }
+
+    @Override
+    public ResourceLocation getName() {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public int getId(ClientVersion version) {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public boolean isRegistered() {
+        return false;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof StaticBannerPattern)) return false;
+        StaticBannerPattern that = (StaticBannerPattern) obj;
+        if (!this.assetId.equals(that.assetId)) return false;
+        return this.translationKey.equals(that.translationKey);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.assetId, this.translationKey);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/enchantment/Enchantment.java

@@ -19,13 +19,12 @@
 package com.github.retrooper.packetevents.protocol.item.enchantment;
 
 import com.github.retrooper.packetevents.protocol.item.enchantment.type.EnchantmentType;
-import com.github.retrooper.packetevents.protocol.item.enchantment.type.EnchantmentTypes;
 
 public class Enchantment {
     private EnchantmentType type;
     private int level;
 
-    private Enchantment(EnchantmentType type, int level) {
+    public Enchantment(EnchantmentType type, int level) {
         this.type = type;
         this.level = level;
     }

api/src/main/java/com/github/retrooper/packetevents/protocol/item/enchantment/type/EnchantmentTypes.java

@@ -20,28 +20,30 @@ package com.github.retrooper.packetevents.protocol.item.enchantment.type;
 
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.resources.ResourceLocation;
-import com.github.retrooper.packetevents.util.TypesBuilder;
-import com.github.retrooper.packetevents.util.TypesBuilderData;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
 import org.jetbrains.annotations.Nullable;
 
 import java.util.HashMap;
 import java.util.Map;
 
 public class EnchantmentTypes {
+
+    private static final Map<String, String> STRING_UPDATER = new HashMap<>();
+
+    static {
+        // renamed in 24w03a, during the 1.20.5 update
+        STRING_UPDATER.put("minecraft:sweeping", "minecraft:sweeping_edge");
+    }
+
     private static final Map<String, EnchantmentType> ENCHANTMENT_TYPE_MAPPINGS = new HashMap<>();
     private static final Map<Byte, Map<Integer, EnchantmentType>> ENCHANTMENT_TYPE_ID_MAPPINGS = new HashMap<>();
-    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("enchantment/enchantment_type_mappings",
-            ClientVersion.V_1_12,
-            ClientVersion.V_1_13,
-            ClientVersion.V_1_14,
-            ClientVersion.V_1_16,
-            ClientVersion.V_1_19);
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("enchantment/enchantment_type_mappings");
 
     public static EnchantmentType define(String key) {
         TypesBuilderData data = TYPES_BUILDER.define(key);
         EnchantmentType enchantmentType = new EnchantmentType() {
-            private final int[] ids = data.getData();
-
             @Override
             public ResourceLocation getName() {
                 return data.getName();
@@ -49,8 +51,7 @@ public class EnchantmentTypes {
 
             @Override
             public int getId(ClientVersion version) {
-                int index = TYPES_BUILDER.getDataIndex(version);
-                return ids[index];
+                return MappingHelper.getId(version, TYPES_BUILDER, data);
             }
 
             @Override
@@ -62,18 +63,14 @@ public class EnchantmentTypes {
             }
         };
 
-        ENCHANTMENT_TYPE_MAPPINGS.put(enchantmentType.getName().toString(), enchantmentType);
-        for (ClientVersion version : TYPES_BUILDER.getVersions()) {
-            int index = TYPES_BUILDER.getDataIndex(version);
-            Map<Integer, EnchantmentType> typeIdMap = ENCHANTMENT_TYPE_ID_MAPPINGS.computeIfAbsent((byte) index, k -> new HashMap<>());
-            typeIdMap.put(enchantmentType.getId(version), enchantmentType);
-        }
+        MappingHelper.registerMapping(TYPES_BUILDER, ENCHANTMENT_TYPE_MAPPINGS, ENCHANTMENT_TYPE_ID_MAPPINGS, enchantmentType);
         return enchantmentType;
     }
 
     @Nullable
     public static EnchantmentType getByName(String name) {
-        return ENCHANTMENT_TYPE_MAPPINGS.get(name);
+        String fixedName = STRING_UPDATER.getOrDefault(name, name);
+        return ENCHANTMENT_TYPE_MAPPINGS.get(fixedName);
     }
 
     @Nullable
@@ -102,7 +99,7 @@ public class EnchantmentTypes {
     public static final EnchantmentType KNOCKBACK = define("knockback");
     public static final EnchantmentType FIRE_ASPECT = define("fire_aspect");
     public static final EnchantmentType MOB_LOOTING = define("looting");
-    public static final EnchantmentType SWEEPING_EDGE = define("sweeping");
+    public static final EnchantmentType SWEEPING_EDGE = define("sweeping_edge");
     public static final EnchantmentType BLOCK_EFFICIENCY = define("efficiency");
     public static final EnchantmentType SILK_TOUCH = define("silk_touch");
     public static final EnchantmentType UNBREAKING = define("unbreaking");
@@ -123,6 +120,11 @@ public class EnchantmentTypes {
     public static final EnchantmentType MENDING = define("mending");
     public static final EnchantmentType VANISHING_CURSE = define("vanishing_curse");
 
+    // Added in 1.20.5
+    public static final EnchantmentType DENSITY = define("density");
+    public static final EnchantmentType BREACH = define("breach");
+    public static final EnchantmentType WIND_BURST = define("wind_burst");
+
     static {
         TYPES_BUILDER.unloadFileMappings();
     }

api/src/main/java/com/github/retrooper/packetevents/protocol/item/instrument/Instrument.java

@@ -0,0 +1,53 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.instrument;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+import com.github.retrooper.packetevents.protocol.sound.Sound;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+public interface Instrument extends MappedEntity {
+
+    Sound getSound();
+
+    int getUseDuration();
+
+    float getRange();
+
+    static Instrument read(PacketWrapper<?> wrapper) {
+        return wrapper.readMappedEntityOrDirect(Instruments::getById, Instrument::readDirect);
+    }
+
+    static Instrument readDirect(PacketWrapper<?> wrapper) {
+        Sound sound = Sound.read(wrapper);
+        int useDuration = wrapper.readVarInt();
+        float range = wrapper.readFloat();
+        return new StaticInstrument(sound, useDuration, range);
+    }
+
+    static void write(PacketWrapper<?> wrapper, Instrument instrument) {
+        wrapper.writeMappedEntityOrDirect(instrument, Instrument::writeDirect);
+    }
+
+    static void writeDirect(PacketWrapper<?> wrapper, Instrument instrument) {
+        Sound.write(wrapper, instrument.getSound());
+        wrapper.writeVarInt(instrument.getUseDuration());
+        wrapper.writeFloat(instrument.getRange());
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/instrument/Instruments.java

@@ -0,0 +1,106 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.instrument;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.protocol.sound.Sound;
+import com.github.retrooper.packetevents.protocol.sound.Sounds;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class Instruments {
+
+    private static final Map<String, Instrument> INSTRUMENT_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, Instrument>> INSTRUMENT_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("item/item_instrument_mappings");
+
+    public static Instrument define(String key, Sound sound) {
+        // vanilla defaults for goat horns
+        return define(key, sound, 140, 256f);
+    }
+
+    public static Instrument define(String key, Sound sound, int useDuration, float range) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        Instrument instrument = new Instrument() {
+            @Override
+            public Sound getSound() {
+                return sound;
+            }
+
+            @Override
+            public int getUseDuration() {
+                return useDuration;
+            }
+
+            @Override
+            public float getRange() {
+                return range;
+            }
+
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return MappingHelper.getId(version, TYPES_BUILDER, data);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof Instrument) {
+                    return getName().equals(((Instrument) obj).getName());
+                }
+                return false;
+            }
+        };
+        MappingHelper.registerMapping(TYPES_BUILDER, INSTRUMENT_MAP, INSTRUMENT_ID_MAP, instrument);
+        return instrument;
+    }
+
+    // with key
+    public static Instrument getByName(String name) {
+        return INSTRUMENT_MAP.get(name);
+    }
+
+    public static Instrument getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, Instrument> idMap = INSTRUMENT_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    public static final Instrument PONDER_GOAT_HORN = define("ponder_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_0);
+    public static final Instrument SING_GOAT_HORN = define("sing_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_1);
+    public static final Instrument SEEK_GOAT_HORN = define("seek_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_2);
+    public static final Instrument FEEL_GOAT_HORN = define("feel_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_3);
+    public static final Instrument ADMIRE_GOAT_HORN = define("admire_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_4);
+    public static final Instrument CALL_GOAT_HORN = define("call_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_5);
+    public static final Instrument YEARN_GOAT_HORN = define("yearn_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_6);
+    public static final Instrument DREAM_GOAT_HORN = define("dream_goat_horn", Sounds.ITEM_GOAT_HORN_SOUND_7);
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/instrument/StaticInstrument.java

@@ -0,0 +1,83 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.instrument;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.protocol.sound.Sound;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+
+import java.util.Objects;
+
+public class StaticInstrument implements Instrument {
+
+    private final Sound sound;
+    private final int useDuration;
+    private final float range;
+
+    public StaticInstrument(Sound sound, int useDuration, float range) {
+        this.sound = sound;
+        this.useDuration = useDuration;
+        this.range = range;
+    }
+
+    @Override
+    public Sound getSound() {
+        return this.sound;
+    }
+
+    @Override
+    public int getUseDuration() {
+        return this.useDuration;
+    }
+
+    @Override
+    public float getRange() {
+        return this.range;
+    }
+
+    @Override
+    public ResourceLocation getName() {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public int getId(ClientVersion version) {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public boolean isRegistered() {
+        return false;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof StaticInstrument)) return false;
+        StaticInstrument that = (StaticInstrument) obj;
+        if (this.useDuration != that.useDuration) return false;
+        if (Float.compare(that.range, this.range) != 0) return false;
+        return this.sound.equals(that.sound);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.sound, this.useDuration, this.range);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/mapdecoration/MapDecorationType.java

@@ -0,0 +1,35 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.mapdecoration;
+
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+
+public interface MapDecorationType extends MappedEntity {
+
+    ResourceLocation getAssetId();
+
+    boolean isShowOnItemFrame();
+
+    int getMapColor();
+
+    boolean isExplorationMapElement();
+
+    boolean isTrackCount();
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/mapdecoration/MapDecorationTypes.java

@@ -0,0 +1,207 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.mapdecoration;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import static com.github.retrooper.packetevents.resources.ResourceLocation.minecraft;
+
+public class MapDecorationTypes {
+
+    private static final Map<String, MapDecorationType> DECORATION_TYPE_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, MapDecorationType>> DECORATION_TYPE_ID_MAP = new HashMap<>();
+
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("item/item_map_decoration_type_mappings");
+
+    public static MapDecorationType define(String key, boolean showOnItemFrame, boolean trackCount) {
+        return define(key, minecraft(key), showOnItemFrame, trackCount);
+    }
+
+    public static MapDecorationType define(
+            String key, ResourceLocation assetId,
+            boolean showOnItemFrame, boolean trackCount
+    ) {
+        return define(key, assetId, showOnItemFrame,
+                -1, false, trackCount);
+    }
+
+    public static MapDecorationType define(
+            String key,
+            boolean showOnItemFrame, int mapColor,
+            boolean explorationMapElement, boolean trackCount
+    ) {
+        return define(key, minecraft(key),
+                showOnItemFrame, mapColor, explorationMapElement, trackCount);
+    }
+
+    public static MapDecorationType define(
+            String key, ResourceLocation assetId,
+            boolean showOnItemFrame, int mapColor,
+            boolean explorationMapElement, boolean trackCount
+    ) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        MapDecorationType potionType = new MapDecorationType() {
+            @Override
+            public ResourceLocation getAssetId() {
+                return assetId;
+            }
+
+            @Override
+            public boolean isShowOnItemFrame() {
+                return showOnItemFrame;
+            }
+
+            @Override
+            public int getMapColor() {
+                return mapColor;
+            }
+
+            @Override
+            public boolean isExplorationMapElement() {
+                return explorationMapElement;
+            }
+
+            @Override
+            public boolean isTrackCount() {
+                return trackCount;
+            }
+
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return MappingHelper.getId(version, TYPES_BUILDER, data);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof MapDecorationType) {
+                    return this.getName().equals(((MapDecorationType) obj).getName());
+                }
+                return false;
+            }
+        };
+        MappingHelper.registerMapping(TYPES_BUILDER, DECORATION_TYPE_MAP, DECORATION_TYPE_ID_MAP, potionType);
+        return potionType;
+    }
+
+    public static @Nullable MapDecorationType getByName(String name) {
+        return DECORATION_TYPE_MAP.get(name);
+    }
+
+    public static @Nullable MapDecorationType getById(int id, ClientVersion version) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, MapDecorationType> idMap = DECORATION_TYPE_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    // color constants used by vanilla
+    private static final int LIGHT_GRAY_COLOR = 0x999999;
+    private static final int COPPER_COLOR = 0xC26B4C;
+
+    public static final MapDecorationType PLAYER = define("player",
+            false, true);
+    public static final MapDecorationType FRAME = define("frame",
+            true, true);
+    public static final MapDecorationType RED_MARKER = define("red_marker",
+            false, true);
+    public static final MapDecorationType BLUE_MARKER = define("blue_marker",
+            false, true);
+    public static final MapDecorationType TARGET_X = define("target_x",
+            true, false);
+    public static final MapDecorationType TARGET_POINT = define("target_point",
+            true, false);
+    public static final MapDecorationType PLAYER_OFF_MAP = define("player_off_map",
+            false, true);
+    public static final MapDecorationType PLAYER_OFF_LIMITS = define("player_off_limits",
+            false, true);
+    public static final MapDecorationType MANSION = define("mansion",
+            true, 0x524C44, true, false);
+    public static final MapDecorationType MONUMENT = define("monument",
+            true, 0x3A7265, true, false);
+    public static final MapDecorationType BANNER_WHITE = define("banner_white",
+            minecraft("white_banner"), true, true);
+    public static final MapDecorationType BANNER_ORANGE = define("banner_orange",
+            minecraft("orange_banner"), true, true);
+    public static final MapDecorationType BANNER_MAGENTA = define("banner_magenta",
+            minecraft("magenta_banner"), true, true);
+    public static final MapDecorationType BANNER_LIGHT_BLUE = define("banner_light_blue",
+            minecraft("light_blue_banner"), true, true);
+    public static final MapDecorationType BANNER_YELLOW = define("banner_yellow",
+            minecraft("yellow_banner"), true, true);
+    public static final MapDecorationType BANNER_LIME = define("banner_lime",
+            minecraft("lime_banner"), true, true);
+    public static final MapDecorationType BANNER_PINK = define("banner_pink",
+            minecraft("pink_banner"), true, true);
+    public static final MapDecorationType BANNER_GRAY = define("banner_gray",
+            minecraft("gray_banner"), true, true);
+    public static final MapDecorationType BANNER_LIGHT_GRAY = define("banner_light_gray",
+            minecraft("light_gray_banner"), true, true);
+    public static final MapDecorationType BANNER_CYAN = define("banner_cyan",
+            minecraft("cyan_banner"), true, true);
+    public static final MapDecorationType BANNER_PURPLE = define("banner_purple",
+            minecraft("purple_banner"), true, true);
+    public static final MapDecorationType BANNER_BLUE = define("banner_blue",
+            minecraft("blue_banner"), true, true);
+    public static final MapDecorationType BANNER_BROWN = define("banner_brown",
+            minecraft("brown_banner"), true, true);
+    public static final MapDecorationType BANNER_GREEN = define("banner_green",
+            minecraft("green_banner"), true, true);
+    public static final MapDecorationType BANNER_RED = define("banner_red",
+            minecraft("red_banner"), true, true);
+    public static final MapDecorationType BANNER_BLACK = define("banner_black",
+            minecraft("black_banner"), true, true);
+    public static final MapDecorationType RED_X = define("red_x",
+            true, false);
+
+    // Added with 1.20.2
+    public static final MapDecorationType VILLAGE_DESERT = define("village_desert", minecraft("desert_village"),
+            true, LIGHT_GRAY_COLOR, true, false);
+    public static final MapDecorationType VILLAGE_PLAINS = define("village_plains", minecraft("plains_village"),
+            true, LIGHT_GRAY_COLOR, true, false);
+    public static final MapDecorationType VILLAGE_SAVANNA = define("village_savanna", minecraft("savanna_village"),
+            true, LIGHT_GRAY_COLOR, true, false);
+    public static final MapDecorationType VILLAGE_SNOWY = define("village_snowy", minecraft("snowy_village"),
+            true, LIGHT_GRAY_COLOR, true, false);
+    public static final MapDecorationType VILLAGE_TAIGA = define("village_taiga", minecraft("taiga_village"),
+            true, LIGHT_GRAY_COLOR, true, false);
+    public static final MapDecorationType JUNGLE_TEMPLE = define("jungle_temple",
+            true, LIGHT_GRAY_COLOR, true, false);
+    public static final MapDecorationType SWAMP_HUT = define("swamp_hut",
+            true, LIGHT_GRAY_COLOR, true, false);
+
+    // Added with 1.20.5
+    public static final MapDecorationType TRIAL_CHAMBERS = define("trial_chambers",
+            true, COPPER_COLOR, true, false);
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/trimmaterial/StaticTrimMaterial.java

@@ -0,0 +1,106 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.trimmaterial;
+
+import com.github.retrooper.packetevents.protocol.item.armormaterial.ArmorMaterial;
+import com.github.retrooper.packetevents.protocol.item.type.ItemType;
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+import java.util.Objects;
+
+public class StaticTrimMaterial implements TrimMaterial {
+
+    private final String assetName;
+    private final ItemType ingredient;
+    private final float itemModelIndex;
+    private final Map<ArmorMaterial, String> overrideArmorMaterials;
+    private final Component description;
+
+    public StaticTrimMaterial(
+            String assetName, ItemType ingredient, float itemModelIndex,
+            Map<ArmorMaterial, String> overrideArmorMaterials, Component description
+    ) {
+        this.assetName = assetName;
+        this.ingredient = ingredient;
+        this.itemModelIndex = itemModelIndex;
+        this.overrideArmorMaterials = overrideArmorMaterials;
+        this.description = description;
+    }
+
+    @Override
+    public ResourceLocation getName() {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public int getId(ClientVersion version) {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public boolean isRegistered() {
+        return false;
+    }
+
+    @Override
+    public String getAssetName() {
+        return this.assetName;
+    }
+
+    @Override
+    public ItemType getIngredient() {
+        return this.ingredient;
+    }
+
+    @Override
+    public float getItemModelIndex() {
+        return this.itemModelIndex;
+    }
+
+    @Override
+    public Map<ArmorMaterial, String> getOverrideArmorMaterials() {
+        return this.overrideArmorMaterials;
+    }
+
+    @Override
+    public Component getDescription() {
+        return this.description;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof StaticTrimMaterial)) return false;
+        StaticTrimMaterial material = (StaticTrimMaterial) obj;
+        if (Float.compare(material.itemModelIndex, this.itemModelIndex) != 0) return false;
+        if (!this.assetName.equals(material.assetName)) return false;
+        if (!this.ingredient.equals(material.ingredient)) return false;
+        if (!this.overrideArmorMaterials.equals(material.overrideArmorMaterials)) return false;
+        return this.description.equals(material.description);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.assetName, this.ingredient, this.itemModelIndex, this.overrideArmorMaterials, this.description);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/trimmaterial/TrimMaterial.java

@@ -0,0 +1,75 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.trimmaterial;
+
+import com.github.retrooper.packetevents.protocol.item.armormaterial.ArmorMaterial;
+import com.github.retrooper.packetevents.protocol.item.armormaterial.ArmorMaterials;
+import com.github.retrooper.packetevents.protocol.item.type.ItemType;
+import com.github.retrooper.packetevents.protocol.item.type.ItemTypes;
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Map;
+
+public interface TrimMaterial extends MappedEntity {
+
+    String getAssetName();
+
+    ItemType getIngredient();
+
+    float getItemModelIndex();
+
+    default @Nullable String getArmorMaterialOverride(ArmorMaterial armorMaterial) {
+        return this.getOverrideArmorMaterials().get(armorMaterial);
+    }
+
+    Map<ArmorMaterial, String> getOverrideArmorMaterials();
+
+    Component getDescription();
+
+    static TrimMaterial read(PacketWrapper<?> wrapper) {
+        return wrapper.readMappedEntityOrDirect(TrimMaterials::getById, TrimMaterial::readDirect);
+    }
+
+    static TrimMaterial readDirect(PacketWrapper<?> wrapper) {
+        String assetName = wrapper.readString();
+        ItemType ingredient = wrapper.readMappedEntity(ItemTypes::getById);
+        float itemModelIndex = wrapper.readFloat();
+        Map<ArmorMaterial, String> overrideArmorMaterials = wrapper.readMap(
+                ew -> ew.readMappedEntity(ArmorMaterials::getById),
+                PacketWrapper::readString);
+        Component description = wrapper.readComponent();
+        return new StaticTrimMaterial(assetName, ingredient, itemModelIndex, overrideArmorMaterials, description);
+    }
+
+    static void write(PacketWrapper<?> wrapper, TrimMaterial material) {
+        wrapper.writeMappedEntityOrDirect(material, TrimMaterial::writeDirect);
+    }
+
+    static void writeDirect(PacketWrapper<?> wrapper, TrimMaterial material) {
+        wrapper.writeString(material.getAssetName());
+        wrapper.writeMappedEntity(material.getIngredient());
+        wrapper.writeFloat(material.getItemModelIndex());
+        wrapper.writeMap(material.getOverrideArmorMaterials(),
+                PacketWrapper::writeMappedEntity, PacketWrapper::writeString);
+        wrapper.writeComponent(material.getDescription());
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/trimmaterial/TrimMaterials.java

@@ -0,0 +1,136 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.trimmaterial;
+
+import com.github.retrooper.packetevents.protocol.item.armormaterial.ArmorMaterial;
+import com.github.retrooper.packetevents.protocol.item.armormaterial.ArmorMaterials;
+import com.github.retrooper.packetevents.protocol.item.type.ItemType;
+import com.github.retrooper.packetevents.protocol.item.type.ItemTypes;
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+import net.kyori.adventure.text.Component;
+
+import java.util.HashMap;
+import java.util.Map;
+
+import static net.kyori.adventure.text.Component.translatable;
+import static net.kyori.adventure.text.format.TextColor.color;
+
+public class TrimMaterials {
+
+    private static final Map<String, TrimMaterial> PATTERN_TYPE_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, TrimMaterial>> PATTERN_TYPE_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("item/item_trim_material_mappings");
+
+    public static TrimMaterial define(String key, ItemType ingredient, float itemModelIndex, int color) {
+        // darken own armor material - if present
+        Map<ArmorMaterial, String> overrideArmorMaterials = new HashMap<>(2);
+        String armorMaterialId = ResourceLocation.minecraft(key).toString();
+        ArmorMaterial armorMaterial = ArmorMaterials.getByName(armorMaterialId);
+        if (armorMaterial != null) {
+            overrideArmorMaterials.put(armorMaterial, key + "_darker");
+        }
+
+        Component description = translatable("trim_material.minecraft." + key, color(color));
+        return define(key, key, ingredient, itemModelIndex, overrideArmorMaterials, description);
+    }
+
+    public static TrimMaterial define(
+            String key, String assetName, ItemType ingredient, float itemModelIndex,
+            Map<ArmorMaterial, String> overrideArmorMaterials, Component description
+    ) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        TrimMaterial pattern = new TrimMaterial() {
+            @Override
+            public String getAssetName() {
+                return assetName;
+            }
+
+            @Override
+            public ItemType getIngredient() {
+                return ingredient;
+            }
+
+            @Override
+            public float getItemModelIndex() {
+                return itemModelIndex;
+            }
+
+            @Override
+            public Map<ArmorMaterial, String> getOverrideArmorMaterials() {
+                return overrideArmorMaterials;
+            }
+
+            @Override
+            public Component getDescription() {
+                return description;
+            }
+
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return TYPES_BUILDER.getDataIndex(version);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof TrimMaterial) {
+                    return this.getName().equals(((TrimMaterial) obj).getName());
+                }
+                return false;
+            }
+        };
+        MappingHelper.registerMapping(TYPES_BUILDER, PATTERN_TYPE_MAP, PATTERN_TYPE_ID_MAP, pattern);
+        return pattern;
+    }
+
+    // with key
+    public static TrimMaterial getByName(String name) {
+        return PATTERN_TYPE_MAP.get(name);
+    }
+
+    public static TrimMaterial getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, TrimMaterial> idMap = PATTERN_TYPE_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    // Added in 1.19.4
+    public static final TrimMaterial AMETHYST = define("amethyst", ItemTypes.AMETHYST_SHARD, 1f, 0x9A5CC6);
+    public static final TrimMaterial COPPER = define("copper", ItemTypes.COPPER_INGOT, 0.5f, 0xB4684D);
+    public static final TrimMaterial DIAMOND = define("diamond", ItemTypes.DIAMOND, 0.8f, 0x6EECD2);
+    public static final TrimMaterial EMERALD = define("emerald", ItemTypes.EMERALD, 0.7f, 0x11A036);
+    public static final TrimMaterial GOLD = define("gold", ItemTypes.GOLD_INGOT, 0.6f, 0xDEB12D);
+    public static final TrimMaterial IRON = define("iron", ItemTypes.IRON_INGOT, 0.2f, 0xECECEC);
+    public static final TrimMaterial LAPIS = define("lapis", ItemTypes.LAPIS_LAZULI, 0.9f, 0x416E97);
+    public static final TrimMaterial NETHERITE = define("netherite", ItemTypes.NETHERITE_INGOT, 0.3f, 0x625859);
+    public static final TrimMaterial QUARTZ = define("quartz", ItemTypes.QUARTZ, 0.1f, 0xE3D4C4);
+    public static final TrimMaterial REDSTONE = define("redstone", ItemTypes.REDSTONE, 0.4f, 0x971607);
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/trimpattern/StaticTrimPattern.java

@@ -0,0 +1,95 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.trimpattern;
+
+import com.github.retrooper.packetevents.protocol.item.type.ItemType;
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import net.kyori.adventure.text.Component;
+
+import java.util.Objects;
+
+public class StaticTrimPattern implements TrimPattern {
+
+    private final ResourceLocation assetId;
+    private final ItemType templateItem;
+    private final Component description;
+    private final boolean decal;
+
+    public StaticTrimPattern(
+            ResourceLocation assetId, ItemType templateItem,
+            Component description, boolean decal
+    ) {
+        this.assetId = assetId;
+        this.templateItem = templateItem;
+        this.description = description;
+        this.decal = decal;
+    }
+
+    @Override
+    public ResourceLocation getName() {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public int getId(ClientVersion version) {
+        throw new UnsupportedOperationException();
+    }
+
+    @Override
+    public boolean isRegistered() {
+        return false;
+    }
+
+    @Override
+    public ResourceLocation getAssetId() {
+        return this.assetId;
+    }
+
+    @Override
+    public ItemType getTemplateItem() {
+        return this.templateItem;
+    }
+
+    @Override
+    public Component getDescription() {
+        return this.description;
+    }
+
+    @Override
+    public boolean isDecal() {
+        return this.decal;
+    }
+
+    @Override
+    public boolean equals(Object obj) {
+        if (this == obj) return true;
+        if (!(obj instanceof StaticTrimPattern)) return false;
+        StaticTrimPattern pattern = (StaticTrimPattern) obj;
+        if (this.decal != pattern.decal) return false;
+        if (!this.assetId.equals(pattern.assetId)) return false;
+        if (!this.templateItem.equals(pattern.templateItem)) return false;
+        return this.description.equals(pattern.description);
+    }
+
+    @Override
+    public int hashCode() {
+        return Objects.hash(this.assetId, this.templateItem, this.description, this.decal);
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/trimpattern/TrimPattern.java

@@ -0,0 +1,60 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.trimpattern;
+
+import com.github.retrooper.packetevents.protocol.item.type.ItemType;
+import com.github.retrooper.packetevents.protocol.item.type.ItemTypes;
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+
+public interface TrimPattern extends MappedEntity {
+
+    ResourceLocation getAssetId();
+
+    ItemType getTemplateItem();
+
+    Component getDescription();
+
+    boolean isDecal();
+
+    static TrimPattern read(PacketWrapper<?> wrapper) {
+        return wrapper.readMappedEntityOrDirect(TrimPatterns::getById, TrimPattern::readDirect);
+    }
+
+    static TrimPattern readDirect(PacketWrapper<?> wrapper) {
+        ResourceLocation assetId = wrapper.readIdentifier();
+        ItemType templateItem = wrapper.readMappedEntity(ItemTypes::getById);
+        Component description = wrapper.readComponent();
+        boolean decal = wrapper.readBoolean();
+        return new StaticTrimPattern(assetId, templateItem, description, decal);
+    }
+
+    static void write(PacketWrapper<?> wrapper, TrimPattern pattern) {
+        wrapper.writeMappedEntityOrDirect(pattern, TrimPattern::writeDirect);
+    }
+
+    static void writeDirect(PacketWrapper<?> wrapper, TrimPattern pattern) {
+        wrapper.writeIdentifier(pattern.getAssetId());
+        wrapper.writeMappedEntity(pattern.getTemplateItem());
+        wrapper.writeComponent(pattern.getDescription());
+        wrapper.writeBoolean(pattern.isDecal());
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/trimpattern/TrimPatterns.java

@@ -0,0 +1,133 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.item.trimpattern;
+
+import com.github.retrooper.packetevents.protocol.item.type.ItemType;
+import com.github.retrooper.packetevents.protocol.item.type.ItemTypes;
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.util.mappings.MappingHelper;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilder;
+import com.github.retrooper.packetevents.util.mappings.TypesBuilderData;
+import net.kyori.adventure.text.Component;
+
+import java.util.HashMap;
+import java.util.Map;
+
+public class TrimPatterns {
+
+    private static final Map<String, TrimPattern> PATTERN_TYPE_MAP = new HashMap<>();
+    private static final Map<Byte, Map<Integer, TrimPattern>> PATTERN_TYPE_ID_MAP = new HashMap<>();
+    private static final TypesBuilder TYPES_BUILDER = new TypesBuilder("item/item_trim_pattern_mappings");
+
+    public static TrimPattern define(String key) {
+        ResourceLocation assetId = ResourceLocation.minecraft(key);
+        ItemType templateItem = ItemTypes.getByName(assetId + "_armor_trim_smithing_template");
+        Component description = Component.translatable("trim_pattern.minecraft." + key);
+        boolean decal = false;
+        return define(key, assetId, templateItem, description, decal);
+    }
+
+    public static TrimPattern define(
+            String key, ResourceLocation assetId, ItemType templateItem,
+            Component description, boolean decal
+    ) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        TrimPattern pattern = new TrimPattern() {
+            @Override
+            public ResourceLocation getAssetId() {
+                return assetId;
+            }
+
+            @Override
+            public ItemType getTemplateItem() {
+                return templateItem;
+            }
+
+            @Override
+            public Component getDescription() {
+                return description;
+            }
+
+            @Override
+            public boolean isDecal() {
+                return decal;
+            }
+
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return TYPES_BUILDER.getDataIndex(version);
+            }
+
+            @Override
+            public boolean equals(Object obj) {
+                if (obj instanceof TrimPattern) {
+                    return this.getName().equals(((TrimPattern) obj).getName());
+                }
+                return false;
+            }
+        };
+        MappingHelper.registerMapping(TYPES_BUILDER, PATTERN_TYPE_MAP, PATTERN_TYPE_ID_MAP, pattern);
+        return pattern;
+    }
+
+    // with key
+    public static TrimPattern getByName(String name) {
+        return PATTERN_TYPE_MAP.get(name);
+    }
+
+    public static TrimPattern getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        Map<Integer, TrimPattern> idMap = PATTERN_TYPE_ID_MAP.get((byte) index);
+        return idMap.get(id);
+    }
+
+    // Added in 1.19.4
+    public static final TrimPattern COAST = define("coast");
+    public static final TrimPattern DUNE = define("dune");
+    public static final TrimPattern EYE = define("eye");
+    public static final TrimPattern RIB = define("rib");
+    public static final TrimPattern SENTRY = define("sentry");
+    public static final TrimPattern SNOUT = define("snout");
+    public static final TrimPattern SPIRE = define("spire");
+    public static final TrimPattern TIDE = define("tide");
+    public static final TrimPattern VEX = define("vex");
+    public static final TrimPattern WARD = define("ward");
+    public static final TrimPattern WILD = define("wild");
+
+    // Added in 1.20
+    public static final TrimPattern RAISER = define("raiser");
+    public static final TrimPattern HOST = define("host");
+    public static final TrimPattern SILENCE = define("silence");
+    public static final TrimPattern SHAPER = define("shaper");
+    public static final TrimPattern WAYFINDER = define("wayfinder");
+
+    // Added in 1.20.5
+    public static final TrimPattern BOLT = define("bolt");
+    public static final TrimPattern FLOW = define("flow");
+
+    static {
+        TYPES_BUILDER.unloadFileMappings();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/item/type/ItemType.java

@@ -18,6 +18,7 @@
 
 package com.github.retrooper.packetevents.protocol.item.type;
 
+import com.github.retrooper.packetevents.protocol.component.StaticComponentMap;
 import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
 import com.github.retrooper.packetevents.protocol.world.states.type.StateType;
 import org.jetbrains.annotations.Nullable;
@@ -39,4 +40,8 @@ public interface ItemType extends MappedEntity {
     Set<ItemTypes.ItemAttribute> getAttributes();
 
     boolean hasAttribute(ItemTypes.ItemAttribute attribute);
+
+    default StaticComponentMap getComponents() {
+        return StaticComponentMap.EMPTY;
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/mapper/GenericMappedEntity.java

@@ -0,0 +1,58 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.mapper;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+
+public class GenericMappedEntity implements StaticMappedEntity {
+
+    private final int id;
+
+    public GenericMappedEntity(ClientVersion ignoredVersion, int id) {
+        this(id);
+    }
+
+    public GenericMappedEntity(int id) {
+        this.id = id;
+    }
+
+    public static GenericMappedEntity getById(ClientVersion version, int id) {
+        return new GenericMappedEntity(version, id);
+    }
+
+    public static GenericMappedEntity read(PacketWrapper<?> wrapper) {
+        return wrapper.readMappedEntity(GenericMappedEntity::new);
+    }
+
+    public static void write(PacketWrapper<?> wrapper, GenericMappedEntity entity) {
+        wrapper.writeMappedEntity(entity);
+    }
+
+    @Override
+    public int getId() {
+        return this.id;
+    }
+
+    @Override
+    public ResourceLocation getName() {
+        throw new UnsupportedOperationException();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/mapper/MappedEntity.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2022 retrooper and contributors
+ * Copyright (C) 2024 retrooper and contributors
  *
  * This program is free software: you can redistribute it and/or modify
  * it under the terms of the GNU General Public License as published by
@@ -22,7 +22,12 @@ import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.resources.ResourceLocation;
 
 public interface MappedEntity {
+
     ResourceLocation getName();
 
     int getId(ClientVersion version);
+
+    default boolean isRegistered() {
+        return true;
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/mapper/MappedEntitySet.java

@@ -0,0 +1,83 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2024 retrooper and contributors
+ *
+ * This program is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License as published by
+ * the Free Software Foundation, either version 3 of the License, or
+ * (at your option) any later version.
+ *
+ * This program is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with this program.  If not, see <http://www.gnu.org/licenses/>.
+ */
+
+package com.github.retrooper.packetevents.protocol.mapper;
+
+import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.ArrayList;
+import java.util.List;
+import java.util.function.BiFunction;
+
+/**
+ * Either a key to a specific tag or a list of possible entities.
+ */
+public class MappedEntitySet<T> {
+
+    private final @Nullable ResourceLocation tagKey;
+    private final @Nullable List<T> entities;
+
+    public MappedEntitySet(ResourceLocation tagKey) {
+        this(tagKey, null);
+    }
+
+    public MappedEntitySet(List<T> entities) {
+        this(null, entities);
+    }
+
+    public MappedEntitySet(
+            @Nullable ResourceLocation tagKey,
+            @Nullable List<T> entities
+    ) {
+        if (tagKey == null && entities == null) {
+            throw new IllegalArgumentException("Illegal generic holder set: either tag key or holder ids have to be set");
+        }
+        this.tagKey = tagKey;
+        this.entities = entities;
+    }
+
+    public static <Z extends MappedEntity> MappedEntitySet<Z> read(
+            PacketWrapper<?> wrapper, BiFunction<ClientVersion, Integer, Z> getter) {
+        int count = wrapper.readVarInt() - 1;
+        if (count == -1) {
+            return new MappedEntitySet<>(wrapper.readIdentifier(), null);
+        }
+        List<Z> entities = new ArrayList<>(Math.min(count, 65536));
+        for (int i = 0; i < count; i++) {
+            entities.add(wrapper.readMappedEntity(getter));
+        }
+        return new MappedEntitySet<>(null, entities);
+    }
+
+    public static <Z extends MappedEntity> void write(PacketWrapper<?> wrapper, MappedEntitySet<Z> set) {
+        if (set.tagKey != null) {
+            wrapper.writeByte(0);
+            wrapper.writeIdentifier(set.tagKey);
+            return;
+        }
+
+        assert set.entities != null; // can't be null, verified in ctor
+        wrapper.writeVarInt(set.entities.size() + 1);
+        for (Z entity : set.entities) {
+            wrapper.writeMappedEntity(entity);
+        }
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTByte.java

@@ -94,4 +94,9 @@ public class NBTByte extends NBTNumber {
     public NBTByte copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "Byte(" + value + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTByteArray.java

@@ -62,4 +62,9 @@ public class NBTByteArray extends NBT {
         System.arraycopy(this.array, 0, abyte, 0, this.array.length);
         return new NBTByteArray(abyte);
     }
+
+    @Override
+    public String toString() {
+        return "ByteArray(" + Arrays.toString(array) + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTCompound.java

@@ -18,6 +18,8 @@
 
 package com.github.retrooper.packetevents.protocol.nbt;
 
+import org.jetbrains.annotations.Nullable;
+
 import java.text.MessageFormat;
 import java.util.Collections;
 import java.util.LinkedHashMap;
@@ -45,6 +47,10 @@ public class NBTCompound extends NBT {
         return Collections.unmodifiableMap(tags);
     }
 
+    public int size() {
+        return tags.size();
+    }
+
     public NBT getTagOrThrow(String key) {
         NBT tag = getTagOrNull(key);
         if (tag == null) {
@@ -53,7 +59,7 @@ public class NBTCompound extends NBT {
         return tag;
     }
 
-    public NBT getTagOrNull(String key) {
+    public @Nullable NBT getTagOrNull(String key) {
         return tags.get(key);
     }
 
@@ -68,7 +74,7 @@ public class NBTCompound extends NBT {
     }
 
     @SuppressWarnings("unchecked")
-    public <T extends NBT> T getTagOfTypeOrNull(String key, Class<T> type) {
+    public <T extends NBT> @Nullable T getTagOfTypeOrNull(String key, Class<T> type) {
         NBT tag = getTagOrNull(key);
         if (type.isInstance(tag)) {
             return (T) tag;
@@ -86,7 +92,7 @@ public class NBTCompound extends NBT {
     }
 
     @SuppressWarnings("unchecked")
-    public <T extends NBT> NBTList<T> getTagListOfTypeOrNull(String key, Class<T> type) {
+    public <T extends NBT> @Nullable NBTList<T> getTagListOfTypeOrNull(String key, Class<T> type) {
         NBTList<? extends NBT> list = getTagOfTypeOrNull(key, NBTList.class);
         if ((list != null) && type.isAssignableFrom(list.getTagsType().getNBTClass())) {
             return (NBTList<T>) list;
@@ -98,7 +104,7 @@ public class NBTCompound extends NBT {
         return getTagOfTypeOrThrow(key, NBTCompound.class);
     }
 
-    public NBTCompound getCompoundTagOrNull(String key) {
+    public @Nullable NBTCompound getCompoundTagOrNull(String key) {
         return getTagOfTypeOrNull(key, NBTCompound.class);
     }
 
@@ -106,7 +112,7 @@ public class NBTCompound extends NBT {
         return getTagOfTypeOrThrow(key, NBTNumber.class);
     }
 
-    public NBTNumber getNumberTagOrNull(String key) {
+    public @Nullable NBTNumber getNumberTagOrNull(String key) {
         return getTagOfTypeOrNull(key, NBTNumber.class);
     }
 
@@ -114,7 +120,7 @@ public class NBTCompound extends NBT {
         return getTagOfTypeOrThrow(key, NBTString.class);
     }
 
-    public NBTString getStringTagOrNull(String key) {
+    public @Nullable NBTString getStringTagOrNull(String key) {
         return getTagOfTypeOrNull(key, NBTString.class);
     }
 
@@ -122,7 +128,7 @@ public class NBTCompound extends NBT {
         return getTagListOfTypeOrThrow(key, NBTCompound.class);
     }
 
-    public NBTList<NBTCompound> getCompoundListTagOrNull(String key) {
+    public @Nullable NBTList<NBTCompound> getCompoundListTagOrNull(String key) {
         return getTagListOfTypeOrNull(key, NBTCompound.class);
     }
 
@@ -130,7 +136,7 @@ public class NBTCompound extends NBT {
         return getTagListOfTypeOrThrow(key, NBTNumber.class);
     }
 
-    public NBTList<NBTNumber> getNumberListTagOrNull(String key) {
+    public @Nullable NBTList<NBTNumber> getNumberListTagOrNull(String key) {
         return getTagListOfTypeOrNull(key, NBTNumber.class);
     }
 
@@ -138,7 +144,7 @@ public class NBTCompound extends NBT {
         return getTagListOfTypeOrThrow(key, NBTString.class);
     }
 
-    public NBTList<NBTString> getStringListTagOrNull(String key) {
+    public @Nullable NBTList<NBTString> getStringListTagOrNull(String key) {
         return getTagListOfTypeOrNull(key, NBTString.class);
     }
 
@@ -146,7 +152,7 @@ public class NBTCompound extends NBT {
         return getStringTagOrThrow(key).getValue();
     }
 
-    public String getStringTagValueOrNull(String key) {
+    public @Nullable String getStringTagValueOrNull(String key) {
         NBT tag = getTagOrNull(key);
         if (tag instanceof NBTString) {
             return ((NBTString) tag).getValue();
@@ -222,4 +228,8 @@ public class NBTCompound extends NBT {
         return tags.hashCode();
     }
 
+    @Override
+    public String toString() {
+        return "Compound{" + tags + "}";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTDouble.java

@@ -90,4 +90,9 @@ public class NBTDouble extends NBTNumber {
     public NBTDouble copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "Double(" + value + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTEnd.java

@@ -47,4 +47,9 @@ public class NBTEnd extends NBT {
     public NBTEnd copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "END";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTFloat.java

@@ -90,4 +90,9 @@ public class NBTFloat extends NBTNumber {
     public NBTFloat copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "Float(" + value + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTInt.java

@@ -90,4 +90,9 @@ public class NBTInt extends NBTNumber {
     public NBTInt copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "Int(" + value + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTIntArray.java

@@ -63,4 +63,9 @@ public class NBTIntArray extends NBT {
         System.arraycopy(this.array, 0, aint, 0, this.array.length);
         return new NBTIntArray(aint);
     }
+
+    @Override
+    public String toString() {
+        return "IntArray(" + Arrays.toString(array) + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTList.java

@@ -87,8 +87,16 @@ public class NBTList<T extends NBT> extends NBT {
         tags.add(tag);
     }
 
+    public void addTagUnsafe(int index, NBT nbt) {
+        addTag(index, (T) nbt);
+    }
+
     public void addTagUnsafe(NBT nbt) {
-        addTag((T)nbt);
+        addTag((T) nbt);
+    }
+
+    public void removeTag(int index) {
+        tags.remove(index);
     }
 
     protected void validateAddTag(T tag) {
@@ -126,4 +134,9 @@ public class NBTList<T extends NBT> extends NBT {
         }
         return new NBTList<>(type, newTags);
     }
+
+    @Override
+    public String toString() {
+        return "List(" + tags + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTLong.java

@@ -90,4 +90,9 @@ public class NBTLong extends NBTNumber {
     public NBTLong copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "Long(" + value + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTLongArray.java

@@ -63,4 +63,9 @@ public class NBTLongArray extends NBT {
         System.arraycopy(this.array, 0, along, 0, this.array.length);
         return new NBTLongArray(along);
     }
+
+    @Override
+    public String toString() {
+        return "LongArray(" + Arrays.toString(array) + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTShort.java

@@ -89,4 +89,9 @@ public class NBTShort extends NBTNumber {
     public NBTShort copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "Short(" + value + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/NBTString.java

@@ -61,4 +61,9 @@ public class NBTString extends NBT {
     public NBTString copy() {
         return this;
     }
+
+    @Override
+    public String toString() {
+        return "String(" + string + ")";
+    }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/nbt/codec/NBTCodec.java

@@ -33,12 +33,12 @@ import java.io.IOException;
 import java.util.ArrayList;
 import java.util.List;
 import java.util.Map;
-import java.util.function.BiConsumer;
 import java.util.zip.GZIPInputStream;
 import java.util.zip.GZIPOutputStream;
 
 public class NBTCodec {
     //PacketEvents start: JSON -> NBT conversion method
+    @Deprecated
     public static NBT jsonToNBT(JsonElement element) {
         //Deal with the primitives first
         if (element instanceof JsonPrimitive) {
@@ -102,6 +102,7 @@ public class NBTCodec {
     //PacketEvents end
 
     //PacketEvents start - NBT to JSON conversion
+    @Deprecated
     public static JsonElement nbtToJson(NBT nbt, boolean parseByteAsBool) {
         //TODO once I make my own nbt implementation, make a toJSON method that each nbt class implements to make this  a one liner
         if (nbt instanceof NBTNumber) {
@@ -147,11 +148,7 @@ public class NBTCodec {
     }
     //PacketEvents end
 
-    public static NBTCompound readNBTFromBuffer(Object byteBuf, ServerVersion serverVersion) {
-        return (NBTCompound) readRawNBTFromBuffer(byteBuf, serverVersion);
-    }
-
-    public static NBT readRawNBTFromBuffer(Object byteBuf, ServerVersion serverVersion) {
+    public static NBT readNBTFromBuffer(Object byteBuf, ServerVersion serverVersion) {
         if (serverVersion.isNewerThanOrEquals(ServerVersion.V_1_8)) {
             try {
                 final boolean named = serverVersion.isOlderThan(ServerVersion.V_1_20_2);

api/src/main/java/com/github/retrooper/packetevents/protocol/npc/NPC.java

@@ -20,6 +20,7 @@ package com.github.retrooper.packetevents.protocol.npc;
 
 import com.github.retrooper.packetevents.PacketEvents;
 import com.github.retrooper.packetevents.manager.server.ServerVersion;
+import com.github.retrooper.packetevents.protocol.entity.type.EntityTypes;
 import com.github.retrooper.packetevents.protocol.item.ItemStack;
 import com.github.retrooper.packetevents.protocol.player.*;
 import com.github.retrooper.packetevents.protocol.world.Location;
@@ -86,10 +87,17 @@ public class NPC {
         PacketEvents.getAPI().getProtocolManager().sendPacket(channel, playerInfo);
 
         //TODO Later if we want entity metadata, its not supported on newer server versions though(confirm if its mandatory on older versions)
-        WrapperPlayServerSpawnPlayer spawnPlayer = new WrapperPlayServerSpawnPlayer(getId(),
-                getProfile().getUUID(),
-                getLocation());
-        PacketEvents.getAPI().getProtocolManager().sendPacket(channel, spawnPlayer);
+
+        PacketWrapper<?> spawnPacket;
+        if (PacketEvents.getAPI().getServerManager().getVersion().isNewerThanOrEquals(ServerVersion.V_1_20_2)) {
+            spawnPacket = new WrapperPlayServerSpawnEntity(getId(), getProfile().getUUID(), EntityTypes.PLAYER, getLocation(), getLocation().getYaw(), 0, null);
+        }
+        else {
+            spawnPacket = new WrapperPlayServerSpawnPlayer(getId(),
+                    getProfile().getUUID(),
+                    getLocation());
+        }
+        PacketEvents.getAPI().getProtocolManager().sendPacket(channel, spawnPacket);
 
         //Create team
         if (getNameColor() != null || getPrefixName() != null

api/src/main/java/com/github/retrooper/packetevents/protocol/packettype/PacketType.java

@@ -37,12 +37,16 @@ import com.github.retrooper.packetevents.protocol.packettype.clientbound.Clientb
 import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_19_4;
 import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_20_2;
 import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_20_3;
+import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_20_5;
 import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_7_10;
 import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_8;
 import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_9;
 import com.github.retrooper.packetevents.protocol.packettype.clientbound.ClientboundPacketType_1_9_3;
 import com.github.retrooper.packetevents.protocol.packettype.config.clientbound.ClientboundConfigPacketType_1_20_2;
 import com.github.retrooper.packetevents.protocol.packettype.config.clientbound.ClientboundConfigPacketType_1_20_3;
+import com.github.retrooper.packetevents.protocol.packettype.config.clientbound.ClientboundConfigPacketType_1_20_5;
+import com.github.retrooper.packetevents.protocol.packettype.config.serverbound.ServerboundConfigPacketType_1_20_2;
+import com.github.retrooper.packetevents.protocol.packettype.config.serverbound.ServerboundConfigPacketType_1_20_5;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_12;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_12_1;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_13;
@@ -57,6 +61,7 @@ import com.github.retrooper.packetevents.protocol.packettype.serverbound.Serverb
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_19_4;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_20_2;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_20_3;
+import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_20_5;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_7_10;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_8;
 import com.github.retrooper.packetevents.protocol.packettype.serverbound.ServerboundPacketType_1_9;
@@ -69,7 +74,9 @@ import java.util.HashMap;
 import java.util.Map;
 
 public final class PacketType {
+
     private static boolean PREPARED = false;
+
     //TODO UPDATE Update packet type mappings (clientbound pt. 1)
     private static final VersionMapper CLIENTBOUND_PLAY_VERSION_MAPPER = new VersionMapper(
             ClientVersion.V_1_7_10,
@@ -92,7 +99,8 @@ public final class PacketType {
             ClientVersion.V_1_19_3,
             ClientVersion.V_1_19_4,
             ClientVersion.V_1_20_2,
-            ClientVersion.V_1_20_3);
+            ClientVersion.V_1_20_3,
+            ClientVersion.V_1_20_5);
 
     //TODO UPDATE Update packet type mappings (serverbound pt. 1)
     private static final VersionMapper SERVERBOUND_PLAY_VERSION_MAPPER = new VersionMapper(
@@ -112,16 +120,23 @@ public final class PacketType {
             ClientVersion.V_1_19_3,
             ClientVersion.V_1_19_4,
             ClientVersion.V_1_20_2,
-            ClientVersion.V_1_20_3);
+            ClientVersion.V_1_20_3,
+            ClientVersion.V_1_20_5);
 
-    //TODO UPDATE Update packet type mappings (config clientbound pt. 1)
+    // TODO UPDATE Update packet type mappings (config clientbound pt. 1)
     private static final VersionMapper CLIENTBOUND_CONFIG_VERSION_MAPPER = new VersionMapper(
             ClientVersion.V_1_20_2,
-            ClientVersion.V_1_20_3);
+            ClientVersion.V_1_20_3,
+            ClientVersion.V_1_20_5);
+    // TODO UPDATE Update packet type mappings (config serverbound pt. 1)
+    private static final VersionMapper SERVERBOUND_CONFIG_VERSION_MAPPER = new VersionMapper(
+            ClientVersion.V_1_20_2,
+            ClientVersion.V_1_20_5);
 
     public static void prepare() {
         PacketType.Play.Client.load();
         PacketType.Play.Server.load();
+        PacketType.Configuration.Client.load();
         PacketType.Configuration.Server.load();
         PREPARED = true;
     }
@@ -158,7 +173,7 @@ public final class PacketType {
                 }
             case CONFIGURATION:
                 if (side == PacketSide.CLIENT) {
-                    return Configuration.Client.getById(packetID);
+                    return Configuration.Client.getById(version, packetID);
                 } else {
                     return Configuration.Server.getById(version, packetID);
                 }
@@ -168,13 +183,15 @@ public final class PacketType {
     }
 
     public static class Handshaking {
+
         public enum Client implements PacketTypeConstant, ServerBoundPacket {
+
             HANDSHAKE(0),
             /**
              * Technically not part of the current protocol, but clients older than 1.7 will send this to initiate Server List Ping.
              * 1.8 and newer servers will handle it correctly though.
              */
-            LEGACY_SERVER_LIST_PING(254);//0xFE in hex
+            LEGACY_SERVER_LIST_PING(0xFE);
 
             private final int id;
 
@@ -186,7 +203,7 @@ public final class PacketType {
             public static PacketTypeCommon getById(int packetID) {
                 if (packetID == 0) {
                     return HANDSHAKE;
-                } else if (packetID == 254) {
+                } else if (packetID == 0xFE) {
                     return LEGACY_SERVER_LIST_PING;
                 } else {
                     return null;
@@ -204,7 +221,8 @@ public final class PacketType {
         }
 
         public enum Server implements PacketTypeConstant, ClientBoundPacket {
-            LEGACY_SERVER_LIST_RESPONSE(254); //0xFE in hex
+
+            LEGACY_SERVER_LIST_RESPONSE(0xFE);
 
             private final int id;
 
@@ -214,7 +232,7 @@ public final class PacketType {
 
             @Nullable
             public static PacketTypeCommon getById(int packetID) {
-                return packetID == 254 ? LEGACY_SERVER_LIST_RESPONSE : null;
+                return packetID == 0xFE ? LEGACY_SERVER_LIST_RESPONSE : null;
             }
 
             public int getId() {
@@ -229,9 +247,11 @@ public final class PacketType {
     }
 
     public static class Status {
+
         public enum Client implements PacketTypeConstant, ServerBoundPacket {
-            REQUEST(0),
-            PING(1);
+
+            REQUEST(0x00),
+            PING(0x01);
 
             private final int id;
 
@@ -254,7 +274,6 @@ public final class PacketType {
                 return id;
             }
 
-
             @Override
             public PacketSide getSide() {
                 return PacketSide.CLIENT;
@@ -262,8 +281,9 @@ public final class PacketType {
         }
 
         public enum Server implements PacketTypeConstant, ClientBoundPacket {
-            RESPONSE(0),
-            PONG(1);
+
+            RESPONSE(0x00),
+            PONG(0x01);
 
             private final int id;
 
@@ -294,13 +314,20 @@ public final class PacketType {
     }
 
     public static class Login {
+
         public enum Client implements PacketTypeConstant, ServerBoundPacket {
-            LOGIN_START(0),
-            ENCRYPTION_RESPONSE(1),
-            ///Added in 1.13
-            LOGIN_PLUGIN_RESPONSE(2),
-            //Added in 1.20.2
-            LOGIN_SUCCESS_ACK(3);
+
+            LOGIN_START(0x00),
+            ENCRYPTION_RESPONSE(0x01),
+
+            // Added in 1.13
+            LOGIN_PLUGIN_RESPONSE(0x02),
+
+            // Added in 1.20.2
+            LOGIN_SUCCESS_ACK(0x03),
+
+            // Added in 1.20.5
+            COOKIE_RESPONSE(0x04);
 
             private final int id;
 
@@ -310,16 +337,19 @@ public final class PacketType {
 
             @Nullable
             public static PacketTypeCommon getById(int packetID) {
-                if (packetID == 0) {
-                    return LOGIN_START;
-                } else if (packetID == 1) {
-                    return ENCRYPTION_RESPONSE;
-                } else if (packetID == 2) {
-                    return LOGIN_PLUGIN_RESPONSE;
-                } else if (packetID == 3) {
-                    return LOGIN_SUCCESS_ACK;
-                } else {
-                    return null;
+                switch (packetID) {
+                    case 0x00:
+                        return LOGIN_START;
+                    case 0x01:
+                        return ENCRYPTION_RESPONSE;
+                    case 0x02:
+                        return LOGIN_PLUGIN_RESPONSE;
+                    case 0x03:
+                        return LOGIN_SUCCESS_ACK;
+                    case 0x04:
+                        return COOKIE_RESPONSE;
+                    default:
+                        return null;
                 }
             }
 
@@ -334,13 +364,19 @@ public final class PacketType {
         }
 
         public enum Server implements PacketTypeConstant, ClientBoundPacket {
-            DISCONNECT(0),
-            ENCRYPTION_REQUEST(1),
-            LOGIN_SUCCESS(2),
-            //Added in 1.8
-            SET_COMPRESSION(3),
-            ///Added in 1.13
-            LOGIN_PLUGIN_REQUEST(4);
+
+            DISCONNECT(0x00),
+            ENCRYPTION_REQUEST(0x01),
+            LOGIN_SUCCESS(0x02),
+
+            // Added in 1.8
+            SET_COMPRESSION(0x03),
+
+            // Added in 1.13
+            LOGIN_PLUGIN_REQUEST(0x04),
+
+            // Added in 1.20.5
+            COOKIE_REQUEST(0x05);
 
             private final int id;
 
@@ -351,16 +387,18 @@ public final class PacketType {
             @Nullable
             public static PacketTypeCommon getById(int packetID) {
                 switch (packetID) {
-                    case 0:
+                    case 0x00:
                         return DISCONNECT;
-                    case 1:
+                    case 0x01:
                         return ENCRYPTION_REQUEST;
-                    case 2:
+                    case 0x02:
                         return LOGIN_SUCCESS;
-                    case 3:
+                    case 0x03:
                         return SET_COMPRESSION;
-                    case 4:
+                    case 0x04:
                         return LOGIN_PLUGIN_REQUEST;
+                    case 0x05:
+                        return COOKIE_REQUEST;
                     default:
                         return null;
                 }
@@ -380,43 +418,72 @@ public final class PacketType {
     // Added in 1.20.2
     public static class Configuration {
 
-        public enum Client implements PacketTypeConstant, ServerBoundPacket {
+        public enum Client implements PacketTypeCommon, ServerBoundPacket {
 
-            CLIENT_SETTINGS(0x00),
-            PLUGIN_MESSAGE(0x01),
-            CONFIGURATION_END_ACK(0x02),
-            KEEP_ALIVE(0x03),
-            PONG(0x04),
-            RESOURCE_PACK_STATUS(0x05);
+            CLIENT_SETTINGS,
+            PLUGIN_MESSAGE,
+            CONFIGURATION_END_ACK,
+            KEEP_ALIVE,
+            PONG,
+            RESOURCE_PACK_STATUS,
 
-            private final int id;
+            // Added in 1.20.5
+            COOKIE_RESPONSE,
+            SELECT_KNOWN_PACKS;
 
-            Client(int id) {
-                this.id = id;
+            private static int INDEX = 0;
+            private static final Map<Byte, Map<Integer, PacketTypeCommon>> PACKET_TYPE_ID_MAP = new HashMap<>();
+            private final int[] ids;
+
+            Client() {
+                this.ids = new int[SERVERBOUND_CONFIG_VERSION_MAPPER.getVersions().length];
+                Arrays.fill(this.ids, -1);
+            }
+
+            public static void load() {
+                INDEX = 0;
+                loadPacketIds(ServerboundConfigPacketType_1_20_2.values());
+                loadPacketIds(ServerboundConfigPacketType_1_20_5.values());
+                // TODO UPDATE Update packet type mappings (config serverbound pt. 2)
+            }
+
+            private static void loadPacketIds(Enum<?>[] enumConstants) {
+                int index = INDEX;
+                for (Enum<?> constant : enumConstants) {
+                    int id = constant.ordinal();
+                    Configuration.Client value = Configuration.Client.valueOf(constant.name());
+                    value.ids[index] = id;
+                    Map<Integer, PacketTypeCommon> packetIdMap = PACKET_TYPE_ID_MAP.computeIfAbsent((byte) index, k -> new HashMap<>());
+                    packetIdMap.put(id, value);
+                }
+                INDEX++;
             }
 
             public static @Nullable PacketTypeCommon getById(int packetId) {
-                switch (packetId) {
-                    case 0x00:
-                        return CLIENT_SETTINGS;
-                    case 0x01:
-                        return PLUGIN_MESSAGE;
-                    case 0x02:
-                        return CONFIGURATION_END_ACK;
-                    case 0x03:
-                        return KEEP_ALIVE;
-                    case 0x04:
-                        return PONG;
-                    case 0x05:
-                        return RESOURCE_PACK_STATUS;
-                    default:
-                        return null;
+                return getById(ClientVersion.getLatest(), packetId);
+            }
+
+            public static @Nullable PacketTypeCommon getById(ClientVersion version, int packetId) {
+                if (!PREPARED) {
+                    PacketType.prepare();
                 }
+                int index = SERVERBOUND_CONFIG_VERSION_MAPPER.getIndex(version);
+                Map<Integer, PacketTypeCommon> map = PACKET_TYPE_ID_MAP.get((byte) index);
+                return map.get(packetId);
+            }
+
+            @Deprecated
+            public int getId() {
+                return this.getId(ClientVersion.getLatest());
             }
 
             @Override
-            public int getId() {
-                return this.id;
+            public int getId(ClientVersion version) {
+                if (!PREPARED) {
+                    PacketType.prepare();
+                }
+                int index = SERVERBOUND_CONFIG_VERSION_MAPPER.getIndex(version);
+                return this.ids[index];
             }
 
             @Override
@@ -437,8 +504,15 @@ public final class PacketType {
             UPDATE_ENABLED_FEATURES,
             UPDATE_TAGS,
 
-            // added in 1.20.3
-            RESOURCE_PACK_REMOVE;
+            // Added in 1.20.3
+            RESOURCE_PACK_REMOVE,
+
+            // Added in 1.20.5
+            COOKIE_REQUEST,
+            RESET_CHAT,
+            STORE_COOKIE,
+            TRANSFER,
+            SELECT_KNOWN_PACKS;
 
             private static int INDEX = 0;
             private static final Map<Byte, Map<Integer, PacketTypeCommon>> PACKET_TYPE_ID_MAP = new HashMap<>();
@@ -453,6 +527,7 @@ public final class PacketType {
                 INDEX = 0;
                 loadPacketIds(ClientboundConfigPacketType_1_20_2.values());
                 loadPacketIds(ClientboundConfigPacketType_1_20_3.values());
+                loadPacketIds(ClientboundConfigPacketType_1_20_5.values());
                 // TODO UPDATE Update packet type mappings (config clientbound pt. 2)
             }
 
@@ -503,8 +578,10 @@ public final class PacketType {
     }
 
     public static class Play {
+
         public enum Client implements PacketTypeCommon, ServerBoundPacket {
-            //Packets that no longer exist on the latest version
+
+            // Packets which no longer exist on the latest version
             CHAT_PREVIEW,
 
             TELEPORT_CONFIRM,
@@ -557,18 +634,28 @@ public final class PacketType {
             SPECTATE,
             PLAYER_BLOCK_PLACEMENT,
             USE_ITEM,
-            //Added in 1.19
+
+            // Added in 1.19
             CHAT_COMMAND,
-            //Added in 1.19.1
+
+            // Added in 1.19.1
             CHAT_ACK,
-            //Added in 1.19.3
+
+            // Added in 1.19.3
             CHAT_SESSION_UPDATE,
-            //Added in 1.20.2
+
+            // Added in 1.20.2
             CHUNK_BATCH_ACK,
             CONFIGURATION_ACK,
             DEBUG_PING,
-            //Added in 1.20.3
-            SLOT_STATE_CHANGE;
+
+            // Added in 1.20.3
+            SLOT_STATE_CHANGE,
+
+            // Added in 1.20.5
+            CHAT_COMMAND_UNSIGNED,
+            COOKIE_RESPONSE,
+            DEBUG_SAMPLE_SUBSCRIPTION;
 
             private static int INDEX = 0;
             private static final Map<Byte, Map<Integer, PacketTypeCommon>> PACKET_TYPE_ID_MAP = new HashMap<>();
@@ -621,6 +708,7 @@ public final class PacketType {
                 loadPacketIds(ServerboundPacketType_1_19_4.values());
                 loadPacketIds(ServerboundPacketType_1_20_2.values());
                 loadPacketIds(ServerboundPacketType_1_20_3.values());
+                loadPacketIds(ServerboundPacketType_1_20_5.values());
                 //TODO UPDATE Update packet type mappings (serverbound pt. 2)
             }
 
@@ -639,7 +727,8 @@ public final class PacketType {
         }
 
         public enum Server implements PacketTypeCommon, ClientBoundPacket {
-            //Packets that are no longer present on latest version
+
+            // Packets which are no longer exist on the latest version
             SET_COMPRESSION,
             MAP_CHUNK_BULK,
             UPDATE_ENTITY_NBT,
@@ -662,7 +751,7 @@ public final class PacketType {
             UPDATE_ENABLED_FEATURES,
             SPAWN_PLAYER,
 
-            //Okay these are normal ones
+            // Still existing packets
             WINDOW_CONFIRMATION,
             SPAWN_ENTITY,
             SPAWN_EXPERIENCE_ORB,
@@ -762,37 +851,44 @@ public final class PacketType {
             TAGS,
             CHAT_MESSAGE,
 
-            //Added in 1.19
+            // Added in 1.19
             ACKNOWLEDGE_BLOCK_CHANGES,
             SERVER_DATA,
             SYSTEM_CHAT_MESSAGE,
 
-            //Added in 1.19.1
+            // Added in 1.19.1
             DELETE_CHAT,
             CUSTOM_CHAT_COMPLETIONS,
 
-            //Added in 1.19.3
+            // Added in 1.19.3
             DISGUISED_CHAT,
             PLAYER_INFO_REMOVE,
             PLAYER_INFO_UPDATE,
 
-            //Added in 1.19.4
+            // Added in 1.19.4
             DAMAGE_EVENT,
             HURT_ANIMATION,
             BUNDLE,
             CHUNK_BIOMES,
 
-            //Added in 1.20.2
+            // Added in 1.20.2
             CHUNK_BATCH_END,
             CHUNK_BATCH_BEGIN,
             DEBUG_PONG,
             CONFIGURATION_START,
 
-            //Added in 1.20.3
+            // Added in 1.20.3
             RESET_SCORE,
             RESOURCE_PACK_REMOVE,
             TICKING_STATE,
-            TICKING_STEP;
+            TICKING_STEP,
+
+            // Added in 1.20.5
+            COOKIE_REQUEST,
+            DEBUG_SAMPLE,
+            STORE_COOKIE,
+            TRANSFER,
+            PROJECTILE_POWER;
 
             private static int INDEX = 0;
             private static final Map<Byte, Map<Integer, PacketTypeCommon>> PACKET_TYPE_ID_MAP = new HashMap<>();
@@ -861,6 +957,7 @@ public final class PacketType {
                 loadPacketIds(ClientboundPacketType_1_19_4.values());
                 loadPacketIds(ClientboundPacketType_1_20_2.values());
                 loadPacketIds(ClientboundPacketType_1_20_3.values());
+                loadPacketIds(ClientboundPacketType_1_20_5.values());
                 //TODO UPDATE Update packet type mappings (clientbound pt. 2)
             }
         }