Konfigurations-Format

Die SpongeAPI unterstützt die Serialisierung von Texten in eine Configurate Konfigurationsdatei durch die Verwendung der TypeToken Klasse. Text Objekte werden genauso gespeichert wie die JSON Repräsentation des Text es.

Tipp

Für mehr Informationen wie du Configurate für Konfigurationsdateien für dein Plugin verwendest, halte dich bitte an die Plugins konfigurieren Dokumentation.

Zum Beispiel der unterstrichene und rot formatierte Text „Hello World!“ hätte die folgende HOCON Repräsentation:

{
    underlined=true
    color=red
    text="Hello, world!"
}

Um ein Text Objekt zu speichern, reicht es den Wert entsprechend des Beispiels in den gewünschten Knoten zu setzen:

import com.google.common.reflect.TypeToken;
import ninja.leaping.configurate.ConfigurationNode;
import org.spongepowered.api.text.Text;
import org.spongepowered.api.text.format.TextColors;
import org.spongepowered.api.text.format.TextStyles;

ConfigurationNode node = loader.load();
Text text = Text.of(TextColors.RED, TextStyles.UNDERLINE, "Hello World!");
node.getNode("mytext").setValue(TypeToken.of(Text.class), text);
loader.save(node);

Man kann dann ein Text Objekt mithilfe des folgenden Codes laden:

Text text = node.getNode("mytext").getValue(TypeToken.of(Text.class));

Bemerkung

Diese Strategie ist nicht begrenzt auf den HoconConfigurationLoader, sondern funktioniert mit allen ConfigurationLoadern.