🫀 Challenges

💡 Interface d'Administration : Les challenges peuvent être configurés directement en jeu via l'interface d'administration accessible avec /challenges admin (permission requise : horizons.challenges.admin)

📑 Table des MatièresCopy Anchor Link

1. 🎯 Introduction
2. 🏗️ Structure de Base
3. 🎮 Types de Challenges
4. ⚡ Triggers Disponibles
5. 🔄 Types de Répétition
6. 🎁 Configuration des Récompenses
7. 📢 Système de Notifications
8. 📝 Exemples Complets
9. ✅ Validation et Commandes
10. 🔐 Permissions
11. 💡 Conseils et Bonnes Pratiques

🎯 IntroductionCopy Anchor Link

Le système de challenges d'Horizons permet de créer des défis personnalisés pour vos joueurs. Ces challenges peuvent être individuels, d'équipe ou globaux, avec de nombreuses possibilités de configuration.

Fichier de ConfigurationCopy Anchor Link

Tous les challenges sont configurés dans le fichier challenges.yml situé dans le dossier du plugin.

🏗️ Structure de BaseCopy Anchor Link

Chaque challenge suit cette structure de base :

challenges:
  nom_du_challenge:
    name: "&7Nom Affiché du Challenge"
    description:
      - "&7Première ligne de description"
      - "&7Deuxième ligne de description"
    type: "PLAYER"  # PLAYER, TEAM, ou GLOBAL
    trigger: "BLOCK_BREAK"  # Type d'événement
    trigger-data:  # Configuration spécifique au trigger
      material: "STONE"
    target-amount: 100  # Objectif à atteindre
    repeat-type: "DAILY"  # Type de répétition
    display:  # Affichage dans l'interface
      item: "STONE"
      slot: 0
      lore:
        - "&7Progression: &e{progress}/{target}"
    notification:  # Configuration des notifications
      type: "CHAT"
      message: "&aChallenge terminé !"
    rewards:  # Récompenses
      score:
        type: "PLAYER_SCORE"
        amount: 50

🎮 Types de ChallengesCopy Anchor Link

PLAYERCopy Anchor Link

• Description : Challenge individuel pour chaque joueur
• Progression : Chaque joueur a sa propre progression
• Utilisation : Défis personnels, objectifs individuels

TEAMCopy Anchor Link

• Description : Challenge d'équipe où tous les membres contribuent
• Progression : Progression partagée entre les membres de l'équipe
• Utilisation : Défis collaboratifs, objectifs d'équipe

GLOBALCopy Anchor Link

• Description : Challenge pour tout le serveur
• Progression : Un seul joueur ou une équipe peut le compléter
• Utilisation : Événements serveur, premiers à accomplir quelque chose

⚡ Triggers DisponiblesCopy Anchor Link

🏗️ Construction et DestructionCopy Anchor Link

• BLOCK_BREAK : Casser des blocs
• BLOCK_PLACE : Placer des blocs

⚔️ CombatCopy Anchor Link

• ENTITY_KILL : Tuer des entités (mobs)
• PLAYER_KILL : Tuer d'autres joueurs
• DAMAGE_DEAL : Infliger des dégâts
• DAMAGE_TAKE : Subir des dégâts
• DEATH : Mourir

🎯 ActivitésCopy Anchor Link

• ITEM_CRAFT : Crafter des objets
• ITEM_CONSUME : Consommer des objets
• FISH_CATCH : Pêcher
• ENCHANT_ITEM : Enchanter des objets
• TRADE_VILLAGER : Commercer avec des villageois
• POTION_BREW : Brasser des potions

🐾 AnimauxCopy Anchor Link

• TAME_ANIMAL : Apprivoiser des animaux
• BREED_ANIMAL : Faire reproduire des animaux

🚶 Déplacement et ExplorationCopy Anchor Link

