HOCON 简介

HOCON（Human-Optimized Config Object Notation）是一个易于使用的配置文件格式。它被用于 Sponge 以及利用 SpongeAPI 的独立插件以储存重要的数据，比如配置或者玩家数据。HOCON 文件通常以 .conf 作为后缀名。

组成部分

• 一个 key 是一个键值对字符串中的前一个值

• 一个 value 可以是字符串、数字、对象、数组或者布尔值并紧随 key 的后面

• 一个 key-value separator 把键和值分离，可以是 : 或者 =

• 一个 comment 以 # 或者 // 开头，通常用于提供反馈或说明

示例：

yellow-thing: "Sponge"

在这一示例中，key 是 yellow-thing，value 是 Sponge，而 key-value separator 是 :。

使用 HOCON

HOCON 要比 JSON（JavaScript Object Notation）更灵活，因为书写一个合法的 HOCON 的方式要更多。下面是两个合法的 HOCON 的例子。

示例一：

player: {
    name: "Steve",
    level: 30
}

示例二：

player {
    name = "Steve"
    level = 30
}

在实际使用中，最好遵守你正在编辑的 HOCON 的格式约定。当你在编辑 Sponge 以及利用 SpongeAPI 的独立插件的 HOCON 配置文件的时候，除了值（Value）之外，其他的内容如无特殊要求，请不要动。

调试你的配置

如果 HOCON 配置文件似乎不会工作，这里有一些小提示。

• 花括号必须匹配

• 引号必须匹配

• 如果两个键重复，以后出现的为准

技术规范

在这里可以找到有关 HOCON 配置文件格式的更多信息。