Introduction à HOCON
HOCON (Human-Optimized Config Object Notation) est un format de configuration simple à utiliser. Il est utilisé par Sponge et ses plugins pour stocker des informations importantes, tel que les configurations ou les données des joueurs. Les fichiers HOCON sont typiquement suivis de l’extension .conf
.
Composants
une
key
est une chaîne de caractères identifiant une valeurune
value
est une chaîne de caractère, un nombre, un objet, un tableau, ou un booléen associé à unekey
un
key-value separator
sépare les clés des valeurs, et peut soit être un:
soit un=
un
comment
est précédé d’un#
ou d’un//
, ils servent surtout à fournir des informations ou des retours
Exemple:
yellow-thing: "Sponge"
Dans cet exemple, la key
est yellow-thing
, la value
est Sponge
, et le key-value separator
est :
.
Travailer avec HOCON
HOCON est plus souple que le format JSON (JavaScript Object Notation) car il existe plusieurs façons d’écrire des fichiers HOCON valides. Voici deux exemples de fichier HOCON valide.
Exemple n°1:
player: {
name: "Steve",
level: 30
}
Exemple n°2:
player {
name = "Steve"
level = 30
}
Dans la pratique, il est préférable de suivre les conventions typographiques de la configuration HOCON que vous êtes en train de modifier. Lorsque vous modifiez une configuration HOCON pour Sponge ou un plugin utilisant l’API Sponge, les valeurs sont probablement la seule chose vous devriez changer sauf indication contraire.
Debugger votre configuration
Si une configuration HOCON ne semble pas fonctionner, voici quelques conseils.
Toute accolade ouverte doit être fermée
Tout guillemet ouvert doit être fermé
Les clés dupliquées qui apparaissent en dernier sont prioritaires
Caractéristiques
Vous trouverez plus d’informations sur le format HOCON ici.