Pengantar ke HTML

HOCON (Human-Optimized Config Object Notation) is an easy-to-use configuration format. It is used by Sponge and individual plugins utilizing SpongeAPI to store important data, such as configuration or player data. HOCON files typically use the suffix .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
}

In practice, it is best to follow the formatting conventions of the HOCON configuration you are editing. When editing a HOCON configuration for Sponge or an individual plugin utilizing SpongeAPI, the values are likely the only thing you will be changing unless otherwise specified.

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.