Neoforge模组开发-Config

250 字

1 分钟

Neoforge模组开发-Config

2025-09-24

Minecraft/NeoForge

NeoForge

/

Minecraft

/

Modding

/

Java

Config用于存储模组的配置选项，允许用户在游戏内或通过配置文件进行调整。NeoForge提供了一个强大的配置系统，支持多种数据类型

Config的三种类型#

Server#

Server配置存储在服务端，会在客户端连接时同步，可在世界存档的serverconfig目录中单独配置，neoforge会优先读取存档中的配置，若不单独配置则默认在游戏的config目录下

Common#

Common配置存储在服务端和客户端，不会自动同步，适用于不需要同步的配置选项

Client#

Client配置存储在客户端，适用于仅影响客户端的选项（如gui等）

如何使用#

新建自己的Config类#

1
public class MyModConfig {
2

3
    private static final ModConfigSpec.Builder BUILDER = new ModConfigSpec.Builder();
4

5
    //...
6

7

8
    public static final ModConfigSpec SPEC = BUILDER.build();
9
}

配置项举例#

1
public class MyModConfig {
2

3
    private static final ModConfigSpec.Builder BUILDER = new ModConfigSpec.Builder();
4

5
    public static final ModConfigSpec.BooleanValue MY_CONFIG_1 = BUILDER
6

7
            .comment("This is my first config")
8

9
            .translation("mod_id.config.my_config_1")
10

11
            .define("myConfig1", false);
12

13
    //...
14

15
    public static final ModConfigSpec SPEC = BUILDER.build();
16
}