Cryonic Config

• Кроссплатформенный инструмент для конфигов, лёгкий в портировании, с минимумом зависимостей
• Главная цель — простота использования и портируемость
• Cryonic, потому что это чертовски круто

Описание функционала

• Сохраняет json-файлы в {minecraft_dir}/config под именем "mod_id.json"
• Все конфиг-файлы считываются словарём из "cryonicconfig.json" на ранней инициализации
• Конфиги настраиваются только прямым редактированием json, GUI-конфига не планируется
• Для удобства портирования синхронизируемые переменные отправляются игроку прямо в чат и перехватываются
• Используются хэшмапы для поиска Str → ConfigStorage и Str → Obj (переменная)

API

Groovy (build.gradle) Добавление зависимости

Добавьте Maven:

repositories {
    maven { url "https://api.modrinth.com/maven" }
}

Modern/Architectury: Только для fabric или neoforge — замените ${project.name} на fabric, forge, neoforge

dependencies {
    modImplementation "maven.modrinth:cryonicconfig:fabric-${project.name}:1.0.0+mc${rootProject.minecraft_version}"
}

b1.7.3:

dependencies {
    modImplementation "maven.modrinth:cryonicconfig:babric:1.0.0+mcb1.7.3"
}

Простое использование:

// Можно сохранить или использовать на лету, вызывать можно где угодно
ConfigStorage config = CryonicConfig.getConfig("mod_id");

// Можно хранить int, double, boolean и строки
// При получении вы также задаёте их значение по умолчанию
// формат геттера (имя переменной, значение по умолчанию)
// Нельзя переиспользовать имена переменных! Они будут перезаписаны.
config.getInt("varName", 3);
config.getDouble("name", 3.3);
config.getBoolean("var", true);
config.getString("str", "Geronimo!")

// Переменная будет существовать локально на клиенте и сервере
// Если вы хотите, чтобы подключённый игрок использовал серверный конфиг,
// нужно вызвать это, чтобы клиент использовал значение сервера
config.sync("varName", playerEntity);

// Смело используйте такой формат:
CryonicConfig.getConfig("mod_id").getInt("varName", 3);

// Можно задавать переменные вручную, вместо того чтобы позволять get создавать их
// Это также полезно для перезаписи старых значений
config.setInt("varName", 3);
config.setDouble("name", 3.3);
config.setBoolean("var", true);
config.setString("str", "Geronimo!");

Пометка зависимости

В fabric.mod.json:

{
  "depends": {
    "cryonicconfig": "*"
  }
}

В mods.toml/neoforge.mods.toml:

[[dependencies.cryonicconfig]]
modId = "cryonicconfig"
type = "required"
versionRange = "[0,)"