Prickle Mod za Minecraft 1.21, 26.3

Prickle je JSON format za konfiguraciju. Ovaj mod omogućava korišćenje tog formata u Minecraft-u! Za tehničku dokumentaciju pogledajte GitHub stranicu.

Često postavljana pitanja

Koje prednosti nudi Prickle? Prickle se zasniva na JSON-u, ali dodaje nekoliko korisnih funkcija kao što su komentari i dekoratori. Prickle je 100% kompatibilan unazad sa JSON-om i podržava sve njegove funkcije, alate i isticanje sintakse.

Zašto se zove Prickle? Prickle je zbirna imenica za grupu ježeva. Ježevi su jedna od mojih omiljenih životinja i smatram da su prikladna metafora za konfiguracione fajlove. Na primer, oba mogu na prvi pogled delovati zastrašujuće, ali mogu biti prijatni kada ih upoznate i razumete.

Zašto ne koristiti postojeći format? U prošlosti sam koristio JSON za svoje konfiguracione fajlove, ali bilo je nekoliko problema kao što su nedostatak komentara i podrazumevanih vrednosti. Prickle dodaje te funkcije JSON-u dok ostaje 100% kompatibilan unazad. Probao sam druge formate poput TOML-a, ali sam bio razočaran mnogim njihovim Java implementacijama. Često im nedostaju funkcije koje smatram važnim, imaju ozbiljne greške i više se ne održavaju. Minecraft već koristi JSON za datapack-ove i komande, što ga čini poznatim izborom za većinu igrača.

Specifikacije formata

U Prickle-u su vrednosti svojstava umotane u JSON objekat. To omogućava da se metapodaci poput komentara pripišu tom svojstvu.

Na primer, standardni JSON fajl bi izgledao ovako.

{ "databasehost": "192.168.1.222" }

Isti JSON kao Prickle fajl bi izgledao ovako.

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

Komentari

Ključ // je rezervisan za komentare. Komentari se koriste samo za pružanje dodatnog konteksta čitaocu i nikada ne bi trebalo da utiču na način na koji se fajl parsira. Komentari mogu biti JSON string ili niz stringova za komentare u više redova.

{ "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" } }

Dekoratori

Dekoratori su imenovani komentari koji prenose određeni atribut svojstva. Čest primer dekoratora je //default koji se može koristiti za prikaz podrazumevane vrednosti svojstva. Kao i komentari, dekoratori nemaju uticaja na način na koji se fajl parsira, oni samo opisuju kako će svojstvo biti parsirano.

U prickle fajlovima možete naići na neke od sledećih dekoratora.

• //default - Podrazumevana vrednost svojstva.
• //reference - Resurs koji se može koristiti za dodatno učenje, kao link do wiki stranice.
• //range - Prihvatljiv opseg za vrednost. Na primer >=5.
• //regex - Regex obrazac koji vrednost mora da zadovolji.
• //empty-allowed - Da li vrednost može biti prazna ili ne. (podrazumevano je true).

Sponzori

Ovaj projekat sponzoriše Nodecraft. Iskoristite kod DARKHAX za 30% popusta na prvi mesec usluge!