📚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:

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:

book-author

  • Type: String

  • Défaut: "Administration"

  • Description: L'auteur du livre affiché dans les métadonnées.

Exemple:

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 :

🎨 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.

Exemple 2 : Règles Détaillées

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

Exemple 3 : Formatage Avancé

Un livre utilisant différents styles de formatage.

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

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

🎮 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