Формат конфигурации

SpongeAPI offers support to serialize text directly to a Configurate configuration file through the use of the TypeToken class. Text objects are saved using the same node structure as the Text's Формат JSON, but in a more flexible format called Human-Optimized Config Object Notation (HOCON).

Совет

Информацию о том, как использовать Configurate для создания файлов конфигурации вашего плагина, можно найти в статье Настройка плагинов.

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

{
    underlined=true
    color=red
    text="Hello World!"
}

Чтобы сохранить объект Text, просто задайте значение нужного узла, используя следующий код:

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);

Затем вы можете загрузить объект Text, используя следующий код:

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

Примечание

Эта стратегия не ограничивается HoconConfigurationLoader; любого ConfigurationLoader будет достаточно.