NBT Component Serializer#1404

Open

MelonHell wants to merge 90 commits intoPaperMC:main/5from

MelonHell:feat/nbt-text-serializer

Commits on Apr 17, 2026

feat: basic component serializing to nbt (without styling)

Codestech1
authored and
MelonHell
committed
feat: serialize component children and types

Codestech1
authored and
MelonHell
committed
misc: i'm too lazy to name this commit, but it fixes and adds a lot of stuff after spigotting (looking at nms code decompiled and mapped with build tools)

Codestech1
authored and
MelonHell
committed
chore: remove useless gson serializer

Codestech1
authored and
MelonHell
committed
chore: add support for legacy item tags

Codestech1
authored and
MelonHell
committed
feat: component deserialization

Codestech1
authored and
MelonHell
committed
fix: translatable component arguments aren't deserializing

Codestech1
authored and
MelonHell
committed
fix: legacy hover events aren't serialized properly

Codestech1
authored and
MelonHell
committed
fix: serializing show entity as a legacy hover event throws an exception instead of returning null

Codestech1
authored and
MelonHell
committed
misc: split the style serialization and deserialization to other class

Codestech1
authored and
MelonHell
committed
feat: add an emit rgb flag

Codestech1
authored and
MelonHell
committed
feat: add a builder for the nbt component serializer

Codestech1
authored and
MelonHell
committed
chore: add a non-null requirement to NBTComponentSerializerImpl.BuilderImpl#options

Codestech1
authored and
MelonHell
committed
feat: nbt component providers

Codestech1
authored and
MelonHell
committed
chore: add remaining serializer options to builder

Codestech1
authored and
MelonHell
committed
chore: cleanup

Codestech1
authored and
MelonHell
committed
chore: add javadocs to and simplify NBTSerializerOptions and add license headers

Codestech1
authored and
MelonHell
committed
chore: add javadocs for public classes

Codestech1
authored and
MelonHell
committed
chore: add tests

Codestech1
authored and
MelonHell
committed
fix: hover events are not serialized properly, feat: add a test for hover event

Codestech1
authored and
MelonHell
committed
feat: add a test for click event

Codestech1
authored and
MelonHell
committed
chore: resolve requested changes

Codestech1
authored and
MelonHell
committed
feat: add a possibility to (de)-serialize a style without a component

Codestech1
authored and
MelonHell
committed
chore: simplify serializing text colors with TextColor#toString

Codestech1
authored and
MelonHell
committed
feat: shadow color serializing

Codestech1
authored and
MelonHell
committed
chore: update all `@since` tags to use version 4.24.0

Codestech1
authored and
MelonHell
committed
chore: update ClickEventSerializer to support the latest format

Codestech1
authored and
MelonHell
committed
chore: create ShowItemSerializer for future use in StyleSerializer to support the latest format

Codestech1
authored and
MelonHell
committed
misc: fix double colon in JSON ShowItemSerializer

Codestech1
authored and
MelonHell
committed
chore: update ShowEntitySerializer to support the latest format

Codestech1
authored and
MelonHell
committed
chore: update HoverEventSerializer to support the latest format

Codestech1
authored and
MelonHell
committed
chore: add missing options to the NBTSerializerOptions

Codestech1
authored and
MelonHell
committed
chore: apply new serializing system of click events and hover events in StyleSerializer

Codestech1
authored and
MelonHell
committed
chore: update StyleSerializer fields to support the latest format

Codestech1
authored and
MelonHell
committed
chore: serialize and deserialize text decorations in loops

Codestech1
authored and
MelonHell
committed
chore: ensure order of serializing and use ComponentTreeConstants in NBTComponentSerializerImpl

Codestech1
authored and
MelonHell
committed
chore: do not serialize or deserialize "type" fields of components as it's obsolete

Codestech1
authored and
MelonHell
committed
chore: remove serialize/deserialize data sources TODO

Codestech1
authored and
MelonHell
committed
feat: add an option for emitting default nbt component interpret value

Codestech1
authored and
MelonHell
committed
chore: remove redundant cast in NBTSerializerUtils#getRequiredTag

Codestech1
authored and
MelonHell
committed
chore: fix spacing in NBTSerializerUtils

Codestech1
authored and
MelonHell
committed
chore: vanilla-like component children serializing

Codestech1
authored and
MelonHell
committed
chore: vanilla-like translatable component arguments serializing

