JSON Format

JSON is JavaScript Object Notation, a „light-weight data-interchange format” that is „easy for humans to read and write” and „for machines to parse and generate”. The JSON web site details the structure of text represented in the JSON format. In addition, the Minecraft Wiki provides Minecraft-related information about JSON files.


The data are stored in structures called trees. Each data point on a tree is a node. See Configuration Nodes for more information on this topic.

For example, the text "Hello World!", formatted with the color red and an underline, would have the following representation in JSON:

    "text":"Hello World!"

This output can be produced using the following code:

import org.spongepowered.api.text.Text;
import org.spongepowered.api.text.format.TextColors;
import org.spongepowered.api.text.format.TextStyles;
import org.spongepowered.api.text.serializer.TextSerializers;

Text text = Text.of(TextColors.RED, TextStyles.UNDERLINE, "Hello World!");
String jsonText = TextSerializers.JSON.serialize(text);