Prickle Mod untuk Minecraft 1.21, 26.3

Prickle adalah format konfigurasi berbasis JSON. Mod ini memungkinkan format tersebut digunakan di Minecraft! Untuk dokumentasi teknis, silakan lihat halaman GitHub.

Apa keunggulan yang ditawarkan Prickle? Prickle berbasis JSON tetapi menambahkan beberapa fitur berguna seperti komentar dan decorator. Prickle 100% kompatibel mundur dengan JSON dan mendukung semua fitur, alat, dan penyorotan sintaksisnya.

Mengapa ini disebut Prickle? Prickle adalah kata kolektif untuk sekelompok landak. Landak adalah salah satu hewan favorit saya dan menurut saya mereka adalah metafora yang cocok untuk file konfigurasi. Misalnya, keduanya mungkin tampak menakutkan pada awalnya tetapi bisa menyenangkan setelah Anda mengenal dan memahaminya.

Mengapa tidak menggunakan format yang sudah ada? Di masa lalu saya menggunakan JSON untuk file konfigurasi saya tetapi ada beberapa masalah seperti kurangnya komentar dan nilai default. Prickle menambahkan fitur-fitur ini ke JSON sambil tetap 100% kompatibel mundur. Saya telah mencoba format lain seperti TOML tetapi kecewa dengan banyak implementasi Java-nya. Mereka sering kali kekurangan fitur yang menurut saya penting, memiliki bug serius, dan tidak lagi dipelihara. Minecraft sudah menggunakan JSON untuk datapack dan perintah, sehingga menjadi pilihan yang familier bagi sebagian besar pemain.

Spesifikasi Format

Dalam Prickle, nilai properti dibungkus dalam objek JSON. Ini memungkinkan metadata seperti komentar dikaitkan dengan properti tersebut.

Sebagai contoh, file JSON standar akan terlihat seperti ini.

{ "databasehost": "192.168.1.222" }

JSON yang sama sebagai file Prickle akan terlihat seperti ini.

{ "databasehost": { "//": "Alamat IP database yang akan dihubungi.", "value": "192.168.1.222" } }

Komentar

Kunci // disediakan untuk komentar. Komentar hanya digunakan untuk memberikan konteks tambahan kepada pembaca dan tidak boleh memengaruhi cara file diurai. Komentar dapat berupa string JSON atau array string untuk komentar multibaris.

{ "databasehost": { "//": [ "Alamat IP database yang akan dihubungi.", "Port dapat ditentukan di akhir menggunakan :" ], "value": "192.168.1.222:1273" } }

Decorator

Decorator adalah komentar bernama yang menyampaikan atribut tertentu dari properti. Contoh umum decorator adalah //default yang dapat digunakan untuk menampilkan nilai default dari properti. Seperti komentar, decorator tidak memengaruhi cara file diurai, mereka hanya menjelaskan bagaimana properti akan diurai.

Anda mungkin menemukan beberapa decorator berikut dalam file prickle.

• //default - Nilai default dari properti.
• //reference - Sumber daya yang dapat digunakan untuk mempelajari lebih lanjut, seperti tautan ke halaman wiki.
• //range - Rentang yang dapat diterima untuk suatu nilai. Misalnya >=5.
• //regex - Pola regex yang harus cocok dengan nilai.
• //empty-allowed - Apakah nilai boleh kosong atau tidak. (default adalah true).

Sponsor

Proyek ini disponsori oleh Nodecraft. Gunakan kode DARKHAX untuk diskon 30% untuk bulan pertama layanan Anda!