Release of PacketEvents 2.3.0

Fix reading/writing of JoinGame packet on 1.16/1.16.1

.github/workflows/gradle-publish.yml

@@ -11,44 +11,51 @@ jobs:
       packages: write
 
     steps:
-      - uses: actions/checkout@v2
-      - name: Set up JDK 8
-        uses: actions/setup-java@v2
+      - uses: actions/checkout@v3
+
+      - 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: gradle shadowJar
+        run: chmod +x gradlew && ./gradlew build
 
       - name: Upload build artifacts api
-        uses: actions/upload-artifact@v1
+        uses: actions/upload-artifact@v3
         with:
           name: api-build
           path: api/build/libs
 
       - name: Upload build artifacts spigot
-        uses: actions/upload-artifact@v1
+        uses: actions/upload-artifact@v3
         with:
           name: spigot-build
           path: spigot/build/libs
 
       - name: Upload build artifacts netty-common
-        uses: actions/upload-artifact@v1
+        uses: actions/upload-artifact@v3
         with:
           name: netty-common-build
           path: netty-common/build/libs
 
       - name: Upload build artifacts bungeecord
-        uses: actions/upload-artifact@v1
+        uses: actions/upload-artifact@v3
         with:
           name: bungeecord-build
           path: bungeecord/build/libs
 
       - name: Upload build artifacts velocity
-        uses: actions/upload-artifact@v1
+        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

.gitignore

@@ -102,6 +102,7 @@ $RECYCLE.BIN/
 
 .gradle
 build/
+bin/
 
 # Ignore Gradle GUI config
 gradle-app.setting
@@ -118,3 +119,7 @@ run/
 !gradle-wrapper.jar
 /src/main/resources/plugin.yml
 /.idea/
+.vscode/
+.project
+.settings/
+.classpath

README.md

@@ -1,20 +1,20 @@
 # packetevents
 
