Premiers pas

Cette page vous aide à comprendre comment éditer correctement un fichier .yml (.yaml). Tous mes plugins utilisent des fichiers de configuration .yml, qui se réinitialiseront ou cesseront de fonctionner si vous les éditez incorrectement.

Ci-dessous, vous trouverez tous les types d'entrées de configuration et comment ils doivent être formatés si vous modifiez des valeurs.

Comment éditer les fichiers .yml

Les fichiers sont stockés au format .yml et Notepad++ est le logiciel d'édition de fichiers recommandé pour le travail de configuration. Bien sûr, vous pouvez utiliser n'importe quel autre éditeur de texte de votre choix.

Boolean

Les valeurs Boolean sont true ou false. Voici à quoi elles ressemblent :

value1: true
value2: false

Les Boolean n'acceptent que les valeurs true ou false. Ils sont généralement utilisés pour activer ou désactiver des fonctionnalités spécifiques.

String

Les valeurs String sont généralement du texte normal. Il est fortement recommandé de créer des valeurs String entre guillemets, en suivant ce format :

value: "String"

Bien que cela ne soit pas toujours obligatoire, c'est obligatoire pour toute chaîne contenant des codes de couleur, surtout si le premier caractère commence par un code de couleur. Les codes de couleur suivent le format de code de couleur du jeu ce qui signifie que "&aTest" donnerait un texte vert. La disponibilité du texte coloré varie selon le paramètre de configuration. Consultez cette page pour les codes de couleur.

Details

Pourquoi ?

Les chaînes de configuration peuvent accepter des caractères spéciaux tels que &. Si ces caractères spéciaux occupent le premier caractère, comme dans value: "&aString", si la String n'est pas entre guillemets, la valeur sera effacée et l'option de configuration sera réinitialisée à ses valeurs par défaut. Il s'agit d'une limitation du système de configuration utilisé par Spigot.

Serialized Location

Serialized Location est un type spécifique de String qui ressemble à ceci :

location: world,1.0,2.0,3.0,4.0,5.0

Ceux-ci sont utilisés pour stocker et configurer des emplacements. Il suit ce format : worldName,X,Y,Z,PITCH,YAW. Pitch et yaw déterminent simplement la direction vers laquelle le joueur regarde, et sont implémentés de la même manière que les emplacements Minecraft.

Multiplier

Les valeurs Multiplier multiplient les valeurs du plugin par ce nombre. Ces valeurs ne doivent jamais être entre guillemets. Voici un exemple :

damageMultiplier: 1.0

Dans ce cas, le multiplicateur de dégâts serait multiplié par 1, ce qui signifie qu'il n'y a aucun changement par rapport à la valeur par défaut. Si le Multiplier était 2.0, la valeur serait multipliée par 2.0. S'il était 0.5, il serait multiplié par 0.5.

Pour ceux qui ne sont pas bons avec les fractions, multiplier par 0.5 revient à diviser par 2. Les valeurs Multiplier doivent toujours être supérieures à 0 (0.0001 est valide) et n'ont généralement pas de limite supérieure.

Integer

Les valeurs Integer sont simplement des nombres entiers. Exemple :

value: 10

Vous pouvez randomiser ces valeurs pour les scripts en utilisant ~. Exemple :

value: 1~10

La principale chose à propos des valeurs Integer est qu'elles doivent être des nombres entiers. Cela signifie que 10.1 n'est pas valide.

Double

Les Double sont des nombres irrationnels. Exemple :

value: 10.01

Vous pouvez randomiser ces valeurs pour les scripts en utilisant ~. Exemple :

value: 1.0~10.01

Les Double peuvent également être des nombres entiers comme les integers, comme 10.0 ou même représentés comme 10.

Floats

Les Floats sont des nombres avec des points décimaux et peuvent stocker de nombreux décimales. Exemple :

value: 10.42452

Vous pouvez randomiser ces valeurs pour les scripts en utilisant ~. Exemple :

value: 1.0~10.42452

Les Double peuvent également être des nombres entiers comme les integers, comme 10.0 ou même représentés comme 10.

String List

Les String List sont des listes de valeurs String. Celles-ci ont tendance à être les valeurs les plus difficiles à configurer, car elles nécessitent un format de configuration très spécifique :

valuesList:
- "value,1"
- "value,2"
- "value,3"

Comme pour les String, il est recommandé de garder les valeurs entre guillemets. Chaque String List a son propre format, vous devrez donc trouver le format spécifique requis par celui que vous éditez ; cependant, globalement, c'est à quoi devrait ressembler le format général.

Map List

Les 'Map List' sont des listes de valeurs 'Map'. Celles-ci ne sont utilisées que dans le scripting elite et nécessitent ce format de configuration :

parentMap:
- Map1:
  key: value
- Map2:
  key: value
  keyForList:
    - "value1"
    - "value2"

Comme vous pouvez le voir, les Map Lists peuvent contenir n'importe quel type de format à l'intérieur, mais si vous les utilisez dans le scripting, vous devrez vous référer à la documentation pour voir quelles sont les clés et valeurs valides pour les différentes maps.

Color Codes

Vous pouvez également attribuer des couleurs ou mettre le texte en gras en utilisant les modificateurs suivants :

