Skip to content

配置文件

配置开发的主要内容即创建与编写配置文件在开发配置的语境中,配置文件(或简称配置)是一系列包含了地形包的文件,能够控制 Terra 生成世界的方式。

文件格式

通常,配置文件要求其内的数据能够序列化,这就表示其格式通常为 JSON、XML 或是 YAML。

在 Terra 中,地形包的配置格式灵活多变,对它们的读取和判断均通过拓展实现——这允许开发者随意使用想要的格式。在地形包中的对应格式配置文件只会在安装对应语言拓展的情况下载入。

YAML

这是 Terra 配置支持的标准文件格式/标记语言,标准的 Terra 发行版自带对其支持的拓展模块。正因如此,YAML 是本维基的首选标记语言,所有示例配置与教程均使用它展示。

YAML 语言拓展会尝试载入地形包内所有 .yml 结尾的文件,同时其内容应当能被 YAML 判断器识别。

创建配置文件

如果你没有安装其他语言拓展,那么你可以先在地形包文件夹下创建一个 .yml 文件,作为标准的配置文件。

否则,在创建新文件的时候,你应当选择语言拓展支持的格式。

配置文件结构

通常来讲,配置文件的名称与地形包中的子文件夹不会被 Terra 读取。正因如此,你可以随意命名文件或组织文件夹结构。但包文件例外,它必须处于最上级目录中,且名称只能是 pack(不需要文件后缀)。

贡献者

页面历史