• DISTANCE_WALK : Marcher une certaine distance
• DISTANCE_FLY : Voler une certaine distance
• BIOME_ENTER : Entrer dans des biomes
• DIMENSION_ENTER : Entrer dans des dimensions
• WORLD_CHANGE : Changer de monde

📈 ProgressionCopy Anchor Link

• EXPERIENCE_GAIN : Gagner de l'expérience
• LEVEL_UP : Monter de niveau

💬 SocialCopy Anchor Link

• JOIN_SERVER : Se connecter au serveur
• CHAT_MESSAGE : Envoyer des messages
• COMMAND_USE : Utiliser des commandes

⚙️ Configuration des Trigger-DataCopy Anchor Link

Pour BLOCK_BREAK et BLOCK_PLACECopy Anchor Link

trigger-data:
  material: "STONE"  # Un seul matériau
  # OU
  materials:  # Liste de matériaux
    - "STONE"
    - "COBBLESTONE"
    - "GRANITE"

Pour ENTITY_KILLCopy Anchor Link

trigger-data:
  entity: "ZOMBIE"  # Une seule entité
  # OU
  entities:  # Liste d'entités
    - "ZOMBIE"
    - "SKELETON"
    - "CREEPER"

Pour BIOME_ENTERCopy Anchor Link

trigger-data:
  biome: "DESERT"  # Un biome spécifique
  # OU
  biomes:  # Liste de biomes
    - "DESERT"
    - "FOREST"
    - "JUNGLE"
  # OU vide pour tous les biomes
  # trigger-data: {}

Pour DIMENSION_ENTERCopy Anchor Link

trigger-data:
  to_dimension: "NETHER"  # NORMAL, NETHER, THE_END

Pour WORLD_CHANGECopy Anchor Link

trigger-data:
  to_world: "world_nether"  # Monde de destination
  from_world: "world"      # Monde d'origine (optionnel)

🔄 Types de RépétitionCopy Anchor Link

UNIQUECopy Anchor Link

• Description : Ne peut être complété qu'une seule fois
• Utilisation : Achievements permanents, premières fois

UNLIMITEDCopy Anchor Link

• Description : Peut être répété indéfiniment
• Configuration : Optionnel cooldown-seconds pour limiter la fréquence

DAILYCopy Anchor Link

• Description : Se remet à zéro chaque jour
• Reset : Minuit (heure du serveur)

WEEKLYCopy Anchor Link

• Description : Se remet à zéro chaque semaine
• Reset : Lundi à minuit

COOLDOWNCopy Anchor Link

• Description : Cooldown personnalisé entre les complétions
• Configuration : Requis cooldown-seconds

LIMITED_COUNTCopy Anchor Link

• Description : Nombre limité de complétions
• Configuration : Requis max-completions

# Exemple avec cooldown
repeat-type: "COOLDOWN"
cooldown-seconds: 3600  # 1 heure

# Exemple avec limite
repeat-type: "LIMITED_COUNT"
max-completions: 5

🎁 Configuration des RécompensesCopy Anchor Link

Types de RécompensesCopy Anchor Link

PLAYER_SCORECopy Anchor Link

rewards:
  score:
    type: "PLAYER_SCORE"
    amount: 100

TEAM_SCORECopy Anchor Link

rewards:
  team_score:
    type: "TEAM_SCORE"
    amount: 150

ITEMCopy Anchor Link

rewards:
  item:
    type: "ITEM"
    material: "DIAMOND"
    amount: 5

COMMANDCopy Anchor Link

rewards:
  command:
    type: "COMMAND"
    command: "give {player} golden_apple 1"

EXPERIENCECopy Anchor Link

rewards:
  xp:
    type: "EXPERIENCE"
    amount: 100

MONEY (si Vault installé)Copy Anchor Link

rewards:
  money:
    type: "MONEY"
    amount: 500

Récompenses MultiplesCopy Anchor Link

rewards:
  score:
    type: "PLAYER_SCORE"
    amount: 100
  item:
    type: "ITEM"
    material: "DIAMOND"
    amount: 1
  command:
    type: "COMMAND"
    command: "effect give {player} speed 60 1"

