Horizons
⚙️ Configuration

📚 Règlement de l'événement

📝 Introduction

Le système de règles d'événement permet de créer un livre personnalisé contenant les règles de votre serveur ou événement. Les joueurs peuvent consulter ce livre en utilisant la commande /rules (ou /eventrules, /regles).

⚙️ Configuration

La configuration se fait dans le fichier plugins/Horizons/config.yml sous la section event-rules.

Structure de Base

event-rules:
  enabled: true
  book-title: "&6&lRègles de l'Événement"
  book-author: "Administration"
  pages:
    - "&l&6Règles de l'Événement\n\n&r&7Bienvenue !"
    - "&l&cRègle 1: Respect\n\n&r&7Respectez tous les joueurs."

🔧 Paramètres

enabled

  • Type: Boolean
  • Défaut: true
  • Description: Active ou désactive le système de règles d'événement.

Comportement:

  • true: Les joueurs peuvent utiliser /rules pour voir le livre des règles
  • false: La commande /rules affiche un message indiquant que les règles ne sont pas disponibles

Exemple:

event-rules:
  enabled: true

book-title

  • Type: String
  • Défaut: "&6&lRègles de l'Événement"
  • Description: Le titre du livre affiché dans l'inventaire.

Limitations:

  • Maximum 32 caractères (limite Minecraft)
  • Si le titre dépasse 32 caractères, il sera automatiquement tronqué avec "..."
  • Les codes couleur comptent dans la limite de caractères

Exemple:

event-rules:
  book-title: "&6&lRègles du Serveur"

book-author

  • Type: String
  • Défaut: "Administration"
  • Description: L'auteur du livre affiché dans les métadonnées.

Exemple:

event-rules:
  book-author: "Équipe de Modération"

pages

  • Description: Liste des pages du livre. Chaque élément de la liste représente une page.

Limitations importantes:

  • Maximum ~256 caractères par page (limite Minecraft)
  • Maximum 14 lignes par page (limite Minecraft)
  • Si une page dépasse 256 caractères, elle sera automatiquement tronquée avec "..."
  • Utilisez \n pour créer des retours à la ligne dans une page

Pages par défaut: Si aucune configuration n'est fournie, le système utilise ces pages par défaut :

pages:
  - "&l&6Règles de l'Événement\n\n&r&7Bienvenue !\n\n&r&fVeuillez lire attentivement les règles suivantes."
  - "&l&cRègle 1: Respect\n\n&r&7Respectez tous les joueurs et l'équipe de modération.\n\n&r&fAucun comportement toxique ne sera toléré."
  - "&l&6Merci !\n\n&r&7En suivant ces règles, vous contribuez à créer une expérience agréable pour tous."

🎨 Codes Couleur

Vous pouvez utiliser les codes couleur Minecraft standard dans les pages :

  • &0 - Noir
  • &1 - Bleu foncé
  • &2 - Vert foncé
  • &3 - Cyan
  • &4 - Rouge foncé
  • &5 - Violet
  • &6 - Orange
  • &7 - Gris
  • &8 - Gris foncé
  • &9 - Bleu
  • &a - Vert
  • &b - Cyan clair
  • &c - Rouge
  • &d - Rose
  • &e - Jaune
  • &f - Blanc
  • &l - Gras
  • &m - Barré
  • &n - Souligné
  • &o - Italique
  • &r - Réinitialiser
  • &k - Texte magique (obfuscated)

Note: Les codes couleur & sont automatiquement convertis en codes § pour les livres Minecraft.

📋 Exemples de Configuration

Exemple 1 : Règles Simples

Un livre avec quelques règles de base.

event-rules:
  enabled: true
  book-title: "&6&lRègles du Serveur"
  book-author: "Administration"
  pages:
    - "&l&6Règles du Serveur\n\n&r&7Bienvenue sur le serveur !\n\n&r&fVeuillez lire attentivement les règles suivantes."
    - "&l&cRègle 1: Respect\n\n&r&7Respectez tous les joueurs et l'équipe de modération.\n\n&r&fAucun comportement toxique ne sera toléré."
    - "&l&cRègle 2: Triche\n\n&r&7L'utilisation de cheats, hacks ou mods non autorisés est strictement interdite.\n\n&r&fLes contrevenants seront bannis."
    - "&l&aMerci !\n\n&r&7En suivant ces règles, vous contribuez à créer une expérience agréable pour tous."

Exemple 2 : Règles Détaillées

Un livre plus complet avec plusieurs pages de règles.

event-rules:
  enabled: true
  book-title: "&6&lRègles de l'Événement"
  book-author: "Équipe de Modération"
  pages:
    - "&l&6Règles de l'Événement\n\n&r&7Bienvenue !\n\n&r&fVeuillez lire attentivement les règles suivantes pour participer à l'événement."
    - "&l&cRègle 1: Respect\n\n&r&7Respectez tous les joueurs et l'équipe de modération.\n\n&r&fAucun comportement toxique ne sera toléré."
    - "&l&cRègle 2: Triche\n\n&r&7L'utilisation de cheats, hacks ou mods non autorisés est strictement interdite.\n\n&r&fLes contrevenants seront bannis."
    - "&l&cRègle 3: Équipe\n\n&r&7Travaillez en équipe et communiquez efficacement.\n\n&r&fLa coopération est essentielle pour réussir."
    - "&l&6Bonnes Pratiques\n\n&r&7- Écoutez les instructions des modérateurs\n- Signalez tout comportement suspect\n- Profitez de l'événement !"
    - "&l&aMerci !\n\n&r&7En suivant ces règles, vous contribuez à créer une expérience agréable pour tous.\n\n&r&f&lBon jeu !"

