Pengantar ke HTML
HOCON (Human-Optimized Config Object Notation) merupakan format konfigurasi yang mudah digunakan. Format ini digunakan oleh Sponge dan plugin pribadi memanfaatkan Spong API untuk menyimpan data penting, seperti konfigurasi atau data player. File HOCON umumnya menggunakan akhiran kata .conf
.
Komponen
kunci
merupakan sebuah string yang mengikuti suatu nilainilai
merupakan sebuah string, angka, objek, susunan, atau boolean yang mengikuti sebuahkunci
key-value separator
memisahkan kunci-kunci dari nilai-nilai, dan bisa berbentuk:
atau=
comment
merupakan awalan dengan tanda#
atau//
, umumnya berfungsi untuk memberikan umpan balik atau instruksi
Contoh
yellow-thing: "Sponge"
Dalam contoh ini, Key
merupakan sesuatu-yang kuning
, value
merupakan Sponge
, dan key-value separator
merupakan :
.
Bekerja dengan header
HOCON lebih fleksibel dibandingkan dengan format JSON (JavaScript Object Notation) dimana ada beberapa cara untuk menulis HOCON yang benar. Berikut adalah dua contoh dari HOCON yang benar.
Contoh #1:
player: {
name: "Steve",
level: 30
}
Contoh #2:
player {
name = "Steve"
level = 30
}
Pada prakteknya, lebih baik mengikuti format yang sudah biasa dari konfigurasi HOCON yang anda edit. Saat meng-edit konfigurasi HOCON untuk Sponge atau sebuah plugin pribadi dengan memanfaatkan SPonge API, kemungkinan hanya nilai yang akan anda rubah kecuali telah dispesifikasikan sebaliknya.
Uji konfigurasi Anda
Jika konfigurasi HOCON kelihatanya tidak bekerja, berikut ada beberapa petunjuk.
Kurung kurawal harus seimbang
Kutip harus seimbang
Duplikat kunci yang muncul kemudian didahulukan
Spesifik persyaratan
Informasi lebih lanjut tentang format HOCON bisa didapatkan disini.