Introduksjon til HOCON

HOCON (Human-Optimized Config Object Notation) is an easy-to-use configuration format. It is used by Sponge and individual plugins utilizing the Sponge API to store important data, such as configuration or player data. HOCON files typically use the suffix .conf.

Komponenter

  • en nøkkel er en tekststreng som kommer før en verdi

  • en verdi er en streng, et tall, et objekt, en liste eller en boolsk verdi som etterfølger en nøkkel

  • en nøkkel-verdi-separator deler nøkler fra verdier, og kan være enten : eller =

  • en kommentar begynner med # eller //, og brukes vanligvis til å gi tilbakemelding eller instruksjoner

Eksempel:

yellow-thing: "Sponge"

I dette eksempelet er nøkkelen lik yellow-thing, og verdien er Sponge. Nøkkel-verdi-separatoren er :.

Jobbe med HOCON

HOCON er mer fleksibelt enn JSON-formatet (JavaScript Object Notation, JavaScript-objektnotasjon) i den forstand at det er flere måter å skrive riktig HOCON. Nedenfor er to eksempler på gyldig HOCON.

Eksempel 1:

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

Eksempel 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 the Sponge API, the values are likely the only thing you will be changing unless otherwise specified.

Finne feil i konfigurasjonen din

Her er noen tips hvis det virker som en HOCON-konfigurasjon ikke fungerer.

  • Krøllparenteser må være balanserte

  • Sitattegn må være balanserte

  • Dupliserte nøkler som dukker opp lenger ned i konfigurasjonen overskriver de som står lenger opp

Spesifikasjon

Mer informasjon om HOCON-formatet kan du finne her.