📢 Système de NotificationsCopy Anchor Link

Types de NotificationsCopy Anchor Link

CHATCopy Anchor Link

notification:
  type: "CHAT"
  message: "&a✓ Challenge terminé !"

ACTIONBARCopy Anchor Link

notification:
  type: "ACTIONBAR"
  message: "&e🎯 Objectif atteint !"

TITLECopy Anchor Link

notification:
  type: "TITLE"
  message: "&b🏆 CHALLENGE TERMINÉ !"

SUBTITLECopy Anchor Link

notification:
  type: "SUBTITLE"
  message: "&7Félicitations !"

BOSSBARCopy Anchor Link

notification:
  type: "BOSSBAR"
  message: "&6🎉 Challenge accompli !"

Configuration AudioCopy Anchor Link

notification:
  type: "CHAT"
  message: "&aChallenge terminé !"
  sound: "ENTITY_PLAYER_LEVELUP"  # Son Minecraft
  volume: 1.0  # Volume (0.0 à 1.0)
  pitch: 1.0   # Hauteur (0.5 à 2.0)

Variables DisponiblesCopy Anchor Link

• {player} : Nom du joueur
• {progress} : Progression actuelle
• {target} : Objectif à atteindre
• {completions} : Nombre de complétions
• {status} : Statut du challenge

🖼️ Configuration de l'AffichageCopy Anchor Link

Interface GraphiqueCopy Anchor Link

display:
  item: "DIAMOND"  # Matériau d'affichage
  slot: 0          # Position dans l'interface (0-53)
  lore:            # Description supplémentaire
    - "&7Progression: &e{progress}/{target}"
    - ""
    - "&7Statut: {status}"
    - "&7Complétions: &e{completions}"

📝 Exemples CompletsCopy Anchor Link

Challenge de Minage SimpleCopy Anchor Link

mine_diamonds:
  name: "&b💎 Mineur de Diamant"
  description:
    - "&7Minez 10 minerais de diamant"
    - "&7pour devenir un mineur expert"
  type: "PLAYER"
  trigger: "BLOCK_BREAK"
  trigger-data:
    material: "DIAMOND_ORE"
  target-amount: 10
  repeat-type: "WEEKLY"
  display:
    item: "DIAMOND_ORE"
    slot: 1
  notification:
    type: "TITLE"
    message: "&b💎 Mineur de Diamant !"
    sound: "ENTITY_PLAYER_LEVELUP"
  rewards:
    score:
      type: "PLAYER_SCORE"
      amount: 200

Challenge d'Équipe ComplexeCopy Anchor Link

team_builder:
  name: "&6🏗️ Constructeurs d'Équipe"
  description:
    - "&7Votre équipe doit placer"
    - "&7500 blocs de construction"
  type: "TEAM"
  trigger: "BLOCK_PLACE"
  trigger-data:
    materials:
      - "STONE_BRICKS"
      - "BRICKS"
      - "COBBLESTONE"
      - "WOOD_PLANKS"
  target-amount: 500
  repeat-type: "DAILY"
  display:
    item: "BRICKS"
    slot: 11
  notification:
    type: "BOSSBAR"
    message: "&6🏗️ Équipe de Constructeurs !"
  rewards:
    team_score:
      type: "TEAM_SCORE"
      amount: 300
    command:
      type: "COMMAND"
      command: "effect give @a[team={team}] speed 300 1"

Challenge Global UniqueCopy Anchor Link

first_nether:
  name: "&c🔥 Pionnier du Nether"
  description:
    - "&7Soyez le premier joueur"
    - "&7à entrer dans le Nether !"
  type: "GLOBAL"
  trigger: "DIMENSION_ENTER"
  trigger-data:
    to_dimension: "NETHER"
  target-amount: 1
  repeat-type: "UNIQUE"
  display:
    item: "OBSIDIAN"
    slot: 20
  notification:
    type: "CHAT"
    message: "&c🔥 {player} est le premier à entrer dans le Nether !"
    sound: "UI_TOAST_CHALLENGE_COMPLETE"
  rewards:
    score:
      type: "PLAYER_SCORE"
      amount: 500
    item:
      type: "ITEM"
      material: "FIRE_RESISTANCE_POTION"
      amount: 3