Codestech1
authored and
MelonHell
committed
chore: add missing license headers and update to 2025

Codestech1
authored and
MelonHell
committed
chore: use TextDecoration#values for style decoration serialization (order does not matter in NBT since compound tags use maps)

Codestech1
authored and
MelonHell
committed
chore: use option schema for NBT serializer options instead

Codestech1
authored and
MelonHell
committed
feat: deserializing components from list binary tags

Codestech1
authored and
MelonHell
committed
feat: deserialize and serialize legacy additional data of show item hover events

Codestech1
authored and
MelonHell
committed
chore: make the code consistent

Codestech1
authored and
MelonHell
committed
feat: initial versioned option state with options for 23w40a

Codestech1
authored and
MelonHell
committed
feat: support plain string show-item hover events in deserialization

Codestech1
authored and
MelonHell
committed
feat: add 24w09a version to the versioned option state

Codestech1
authored and
MelonHell
committed
feat: add 24w44a version to the versioned option state

Codestech1
authored and
MelonHell
committed
feat: add 25w02a version to the versioned option state

Codestech1
authored and
MelonHell
committed
chore: remove unneeded options

Codestech1
authored and
MelonHell
committed
chore: replace ClickEventSerializer#deserializeCamel and ClickEventSerializer#deserializeSnake methods with ClickEventSerializer#deserialize to be more consistent with StyleSerializer

Codestech1
authored and
MelonHell
committed
chore: add TODO messages about show_text field names in HoverEventSerializer

Codestech1
authored and
MelonHell
committed
chore: review whether the serialization matches Minecraft 23w40a and 1.21.6 serialization

Codestech1
authored and
MelonHell
committed
chore: remove all previous tests

Codestech1
authored and
MelonHell
committed
feat: text component serialization test

Codestech1
authored and
MelonHell
committed
chore: use ComponentTreeConstants instead for field names in TextComponentTest

Codestech1
authored and
MelonHell
committed
feat: translatable component serialization test

Codestech1
authored and
MelonHell
committed
chore: make TextComponentTest package-private

Codestech1
authored and
MelonHell
committed
feat: keybind component serialization test

Codestech1
authored and
MelonHell
committed
feat: score component serialization test

Codestech1
authored and
MelonHell
committed
feat: selector component serialization test

Codestech1
authored and
MelonHell
committed
feat: block NBT component serialization test

Codestech1
authored and
MelonHell
committed
feat: entity NBT component serialization test

Codestech1
authored and
MelonHell
committed
feat: storage NBT component serialization test

Codestech1
authored and
MelonHell
committed
feat: component style serialization test, chore: use jetbrains not-null annotations instead

Codestech1
authored and
MelonHell
committed
feat: add a test for deserializing component from lists, fix: deserializing from lists does not support heterogeneous lists

Codestech1
authored and
MelonHell
committed
feat: show entity serialization test

Codestech1
authored and
MelonHell
committed
feat: show item serialization test

Codestech1
authored and
MelonHell
committed
chore: cleanup tests

Codestech1
authored and
MelonHell
committed
feat: legacy hover event deserializing

Codestech1
authored and
MelonHell
committed
chore: replace Key serialization with KeySerializer

Codestech1
authored and
MelonHell
committed
chore: resolve TODOs

Codestech1
authored and
MelonHell
committed
chore: cleanup

Codestech1
authored and
MelonHell
committed
chore: fix style of the main module

Codestech1
authored and
MelonHell
committed
chore: fix style of the test module

Codestech1
authored and
MelonHell
committed
fix: spotless task is failing

Codestech1
authored and
MelonHell
committed
fix: lists are not serialized as arrays when it is possible (vanilla does that)

Codestech1
authored and
MelonHell
committed
fix(nbt): TagStringWriter does not write compound entries in vanilla order

Codestech1
authored and
MelonHell
committed
chore: replace NBTSerializerOptions#SHADOW_COLOR_MODE with NBTSerializerOptions#EMIT_SHADOW_COLOR, fix: versioned option state of NBTSerializerOptions serializes shadow color as a list by default

Codestech1
authored and
MelonHell
committed
fix: optimized lists are emitted on 25w04a and above

Codestech1
authored and
MelonHell
committed
chore: replace adventure version references in the NBT Serializer from "4.24.0" to "4.25.0"

Codestech1
authored and
MelonHell
committed