Exemple 3 : Formatage Avancé

Un livre utilisant différents styles de formatage.

event-rules:
  enabled: true
  book-title: "&5&lGuide du Joueur"
  book-author: "Staff"
  pages:
    - "&l&5&m═══════════════\n&r&5&lGuide du Joueur\n&l&5&m═══════════════\n\n&r&7Bienvenue !\n\n&r&fCe guide contient toutes les informations importantes."
    - "&l&e&nCommandes Utiles:\n\n&r&a/spawn &7- Retourner au spawn\n&a/warp &7- Se téléporter\n&a/team &7- Gestion d'équipe\n&a/challenge &7- Défis"
    - "&l&c&nRègles Importantes:\n\n&r&4&l1. &r&7Respectez les autres\n&4&l2. &r&7Pas de triche\n&4&l3. &r&7Pas de spam"
    - "&l&a&nConseils:\n\n&r&7- Rejoignez une équipe\n- Participez aux événements\n- Amusez-vous !"

Exemple 4 : Règles d'Événement Temporaire

Un livre pour un événement spécifique avec des règles temporaires.

event-rules:
  enabled: true
  book-title: "&c&lÉvénement Spécial"
  book-author: "Événements"
  pages:
    - "&l&c&m═══════════════\n&r&c&lÉVÉNEMENT SPÉCIAL\n&l&c&m═══════════════\n\n&r&7Dates: 1er - 7 Janvier\n\n&r&fLisez les règles ci-dessous."
    - "&l&eRègles de l'Événement:\n\n&r&7- Durée limitée: 7 jours\n- Équipes de 4 joueurs max\n- Pas de respawn pendant l'événement"
    - "&l&aRécompenses:\n\n&r&7- 1er place: 1000 émeraudes\n- 2ème place: 500 émeraudes\n- 3ème place: 250 émeraudes"
    - "&l&6Bon jeu !\n\n&r&7Amusez-vous et respectez les règles."

🎮 Utilisation In-Game

Les joueurs peuvent utiliser les commandes suivantes pour ouvrir le livre des règles :

  • /rules - Commande principale
  • /eventrules - Alias
  • /regles - Alias (français)

🔄 Rechargement

Pour appliquer les modifications de configuration :

  1. Via commande: Utilisez /horizons reload ou /hz reload
  2. Redémarrage: Redémarrez le serveur

Note: Après modification du fichier config.yml, vous devez recharger la configuration pour que les changements prennent effet.

📝 Notes Importantes

Limites des Livres Minecraft

Les livres Minecraft ont des limitations strictes :

  1. Caractères par page: Maximum ~256 caractères par page
    • Si une page dépasse cette limite, elle sera automatiquement tronquée
    • Les codes couleur comptent dans cette limite
  2. Lignes par page: Maximum 14 lignes par page
    • Les lignes sont comptées après le formatage
    • Utilisez \n pour créer des retours à la ligne
  3. Titre du livre: Maximum 32 caractères
    • Si le titre dépasse cette limite, il sera automatiquement tronqué avec "..."
  4. Nombre de pages: Pas de limite stricte, mais gardez à l'esprit que trop de pages peuvent être difficiles à naviguer

Formatage des Pages

  • Utilisez \n pour créer des retours à la ligne dans une page
  • Les codes couleur & sont automatiquement convertis en codes §
  • Le code &r réinitialise tous les formats (utile pour réinitialiser les couleurs)

Conseils de Formatage

  1. Utilisez des titres: &l&6Titre pour les titres de section
  2. Utilisez des séparateurs: &7&m────── pour les lignes de séparation
  3. Gardez les pages courtes: Respectez la limite de 256 caractères
  4. Testez vos pages: Ouvrez le livre en jeu pour vérifier le formatage

🖥️ Configuration via GUI

Les règles peuvent également être configurées via le GUI d'administration :

  1. Ouvrez le menu admin avec /hz gui
  2. Accédez à la section "Configuration"
  3. Sélectionnez "Règles d'Événement"
  4. Modifiez le titre, l'auteur et les pages
  5. Sauvegardez les modifications

Note: Les modifications via le GUI sont automatiquement sauvegardées dans config.yml.

💡 Conseils

Organisation des Pages

  1. Page d'introduction: Commencez par une page de bienvenue
  2. Pages de règles: Organisez les règles par catégories (une page par catégorie)
  3. Page de conclusion: Terminez par une page de remerciement ou de conseils

Formatage Visuel

  1. Utilisez des couleurs différentes pour différencier les sections
  2. Utilisez des séparateurs pour améliorer la lisibilité
  3. Utilisez le formatage (&l pour gras, &n pour souligné) pour mettre en évidence

Longueur des Pages

  1. Gardez les pages courtes pour une meilleure lisibilité
  2. Divisez le contenu en plusieurs pages si nécessaire
  3. Testez vos pages en jeu pour vérifier qu'elles s'affichent correctement

On this page