✅ Validation et CommandesCopy Anchor Link

Commandes DisponiblesCopy Anchor Link

• /challenges : Ouvre l'interface des challenges
• /challenges admin : Ouvre l'interface d'administration (permission requise)
• /challenges reload : Recharge la configuration (permission requise)
• /challenges reset <player/team/global> [challenge] : Remet à zéro la progression (permission requise)
• /challenges info <challenge> : Informations sur un challenge
• /challenges progress <player> [challenge] : Progression d'un joueur

🔐 PermissionsCopy Anchor Link

horizons.challenges.adminCopy Anchor Link

• Description : Accès complet à l'administration des challenges
• Fonctionnalités :
  • Interface d'administration (/challenges admin)
  • Création, modification et suppression de challenges
  • Gestion des récompenses et paramètres avancés
  • Accès à toutes les fonctionnalités d'édition

horizons.challenges.reloadCopy Anchor Link

• Description : Rechargement de la configuration des challenges
• Fonctionnalités :
  • Commande /challenges reload
  • Rechargement à chaud des challenges depuis les fichiers

horizons.challenges.resetCopy Anchor Link

• Description : Réinitialisation des progressions de challenges
• Fonctionnalités :
  • /challenges reset player <nom> - Reset d'un joueur spécifique
  • /challenges reset team <nom> - Reset d'une équipe complète
  • /challenges reset global - Reset de tous les challenges globaux

Commandes Sans PermissionCopy Anchor Link

Ces commandes sont accessibles à tous les joueurs :

• /challenges - Interface principale des challenges
• /challenges gui [type] - Interface par type de challenge
• /challenges info <id> - Informations détaillées sur un challenge
• /challenges progress <id> - Consultation de sa progression personnelle
• /challenges help - Aide et liste des commandes

💡 Conseils et Bonnes PratiquesCopy Anchor Link

🎯 Conception des ChallengesCopy Anchor Link

1. Équilibrage : Ajustez les objectifs selon la difficulté
2. Progression : Créez des challenges de difficulté croissante
3. Variété : Utilisez différents triggers pour diversifier
4. Récompenses : Équilibrez les récompenses avec l'effort requis

🔧 Configuration TechniqueCopy Anchor Link

1. Sauvegarde : Sauvegardez toujours avant modification
2. Reload : Utilisez /challenges reload pour appliquer les changements
3. Logs : Consultez les logs en cas d'erreur

📊 PerformanceCopy Anchor Link

1. Slots : Évitez les doublons de slots dans l'interface
2. Triggers : Les triggers fréquents (CHAT_MESSAGE) peuvent impacter les performances
3. Cooldowns : Utilisez des cooldowns pour limiter le spam

🛠️ Support et DépannageCopy Anchor Link

Problèmes CourantsCopy Anchor Link

Challenge ne se déclenche pas :

• Vérifiez le trigger et les trigger-data
• Confirmez que le challenge est actif
• Consultez les logs pour les erreurs

Erreurs de configuration :

• Vérifiez la syntaxe YAML
• Consultez les messages d'erreur détaillés

Récompenses non distribuées :

• Vérifiez la configuration des rewards
• Confirmez les permissions nécessaires
• Testez avec des récompenses simples

Logs et DebugCopy Anchor Link

Les logs du plugin fournissent des informations détaillées sur :

• Chargement des challenges
• Erreurs de configuration
• Progression des joueurs
• Distribution des récompenses

Cette documentation couvre toutes les fonctionnalités du système de challenges d'Horizons. Pour des questions spécifiques ou des problèmes, consultez les logs du serveur ou contactez le support.