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 nilai

  • nilai merupakan sebuah string, angka, objek, susunan, atau boolean yang mengikuti sebuah kunci

  • 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.