配置 Sponge

This article is about configuring Sponge itself; plugins will usually create their own configuration files inside the server “config” directory. For Vanilla configuration check out the Minecraft Wiki.

Sponge 配置文件

Sponge 有若干配置文件，可在你的服务器根目录下的 config/sponge/ 目录中找到：

tracker.conf
custom_data.conf
global.conf 及 worlds 目录下对应维度和世界里的子配置文件

Sponge 的全局配置储存在 global.conf 文件中。它包含的配置选项也可以通过 config/worlds 目录下特定世界或维度目录中对应的配置文件中的配置来覆盖。

tracker.conf 可用于配置 Phase Tracker，而 custom_data.conf 可用于管理插件添加的自定义数据。

使用文本编辑器编辑配置文件

用你喜欢的编辑器打开目标文件即可。Sponge 配置文件使用 HOCON 格式，关于它的更多信息可在“HOCON 简介”一文中找到。

在完成你需要的修改后，保存配置文件。如果你是在服务器运行时修改的配置文件，你需要按照下文描述的方式重载配置文件。例如，在编辑完 global.conf` 后，应执行 ``/sponge reload -g 命令重载 global.conf。

覆盖全局配置

你可以通过“子配置文件”来在某个维度或世界中覆盖全局配置的某些选项，比如可以只在原版下界中抬高刷怪量。你可以在 Sponge 主配置目录中的 worlds 目录下找到针对每一个世界和维度的配置。这些配置依所属的 Mod 以及维度类型排序。按需修改对应的配置文件并重载后即可让配置在所有相关世界中生效，并覆盖上一级的配置中的对应选项。覆盖的顺序是：世界配置 > 维度配置 > 全局配置。

使用命令编辑配置文件

你可以通过游戏内命令 /sponge config 来修改绝大多数配置选项。该命令的语法如下：

/sponge config <flag> <key> <value>

下列几个“标记”（flag）可用于指定要修改的目标配置文件：

-g 标记全局配置（global.conf）
-d <dim> 标记目标维度配置（dimension.conf）
-w <world> 标记目标世界配置（world.conf）
-t 标记追踪器配置（tracker.conf）

你需要把 <name> 换成合适的目标名称，比如 -d minecraft:nether。

key 代表你想改变的选项，value 则代表具体选项的值。比如说，如果你想把 config/sponge/minecraft/nether/dimension.conf 中的 chunk-load 改成 true：

sponge {
    logging {
        # Log when chunks are loaded
        chunk-load=false
    }
}

你需要这样执行命令：

/sponge config -d minecraft:nether logging.chunk-load true

如果你需要检查一个键对应的值，省略值的部分即可。举个例子，如果我们要检查下界的配置中 logging.chunk-load 对应的值，我们可以这么做：

/sponge config -d minecraft:nether logging.chunk-load

保存配置

在完成配置后需要把世界配置保存到文件中。这一做法的意义是防止意外的服务端崩溃。可以在 Sponge 服务器上使用 /sponge save 命令保存配置。其对应命令的格式就像用于配置的命令一样：

/sponge save <flag>

下面是用于保存全局配置的一个示例：

/sponge save -g

重新加载配置

有时候你可能需要在服务器运行的时候重新加载配置，尤其是在你编辑完本机上的配置文件，需要将其部署到正在运行的服务器上时，这样一个功能能省不少事。你可以使用 /sponge reload 命令完成这件事，就像这样：

/sponge reload <flag>

下面是重新加载末地配置文件的示例：

/sponge reload -d minecraft:the_end