Code	Couleur	Exemple
&4	Rouge foncé	&4Exemple rouge foncé.
&c	Rouge	&cExemple rouge.
&6	Orange	&6Exemple orange.
&e	Jaune	&eExemple jaune.
&2	Vert foncé	&2Exemple vert foncé.
&a	Vert	&aExemple vert.
&b	Aqua	&bExemple aqua.
&3	Aqua foncé	&3Exemple aqua foncé.
&1	Bleu foncé	&1Exemple bleu foncé.
&9	Bleu	&9Exemple bleu.
&d	Violet clair	&dExemple violet clair.
&5	Violet foncé	&5Exemple violet foncé.
&f	Blanc	&fExemple blanc.
&7	Gris	&7Exemple gris.
&8	Gris foncé	&8Exemple gris foncé.
&0	Noir	&0Exemple noir.
&r	Réinitialiser couleur	&rExemple de réinitialisation.
&i	Gras	&iExemple gras.
&o	Italique	&oExemple italique.
&n	Souligné	&nExemple souligné.
&m	Barré	&mExemple barré.
&k	Aléatoire	&k &fexemple.

Comme vous pouvez le voir dans les exemples, les modificateurs suivent la syntaxe Minecraft régulière sauf que le § est remplacé par un & lorsqu'il est utilisé avec EliteMobs. Vous pouvez utiliser cela pour modifier la plupart du texte EliteMobs tel que les noms de mobs, le texte de quête, les noms de donjons, etc.

Notez que lorsqu'il fonctionne correctement, les modificateurs eux-mêmes ne s'afficheront pas dans votre texte. Ils ne sont affichés ici qu'à des fins de démonstration.

Il est également possible de combiner des couleurs et d'autres modificateurs de texte. Par exemple, vous pouvez faire :

&a&oPour obtenir du texte vert en italique.

Si nous voulions que notre mob personnalisé ait un joli nom coloré fantaisiste, nous ferions ce qui suit :

name: $normalBossLevel &aScary &dDragon

Material

Les valeurs Material sont simplement des Materials que vous pouvez trouver dans MineCraft, comme IRON_CHESTPLATE. Pour une liste de Material valides, consultez cette page.

helmet: IRON_HELMET

Les Material sont utilisés comme valeurs dans plusieurs paramètres tels que l'équipement pour les mobs, le butin, les récompenses de quête, etc.

Filename

Les valeurs Filename sont simplement des fichiers de configuration .yml qui sont formatés pour être utilisés avec les plugins de MagmaGuy. Ceux-ci peuvent être n'importe quoi, des items aux quêtes.

uniqueLootList:
  - filename: magmaguys_toothpick.yml

Découpage de mondes

Parfois, vous devrez peut-être réduire la taille de votre monde Minecraft pour le rendre plus léger et, par conséquent, plus facile à distribuer. Cela peut être réalisé grâce à l'utilisation du plugin WorldBorder. Bien que le plugin soit répertorié comme ne prenant en charge que MineCraft jusqu'à la version 1.19, il fonctionne parfaitement sur la dernière version de MineCraft au 25 janvier 2024.

Details

Conseil

Si vous faites cela pour la première fois, il serait peut-être judicieux de créer une sauvegarde de votre monde au cas où quelque chose tournerait mal.

Une fois le plugin installé, naviguez vers le milieu du monde ou la zone spécifique que vous souhaitez découper. Ensuite, exécutez la commande /wb set x, où x représente la taille approximative du rayon que vous souhaitez pour votre zone.

Details

Conseil

Si /wb ne fonctionne pas pour vous, essayez /worldborder:wb.

Après avoir exécuté cette commande, volez jusqu'aux bords de votre monde pour vérifier que la bordure du monde a été correctement définie et couvre la taille prévue. Vous reconnaîtrez avoir atteint le bord de la bordure du monde lorsque vous serez repoussé, accompagné d'un message dans le chat.

Dans l'image ci-dessus, nous visons à découper le monde autour des blocs violets, ne laissant que quelques chunks autour d'eux. Pour y parvenir, nous nous tenons au milieu de la zone violette sur les carrés rouges et exécutons /wb set 50, définissant la bordure du monde juste au-delà de la zone violette.

Ensuite, nous utilisons la commande /wb trim [freq] [pad], avec la fréquence définie sur 200 et le pad sur 20. Le pad détermine combien de chunks doivent être laissés autour de la bordure du monde (la zone violette), et la fréquence détermine combien de chunks doivent être traités par seconde. Après avoir exécuté /wb trim 200 20, nous serons invités à confirmer en exécutant /wb trim confirm. Nous confirmons l'action et, après un certain temps, notre monde sera découpé, réduisant sa taille et le rendant plus pratique pour la distribution.

Vous pouvez maintenant supprimer la bordure du monde en utilisant /wb clear all ou simplement la laisser si vous le souhaitez.

Découpage du dossier du monde

Il existe plusieurs fichiers et dossiers situés dans votre dossier de monde que nous pouvons supprimer car les plugins ne les utilisent pas tous. Cela réduira la taille de votre monde et facilitera sa distribution.

Pour un environnement de monde NORMAL :

Pour préparer votre monde, conservez les fichiers et dossiers suivants :

1. Dossier region
2. raids.dat de l'intérieur du dossier data (assurez-vous qu'il est placé à l'intérieur du dossier data lors de la copie)
3. Fichier level.dat

Vous pouvez supprimer en toute sécurité tous les autres fichiers et dossiers situés dans le dossier du monde. Cela configurera correctement votre monde pour l'environnement NORMAL.

Pour les environnements de monde NETHER et THE_END :

Pour préparer votre monde, conservez les fichiers et dossiers suivants :

1. Dossier region à l'intérieur du dossier DIM-1 (assurez-vous qu'il est placé à l'intérieur du dossier DIM-1 lors de la copie)
2. raids.dat de l'intérieur du dossier data (assurez-vous qu'il est placé à l'intérieur du dossier data lors de la copie)
3. Fichier level.dat

Vous pouvez supprimer en toute sécurité tous les autres fichiers et dossiers situés dans le dossier du monde. Cela configurera correctement votre monde pour les environnements NETHER et THE_END.