Minecraft 1.21, 26.3用Prickle MOD

PrickleはJSONベースの設定フォーマットです。このMODを使うと、そのフォーマットをMinecraftで利用できるようになります！技術的なドキュメントについてはGitHubページをご覧ください。

よくある質問

Prickleにはどんな利点がありますか？PrickleはJSONをベースにしていますが、コメントやデコレーターなど、いくつかの便利な機能を追加しています。PrickleはJSONと100%後方互換性があり、そのすべての機能、ツール、シンタックスハイライトをサポートしています。

なぜPrickleという名前なのですか？Prickleはハリネズミの群れを指す集合名詞です。ハリネズミは私のお気に入りの動物の一つで、設定ファイルの比喩としてぴったりだと思います。たとえば、どちらも最初は威圧的に見えるかもしれませんが、知って理解すれば親しみやすくなります。

なぜ既存のフォーマットを使わないのですか？以前は設定ファイルにJSONを使っていましたが、コメントやデフォルト値の欠如など、いくつかの問題がありました。Prickleはこれらの機能をJSONに追加しつつ、100%後方互換性を保っています。TOMLのような他のフォーマットも試しましたが、そのJava実装の多くに失望しました。それらは私が重要だと考える機能を欠いていることが多く、深刻なバグがあり、もはやメンテナンスされていません。MinecraftはすでにデータパックやコマンドにJSONを使用しているため、ほとんどのプレイヤーにとって馴染みのある選択肢です。

フォーマット仕様

Prickleでは、プロパティの値はJSONオブジェクトでラップされます。これにより、コメントなどのメタデータをそのプロパティに付与できます。

たとえば、標準的なJSONファイルは次のようになります。

{ "databasehost": "192.168.1.222" }

同じJSONをPrickleファイルにすると次のようになります。

{ "databasehost": { "//": "The IP address of the database to connect to.", "value": "192.168.1.222" } }

コメント

//キーはコメント用に予約されています。コメントは読者に追加の文脈を提供するためだけに使われ、ファイルの解析方法に影響を与えてはいけません。コメントはJSON文字列、または複数行コメント用の文字列の配列にできます。

{ "databasehost": { "//": [ "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を使うと、最初の1か月のサービスが30%オフになります！