Serializers

Serializers are used to convert structured data between different formats.

Text Components

Prefer using Serialize methods on Component for serialization.

• ComponentJsonSerializer
  • Converts Text Component to Json or Json to Text Component.
• ComponentLegacySerializer
  • Converts Text Component to Legacy string or Legacy string to Text Component.
• ComponentNbtSerializer
  • Converts Text Component to Nbt or Nbt to Text Component.

NBT

Helpful to convert Json or Snbt to Nbt and vice versa.

• NbtJsonSerializer
  • Converts Nbt to Json or Json to Nbt.
• NbtStringSerializer -
  • Converts Nbt to Snbt or Snbt to Nbt.

Prefer deserializing from Snbt

Json is not recommended because its properties’ type conversion is guessed by bounds of the value.

{
    "value": 1
}

This ‘value’ number does not specify if it is a byte, short, int or long. So in deserialization time, parser checks if it fits in byte, short, int or long, and uses the first Nbt Tag Type that fits.

On the other hand, Snbt specifies concrete type of the value.

{
    value: 1b
}