Wprowadzenie do HOCON

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.

Element

  • klucz to string (ciąg znaków) identyfikujący wartość
  • wartość to string, liczba, obiekt, tablica albo boolean przypisany do klucza
  • separator oddziela klucze od ich wartości, może nim być : lub =
  • komentarz zaczyna się od # lub //, zwykle wykorzystywany jest do umieszczenia dodatkowych informacji lub instrukcji

Przykład:

yellow-thing: "Sponge"

W tym przykładzie kluczem jest yellow-thing, wartością jest Sponge, a separatorem jest :.

Praca z HOCON

HOCON is more flexible than the JSON (JavaScript Object Notation) format in that there are several ways to write valid HOCON. Below are two examples of valid HOCON.

Przykład #1:

player: {
    name: "Steve",
    level: 30
}

Przykład #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.

Debugowanie konfiguracji

Jeżeli konfiguracja HOCON zdaje się nie działać, zobacz poniższe wskazówki.

  • Wszystkie nawiasy klamrowe muszą być domknięte
  • Wszystkie cudzysłowy muszą być domknięte
  • Jeśli klucze się powtarzają to pod uwagę barany jest ten występujący najpóźniej

Specyfikacja

More information about the HOCON format can be found here.