配置

配置定义了可以应用于模组实例的设置和Consumer偏好。Forge使用一个采用TOML文件的配置系统，并使用NightConfig进行读取。

创建一个配置

可以使用IConfigSpec的子类型创建配置。Forge通过ForgeConfigSpec实现该类型，并通过ForgeConfigSpec$Builder实现其构造。生成器可以通过Builder#push创建一个部分，通过Builder#pop留下一个部分以将配置值分隔为多个部分。之后，可以使用以下两种方法之一构建配置：

// 在某个配置类中
ExampleConfig(ForgeConfigSpec.Builder builder) {
  // 在此处在final字段中定义值
}

// 在该构造函数可被访问的某处
static {
  Pair<ExampleConfig, ForgeConfigSpec> pair = new ForgeConfigSpec.Builder()
    .configure(ExampleConfig::new);
  // 在某个常量字段中存储成对的值
}

可以为每个配置值提供额外的上下文，以提供额外的行为。必须先定义上下文，然后才能完全生成配置值：

ConfigValue

配置值可以使用所提供的上下文（如果已定义）使用任何#define方法构建。

所有配置值方法都至少接受两个组件：

• 表示变量名称的路径：一个被.分隔的字符串，表示配置值所在的部分
• 不存在有效配置时的默认值

特定于ConfigValue的方法包含两个附加组件：

• 用于确保反序列化对象有效的验证器
• 表示配置值的数据类型的类

// 对于某个ForgeConfigSpec$Builder生成器
ConfigValue<T> value = builder.comment("Comment")
  .define("config_value_name", defaultValue);

可以使用ConfigValue#get获取值本身。这些值会被额外缓存，以防止从文件中进行多次读取。

附加的配置值类型

• 范围值
  • 描述: 值必须在所定义的范围之间
  • 类型: Comparable<T>
  • 方法名称: #defineInRange
  • 附加组件:
  • 配置值可能的最小值和最大值
  • 表示配置值的数据类型的类

• 白名单值

  • 描述: 值必须在所提供的集合中
  • 类型: T
  • 方法名称: #defineInList
  • 附加组件:
  • 配置所允许的值的集合

• 列表值

  • 描述: 值是一个条目列表
  • 类型: List<T>
  • 方法名称: #defineList，#defineListAllowEmpty（如果列表可为空）
  • 附加组件:
  • 用于确保列表中反序列化元素有效的验证器

• 枚举值

  • 描述: 在所提供的集合中的一个枚举值
  • 类型: Enum<T>
  • 方法名称: #defineEnum
  • 附加组件:
  • A getter to convert a string or integer into an enum
  • A collection of the allowed values the configuration can be

• 布尔值

  • 描述: A boolean value
  • 类型: Boolean
  • 方法名称: #define

注册一个配置

一旦构建了ForgeConfigSpec，就必须对其进行注册，以允许Forge根据需要加载、跟踪和同步配置设置。配置应通过ModLoadingContext#registerConfig在模组构造函数中注册。配置可以注册为表示配置所属侧的给定类型ForgeConfigSpec，以及配置的特定文件名（可选）。

// 在具有一个ForgeConfigSpec CONFIG的模组构造函数中
ModLoadingContext.get().registerConfig(Type.COMMON, CONFIG);

以下是可用的配置类型的列表：

配置事件

每当加载或重新加载配置时发生的操作可以使用ModConfigEvent$Loading和ModConfigEvent$Reloading事件来完成。事件必须注册到模组事件总线。