Cryonic Config - Cryonic Config 配置库

• 跨版本、易于移植且依赖极少的配置工具
• 特别注重易用性与可移植性
• 之所以叫 Cryonic，是因为它酷毙了

功能说明

• 这会将 json 文件存储在 {minecraftdir}/config 中，命名为 "modid.json"
• 所有配置文件都会在早期初始化时通过 "cryonicconfig.json" 中的字典读取
• 所有配置只能通过直接编辑 json 文件来修改，没有制作 GUI 配置界面的计划
• 为了便于移植，同步变量会直接通过聊天发送给玩家，并被拦截
• 使用 HashMap 来查找 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 和 string
// 在获取它们时，也会同时设置它们的默认值
// getter 格式：（变量名，默认值）
// 你不能重复使用变量名！它们会被覆盖。
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,)"