-[![](https://img.shields.io/badge/License-GPLv3-yellow.svg)](https://github.com/retrooper/packetevents/blob/dev/LICENSE)
-[![](https://jitpack.io/v/retrooper/packetevents.svg)](https://jitpack.io/#retrooper/packetevents)
+[![](https://img.shields.io/badge/License-GPLv3-yellow.svg)](https://github.com/retrooper/packetevents/blob/2.0/LICENSE) [![](https://github.com/retrooper/packetevents/actions/workflows/build.yml/badge.svg)](https://github.com/retrooper/packetevents/actions) [![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/prqzNg9tRU)
 
-PacketEvents is a powerful packet library. Our packet wrappers are efficient and easy to use. With our API, you can write code that runs on many platforms including Spigot, BungeeCord, Velocity, and even client-sided Fabric! 
+PacketEvents is a fast and efficient multi-platform packet processing library. Our packet wrappers are easy to use with multi-version support. With our API you can write code that runs on Spigot, BungeeCord, Velocity, and Fabric! Switch to PacketEvents today by joining \
+our [Discord Server](https://discord.me/packetevents) for help.
 
-### Resources
-* [SpigotMC](https://www.spigotmc.org/resources/packetevents-api.80279/)
-* [JavaDocs](https://packetevents.github.io/javadocs)
-* [Discord](https://discord.me/packetevents)
+### Links
+* [Find release builds on Modrinth](https://modrinth.com/plugin/packetevents)
+* [Find development builds on Jenkins](https://ci.codemc.io/job/retrooper/job/packetevents)
+* [View documentation on our JavaDocs Page](https://packetevents.github.io/javadocs)
 
 ### Setup
-[Learn more](https://github.com/retrooper/packetevents/wiki/Setup)
+[How to Setup PacketEvents](https://github.com/retrooper/packetevents/wiki/Depending-on-pre%E2%80%90built-PacketEvents)
 
-### Contributing
-[Learn more](https://github.com/retrooper/packetevents/wiki/Contributing)
+### 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)
@@ -23,11 +23,11 @@ PacketEvents is a powerful packet library. Our packet wrappers are efficient and
 PacketEvents optionally collects statistics using [bStats](https://bstats.org/)\
 Check out our [bStats page](https://bstats.org/plugin/bukkit/packetevents/11327)
 
-### Credit to
-[wiki.vg/Protocol](https://wiki.vg/Protocol)  
-[adventure](https://github.com/KyoriPowered/adventure)  
-[gson](https://github.com/google/gson)  
-[ViaVersion](https://github.com/ViaVersion/ViaVersion)  
-[ProtocolSupport](https://github.com/ProtocolSupport/ProtocolSupport)  
+### Credit to these projects
+[wiki.vg/Protocol](https://wiki.vg/Protocol)\
+[netty](https://github.com/netty/netty)\
+[gson](https://github.com/google/gson)\
+[adventure](https://github.com/KyoriPowered/adventure)\
+[ViaVersion](https://github.com/ViaVersion/ViaVersion)\
+[ProtocolSupport](https://github.com/ProtocolSupport/ProtocolSupport)\
 [MCProtocolLib](https://github.com/GeyserMC/MCProtocolLib/)  
-[netty](https://github.com/netty/netty)  

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/PacketEvents.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -18,10 +18,13 @@
 
 package com.github.retrooper.packetevents;
 
+import org.jetbrains.annotations.ApiStatus;
+
 public final class PacketEvents {
     private static PacketEventsAPI<?> API;
 
     //Put these variable names anywhere else, they are really only for the injectors
+    @ApiStatus.Internal
     public static String IDENTIFIER, ENCODER_NAME, DECODER_NAME, CONNECTION_HANDLER_NAME, SERVER_CHANNEL_HANDLER_NAME,
     TIMEOUT_HANDLER_NAME;
 

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -37,7 +37,8 @@ public abstract class PacketEventsAPI<T> {
     private static final UpdateChecker UPDATE_CHECKER = new UpdateChecker();
     private final Logger LOGGER = Logger.getLogger(PacketEventsAPI.class.getName());
     private static final LogManager LOG_MANAGER = new LogManager();
-    private static final PEVersion VERSION = new PEVersion(2, 0, 0);
+    //TODO UPDATE
+    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/CallableEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -19,15 +19,16 @@
 package com.github.retrooper.packetevents.event;
 
 import com.github.retrooper.packetevents.PacketEvents;
+import com.github.retrooper.packetevents.exception.InvalidHandshakeException;
 import org.jetbrains.annotations.Nullable;
 
-import java.util.HashSet;
-import java.util.Map;
+import java.util.*;
 import java.util.concurrent.ConcurrentHashMap;
 import java.util.logging.Level;
 
 public class EventManager {
-    private final Map<Byte, HashSet<PacketListenerCommon>> listenersMap = new ConcurrentHashMap<>();
+    private final Map<PacketListenerPriority, Set<PacketListenerCommon>> listenersMap =
+            Collections.synchronizedMap(new EnumMap<>(PacketListenerPriority.class));
 
     /**
      * Call the PacketEvent.
@@ -43,14 +44,17 @@ public class EventManager {
     }
 
     public void callEvent(PacketEvent event, @Nullable Runnable postCallListenerAction) {
-        for (byte priority = PacketListenerPriority.LOWEST.getId(); priority <= PacketListenerPriority.MONITOR.getId(); priority++) {
-            HashSet<PacketListenerCommon> listeners = listenersMap.get(priority);
+        for (PacketListenerPriority priority : PacketListenerPriority.values()) {
+            Set<PacketListenerCommon> listeners = listenersMap.get(priority);
             if (listeners != null) {
                 for (PacketListenerCommon listener : listeners) {
                     try {
                         event.call(listener);
-                    } catch (Throwable t) {
-                        PacketEvents.getAPI().getLogger().log(Level.WARNING, "PacketEvents caught an unhandled exception while calling your listener.", t);
+                    } catch (Exception t) {
+                        // ignore handshake exceptions
+                        if (t.getClass() != InvalidHandshakeException.class) {
+                            PacketEvents.getAPI().getLogger().log(Level.WARNING, "PacketEvents caught an unhandled exception while calling your listener.", t);
+                        }
                     }
                     if (postCallListenerAction != null) {
                         postCallListenerAction.run();
@@ -58,7 +62,8 @@ public class EventManager {
                 }
             }
         }
-        if (event instanceof ProtocolPacketEvent && PacketEvents.getAPI().getSettings().shouldListenersReadOnly()) {
+        // For performance reasons, we don't want to re-encode the packet if it's not needed.
+        if (event instanceof ProtocolPacketEvent && !((ProtocolPacketEvent<?>) event).needsReEncode()) {
             ((ProtocolPacketEvent<?>) event).setLastUsedWrapper(null);
         }
 
@@ -75,13 +80,12 @@ public class EventManager {
      * @param listener {@link PacketListenerCommon}
      */
     public PacketListenerCommon registerListener(PacketListenerCommon listener) {
-        byte priority = listener.getPriority().getId();
-        HashSet<PacketListenerCommon> listenerSet = listenersMap.get(priority);
+        Set<PacketListenerCommon> listenerSet = listenersMap.get(listener.getPriority());
         if (listenerSet == null) {
-            listenerSet = new HashSet<>();
+            listenerSet = ConcurrentHashMap.newKeySet();
         }
         listenerSet.add(listener);
-        listenersMap.put(priority, listenerSet);
+        listenersMap.put(listener.getPriority(), listenerSet);
         return listener;
     }
 
@@ -98,7 +102,7 @@ public class EventManager {
     }
 
     public void unregisterListener(PacketListenerCommon listener) {
-        HashSet<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/event/PacketEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -47,20 +47,13 @@ public class PacketReceiveEvent extends ProtocolPacketEvent<Object> {
 
     @Override
     public PacketReceiveEvent clone() {
-        if (this instanceof PacketHandshakeReceiveEvent) {
-            return ((PacketHandshakeReceiveEvent)this).clone();
-        }
-        else if (this instanceof PacketStatusReceiveEvent) {
-            return ((PacketStatusReceiveEvent)this).clone();
-        }
-        else if (this instanceof PacketLoginReceiveEvent) {
-            return ((PacketLoginReceiveEvent)this).clone();
-        }
-        else if (this instanceof PacketPlayReceiveEvent) {
-            return ((PacketPlayReceiveEvent)this).clone();
-        }
-        else {
-            return null;
+        try {
+            Object clonedBuffer = ByteBufHelper.retainedDuplicate(getByteBuf());
+            return new PacketReceiveEvent(getPacketId(), getPacketType(), getServerVersion(),
+                    getChannel(), getUser(), getPlayer(), clonedBuffer);
+        } catch (PacketProcessException e) {
+            e.printStackTrace();
         }
+        return null;
     }
 }

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -18,9 +18,7 @@
 
 package com.github.retrooper.packetevents.event;
 
-import com.github.retrooper.packetevents.event.simple.PacketLoginSendEvent;
-import com.github.retrooper.packetevents.event.simple.PacketPlaySendEvent;
-import com.github.retrooper.packetevents.event.simple.PacketStatusSendEvent;
+import com.github.retrooper.packetevents.event.simple.PacketHandshakeSendEvent;
 import com.github.retrooper.packetevents.exception.PacketProcessException;
 import com.github.retrooper.packetevents.manager.server.ServerVersion;
 import com.github.retrooper.packetevents.netty.buffer.ByteBufHelper;
@@ -28,7 +26,12 @@ import com.github.retrooper.packetevents.protocol.PacketSide;
 import com.github.retrooper.packetevents.protocol.packettype.PacketTypeCommon;
 import com.github.retrooper.packetevents.protocol.player.User;
 
+import java.util.ArrayList;
+import java.util.List;
+
 public class PacketSendEvent extends ProtocolPacketEvent<Object> {
+    private List<Runnable> tasksAfterSend = null;
+
     protected PacketSendEvent(Object channel, User user, Object player, Object rawByteBuf,
                               boolean autoProtocolTranslation) throws PacketProcessException {
         super(PacketSide.SERVER, channel, user, player, rawByteBuf, autoProtocolTranslation);
@@ -48,19 +51,27 @@ public class PacketSendEvent extends ProtocolPacketEvent<Object> {
         listener.onPacketSend(this);
     }
 
+
+    public List<Runnable> getTasksAfterSend() {
+        if (tasksAfterSend == null) {
+            tasksAfterSend = new ArrayList<>();
+        }
+        return tasksAfterSend;
+    }
+
+    public boolean hasTasksAfterSend() {
+        return tasksAfterSend != null && !tasksAfterSend.isEmpty();
+    }
+
     @Override
     public PacketSendEvent clone() {
-        if (this instanceof PacketStatusSendEvent) {
-            return ((PacketStatusSendEvent)this).clone();
-        }
-        else if (this instanceof PacketLoginSendEvent) {
-            return ((PacketLoginSendEvent)this).clone();
-        }
-        else if (this instanceof PacketPlaySendEvent) {
-            return ((PacketPlaySendEvent)this).clone();
-        }
-        else {
-            return null;
+        try {
+            Object clonedBuffer = ByteBufHelper.retainedDuplicate(getByteBuf());
+            return new PacketSendEvent(getPacketId(), getPacketType(), getServerVersion(),
+                    getChannel(), getUser(), getPlayer(), clonedBuffer);
+        } catch (PacketProcessException e) {
+            e.printStackTrace();
         }
+        return null;
     }
 }

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -19,9 +19,11 @@
 package com.github.retrooper.packetevents.event;
 
 import com.github.retrooper.packetevents.PacketEvents;
+import com.github.retrooper.packetevents.exception.InvalidDisconnectPacketSend;
 import com.github.retrooper.packetevents.exception.PacketProcessException;
 import com.github.retrooper.packetevents.manager.server.ServerVersion;
 import com.github.retrooper.packetevents.netty.buffer.ByteBufHelper;
+import com.github.retrooper.packetevents.netty.buffer.UnpooledByteBufAllocationHelper;
 import com.github.retrooper.packetevents.netty.channel.ChannelHelper;
 import com.github.retrooper.packetevents.protocol.ConnectionState;
 import com.github.retrooper.packetevents.protocol.PacketSide;
@@ -50,6 +52,7 @@ public abstract class ProtocolPacketEvent<T> extends PacketEvent implements Play
     private PacketWrapper<?> lastUsedWrapper;
     private List<Runnable> postTasks = null;
     private boolean cloned;
+    private boolean needsReEncode = PacketEvents.getAPI().getSettings().reEncodeByDefault();
 
     public ProtocolPacketEvent(PacketSide packetSide, Object channel,
                                User user, T player, Object byteBuf,
@@ -59,8 +62,7 @@ public abstract class ProtocolPacketEvent<T> extends PacketEvent implements Play
         this.player = player;
         if (autoProtocolTranslation || user.getClientVersion() == null) {
             this.serverVersion = PacketEvents.getAPI().getServerManager().getVersion();
-        }
-        else {
+        } else {
             //TODO Optimize
             this.serverVersion = user.getClientVersion().toServerVersion();
         }
@@ -76,12 +78,17 @@ public abstract class ProtocolPacketEvent<T> extends PacketEvent implements Play
             throw new PacketProcessException("Failed to read the Packet ID of a packet. (Size: " + size + ")");
         }
         ClientVersion version = serverVersion.toClientVersion();
-        this.packetType = PacketType.getById(packetSide, user.getConnectionState(),
+        ConnectionState state = packetSide == PacketSide.CLIENT ? user.getDecoderState() : user.getEncoderState();
+        this.packetType = PacketType.getById(packetSide, state,
                 version, packetID);
         if (this.packetType == null) {
-            throw new PacketProcessException("Failed to map the Packet ID " + packetID + " to a PacketType constant. Bound: " + packetSide.getOpposite() +  ", Connection state: " + user.getConnectionState() +  ", Server version: " + serverVersion.getReleaseName());
+            // mojang messed up and keeps sending disconnect packets in the wrong protocol state
+            if (PacketType.getById(packetSide, ConnectionState.PLAY, version, packetID) == PacketType.Play.Server.DISCONNECT) {
+                throw new InvalidDisconnectPacketSend();
+            }
+            throw new PacketProcessException("Failed to map the Packet ID " + packetID + " to a PacketType constant. Bound: " + packetSide.getOpposite() + ", Connection state: " + user.getDecoderState() + ", Server version: " + serverVersion.getReleaseName());
         }
-        this.connectionState = user.getConnectionState();
+        this.connectionState = state;
     }
 
     public ProtocolPacketEvent(int packetID, PacketTypeCommon packetType, ServerVersion serverVersion, Object channel,
@@ -93,10 +100,21 @@ public abstract class ProtocolPacketEvent<T> extends PacketEvent implements Play
         this.byteBuf = byteBuf;
         this.packetID = packetID;
         this.packetType = packetType;
-        this.connectionState = user.getConnectionState();
+
+        this.connectionState = (packetType != null && packetType.getSide() == PacketSide.SERVER)
+                ? user.getEncoderState() : user.getDecoderState();
         cloned = true;
     }
 
+    public void markForReEncode(boolean needsReEncode) {
+        this.needsReEncode = needsReEncode;
+    }
+
+    public boolean needsReEncode() {
+        return needsReEncode;
+    }
+
+
     public boolean isClone() {
         return cloned;
     }
@@ -151,7 +169,6 @@ public abstract class ProtocolPacketEvent<T> extends PacketEvent implements Play
         this.byteBuf = byteBuf;
     }
 
-    @Deprecated
     public int getPacketId() {
         return packetID;
     }
@@ -206,4 +223,12 @@ public abstract class ProtocolPacketEvent<T> extends PacketEvent implements Play
             ByteBufHelper.release(byteBuf);
         }
     }
+
+    public Object getFullBufferClone() {
+        byte[] data = ByteBufHelper.copyBytes(getByteBuf());
+        Object buffer = UnpooledByteBufAllocationHelper.buffer();
+        ByteBufHelper.writeVarInt(buffer, getPacketId());
+        ByteBufHelper.writeBytes(buffer, data);
+        return buffer;
+    }
 }

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -41,7 +41,11 @@ public abstract class SimplePacketListenerAbstract extends PacketListenerCommon
             onPacketStatusReceive((PacketStatusReceiveEvent) event);
         } else if (event instanceof PacketLoginReceiveEvent) {
             onPacketLoginReceive((PacketLoginReceiveEvent) event);
-        } else if (event instanceof PacketPlayReceiveEvent) {
+        }
+        else if (event instanceof PacketConfigReceiveEvent) {
+            onPacketConfigReceive((PacketConfigReceiveEvent) event);
+        }
+        else if (event instanceof PacketPlayReceiveEvent) {
             onPacketPlayReceive((PacketPlayReceiveEvent) event);
         }
     }
@@ -52,7 +56,11 @@ public abstract class SimplePacketListenerAbstract extends PacketListenerCommon
             onPacketStatusSend((PacketStatusSendEvent) event);
         } else if (event instanceof PacketLoginSendEvent) {
             onPacketLoginSend((PacketLoginSendEvent) event);
-        } else if (event instanceof PacketPlaySendEvent) {
+        }
+        else if (event instanceof PacketConfigSendEvent) {
+            onPacketConfigSend((PacketConfigSendEvent) event);
+        }
+        else if (event instanceof PacketPlaySendEvent) {
             onPacketPlaySend((PacketPlaySendEvent) event);
         }
     }
@@ -72,6 +80,12 @@ public abstract class SimplePacketListenerAbstract extends PacketListenerCommon
     public void onPacketLoginSend(PacketLoginSendEvent event) {
     }
 
+    public void onPacketConfigReceive(PacketConfigReceiveEvent event) {
+    }
+
+    public void onPacketConfigSend(PacketConfigSendEvent event) {
+    }
+
     public void onPacketPlayReceive(PacketPlayReceiveEvent event) {
     }
 

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketConfigReceiveEvent.java

@@ -0,0 +1,59 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.event.simple;
+
+import com.github.retrooper.packetevents.event.PacketReceiveEvent;
+import com.github.retrooper.packetevents.exception.PacketProcessException;
+import com.github.retrooper.packetevents.manager.server.ServerVersion;
+import com.github.retrooper.packetevents.netty.buffer.ByteBufHelper;
+import com.github.retrooper.packetevents.protocol.packettype.PacketType;
+import com.github.retrooper.packetevents.protocol.packettype.PacketTypeCommon;
+import com.github.retrooper.packetevents.protocol.player.User;
+
+public class PacketConfigReceiveEvent extends PacketReceiveEvent {
+
+    public PacketConfigReceiveEvent(Object channel, User user,
+                                    Object player, Object rawByteBuf,
+                                    boolean autoProtocolTranslation) throws PacketProcessException {
+        super(channel, user, player, rawByteBuf, autoProtocolTranslation);
+    }
+
+    protected PacketConfigReceiveEvent(int packetId, PacketTypeCommon packetType,
+                                       ServerVersion serverVersion,
+                                       Object channel,
+                                       User user, Object player, Object byteBuf) throws PacketProcessException {
+        super(packetId, packetType, serverVersion, channel, user, player, byteBuf);
+    }
+
+    @Override
+    public PacketConfigReceiveEvent clone() {
+        try {
+            Object clonedBuffer = ByteBufHelper.retainedDuplicate(getByteBuf());
+            return new PacketConfigReceiveEvent(getPacketId(), getPacketType(), getServerVersion(),
+                    getChannel(), getUser(), getPlayer(), clonedBuffer);
+        } catch (PacketProcessException e) {
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    public PacketType.Configuration.Client getPacketType() {
+        return (PacketType.Configuration.Client) super.getPacketType();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketConfigSendEvent.java

@@ -0,0 +1,59 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.event.simple;
+
+import com.github.retrooper.packetevents.event.PacketSendEvent;
+import com.github.retrooper.packetevents.exception.PacketProcessException;
+import com.github.retrooper.packetevents.manager.server.ServerVersion;
+import com.github.retrooper.packetevents.netty.buffer.ByteBufHelper;
+import com.github.retrooper.packetevents.protocol.packettype.PacketType;
+import com.github.retrooper.packetevents.protocol.packettype.PacketTypeCommon;
+import com.github.retrooper.packetevents.protocol.player.User;
+
+public class PacketConfigSendEvent extends PacketSendEvent {
+
+    public PacketConfigSendEvent(Object channel, User user,
+                                 Object player, Object rawByteBuf,
+                                 boolean autoProtocolTranslation) throws PacketProcessException {
+        super(channel, user, player, rawByteBuf, autoProtocolTranslation);
+    }
+
+    protected PacketConfigSendEvent(int packetId, PacketTypeCommon packetType,
+                                    ServerVersion serverVersion,
+                                    Object channel,
+                                    User user, Object player, Object byteBuf) throws PacketProcessException {
+        super(packetId, packetType, serverVersion, channel, user, player, byteBuf);
+    }
+
+    @Override
+    public PacketConfigSendEvent clone() {
+        try {
+            Object clonedBuffer = ByteBufHelper.retainedDuplicate(getByteBuf());
+            return new PacketConfigSendEvent(getPacketId(), getPacketType(), getServerVersion(),
+                    getChannel(), getUser(), getPlayer(), clonedBuffer);
+        } catch (PacketProcessException e) {
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    public PacketType.Configuration.Server getPacketType() {
+        return (PacketType.Configuration.Server) super.getPacketType();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketHandshakeReceiveEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketHandshakeSendEvent.java

@@ -0,0 +1,40 @@
+package com.github.retrooper.packetevents.event.simple;
+
+import com.github.retrooper.packetevents.event.PacketSendEvent;
+import com.github.retrooper.packetevents.exception.PacketProcessException;
+import com.github.retrooper.packetevents.manager.server.ServerVersion;
+import com.github.retrooper.packetevents.netty.buffer.ByteBufHelper;
+import com.github.retrooper.packetevents.protocol.packettype.PacketType;
+import com.github.retrooper.packetevents.protocol.packettype.PacketTypeCommon;
+import com.github.retrooper.packetevents.protocol.player.User;
+
+public class PacketHandshakeSendEvent extends PacketSendEvent {
+    public PacketHandshakeSendEvent(Object channel, User user,
+                                       Object player, Object rawByteBuf,
+                                       boolean autoProtocolTranslation) throws PacketProcessException {
+        super(channel, user, player, rawByteBuf, autoProtocolTranslation);
+    }
+
+    protected PacketHandshakeSendEvent(int packetId, PacketTypeCommon packetType,
+                                          ServerVersion serverVersion,
+                                          Object channel,
+                                          User user, Object player, Object byteBuf) throws PacketProcessException {
+        super(packetId, packetType, serverVersion, channel, user, player, byteBuf);
+    }
+
+    @Override
+    public PacketHandshakeSendEvent clone() {
+        try {
+            Object clonedBuffer = ByteBufHelper.retainedDuplicate(getByteBuf());
+            return new PacketHandshakeSendEvent(getPacketId(), getPacketType(), getServerVersion(),
+                    getChannel(), getUser(), getPlayer(), clonedBuffer);
+        } catch (PacketProcessException e) {
+            e.printStackTrace();
+        }
+        return null;
+    }
+
+    public PacketType.Handshaking.Client getPacketType() {
+        return (PacketType.Handshaking.Client) super.getPacketType();
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketLoginReceiveEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketLoginSendEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketPlayReceiveEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketPlaySendEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketStatusReceiveEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/event/simple/PacketStatusSendEvent.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/exception/CancelPacketException.java

@@ -0,0 +1,5 @@
+package com.github.retrooper.packetevents.exception;
+
+public class CancelPacketException extends RuntimeException {
+    public static final CancelPacketException INSTANCE = new CancelPacketException();
+}

api/src/main/java/com/github/retrooper/packetevents/exception/InvalidDisconnectPacketSend.java

@@ -0,0 +1,4 @@
+package com.github.retrooper.packetevents.exception;
+
+public class InvalidDisconnectPacketSend extends RuntimeException {
+}

api/src/main/java/com/github/retrooper/packetevents/exception/InvalidHandshakeException.java

@@ -0,0 +1,4 @@
+package com.github.retrooper.packetevents.exception;
+
+public class InvalidHandshakeException extends RuntimeException {
+}

api/src/main/java/com/github/retrooper/packetevents/exception/PacketProcessException.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -18,7 +18,7 @@
 
 package com.github.retrooper.packetevents.exception;
 
-public class PacketProcessException extends Exception {
+public class PacketProcessException extends RuntimeException {
     public PacketProcessException(String msg, Throwable cause) {
         super(msg, cause);
     }

api/src/main/java/com/github/retrooper/packetevents/injector/ChannelInjector.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -18,9 +18,7 @@
 
 package com.github.retrooper.packetevents.injector;
 
-import com.github.retrooper.packetevents.protocol.ConnectionState;
 import com.github.retrooper.packetevents.protocol.player.User;
-import org.jetbrains.annotations.Nullable;
 
 public interface ChannelInjector {
     default boolean isServerBound() {
@@ -31,13 +29,9 @@ public interface ChannelInjector {
 
     void uninject();
 
-    User getUser(Object channel);
-
-    void changeConnectionState(Object channel, @Nullable ConnectionState connectionState);
-
     void updateUser(Object channel, User user);
 
     void setPlayer(Object channel, Object player);
 
-    boolean hasPlayer(Object player);
+    boolean isProxy();
 }

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -27,20 +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);
     }
@@ -61,49 +71,95 @@ public class InternalPacketListener extends PacketListenerAbstract {
             //Update user profile
             user.getProfile().setUUID(profile.getUUID());
             user.getProfile().setName(profile.getName());
+            //Texture properties are passed in login success on 1.19
+            user.getProfile().setTextureProperties(profile.getTextureProperties());
 
             //Map username with channel
-            ProtocolManager.CHANNELS.put(profile.getName(), channel);
-            PacketEvents.getAPI().getLogManager().debug("Mapped player username with their channel.");
+            synchronized (channel) {
+                ProtocolManager.CHANNELS.put(profile.getUUID(), channel);
+            }
 
-            //Update connection state(injectors might do some adjustments when we transition into PLAY state)
-            //This also updates it for the user instance
-            event.getPostTasks().add(() -> {
-                PacketEvents.getAPI().getInjector().changeConnectionState(channel, ConnectionState.PLAY);
-                PacketEvents.getAPI().getLogManager().debug("Transitioned " + profile.getName() + " into the PLAY state!");
-            });
+            PacketEvents.getAPI().getLogManager().debug("Mapped player UUID with their channel.");
+
+            // Switch the user's connection state to new state, but the variable event.getConnectionState() remains LOGIN
+            // We switch user state immediately to remain in sync with vanilla, allowing you to encode packets immediately
+            boolean proxy = PacketEvents.getAPI().getInjector().isProxy();
+            if (proxy ? event.getUser().getClientVersion().isNewerThanOrEquals(ClientVersion.V_1_20_2)
+                    : event.getServerVersion().isNewerThanOrEquals(ServerVersion.V_1_20_2)) {
+                user.setEncoderState(ConnectionState.CONFIGURATION);
+            } else {
+                user.setConnectionState(ConnectionState.PLAY);
+            }
         }
 
-        // Join game can be used to update world height, and sets dimension data
+        // The server sends dimension information in configuration phase >= 1.20.2
+        else if (event.getPacketType() == PacketType.Configuration.Server.REGISTRY_DATA) {
+            WrapperConfigServerRegistryData registryData = new WrapperConfigServerRegistryData(event);
 
-        if (event.getPacketType() == PacketType.Play.Server.JOIN_GAME) {
+            // Store world data
+            NBTCompound registryDataTag = registryData.getRegistryData();
+            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);
+            }
+        }
+
+        // The server sends dimension information in login packet for >= 1.17 and < 1.20.2
+        else if (event.getPacketType() == PacketType.Play.Server.JOIN_GAME) {
             WrapperPlayServerJoinGame joinGame = new WrapperPlayServerJoinGame(event);
             user.setEntityId(joinGame.getEntityId());
+            user.setDimension(joinGame.getDimension());
             if (event.getServerVersion().isOlderThanOrEquals(ServerVersion.V_1_16_5)) {
                 return; // Fixed world height, no tags are sent to the client
             }
-            // Store world height
-            NBTList<NBTCompound> list = joinGame.getDimensionCodec()
-                    .getCompoundTagOrNull("minecraft:dimension_type").getCompoundListTagOrNull("value");
-            user.setWorldNBT(list);
+
+            // Store world data
+            NBTCompound dimensionCodec = joinGame.getDimensionCodec();
+            if (dimensionCodec != null) {
+                NBTList<NBTCompound> list = dimensionCodec
+                        .getCompoundTagOrNull(DIMENSION_TYPE_REGISTRY_KEY.toString())
+                        .getCompoundListTagOrNull("value");
+                user.setWorldNBT(list);
+            }
 
             // Update world height
-            NBTCompound worldNBT = user.getWorldNBT(joinGame.getDimension().getType().getName()).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
-        if (event.getPacketType() == PacketType.Play.Server.RESPAWN) {
-            if (event.getServerVersion()
-                    .isOlderThanOrEquals(ServerVersion.V_1_16_5)) {
+        else if (event.getPacketType() == PacketType.Play.Server.RESPAWN) {
+            WrapperPlayServerRespawn respawn = new WrapperPlayServerRespawn(event);
+            user.setDimension(respawn.getDimension());
+            if (event.getServerVersion().isOlderThanOrEquals(ServerVersion.V_1_16_5)) {
                 return; // Fixed world height, no tags are sent to the client
             }
-            WrapperPlayServerRespawn respawn = new WrapperPlayServerRespawn(event);
 
-            NBTCompound worldNBT = user.getWorldNBT(respawn.getDimension().getType().getName()).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) {
+            user.setEncoderState(ConnectionState.PLAY);
         }
     }
 
@@ -113,25 +169,20 @@ public class InternalPacketListener extends PacketListenerAbstract {
         if (event.getPacketType() == PacketType.Handshaking.Client.HANDSHAKE) {
             Object channel = event.getChannel();
             InetSocketAddress address = event.getSocketAddress();
-            WrapperHandshakingClientHandshake handshake;
-            try {
-                handshake = new WrapperHandshakingClientHandshake(event);
-            } catch (ArrayIndexOutOfBoundsException exception) {
-                user.closeConnection();
-                PacketEvents.getAPI().getLogManager().debug("Disconnected " + address.getHostString() + ":" + address.getPort() + " for sending an invalid handshaking packet. They might be on an outdated client.");
-                return;
-            }
+            WrapperHandshakingClientHandshake handshake = new WrapperHandshakingClientHandshake(event);
             ConnectionState nextState = handshake.getNextConnectionState();
             ClientVersion clientVersion = handshake.getClientVersion();
-
             //Update client version for this event call(and user)
             user.setClientVersion(clientVersion);
             PacketEvents.getAPI().getLogManager().debug("Processed " + address.getHostString() + ":" + address.getPort() + "'s client version. Client Version: " + clientVersion.getReleaseName());
-            event.getPostTasks().add(() -> {
-                //Transition into the LOGIN OR STATUS connection state
-                PacketEvents.getAPI().getInjector().changeConnectionState(channel, nextState);
-                PacketEvents.getAPI().getLogManager().debug("Transitioned " + address.getHostString() + ":" + address.getPort() + " into the " + nextState + " state!");
-            });
+            //Transition into LOGIN or STATUS connection state immediately, to remain in sync with vanilla
+            user.setConnectionState(nextState);
+        } else if (event.getPacketType() == PacketType.Login.Client.LOGIN_SUCCESS_ACK) {
+            user.setDecoderState(ConnectionState.CONFIGURATION);
+        } else if (event.getPacketType() == PacketType.Play.Client.CONFIGURATION_ACK) {
+            user.setDecoderState(ConnectionState.CONFIGURATION);
+        } else if (event.getPacketType() == PacketType.Configuration.Client.CONFIGURATION_END_ACK) {
+            user.setDecoderState(ConnectionState.PLAY);
         }
     }
-}
+}

api/src/main/java/com/github/retrooper/packetevents/manager/player/PlayerManager.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -32,7 +32,7 @@ public interface PlayerManager {
 
     Object getChannel(@NotNull Object player);
 
-    @NotNull User getUser(@NotNull Object player);
+    User getUser(@NotNull Object player);
 
     default ConnectionState getConnectionState(@NotNull Object player) {
         return getUser(player).getConnectionState();
@@ -41,96 +41,47 @@ public interface PlayerManager {
     default void sendPacket(@NotNull Object player, @NotNull Object byteBuf) {
         PacketEvents.getAPI().getProtocolManager().sendPacket(getChannel(player), byteBuf);
     }
-
-    default void sendPacketAsync(@NotNull Object player, @NotNull Object byteBuf) {
-        PacketEvents.getAPI().getProtocolManager().sendPacketAsync(getChannel(player), byteBuf);
-    }
-
     default void sendPacket(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
         PacketEvents.getAPI().getProtocolManager().sendPacket(getChannel(player), wrapper);
     }
 
-    default void sendPacketAsync(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
-        PacketEvents.getAPI().getProtocolManager().sendPacketAsync(getChannel(player), wrapper);
-    }
-
     default void sendPacketSilently(@NotNull Object player, @NotNull Object byteBuf) {
         PacketEvents.getAPI().getProtocolManager().sendPacketSilently(getChannel(player), byteBuf);
     }
 
-    default void sendPacketSilentlyAsync(@NotNull Object player, @NotNull Object byteBuf) {
-        PacketEvents.getAPI().getProtocolManager().sendPacketSilentlyAsync(getChannel(player), byteBuf);
-    }
-
     default void sendPacketSilently(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
         PacketEvents.getAPI().getProtocolManager().sendPacketSilently(getChannel(player), wrapper);
     }
 
-    default void sendPacketSilentlyAsync(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
-        PacketEvents.getAPI().getProtocolManager().sendPacketSilentlyAsync(getChannel(player), wrapper);
-    }
-
     default void writePacket(@NotNull Object player, @NotNull Object byteBuf) {
         PacketEvents.getAPI().getProtocolManager().writePacket(getChannel(player), byteBuf);
     }
 
-    default void writePacketAsync(@NotNull Object player, @NotNull Object byteBuf) {
-        PacketEvents.getAPI().getProtocolManager().writePacketAsync(getChannel(player), byteBuf);
-    }
-
     default void writePacket(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
         PacketEvents.getAPI().getProtocolManager().writePacket(getChannel(player), wrapper);
     }
 
-    default void writePacketAsync(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
-        PacketEvents.getAPI().getProtocolManager().writePacketAsync(getChannel(player), wrapper);
-    }
-
     default void writePacketSilently(@NotNull Object player, @NotNull Object byteBuf) {
         PacketEvents.getAPI().getProtocolManager().writePacketSilently(getChannel(player), byteBuf);
     }
 
-    default void writePacketSilentlyAsync(@NotNull Object player, @NotNull Object byteBuf) {
-        PacketEvents.getAPI().getProtocolManager().writePacketSilentlyAsync(getChannel(player), byteBuf);
-    }
-
     default void writePacketSilently(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
         PacketEvents.getAPI().getProtocolManager().writePacketSilently(getChannel(player), wrapper);
     }
 
-    default void writePacketSilentlyAsync(@NotNull Object player, @NotNull PacketWrapper<?> wrapper) {
-        PacketEvents.getAPI().getProtocolManager().writePacketSilentlyAsync(getChannel(player), wrapper);
-    }
-
     default void receivePacket(Object player, Object byteBuf) {
         PacketEvents.getAPI().getProtocolManager().receivePacket(getChannel(player), byteBuf);
     }
 
-    default void receivePacketAsync(Object player, Object byteBuf) {
-        PacketEvents.getAPI().getProtocolManager().receivePacketAsync(getChannel(player), byteBuf);
-    }
-
     default void receivePacket(Object player, PacketWrapper<?> wrapper) {
         PacketEvents.getAPI().getProtocolManager().receivePacket(getChannel(player), wrapper);
     }
 
-    default void receivePacketAsync(Object player, PacketWrapper<?> wrapper) {
-        PacketEvents.getAPI().getProtocolManager().receivePacketAsync(getChannel(player), wrapper);
-    }
-
     default void receivePacketSilently(Object player, Object byteBuf) {
         PacketEvents.getAPI().getProtocolManager().receivePacketSilently(getChannel(player), byteBuf);
     }
 
-    default void receivePacketSilentlyAsync(Object player, Object byteBuf) {
-        PacketEvents.getAPI().getProtocolManager().receivePacketSilentlyAsync(getChannel(player), byteBuf);
-    }
-
     default void receivePacketSilently(Object player, PacketWrapper<?> wrapper) {
         PacketEvents.getAPI().getProtocolManager().receivePacketSilently(getChannel(player), wrapper);
     }
-
-    default void receivePacketSilentlyAsync(Object player, PacketWrapper<?> wrapper) {
-        PacketEvents.getAPI().getProtocolManager().receivePacketSilentlyAsync(getChannel(player), wrapper);
-    }
 }

api/src/main/java/com/github/retrooper/packetevents/manager/protocol/ProtocolManager.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -20,21 +20,21 @@ package com.github.retrooper.packetevents.manager.protocol;
 
 import com.github.retrooper.packetevents.PacketEvents;
 import com.github.retrooper.packetevents.netty.channel.ChannelHelper;
-import com.github.retrooper.packetevents.protocol.ConnectionState;
 import com.github.retrooper.packetevents.protocol.ProtocolVersion;
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
 import com.github.retrooper.packetevents.protocol.player.User;
 import com.github.retrooper.packetevents.util.PacketTransformationUtil;
 import com.github.retrooper.packetevents.wrapper.PacketWrapper;
-import org.jetbrains.annotations.Nullable;
+import org.jetbrains.annotations.ApiStatus;
 
 import java.util.Collection;
-import java.util.List;
 import java.util.Map;
+import java.util.UUID;
 import java.util.concurrent.ConcurrentHashMap;
 
 public interface ProtocolManager {
-    Map<String, Object> CHANNELS = new ConcurrentHashMap<>();
+    Map<UUID, Object> CHANNELS = new ConcurrentHashMap<>();
+    // Use SocketAddress because ProtocolLib wraps Channels with NettyChannelProxy class
     Map<Object, User> USERS = new ConcurrentHashMap<>();
 
     default Collection<User> getUsers() {
@@ -47,163 +47,120 @@ public interface ProtocolManager {
 
     //Methods to implement
     ProtocolVersion getPlatformVersion();
-
-    void sendPacket(Object channel, Object packet);
-
-    void sendPacketSilently(Object channel, Object packet);
-
-    void writePacket(Object channel, Object packet);
-
-    void writePacketSilently(Object channel, Object packet);
-
-    void receivePacket(Object channel, Object packet);
-
-    void receivePacketSilently(Object channel, Object packet);
-
+    void sendPacket(Object channel, Object byteBuf);
+    void sendPacketSilently(Object channel, Object byteBuf);
+    void writePacket(Object channel, Object byteBuf);
+    void writePacketSilently(Object channel, Object byteBuf);
+    void receivePacket(Object channel, Object byteBuf);
+    void receivePacketSilently(Object channel, Object byteBuf);
     ClientVersion getClientVersion(Object channel);
+    //TODO Define method that accepts an array of channels/set/list of channels.
 
-    default void sendPacketAsync(Object channel, Object byteBuf) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            sendPacket(channel, byteBuf);
-        });
+    default void sendPackets(Object channel, Object... byteBuf) {
+        for (Object buf : byteBuf) {
+            sendPacket(channel, buf);
+        }
     }
 
-    default void sendPacketSilentlyAsync(Object channel, Object byteBuf) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            sendPacketSilently(channel, byteBuf);
-        });
+    default void sendPacketsSilently(Object channel, Object... byteBuf) {
+        for (Object buf : byteBuf) {
+            sendPacketSilently(channel, buf);
+        }
     }
 
-    default void writePacketAsync(Object channel, Object byteBuf) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            writePacket(channel, byteBuf);
-        });
+    default void writePackets(Object channel, Object... byteBuf) {
+        for (Object buf : byteBuf) {
+            writePacket(channel, buf);
+        }
     }
 
-    default void writePacketSilentlyAsync(Object channel, Object byteBuf) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            writePacketSilently(channel, byteBuf);
-        });
+    default void writePacketsSilently(Object channel, Object... byteBuf) {
+        for (Object buf : byteBuf) {
+            writePacketSilently(channel, buf);
+        }
     }
 
-    default void receivePacketAsync(Object channel, Object byteBuf) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            receivePacket(channel, byteBuf);
-        });
+    default void receivePackets(Object channel, Object... byteBuf) {
+        for (Object buf : byteBuf) {
+            receivePacket(channel, buf);
+        }
     }
 
-    default void receivePacketSilentlyAsync(Object channel, Object byteBuf) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            receivePacketSilently(channel, byteBuf);
-        });
+    default void receivePacketsSilently(Object channel, Object... byteBuf) {
+        for (Object buf : byteBuf) {
+            receivePacketSilently(channel, buf);
+        }
     }
 
-    //TODO Make it clear that this only updates the connection state in our user.
-    //Sometimes you should use getInjector().changeConnectionState because that can allow the injector to make adjustments.
-    //This is very important, especially on Spigot.
-    //As soon as we switch to the play state on spigot, our injector makes some adjustments.
-    default void changeConnectionState(Object channel, ConnectionState connectionState) {
-        getUser(channel).setConnectionState(connectionState);
-    }
 
     default void setClientVersion(Object channel, ClientVersion version) {
         getUser(channel).setClientVersion(version);
     }
 
-    default void sendPacket(Object channel, PacketWrapper<?> wrapper) {
+    @ApiStatus.Internal
+    default Object[] transformWrappers(PacketWrapper<?> wrapper, Object channel, boolean outgoing) {
+        //It is possible that our packet transformer util decides to transform one wrapper into multiple packets.
+        //(Correcting some mistakes on your end)
         PacketWrapper<?>[] wrappers = PacketTransformationUtil.transform(wrapper);
-        for (PacketWrapper<?> packet : wrappers) {
-            packet.prepareForSend();
-            sendPacket(channel, packet.buffer);
+        Object[] buffers = new Object[wrappers.length];
+        for (int i = 0; i < wrappers.length; i++) {
+            wrappers[i].prepareForSend(channel, outgoing);
+            buffers[i] = wrappers[i].buffer;
+            // Fix race condition when sending packets to multiple people (due to when the buffer is freed)
+            wrappers[i].buffer = null;
         }
+        return buffers;
     }
 
-    default void sendPacketAsync(Object channel, PacketWrapper<?> wrapper) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            sendPacket(channel, wrapper);
-        });
+    default void sendPacket(Object channel, PacketWrapper<?> wrapper) {
+        Object[] transformed = transformWrappers(wrapper, channel, true);
+        sendPackets(channel, transformed);
     }
 
     default void sendPacketSilently(Object channel, PacketWrapper<?> wrapper) {
-        PacketWrapper<?>[] wrappers = PacketTransformationUtil.transform(wrapper);
-        for (PacketWrapper<?> packet : wrappers) {
-            packet.prepareForSend();
-            sendPacketSilently(channel, packet.buffer);
-        }
-    }
-
-    default void sendPacketSilentlyAsync(Object channel, PacketWrapper<?> wrapper) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            sendPacketSilently(channel, wrapper);
-        });
+        Object[] transformed = transformWrappers(wrapper, channel, true);
+        sendPacketsSilently(channel, transformed);
     }
 
     default void writePacket(Object channel, PacketWrapper<?> wrapper) {
-        PacketWrapper<?>[] wrappers = PacketTransformationUtil.transform(wrapper);
-        for (PacketWrapper<?> packet : wrappers) {
-            packet.prepareForSend();
-            writePacket(channel, packet.buffer);
-        }
-    }
-
-    default void writePacketAsync(Object channel, PacketWrapper<?> wrapper) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            writePacket(channel, wrapper);
-        });
+        Object[] transformed = transformWrappers(wrapper, channel, true);
+        writePackets(channel, transformed);
     }
 
     default void writePacketSilently(Object channel, PacketWrapper<?> wrapper) {
-        PacketWrapper<?>[] wrappers = PacketTransformationUtil.transform(wrapper);
-        for (PacketWrapper<?> packet : wrappers) {
-            packet.prepareForSend();
-            writePacketSilently(channel, packet.buffer);
-        }
-    }
-
-    default void writePacketSilentlyAsync(Object channel, PacketWrapper<?> wrapper) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            writePacketSilently(channel, wrapper);
-        });
+        Object[] transformed = transformWrappers(wrapper, channel, true);
+        writePacketsSilently(channel, transformed);
     }
 
     default void receivePacket(Object channel, PacketWrapper<?> wrapper) {
-        PacketWrapper<?>[] wrappers = PacketTransformationUtil.transform(wrapper);
-        for (PacketWrapper<?> packet : wrappers) {
-            packet.prepareForSend();
-            receivePacket(channel, packet.buffer);
-        }
-    }
-
-    default void receivePacketAsync(Object channel, PacketWrapper<?> wrapper) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            receivePacket(channel, wrapper);
-        });
+        Object[] transformed = transformWrappers(wrapper, channel, false);
+        receivePackets(channel, transformed);
     }
 
     default void receivePacketSilently(Object channel, PacketWrapper<?> wrapper) {
-        PacketWrapper<?>[] wrappers = PacketTransformationUtil.transform(wrapper);
-        for (PacketWrapper<?> packet : wrappers) {
-            packet.prepareForSend();
-            receivePacketSilently(channel, packet.buffer);
-        }
-    }
-
-    default void receivePacketSilentlyAsync(Object channel, PacketWrapper<?> wrapper) {
-        ChannelHelper.runInEventLoop(channel, () -> {
-            receivePacketSilently(channel, wrapper);
-        });
+        Object[] transformed = transformWrappers(wrapper, channel, false);
+        receivePacketsSilently(channel, transformed);
     }
 
     default User getUser(Object channel) {
-        return USERS.get(channel);
+        Object pipeline = ChannelHelper.getPipeline(channel);
+        return USERS.get(pipeline);
+    }
+
+    default User removeUser(Object channel) {
+        Object pipeline = ChannelHelper.getPipeline(channel);
+        return USERS.remove(pipeline);
     }
 
     default void setUser(Object channel, User user) {
-        USERS.put(channel, user);
+        synchronized (channel) {
+            Object pipeline = ChannelHelper.getPipeline(channel);
+            USERS.put(pipeline, user);
+        }
         PacketEvents.getAPI().getInjector().updateUser(channel, user);
     }
 
-    default Object getChannel(String username) {
-        return CHANNELS.get(username);
+    default Object getChannel(UUID uuid) {
+        return CHANNELS.get(uuid);
     }
 }

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -19,6 +19,7 @@
 package com.github.retrooper.packetevents.manager.server;
 
 import com.github.retrooper.packetevents.protocol.player.ClientVersion;
+import org.jetbrains.annotations.NotNull;
 
 /**
  * Server Version.
@@ -30,7 +31,7 @@ import com.github.retrooper.packetevents.protocol.player.ClientVersion;
  * @since 1.6.9
  */
 public enum ServerVersion {
-    //TODO Rename to PlatformVersion or LocalVersion or Version?
+    //TODO Rename to MinecraftVersion?
     V_1_7_10(5),
     V_1_8(47), V_1_8_3(47), V_1_8_8(47),
     V_1_9(107), V_1_9_2(109), V_1_9_4(110),
@@ -44,6 +45,10 @@ public enum ServerVersion {
     V_1_16(735), V_1_16_1(736), V_1_16_2(751), V_1_16_3(753), V_1_16_4(754), V_1_16_5(754),
     V_1_17(755), V_1_17_1(756),
     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. 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);
 
@@ -64,6 +69,7 @@ public enum ServerVersion {
 
     private final int protocolVersion;
     private final String name;
+    private ClientVersion toClientVersion;
 
     ServerVersion(int protocolVersion) {
         this.protocolVersion = protocolVersion;
@@ -84,17 +90,17 @@ public enum ServerVersion {
     }
 
     public static ServerVersion getLatest() {
-        return reversedValues()[1];
+        return REVERSED_VALUES[1];
     }
 
     public static ServerVersion getOldest() {
-        return values()[0];
+        return VALUES[0];
     }
 
     //TODO Optimize
     @Deprecated
     public static ServerVersion getById(int protocolVersion) {
-        for (ServerVersion version : values()) {
+        for (ServerVersion version : VALUES) {
             if (version.protocolVersion == protocolVersion) {
                 return version;
             }
@@ -103,12 +109,16 @@ public enum ServerVersion {
     }
 
     public ClientVersion toClientVersion() {
-        return ClientVersion.getById(this.protocolVersion);
+        if (toClientVersion == null) {
+            toClientVersion = ClientVersion.getById(protocolVersion);
+        }
+        return toClientVersion;
     }
 
     /**
      * Get the release name of this server version.
      * For example, for the V_1_18 enum constant, it would return "1.18".
+     *
      * @return Release name
      */
     public String getReleaseName() {
@@ -133,31 +143,7 @@ public enum ServerVersion {
      * @return Is this server version newer than the compared server version.
      */
     public boolean isNewerThan(ServerVersion target) {
-        /*
-         * Some server versions have the same protocol version in the minecraft protocol.
-         * We still need this method to work in such cases.
-         * We first check if this is the case, if the protocol versions aren't the same, we can just use the protocol versions
-         * to compare the server versions.
-         */
-        if (target.protocolVersion != protocolVersion || this == target) {
-            return protocolVersion > target.protocolVersion;
-        }
-
-        /*
-         * The server versions unfortunately have the same protocol version.
-         * We need to look at this "reversedValues" variable.
-         * The reversed values variable is an array containing all enum constants in this enum but in a reversed order.
-         * I already made this variable a while ago for a different usage, you can check that out.
-         * The first one we find in the array is the newer version.
-         */
-        for (ServerVersion version : reversedValues()) {
-            if (version == target) {
-                return false;
-            }
-            if (version == this) return true;
-        }
-
-        return false;
+        return this.ordinal() > target.ordinal();
     }
 
     /**
@@ -169,28 +155,7 @@ public enum ServerVersion {
      * @return Is this server version older than the compared server version.
      */
     public boolean isOlderThan(ServerVersion target) {
-        /*
-         * Some server versions have the same protocol version in the minecraft protocol.
-         * We still need this method to work in such cases.
-         * We first check if this is the case, if the protocol versions aren't the same, we can just use the protocol versions
-         * to compare the server versions.
-         */
-        if (target.protocolVersion != protocolVersion || this == target) {
-            return protocolVersion < target.protocolVersion;
-        }
-        /*
-         * The server versions unfortunately have the same protocol version.
-         * We look at all enum constants in the ServerVersion enum in the order they have been defined in.
-         * The first one we find in the array is the newer version.
-         */
-        for (ServerVersion version : VALUES) {
-            if (version == this) {
-                return true;
-            } else if (version == target) {
-                return false;
-            }
-        }
-        return false;
+        return this.ordinal() < target.ordinal();
     }
 
     /**
@@ -202,7 +167,7 @@ public enum ServerVersion {
      * @return Is this server version newer than or equal to the compared server version.
      */
     public boolean isNewerThanOrEquals(ServerVersion target) {
-        return this == target || isNewerThan(target);
+        return this.ordinal() >= target.ordinal();
     }
 
     /**
@@ -214,6 +179,36 @@ public enum ServerVersion {
      * @return Is this server version older than or equal to the compared server version.
      */
     public boolean isOlderThanOrEquals(ServerVersion target) {
-        return this == target || isOlderThan(target);
+        return this.ordinal() <= target.ordinal();
+    }
+
+    /**
+     * Is this server version newer than, older than or equal to the compared server version?
+     * This method simply checks if this server version's protocol version is greater than, less than or equal to
+     * the compared server version's protocol version.
+     *
+     * @param comparison    Comparison type.
+     * @param targetVersion Compared server version.
+     * @return true or false, based on the comparison type.
+     * @see #isNewerThan(ServerVersion)
+     * @see #isNewerThanOrEquals(ServerVersion)
+     * @see #isOlderThan(ServerVersion)
+     * @see #isOlderThanOrEquals(ServerVersion)
+     */
+    public boolean is(@NotNull VersionComparison comparison, @NotNull ServerVersion targetVersion) {
+        switch (comparison) {
+            case EQUALS:
+                return protocolVersion == targetVersion.protocolVersion;
+            case NEWER_THAN:
+                return isNewerThan(targetVersion);
+            case NEWER_THAN_OR_EQUALS:
+                return isNewerThanOrEquals(targetVersion);
+            case OLDER_THAN:
+                return isOlderThan(targetVersion);
+            case OLDER_THAN_OR_EQUALS:
+                return isOlderThanOrEquals(targetVersion);
+            default:
+                return false;
+        }
     }
 }

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -0,0 +1,45 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.manager.server;
+
+/**
+ * This enum contains all possible comparison types for server versions.
+ */
+public enum VersionComparison {
+    /*
+    The server version equals the compared server version.
+     */
+    EQUALS,
+    /*
+    The server version is newer than the compared server version.
+     */
+    NEWER_THAN,
+    /*
+    The server version is newer than or equal to the compared server version.
+     */
+    NEWER_THAN_OR_EQUALS,
+    /*
+    The server version is older than the compared server version.
+     */
+    OLDER_THAN,
+    /*
+    The server version is older than or equal to the compared server version.
+     */
+    OLDER_THAN_OR_EQUALS;
+}

api/src/main/java/com/github/retrooper/packetevents/netty/NettyManager.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -23,6 +23,14 @@ import com.github.retrooper.packetevents.PacketEvents;
 import java.nio.charset.Charset;
 
 public class ByteBufHelper {
+    public static int capacity(Object buffer) {
+        return PacketEvents.getAPI().getNettyManager().getByteBufOperator().capacity(buffer);
+    }
+
+    public static Object capacity(Object buffer, int capacity) {
+        return PacketEvents.getAPI().getNettyManager().getByteBufOperator().capacity(buffer, capacity);
+    }
+
     public static int readerIndex(Object buffer) {
         return PacketEvents.getAPI().getNettyManager().getByteBufOperator().readerIndex(buffer);
     }

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -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/netty/buffer/ByteBufOperator.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -21,6 +21,8 @@ package com.github.retrooper.packetevents.netty.buffer;
 import java.nio.charset.Charset;
 
 public interface ByteBufOperator {
+    int capacity(Object buffer);
+    Object capacity(Object buffer, int capacity);
     int readerIndex(Object buffer);
     Object readerIndex(Object buffer, int readerIndex);
 

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/netty/channel/ChannelHelper.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -81,6 +81,10 @@ public class ChannelHelper {
         return Arrays.toString(pipelineHandlerNames(channel).toArray(new String[0]));
     }
 
+    public static Object getPipeline(Object channel) {
+        return PacketEvents.getAPI().getNettyManager().getChannelOperator().getPipeline(channel);
+    }
+
     public static Object getPipelineHandler(Object channel, String name) {
         return PacketEvents.getAPI().getNettyManager().getChannelOperator().getPipelineHandler(channel, name);
     }
@@ -89,6 +93,10 @@ public class ChannelHelper {
         return PacketEvents.getAPI().getNettyManager().getChannelOperator().getPipelineContext(channel, handlerName);
     }
 
+    public static Object pooledByteBuf(Object channel) {
+        return PacketEvents.getAPI().getNettyManager().getChannelOperator().pooledByteBuf(channel);
+    }
+
     public static void runInEventLoop(Object channel, Runnable runnable) {
         PacketEvents.getAPI().getNettyManager().getChannelOperator().runInEventLoop(channel, runnable);
     }

api/src/main/java/com/github/retrooper/packetevents/netty/channel/ChannelOperator.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -20,26 +20,41 @@ package com.github.retrooper.packetevents.netty.channel;
 
 import java.net.SocketAddress;
 import java.util.List;
-import java.util.Set;
 
 public interface ChannelOperator {
-    Set<Class<? extends Throwable>> getIgnoredHandlerExceptions();
-
     SocketAddress remoteAddress(Object channel);
+
     SocketAddress localAddress(Object channel);
+
     boolean isOpen(Object channel);
+
     Object close(Object channel);
+
     Object write(Object channel, Object buffer);
+
     Object flush(Object channel);
+
     Object writeAndFlush(Object channel, Object buffer);
+
     Object fireChannelRead(Object channel, Object buffer);
 
     Object writeInContext(Object channel, String ctx, Object buffer);
+
     Object flushInContext(Object channel, String ctx);
+
     Object writeAndFlushInContext(Object channel, String ctx, Object buffer);
+
     Object fireChannelReadInContext(Object channel, String ctx, Object buffer);
+
     List<String> pipelineHandlerNames(Object channel);
+
     Object getPipelineHandler(Object channel, String name);
+
     Object getPipelineContext(Object channel, String name);
+
+    Object getPipeline(Object channel);
+
     void runInEventLoop(Object channel, Runnable runnable);
+
+    Object pooledByteBuf(Object channel);
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/ConnectionState.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -23,9 +23,12 @@ package com.github.retrooper.packetevents.protocol;
  * @since 1.8
  */
 public enum ConnectionState {
-    HANDSHAKING, STATUS, LOGIN, PLAY;
+    HANDSHAKING, STATUS, LOGIN, PLAY, CONFIGURATION;
 
     public static ConnectionState getById(int id) {
+        if (id >= values().length || id < 0) {
+            return null;
+        }
         return values()[id];
     }
 }

api/src/main/java/com/github/retrooper/packetevents/protocol/PacketSide.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

api/src/main/java/com/github/retrooper/packetevents/protocol/ProtocolVersion.java

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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

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/ChatCompletionAction.java

@@ -0,0 +1,13 @@
+package com.github.retrooper.packetevents.protocol.chat;
+
+public enum ChatCompletionAction {
+    ADD,
+    REMOVE,
+    SET;
+
+    private static final ChatCompletionAction[] VALUES = values();
+
+    public static ChatCompletionAction fromId(int id) {
+        return VALUES[id];
+    }
+}

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

@@ -1,6 +1,6 @@
 /*
  * This file is part of packetevents - https://github.com/retrooper/packetevents
- * Copyright (C) 2021 retrooper and contributors
+ * Copyright (C) 2022 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
@@ -18,16 +18,8 @@
 
 package com.github.retrooper.packetevents.protocol.chat;
 
-public enum ChatPosition {
-    CHAT,
-    SYSTEM,
-    GAME_INFO;
-    
-    public int getId() {
-        return ordinal();
-    }
+import com.github.retrooper.packetevents.protocol.mapper.MappedEntity;
+
+public interface ChatType extends MappedEntity {
 
-    public static ChatPosition getById(int id) {
-        return values()[id];
-    }
 }

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

@@ -0,0 +1,84 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat;
+
+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 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");
+
+    public static ChatType define(String key) {
+        TypesBuilderData data = TYPES_BUILDER.define(key);
+        ChatType chatType = new ChatType() {
+            @Override
+            public ResourceLocation getName() {
+                return data.getName();
+            }
+
+            @Override
+            public int getId(ClientVersion version) {
+                return MappingHelper.getId(version, TYPES_BUILDER, data);
+            }
+        };
+        MappingHelper.registerMapping(TYPES_BUILDER, CHAT_TYPE_MAP, CHAT_TYPE_ID_MAP, chatType);
+        return chatType;
+    }
+
+    //with minecraft:key
+    public static ChatType getByName(String name) {
+        return CHAT_TYPE_MAP.get(name);
+    }
+
+    public static ChatType getById(ClientVersion version, int id) {
+        int index = TYPES_BUILDER.getDataIndex(version);
+        return CHAT_TYPE_ID_MAP.get((byte) index).get(id);
+    }
+
+    public static final ChatType CHAT = define("chat");
+    public static final ChatType SAY_COMMAND = define("say_command");
+    public static final ChatType MSG_COMMAND_INCOMING = define("msg_command_incoming");
+    public static final ChatType MSG_COMMAND_OUTGOING = define("msg_command_outgoing");
+    public static final ChatType TEAM_MSG_COMMAND_INCOMING = define("team_msg_command_incoming");
+    public static final ChatType TEAM_MSG_COMMAND_OUTGOING = define("team_msg_command_outgoing");
+    public static final ChatType EMOTE_COMMAND = define("emote_command");
+    public static final ChatType RAW = define("raw");
+
+    @Deprecated
+    public static final ChatType SYSTEM = define("system");
+    @Deprecated
+    public static final ChatType GAME_INFO = define("game_info");
+    @Deprecated
+    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/LastSeenMessages.java

@@ -0,0 +1,105 @@
+package com.github.retrooper.packetevents.protocol.chat;
+
+import org.jetbrains.annotations.Nullable;
+
+import java.io.DataOutput;
+import java.io.IOException;
+import java.util.ArrayList;
+import java.util.BitSet;
+import java.util.List;
+import java.util.UUID;
+
+public class LastSeenMessages {
+    public static final LastSeenMessages EMPTY = new LastSeenMessages(new ArrayList<>());
+
+    private final List<Entry> entries;
+
+    public LastSeenMessages(List<Entry> entries) {
+        this.entries = entries;
+    }
+
+    public void updateHash(DataOutput output) throws IOException {
+        for (Entry entry : this.entries) {
+            UUID uuid = entry.getUUID();
+            byte[] lastVerifier = entry.getLastVerifier();
+            output.writeByte(70);
+            output.writeLong(uuid.getMostSignificantBits());
+            output.writeLong(uuid.getLeastSignificantBits());
+            output.write(lastVerifier);
+        }
+    }
+
+    public List<Entry> getEntries() {
+        return entries;
+    }
+
+    public static class Packed {
+        private List<MessageSignature.Packed> packedMessageSignatures;
+
+        public Packed(List<MessageSignature.Packed> packedMessageSignatures) {
+            this.packedMessageSignatures = packedMessageSignatures;
+        }
+
+        public List<MessageSignature.Packed> getPackedMessageSignatures() {
+            return packedMessageSignatures;
+        }
+
+        public void setPackedMessageSignatures(List<MessageSignature.Packed> packedMessageSignatures) {
+            this.packedMessageSignatures = packedMessageSignatures;
+        }
+    }
+
+    public static class Entry {
+        private final UUID uuid;
+        private final byte[] signature;
+
+        public Entry(UUID uuid, byte[] lastVerifier) {
+            this.uuid = uuid;
+            this.signature = lastVerifier;
+        }
+
+        public UUID getUUID() {
+            return uuid;
+        }
+
+        public byte[] getLastVerifier() {
+            return signature;
+        }
+    }
+
+    public static class LegacyUpdate {
+        private final LastSeenMessages lastSeenMessages;
+        private final @Nullable Entry lastReceived;
+
+        public LegacyUpdate(LastSeenMessages lastSeenMessages, @Nullable Entry lastReceived) {
+            this.lastSeenMessages = lastSeenMessages;
+            this.lastReceived = lastReceived;
+        }
+
+        public LastSeenMessages getLastSeenMessages() {
+            return lastSeenMessages;
+        }
+
+        public @Nullable Entry getLastReceived() {
+            return lastReceived;
+        }
+    }
+
+    public static class Update {
+        private final int offset;
+        private final BitSet acknowledged;
+
+        public Update(int offset, BitSet acknowledged) {
+            this.offset = offset;
+            this.acknowledged = acknowledged;
+        }
+
+        public int getOffset() {
+            return offset;
+        }
+
+        public BitSet getAcknowledged() {
+            return acknowledged;
+        }
+    }
+}

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

@@ -0,0 +1,69 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat;
+
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.UUID;
+
+public class MessageSender {
+    private @NotNull UUID uuid;
+    private @Nullable Component displayName;
+    private @Nullable Component teamName;
+
+    public MessageSender(@NotNull UUID uuid, @Nullable Component displayName, @Nullable Component teamName) {
+        this.uuid = uuid;
+        this.displayName = displayName;
+        this.teamName = teamName;
+    }
+
+    public MessageSender(@Nullable Component displayName, @Nullable Component teamName) {
+        this(new UUID(0L, 0L), displayName, teamName);
+    }
+
+    public MessageSender() {
+        this(null, null);
+    }
+
+    public UUID getUUID() {
+        return uuid;
+    }
+
+    public void setUUID(@NotNull UUID uuid) {
+        this.uuid = uuid;
+    }
+
+    public @Nullable Component getDisplayName() {
+        return displayName;
+    }
+
+    public void setDisplayName(@Nullable Component displayName) {
+        this.displayName = displayName;
+    }
+
+    public @Nullable Component getTeamName() {
+        return teamName;
+    }
+
+    public void setTeamName(@Nullable Component teamName) {
+        this.teamName = teamName;
+    }
+}

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

@@ -0,0 +1,70 @@
+/*
+ * 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.chat;
+
+import org.jetbrains.annotations.Nullable;
+
+import java.util.Optional;
+
+public class MessageSignature {
+    private byte[] bytes;
+
+    public MessageSignature(byte[] bytes) {
+        this.bytes = bytes;
+    }
+
+    public byte[] getBytes() {
+        return bytes;
+    }
+
+    public void setBytes(byte[] bytes) {
+        this.bytes = bytes;
+    }
+
+    public static class Packed {
+        private int id;
+        private @Nullable MessageSignature fullSignature;
+
+        public Packed(@Nullable MessageSignature fullSignature) {
+            this.id = -1;
+            this.fullSignature = fullSignature;
+        }
+
+        public Packed(int id) {
+            this.id = id;
+            this.fullSignature = null;
+        }
+
+        public int getId() {
+            return id;
+        }
+
+        public void setId(int id) {
+            this.id = id;
+        }
+
+        public Optional<MessageSignature> getFullSignature() {
+            return Optional.ofNullable(fullSignature);
+        }
+
+        public void setFullSignature(@Nullable MessageSignature fullSignature) {
+            this.fullSignature = fullSignature;
+        }
+    }
+}

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

@@ -0,0 +1,102 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat;
+
+import com.github.retrooper.packetevents.resources.ResourceLocation;
+import org.jetbrains.annotations.Nullable;
+
+import java.util.List;
+import java.util.Optional;
+
+public class Node {
+    private byte flags;
+    private List<Integer> children;
+    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, int redirectNodeIndex, @Nullable String name, @Nullable Integer parserID, @Nullable List<Object> properties, @Nullable ResourceLocation suggestionsType) {
+        this.flags = flags;
+        this.children = children;
+        this.redirectNodeIndex = redirectNodeIndex;
+        this.name = Optional.ofNullable(name);
+        this.parserID = Optional.ofNullable(parserID);
+        this.properties = Optional.ofNullable(properties);
+        this.suggestionsType = Optional.ofNullable(suggestionsType);
+    }
+
+    public byte getFlags() {
+        return flags;
+    }
+
+    public void setFlags(byte flags) {
+        this.flags = flags;
+    }
+
+    public List<Integer> getChildren() {
+        return children;
+    }
+
+    public void setChildren(List<Integer> children) {
+        this.children = children;
+    }
+
+    public int getRedirectNodeIndex() {
+        return redirectNodeIndex;
+    }
+
+    public void setRedirectNodeIndex(int redirectNodeIndex) {
+        this.redirectNodeIndex = redirectNodeIndex;
+    }
+
+    public Optional<String> getName() {
+        return name;
+    }
+
+    public void setName(Optional<String> name) {
+        this.name = name;
+    }
+
+    public Optional<Integer> getParserID() {
+        return parserID;
+    }
+
+    public void setParserID(Optional<Integer> parserID) {
+        this.parserID = parserID;
+    }
+
+    public Optional<List<Object>> getProperties() {
+        return properties;
+    }
+
+    public void setProperties(Optional<List<Object>> properties) {
+        this.properties = properties;
+    }
+
+    public Optional<ResourceLocation> getSuggestionsType() {
+        return suggestionsType;
+    }
+
+    public void setSuggestionsType(Optional<ResourceLocation> suggestionsType) {
+        this.suggestionsType = suggestionsType;
+    }
+}

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

@@ -0,0 +1,275 @@
+/*
+ * 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.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> 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 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(
+                    new TypesBuilderData(new ResourceLocation(name), new int[0]),
+                    read == null ? null : read::apply,
+                    write == null ? null : write::accept
+            );
+        }
+
+        private Parser(TypesBuilderData data, @Nullable Reader reader, Writer writer) {
+            this.data = data;
+            this.reader = reader;
+            this.writer = writer;
+        }
+
+        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/chat/RemoteChatSession.java

@@ -0,0 +1,41 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat;
+
+import com.github.retrooper.packetevents.protocol.player.PublicProfileKey;
+
+import java.util.UUID;
+
+public class RemoteChatSession {
+    private final UUID sessionId;
+    private final PublicProfileKey publicProfileKey;
+
+    public RemoteChatSession(UUID sessionId, PublicProfileKey publicProfileKey) {
+        this.sessionId = sessionId;
+        this.publicProfileKey = publicProfileKey;
+    }
+
+    public UUID getSessionId() {
+        return sessionId;
+    }
+
+    public PublicProfileKey getPublicProfileKey() {
+        return publicProfileKey;
+    }
+}

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

@@ -0,0 +1,27 @@
+package com.github.retrooper.packetevents.protocol.chat;
+
+public class SignedCommandArgument {
+    private String argument;
+    private byte[] signature;
+
+    public SignedCommandArgument(String argument, byte[] signature) {
+        this.argument = argument;
+        this.signature = signature;
+    }
+
+    public String getArgument() {
+        return argument;
+    }
+
+    public void setArgument(String argument) {
+        this.argument = argument;
+    }
+
+    public byte[] getSignature() {
+        return signature;
+    }
+
+    public void setSignature(byte[] signature) {
+        this.signature = signature;
+    }
+}

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

@@ -0,0 +1,52 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.filter;
+
+import java.util.BitSet;
+
+public class FilterMask {
+    public static final FilterMask FULLY_FILTERED;
+    public static final FilterMask PASS_THROUGH;
+
+    static {
+        FULLY_FILTERED = new FilterMask(new BitSet(0), FilterMaskType.FULLY_FILTERED);
+        PASS_THROUGH = new FilterMask(new BitSet(0), FilterMaskType.PASS_THROUGH);
+    }
+
+    private final BitSet mask;
+    private final FilterMaskType type;
+
+    private FilterMask(BitSet mask, FilterMaskType type) {
+        this.type = type;
+        this.mask = mask;
+    }
+
+    public FilterMask(BitSet mask) {
+        this.type = FilterMaskType.PARTIALLY_FILTERED;
+        this.mask = mask;
+    }
+
+    public BitSet getMask() {
+        return mask;
+    }
+
+    public FilterMaskType getType() {
+        return type;
+    }
+}

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

@@ -0,0 +1,35 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.filter;
+
+public enum FilterMaskType {
+    PASS_THROUGH,
+    FULLY_FILTERED,
+    PARTIALLY_FILTERED;
+
+    public static final FilterMaskType[] VALUES = values();
+
+    public int getId() {
+        return ordinal();
+    }
+
+    public static FilterMaskType getById(int id) {
+        return VALUES[id];
+    }
+}

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

@@ -0,0 +1,48 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import net.kyori.adventure.text.Component;
+
+public class ChatMessage {
+    private Component chatContent;
+    private ChatType type;
+
+    protected ChatMessage(Component chatContent, ChatType type) {
+        this.chatContent = chatContent;
+        this.type = type;
+    }
+
+    public Component getChatContent() {
+        return chatContent;
+    }
+
+    public ChatType getType() {
+        return type;
+    }
+
+    public void setChatContent(Component chatContent) {
+        this.chatContent = chatContent;
+    }
+
+    public void setType(ChatType type) {
+        this.type = type;
+    }
+}

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

@@ -0,0 +1,28 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import net.kyori.adventure.text.Component;
+
+public class ChatMessageLegacy extends ChatMessage {
+    public ChatMessageLegacy(Component chatContent, ChatType type) {
+        super(chatContent, type);
+    }
+}

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

@@ -0,0 +1,41 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import net.kyori.adventure.text.Component;
+
+import java.util.UUID;
+
+public class ChatMessage_v1_16 extends ChatMessage {
+    private UUID senderUUID;
+
+    public ChatMessage_v1_16(Component chatContent, ChatType type, UUID senderUUID) {
+        super(chatContent, type);
+        this.senderUUID = senderUUID;
+    }
+
+    public UUID getSenderUUID() {
+        return senderUUID;
+    }
+
+    public void setSenderUUID(UUID senderUUID) {
+        this.senderUUID = senderUUID;
+    }
+}

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

@@ -0,0 +1,95 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.Nullable;
+
+import java.time.Instant;
+import java.util.UUID;
+//We'll extend ChatMessage_v1_16 for now, hopefully no breaking changes in the future
+public class ChatMessage_v1_19 extends ChatMessage_v1_16 {
+    private @Nullable Component unsignedChatContent;
+    private Component senderDisplayName;
+    private @Nullable Component teamName;
+    private Instant timestamp;
+    private long salt;
+    private byte[] signature;
+
+    public ChatMessage_v1_19(Component chatContent, @Nullable Component unsignedChatContent, ChatType type,
+                             UUID senderUUID, Component senderDisplayName, @Nullable Component teamName, Instant timestamp,
+                             long salt, byte[] signature) {
+        super(chatContent, type, senderUUID);
+        this.unsignedChatContent = unsignedChatContent;
+        this.senderDisplayName = senderDisplayName;
+        this.teamName = teamName;
+        this.timestamp = timestamp;
+        this.salt = salt;
+        this.signature = signature;
+    }
+
+    public @Nullable Component getUnsignedChatContent() {
+        return unsignedChatContent;
+    }
+
+    public Component getSenderDisplayName() {
+        return senderDisplayName;
+    }
+
+    public @Nullable Component getTeamName() {
+        return teamName;
+    }
+
+    public Instant getTimestamp() {
+        return timestamp;
+    }
+
+    public long getSalt() {
+        return salt;
+    }
+
+    public byte[] getSignature() {
+        return signature;
+    }
+
+    public void setUnsignedChatContent(@Nullable Component unsignedChatContent) {
+        this.unsignedChatContent = unsignedChatContent;
+    }
+
+    public void setSenderDisplayName(Component senderDisplayName) {
+        this.senderDisplayName = senderDisplayName;
+    }
+
+    public void setTeamName(@Nullable Component teamName) {
+        this.teamName = teamName;
+    }
+
+    public void setTimestamp(Instant timestamp) {
+        this.timestamp = timestamp;
+    }
+
+    public void setSalt(long salt) {
+        this.salt = salt;
+    }
+
+    public void setSignature(byte[] signature) {
+        this.signature = signature;
+    }
+}

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

@@ -0,0 +1,181 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import com.github.retrooper.packetevents.protocol.chat.LastSeenMessages;
+import com.github.retrooper.packetevents.protocol.chat.filter.FilterMask;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.Nullable;
+
+import java.time.Instant;
+import java.util.UUID;
+//We'll extend ChatMessage_v1_16 for now, hopefully no breaking changes in the future
+public class ChatMessage_v1_19_1 extends ChatMessage_v1_16 {
+    private String plainContent;
+    private @Nullable Component unsignedChatContent;
+    private ChatTypeBoundNetwork chatType;
+    private byte @Nullable [] previousSignature;
+    private byte[] signature;
+    private Instant timestamp;
+    private long salt;
+    private LastSeenMessages lastSeenMessages;
+    private FilterMask filterMask;
+
+    public ChatMessage_v1_19_1(String plainContent, Component decoratedChatContent,
+                               @Nullable Component unsignedChatContent,
+                               UUID senderUUID, ChatTypeBoundNetwork chatType,
+                               byte @Nullable [] previousSignature, byte[] signature,
+                               Instant timestamp, long salt,
+                               LastSeenMessages lastSeenMessages,
+                               FilterMask filterMask) {
+        super(decoratedChatContent, chatType.getType(), senderUUID);
+        this.plainContent = plainContent;
+        this.unsignedChatContent = unsignedChatContent;
+        this.chatType = chatType;
+        this.previousSignature = previousSignature;
+        this.signature = signature;
+        this.timestamp = timestamp;
+        this.salt = salt;
+        this.lastSeenMessages = lastSeenMessages;
+        this.filterMask = filterMask;
+    }
+
+    public String getPlainContent() {
+        return plainContent;
+    }
+
+    public void setPlainContent(String plainContent) {
+        this.plainContent = plainContent;
+    }
+
+    public boolean isChatContentDecorated() {
+        return !getChatContent().equals(Component.text(plainContent));
+    }
+
+    public @Nullable Component getUnsignedChatContent() {
+        return unsignedChatContent;
+    }
+
+    public void setUnsignedChatContent(@Nullable Component unsignedChatContent) {
+        this.unsignedChatContent = unsignedChatContent;
+    }
+
+    @Override
+    public ChatType getType() {
+        return chatType.getType();
+    }
+
+    @Override
+    public void setType(ChatType type) {
+        chatType.setType(type);
+    }
+
+    public ChatTypeBoundNetwork getChatType() {
+        return chatType;
+    }
+
+    public void setChatType(ChatTypeBoundNetwork type) {
+        this.chatType = type;
+    }
+
+    public byte @Nullable [] getPreviousSignature() {
+        return previousSignature;
+    }
+
+    public void setPreviousSignature(byte @Nullable [] previousSignature) {
+        this.previousSignature = previousSignature;
+    }
+
+    public byte[] getSignature() {
+        return signature;
+    }
+
+    public void setSignature(byte[] signature) {
+        this.signature = signature;
+    }
+
+    public Instant getTimestamp() {
+        return timestamp;
+    }
+
+    public void setTimestamp(Instant timestamp) {
+        this.timestamp = timestamp;
+    }
+
+    public long getSalt() {
+        return salt;
+    }
+
+    public void setSalt(long salt) {
+        this.salt = salt;
+    }
+
+    public LastSeenMessages getLastSeenMessages() {
+        return lastSeenMessages;
+    }
+
+    public void setLastSeenMessages(LastSeenMessages lastSeenMessages) {
+        this.lastSeenMessages = lastSeenMessages;
+    }
+
+    public FilterMask getFilterMask() {
+        return filterMask;
+    }
+
+    public void setFilterMask(FilterMask filterMask) {
+        this.filterMask = filterMask;
+    }
+
+    public static class ChatTypeBoundNetwork {
+        private ChatType type;
+        private Component name;
+        private @Nullable Component targetName;
+
+        public ChatTypeBoundNetwork(ChatType type, Component name, @Nullable Component targetName) {
+            this.type = type;
+            this.name = name;
+            this.targetName = targetName;
+        }
+
+        public ChatType getType() {
+            return type;
+        }
+
+        public void setType(ChatType type) {
+            this.type = type;
+        }
+
+        public Component getName() {
+            return name;
+        }
+
+        public void setName(Component name) {
+            this.name = name;
+        }
+
+        public @Nullable Component getTargetName() {
+            return targetName;
+        }
+
+        public void setTargetName(@Nullable Component targetName) {
+            this.targetName = targetName;
+        }
+    }
+}

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

@@ -0,0 +1,119 @@
+package com.github.retrooper.packetevents.protocol.chat.message;
+
+import com.github.retrooper.packetevents.protocol.chat.LastSeenMessages;
+import com.github.retrooper.packetevents.protocol.chat.filter.FilterMask;
+import com.github.retrooper.packetevents.util.adventure.AdventureSerializer;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.Nullable;
+
+import java.time.Instant;
+import java.util.Optional;
+import java.util.UUID;
+//We'll extend ChatMessage_v1_16 for now, hopefully no breaking changes in the future
+public class ChatMessage_v1_19_3 extends ChatMessage_v1_16 {
+    int index;
+    byte[] signature;
+    String plainContent;
+    Instant timestamp;
+    long salt;
+    LastSeenMessages.Packed lastSeenMessagesPacked;
+    @Nullable Component unsignedChatContent;
+    FilterMask filterMask;
+    ChatMessage_v1_19_1.ChatTypeBoundNetwork chatType;
+
+    public ChatMessage_v1_19_3(UUID senderUUID, int index, byte[] signature, String plainContent, Instant timestamp, long salt, LastSeenMessages.Packed lastSeenMessagesPacked, @Nullable Component unsignedChatContent, FilterMask filterMask, ChatMessage_v1_19_1.ChatTypeBoundNetwork chatType) {
+        super(Component.text(plainContent), chatType.getType(), senderUUID);
+        this.index = index;
+        this.signature = signature;
+        this.plainContent = plainContent;
+        this.timestamp = timestamp;
+        this.salt = salt;
+        this.lastSeenMessagesPacked = lastSeenMessagesPacked;
+        this.unsignedChatContent = unsignedChatContent;
+        this.filterMask = filterMask;
+        this.chatType = chatType;
+    }
+
+    public int getIndex() {
+        return index;
+    }
+
+    public void setIndex(int index) {
+        this.index = index;
+    }
+
+    public byte[] getSignature() {
+        return signature;
+    }
+
+    public void setSignature(byte[] signature) {
+        this.signature = signature;
+    }
+
+    @Override
+    public Component getChatContent() {
+        return Component.text(plainContent);
+    }
+
+    @Deprecated
+    @Override
+    public void setChatContent(Component chatContent) {
+        throw new UnsupportedOperationException("PacketEvents is not able to serialize components to plain-text. Please use the #setPlainContent instead to update the content.");
+    }
+
+    public String getPlainContent() {
+        return plainContent;
+    }
+
+    public void setPlainContent(String plainContent) {
+        this.plainContent = plainContent;
+    }
+
+    public Instant getTimestamp() {
+        return timestamp;
+    }
+
+    public void setTimestamp(Instant timestamp) {
+        this.timestamp = timestamp;
+    }
+
+    public long getSalt() {
+        return salt;
+    }
+
+    public void setSalt(long salt) {
+        this.salt = salt;
+    }
+
+    public LastSeenMessages.Packed getLastSeenMessagesPacked() {
+        return lastSeenMessagesPacked;
+    }
+
+    public void setLastSeenMessagesPacked(LastSeenMessages.Packed lastSeenMessagesPacked) {
+        this.lastSeenMessagesPacked = lastSeenMessagesPacked;
+    }
+
+    public Optional<Component> getUnsignedChatContent() {
+        return Optional.ofNullable(unsignedChatContent);
+    }
+
+    public void setUnsignedChatContent(@Nullable Component unsignedChatContent) {
+        this.unsignedChatContent = unsignedChatContent;
+    }
+
+    public FilterMask getFilterMask() {
+        return filterMask;
+    }
+
+    public void setFilterMask(FilterMask filterMask) {
+        this.filterMask = filterMask;
+    }
+
+    public ChatMessage_v1_19_1.ChatTypeBoundNetwork getChatType() {
+        return chatType;
+    }
+
+    public void setChatType(ChatMessage_v1_19_1.ChatTypeBoundNetwork chatType) {
+        this.chatType = chatType;
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/message/reader/ChatMessageProcessor.java

@@ -0,0 +1,29 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message.reader;
+
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import org.jetbrains.annotations.NotNull;
+
+public interface ChatMessageProcessor {
+    ChatMessage readChatMessage(@NotNull PacketWrapper<?> wrapper);
+
+    void writeChatMessage(@NotNull PacketWrapper<?> wrapper, @NotNull ChatMessage data);
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/message/reader/impl/ChatMessageProcessorLegacy.java

@@ -0,0 +1,44 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message.reader.impl;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import com.github.retrooper.packetevents.protocol.chat.ChatTypes;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessageLegacy;
+import com.github.retrooper.packetevents.protocol.chat.message.reader.ChatMessageProcessor;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.NotNull;
+
+public class ChatMessageProcessorLegacy implements ChatMessageProcessor {
+    @Override
+    public ChatMessage readChatMessage(@NotNull PacketWrapper<?> wrapper) {
+        Component chatContent = wrapper.readComponent();
+        int id = wrapper.readByte();
+        ChatType type = ChatTypes.getById(wrapper.getServerVersion().toClientVersion(), id);
+        return new ChatMessageLegacy(chatContent, type);
+    }
+
+    @Override
+    public void writeChatMessage(@NotNull PacketWrapper<?> wrapper, @NotNull ChatMessage data) {
+        wrapper.writeComponent(data.getChatContent());
+        wrapper.writeByte(data.getType().getId(wrapper.getServerVersion().toClientVersion()));
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/message/reader/impl/ChatMessageProcessor_v1_16.java

@@ -0,0 +1,48 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message.reader.impl;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import com.github.retrooper.packetevents.protocol.chat.ChatTypes;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage_v1_16;
+import com.github.retrooper.packetevents.protocol.chat.message.reader.ChatMessageProcessor;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.NotNull;
+
+import java.util.UUID;
+
+public class ChatMessageProcessor_v1_16 implements ChatMessageProcessor {
+    @Override
+    public ChatMessage readChatMessage(@NotNull PacketWrapper<?> wrapper) {
+        Component chatContent = wrapper.readComponent();
+        int id = wrapper.readByte();
+        ChatType type = ChatTypes.getById(wrapper.getServerVersion().toClientVersion(), id);
+        UUID senderUUID = wrapper.readUUID();
+        return new ChatMessage_v1_16(chatContent, type, senderUUID);
+    }
+
+    @Override
+    public void writeChatMessage(@NotNull PacketWrapper<?> wrapper, @NotNull ChatMessage data) {
+        wrapper.writeComponent(data.getChatContent());
+        wrapper.writeByte(data.getType().getId(wrapper.getServerVersion().toClientVersion()));
+        wrapper.writeUUID(((ChatMessage_v1_16) data).getSenderUUID());
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/message/reader/impl/ChatMessageProcessor_v1_19.java

@@ -0,0 +1,64 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message.reader.impl;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import com.github.retrooper.packetevents.protocol.chat.ChatTypes;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage_v1_19;
+import com.github.retrooper.packetevents.protocol.chat.message.reader.ChatMessageProcessor;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.NotNull;
+import org.jetbrains.annotations.Nullable;
+
+import java.time.Instant;
+import java.util.UUID;
+
+public class ChatMessageProcessor_v1_19 implements ChatMessageProcessor {
+    @Override
+    public ChatMessage readChatMessage(@NotNull PacketWrapper<?> wrapper) {
+        Component chatContent = wrapper.readComponent();
+        Component unsignedChatContent = wrapper.readOptional(PacketWrapper::readComponent);
+        int id = wrapper.readVarInt();
+        ChatType type = ChatTypes.getById(wrapper.getServerVersion().toClientVersion(), id);
+        UUID senderUUID = wrapper.readUUID();
+        Component senderDisplayName = wrapper.readComponent();
+        @Nullable Component teamName = wrapper.readOptional(PacketWrapper::readComponent);
+        Instant timestamp = wrapper.readTimestamp();
+        long salt = wrapper.readLong();
+        byte[] signature = wrapper.readByteArray();
+        return new ChatMessage_v1_19(chatContent, unsignedChatContent, type, senderUUID, senderDisplayName, teamName,
+                timestamp, salt, signature);
+    }
+
+    @Override
+    public void writeChatMessage(@NotNull PacketWrapper<?> wrapper, @NotNull ChatMessage data) {
+        ChatMessage_v1_19 newData = (ChatMessage_v1_19) data;
+        wrapper.writeComponent(newData.getChatContent());
+        wrapper.writeOptional(newData.getUnsignedChatContent(), PacketWrapper::writeComponent);
+        wrapper.writeVarInt(newData.getType().getId(wrapper.getServerVersion().toClientVersion()));
+        wrapper.writeUUID(newData.getSenderUUID());
+        wrapper.writeComponent(newData.getSenderDisplayName());
+        wrapper.writeOptional(newData.getTeamName(), PacketWrapper::writeComponent);
+        wrapper.writeTimestamp(newData.getTimestamp());
+        wrapper.writeLong(newData.getSalt());
+        wrapper.writeByteArray(newData.getSignature());
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/message/reader/impl/ChatMessageProcessor_v1_19_1.java

@@ -0,0 +1,73 @@
+/*
+ * This file is part of packetevents - https://github.com/retrooper/packetevents
+ * Copyright (C) 2022 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.chat.message.reader.impl;
+
+import com.github.retrooper.packetevents.protocol.chat.ChatType;
+import com.github.retrooper.packetevents.protocol.chat.ChatTypes;
+import com.github.retrooper.packetevents.protocol.chat.LastSeenMessages;
+import com.github.retrooper.packetevents.protocol.chat.filter.FilterMask;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage_v1_19_1;
+import com.github.retrooper.packetevents.protocol.chat.message.reader.ChatMessageProcessor;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.NotNull;
+
+import java.time.Instant;
+import java.util.UUID;
+
+public class ChatMessageProcessor_v1_19_1 implements ChatMessageProcessor {
+    @Override
+    public ChatMessage readChatMessage(@NotNull PacketWrapper<?> wrapper) {
+        byte[] previousSignature = wrapper.readOptional(PacketWrapper::readByteArray);
+        UUID senderUUID = wrapper.readUUID();
+        byte[] signature = wrapper.readByteArray();
+        String plainContent = wrapper.readString(256);
+        Component chatContent = wrapper.readOptional(PacketWrapper::readComponent);
+        if (chatContent == null && plainContent.isEmpty()) {
+            chatContent = Component.empty();
+        } else if (chatContent == null) {
+            chatContent = Component.text(plainContent);
+        }
+        Instant timestamp = wrapper.readTimestamp();
+        long salt = wrapper.readLong();
+        LastSeenMessages lastSeenMessages = wrapper.readLastSeenMessages();
+        Component unsignedChatContent = wrapper.readOptional(PacketWrapper::readComponent);
+        FilterMask filterMask = wrapper.readFilterMask();
+        ChatMessage_v1_19_1.ChatTypeBoundNetwork chatType = wrapper.readChatTypeBoundNetwork();
+        return new ChatMessage_v1_19_1(plainContent, chatContent, unsignedChatContent, senderUUID, chatType,
+                previousSignature, signature, timestamp, salt, lastSeenMessages, filterMask);
+    }
+
+    @Override
+    public void writeChatMessage(@NotNull PacketWrapper<?> wrapper, @NotNull ChatMessage data) {
+        ChatMessage_v1_19_1 newData = (ChatMessage_v1_19_1) data;
+        wrapper.writeOptional(newData.getPreviousSignature(), PacketWrapper::writeByteArray);
+        wrapper.writeUUID(newData.getSenderUUID());
+        wrapper.writeByteArray(newData.getSignature());
+        wrapper.writeString(newData.getPlainContent(), 256);
+        wrapper.writeOptional(newData.getChatContent(), PacketWrapper::writeComponent);
+        wrapper.writeTimestamp(newData.getTimestamp());
+        wrapper.writeLong(newData.getSalt());
+        wrapper.writeLastSeenMessages(newData.getLastSeenMessages());
+        wrapper.writeOptional(newData.getUnsignedChatContent(), PacketWrapper::writeComponent);
+        wrapper.writeFilterMask(newData.getFilterMask());
+        wrapper.writeChatTypeBoundNetwork(newData.getChatType());
+    }
+}

api/src/main/java/com/github/retrooper/packetevents/protocol/chat/message/reader/impl/ChatMessageProcessor_v1_19_3.java

@@ -0,0 +1,47 @@
+package com.github.retrooper.packetevents.protocol.chat.message.reader.impl;
+
+import com.github.retrooper.packetevents.protocol.chat.LastSeenMessages;
+import com.github.retrooper.packetevents.protocol.chat.filter.FilterMask;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage_v1_19_1;
+import com.github.retrooper.packetevents.protocol.chat.message.ChatMessage_v1_19_3;
+import com.github.retrooper.packetevents.protocol.chat.message.reader.ChatMessageProcessor;
+import com.github.retrooper.packetevents.wrapper.PacketWrapper;
+import net.kyori.adventure.text.Component;
+import org.jetbrains.annotations.NotNull;
+
+import java.time.Instant;
+import java.util.UUID;
+
+public class ChatMessageProcessor_v1_19_3 implements ChatMessageProcessor {
+    @Override
+    public ChatMessage readChatMessage(@NotNull PacketWrapper<?> wrapper) {
+        UUID senderUUID = wrapper.readUUID();
+        int index = wrapper.readVarInt();
+        byte[] signature = wrapper.readOptional((w) -> w.readBytes(256));
+        String plainContent = wrapper.readString(256);
+        Instant timestamp = wrapper.readTimestamp();
+        long salt = wrapper.readLong();
+        LastSeenMessages.Packed lastSeenMessagesPacked = wrapper.readLastSeenMessagesPacked();
+        Component unsignedChatContent = wrapper.readOptional(PacketWrapper::readComponent);
+        FilterMask filterMask = wrapper.readFilterMask();
+        ChatMessage_v1_19_1.ChatTypeBoundNetwork chatType = wrapper.readChatTypeBoundNetwork();
+
+        return new ChatMessage_v1_19_3(senderUUID, index, signature, plainContent, timestamp, salt, lastSeenMessagesPacked, unsignedChatContent, filterMask, chatType);
+    }
+
+    @Override
+    public void writeChatMessage(@NotNull PacketWrapper<?> wrapper, @NotNull ChatMessage data) {
+        ChatMessage_v1_19_3 newData = (ChatMessage_v1_19_3) data;
+        wrapper.writeUUID(newData.getSenderUUID());
+        wrapper.writeVarInt(newData.getIndex());
+        wrapper.writeOptional(newData.getSignature(), PacketWrapper::writeBytes);
+        wrapper.writeString(newData.getPlainContent());
+        wrapper.writeTimestamp(newData.getTimestamp());
+        wrapper.writeLong(newData.getSalt());
+        wrapper.writeLastSeenMessagesPacked(newData.getLastSeenMessagesPacked());
+        wrapper.writeOptional(newData.getUnsignedChatContent().orElse(null), PacketWrapper::writeComponent);
+        wrapper.writeFilterMask(newData.getFilterMask());
+        wrapper.writeChatTypeBoundNetwork(newData.getChatType());
+    }
+}

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,
+    }
+}