Prickle 是一种基于 JSON 的配置格式。此模组允许在 Minecraft 中使用该格式!如需技术文档,请参阅 GitHub 页面。
Prickle 是一种基于 JSON 的配置格式。此模组允许在 Minecraft 中使用该格式!如需技术文档,请参阅 GitHub 页面。 常见问题解答 Prickle 提供哪些优势? Prickle 基于 JSON,但增加了注释和装饰器等几个有用功能。Prickle 与 JSON 完全向后兼容,并支持其所有功能、工具和语法高亮。 为什么叫 Prickle? Prickle 是刺猬群的集体名词。刺猬是我最喜欢的动物之一,我认为它们是配置文件的恰当隐喻。例如,它们起初可能看起来令人望而生畏,但一旦你了解并理解它们,就会发现它们其实很友好。 为什么不使用现有格式? 过去我曾使用 JSON 作为配置文件,但存在几个问题,例如缺少注释和默认值。Prickle 在保持与 JSON 完全向后兼容的同时增加了这些功能。我尝试过其他格式如 TOML,但对它们的许多 Java 实现感到失望。它们往往缺少我认为重要的功能,存在严重漏洞,且不再维护。Minecraft 已经为数据包和命令使用 JSON,使其成为大多数玩家熟悉的选择。 格式规范 在 Prickle 中,属性值被包裹在一个 JSON 对象中。这允许将元数据(如注释)归属于该属性。 例如,一个标准的 JSON 文件如下所示。 { "database_host": "192.168.1.222" } 相同的 JSON 作为 Prickle 文件如下所示。 { "database_host": { "//": "The IP address of the database to connect to.", "value": "192.168.1.222" } } 注释 The // key 保留用于注释。注释仅用于为读者提供额外的上下文,绝不应影响文件的解析方式。注释可以是 JSON 字符串,也可以是用于多行注释的字符串数组。 { "database_host": { "//": [ "The IP address of the database to connect to.", "The port can be defined at the end using an :" ], "value": "192.168.1.222:1273" } } 装饰器 装饰器是用于传达属性特定属性的命名注释。装饰器的一个常见示例是 //default 可用于显示属性的默认值。与注释类似,装饰器不会影响文件的解析方式,它们仅描述属性将如何被解析。 您可能会在 prickle 文件中遇到以下某些装饰器。 //default - 属性的默认值。 //reference - 可用于了解更多信息的资源,例如指向 wiki 页面的链接。 //range - 值的可接受范围。例如 >=5。 //regex - 值必须匹配的正则表达式模式。 //empty-allowed - 值是否可以为空。(默认为 true)。 赞助商 本项目由 Nodecraft 赞助。使用代码 DARKHAX 可享首月服务 30% 折扣!
在鱼乐云资源中心浏览该资源,登录后可一键安装到你的游戏服务器。