Aller au contenu principal

Créer du Contenu EliteMobs

EliteMobs vous permet de créer un contenu personnalisé étendu pour votre serveur via des fichiers de configuration YAML. Tout le contenu est créé en plaçant des fichiers .yml correctement formatés dans des dossiers spécifiques au sein du répertoire du plugin EliteMobs.

Types de contenu​

EliteMobs prend en charge 8 types de contenu principaux :

  1. Boss personnalisés - Créez des créatures élites uniques avec des pouvoirs, un équipement et des capacités personnalisés
  2. Objets personnalisés - Concevez des armes, des armures et des objets personnalisés avec des enchantements
  3. Quêtes personnalisées - Construisez des chaînes de quêtes avec des objectifs et des récompenses
  4. Événements personnalisés - Mettez en place des événements de boss déclenchés par le temps ou par une action
  5. PNJ personnalisés - Ajoutez des donneurs de quêtes, des boutiques et des PNJ interactifs
  6. Coffres au trésor - Placez des coffres de butin avec des récompenses personnalisées et des mécaniques de mimique
  7. Arènes - Concevez des défis de combat par vagues avec des rencontres de boss
  8. Trous de ver - Créez des portails de téléportation entre les emplacements

Chaque type de contenu a son propre dossier de configuration et sa propre structure de champs.

Démarrage rapide​

Tout contenu personnalisé suit ce schéma :

  1. Créez un fichier YAML avec l'extension .yml
  2. Nommez-le au format lowercase_with_underscores.yml
  3. Placez-le dans le dossier approprié
  4. Configurez le contenu à l'aide des champs YAML
  5. Rechargez EliteMobs ou redémarrez le serveur

Emplacements des fichiers​

Chaque type de contenu est stocké dans son propre dossier :

  • Boss personnalisés : ~/plugins/EliteMobs/custombosses/
  • Objets personnalisés : ~/plugins/EliteMobs/customitems/
  • Quêtes personnalisées : ~/plugins/EliteMobs/customquests/
  • Événements personnalisés : ~/plugins/EliteMobs/customevents/
  • PNJ personnalisés : ~/plugins/EliteMobs/npcs/
  • Coffres au trésor : ~/plugins/EliteMobs/customtreasurechests/
  • Arènes : ~/plugins/EliteMobs/customarenas/
  • Trous de ver : ~/plugins/EliteMobs/wormholes/

Outils de création de contenu​

WebApp (recommandé pour les débutants)​

Utilisez la WebApp EliteMobs pour générer des fichiers de configuration via une interface visuelle. Cet outil rend le processus beaucoup plus rapide et aide à éviter les erreurs de syntaxe.

Configuration YAML manuelle​

Pour les utilisateurs avancés, créez les fichiers YAML manuellement pour un contrôle complet sur tous les champs et options disponibles.

Format de fichier YAML​

Toutes les configurations d'EliteMobs utilisent le format YAML. Règles principales :

  • Utilisez des espaces, pas des tabulations, pour l'indentation
  • Les chaînes de caractères contenant des codes de couleur nécessitent des guillemets simples
  • Les listes utilisent le format avec tiret ou le format avec crochets
  • isEnabled contrôle si le contenu se charge ; il est optionnel et vaut true par défaut dans chaque type de contenu (vous n'avez donc besoin de définir isEnabled: false que pour désactiver un fichier)
  • Les noms de fichiers devraient utiliser le format lowercase_with_underscores.yml

Pour une aide détaillée sur la syntaxe YAML, consultez le Guide du fichier de configuration.

Aperçu des types de contenu​

Boss personnalisés​

Les boss personnalisés sont des créatures élites dotées de capacités améliorées, d'équipements personnalisés et de pouvoirs spéciaux. Le système de boss prend en charge plus de 60 champs de configuration, dont :

  • Type d'entité et niveau
  • Multiplicateurs de points de vie et de dégâts
  • Équipement (armures et armes)
  • Pouvoirs et capacités d'élite
  • Tables de butin et drops
  • Messages et commandes d'apparition/de mort
  • Mécaniques multi-phases
  • Modèles personnalisés et déguisements

Exemple de boss basique :

isEnabled: true
entityType: ZOMBIE
name: '&e Test Boss'
level: dynamic
healthMultiplier: 2.0
damageMultiplier: 0.5
helmet: GOLDEN_HELMET
chestplate: IRON_CHESTPLATE
mainHand: GOLDEN_AXE
powers:
  - invulnerability_knockback.lua
spawnMessage: A test boss has been spawned!
deathMessage: A test boss has been slain by $players!

Objets personnalisés​

Les objets personnalisés vous permettent de créer des armes, des armures et des outils uniques avec des enchantements et des effets personnalisés. Le système d'objets prend en charge 15 champs de configuration, dont :

  • Type de matériau
  • Nom d'affichage et lore
  • Liste d'enchantements
  • Effets de potion
  • ID de modèles personnalisés
  • Poids de drop et mise à l'échelle
  • Réglages de niveau et de lien d'âme (soulbound)

Exemple d'objet basique :

isEnabled: true
material: DIAMOND_SWORD
name: '&4Legendary Blade'
lore:
  - '&7A powerful weapon'
  - '&7forged in dragon fire'
enchantments:
  - DAMAGE_ALL,5
  - FIRE_ASPECT,2
level: 10
soulbound: true

Quêtes personnalisées​

Les quêtes personnalisées créent des objectifs pour les joueurs avec des récompenses à l'achèvement. Le système de quêtes prend en charge 17 champs de configuration, dont :

  • Objectifs et types de quête
  • Récompenses (objets, argent, permissions)
  • Dialogue d'acceptation/d'achèvement
  • Exigences de remise à un PNJ
  • Minuteurs de verrouillage de quête
  • Suivi et sons

Événements personnalisés​

Les événements personnalisés déclenchent des apparitions de boss en fonction du temps, de la chance ou d'autres conditions. Le système d'événements prend en charge 18 champs de configuration, dont :

  • Type d'événement et liste de boss
  • Chance et poids de déclenchement
  • Messages et commandes de début/fin
  • Minuteurs de temps de recharge (local et global)
  • Nombre minimum de joueurs
  • Durée de l'événement

PNJ personnalisés​

Les PNJ personnalisés fournissent des personnages interactifs pour les quêtes, les boutiques et les arènes. Le système de PNJ prend en charge 18 champs de configuration, dont :

  • Nom, rôle et profession du PNJ
  • Emplacements d'apparition
  • Dialogue (salutations, dialogue, adieu)
  • Types d'interaction
  • Références de quêtes et d'arènes
  • Modèles personnalisés et déguisements

Coffres au trésor​

Les coffres au trésor fournissent des récompenses de butin avec des minuteurs de réapprovisionnement et des mécaniques de mimique personnalisables. Le système de coffres prend en charge 15 champs de configuration, dont :

  • Type et orientation du coffre
  • Coordonnées d'emplacement
  • Table de butin
  • Minuteurs de réapprovisionnement
  • Chance de mimique et liste de boss
  • Effets visuels

Arènes​

Les arènes créent des défis de combat par vagues avec des rencontres de boss. Le système d'arène prend en charge 19 champs de configuration, dont :

  • Limites de l'arène (corner1, corner2)
  • Nombre de vagues et délais
  • Liste de boss et points d'apparition
  • Récompenses et limites de joueurs
  • Messages d'arène
  • Vagues d'intermède

Trous de ver​

Les trous de ver créent des portails de téléportation entre deux emplacements. Le système de trous de ver prend en charge 11 champs de configuration, dont :

  • Deux points d'extrémité d'emplacement
  • Texte d'affichage pour chaque emplacement
  • Style visuel et couleurs de particules
  • Coût en pièces et permissions
  • Effet de cécité et multiplicateur de taille

Schémas courants​

Référencer du contenu​

Les types de contenu se référencent mutuellement à l'aide de noms de fichiers :

  • Référencer des pouvoirs dans les boss : power_name.yml
  • Référencer des objets dans le butin : filename: item_name.yml (consultez le format des Tables de butin pour la chance, la quantité et plus)
  • Référencer des boss dans les événements : boss_filename.yml
  • Référencer des quêtes dans les PNJ : quest_filename.yml

Espaces réservés (placeholders)​

Utilisez ces espaces réservés dans les messages :

  • $players - Liste des joueurs ayant vaincu le boss
  • $distance - Distance jusqu'à l'emplacement du boss
  • $eventBossLevel - Niveau dynamique du boss d'événement

Codes de couleur​

Utilisez les codes de couleur de Minecraft dans les noms et les messages. Les codes de couleur doivent être entre guillemets simples.

Codes de couleur standard de Minecraft :

  • &0 - Noir
  • &1 - Bleu foncé
  • &2 - Vert foncé
  • &3 - Cyan foncé
  • &4 - Rouge foncé
  • &5 - Violet foncé
  • &6 - Or
  • &7 - Gris
  • &8 - Gris foncé
  • &9 - Bleu
  • &a - Vert
  • &b - Cyan
  • &c - Rouge
  • &d - Violet clair
  • &e - Jaune
  • &f - Blanc

Codes de formatage :

  • &l - Gras
  • &m - Barré
  • &n - Souligné
  • &o - Italique
  • &r - Réinitialisation

Système de pouvoirs d'élite​

EliteMobs inclut plus de 60 pouvoirs d'élite qui peuvent être attribués aux boss personnalisés. Les pouvoirs sont référencés par nom de fichier dans les configurations de boss.

Catégories de pouvoirs​

Pouvoirs d'attaque/de combat :

  • ArrowFireworks, ArrowRain, AttackArrow, AttackFireball, AttackLightning
  • AttackPush, AttackVacuum, BulletHell, DeathSlice

Pouvoirs élémentaires :

  • Firestorm, FlamePyre, Flamethrower, FrostCone, FrostWalker
  • LightningBolts, Thunderstorm, PhotonRay, PlasmaBlaster

Pouvoirs défensifs :

  • ShieldWall, InvulnerabilityArrow, InvulnerabilityFallDamage
  • InvulnerabilityFireworks, InvulnerabilityKnockback
  • ChannelHealing, SpiritWalk

Capacités spéciales :

  • GroundPound, Implosion, MeteorShower, GoldExplosion, GoldShotgun
  • SkeletonPillar, SkeletonTrackingArrow, TrackingFireball, Taze, Taunt
  • ZombieBloat, ZombieFriends, ZombieNecronomicon, ZombieParents
  • SummonEmbers, SummonTheReturned, MovementSpeed

Pouvoirs exclusifs au Dragon de l'Ender :

  • AimedFireball, ArrowBombardment, DiscoFireballs, EmpoweredLightning
  • Shockwave, Tornado (11 pouvoirs spécifiques au dragon au total)

Pouvoirs de butin :

  • BonusCoins, BonusLoot, HyperLoot

Les pouvoirs sont ajoutés aux boss à l'aide du champ de liste powers :

powers:
  - invulnerability_knockback.lua
  - flame_pyre.lua
  - spirit_walk.lua

Fonctionnalités avancées​

Boss multi-phases​

Les boss peuvent avoir plusieurs phases avec des fichiers de configuration distincts. Utilisez le champ phases pour référencer les fichiers de boss de phase, et phaseSpawnLocation pour définir où se produisent les transitions de phase.

Elite Scripts​

Les elite scripts fournissent des capacités avancées de boss personnalisé avec des actions, des conditions et des temps de recharge pilotés par événements. Les scripts sont configurés à l'aide du champ eliteScript dans les configurations de boss.

Modèles personnalisés​

Les modèles personnalisés peuvent être appliqués aux boss, aux PNJ et aux objets à l'aide du champ customModel. Cela nécessite une configuration d'intégration de modèle supplémentaire.

Équipement de boss​

Les boss peuvent porter des armures personnalisées et tenir des armes :

helmet: DIAMOND_HELMET
chestplate: IRON_CHESTPLATE
leggings: LEATHER_LEGGINGS
boots: CHAINMAIL_BOOTS
mainHand: GOLDEN_AXE
offHand: SHIELD

Exécution de commandes​

Les boss peuvent exécuter des commandes lors d'événements spécifiques :

  • onSpawnCommands - Exécutées lorsque le boss apparaît
  • onDeathCommands - Exécutées lorsque le boss est vaincu
  • onCombatEnterCommands - Exécutées lorsque le combat commence
  • onCombatLeaveCommands - Exécutées lorsque le combat se termine

Messages de boss​

Personnalisez les annonces de boss :

  • spawnMessage - Diffusé lorsque le boss apparaît
  • deathMessage - Diffusé lorsque le boss est vaincu (prend en charge l'espace réservé $players)
  • escapeMessage - Diffusé lorsque le boss s'échappe
  • locationMessage - Affiche la distance jusqu'au boss (prend en charge l'espace réservé $distance)
  • deathMessages - Liste de variations aléatoires de messages de mort

Les niveaux de priorité d'annonce (0-3) contrôlent la portée de diffusion. Utilisez le champ announcementPriority.

Boss régionaux​

Les boss régionaux utilisent le champ isRegionalBoss et peuvent avoir un rayon de laisse, des restrictions d'apparition et des changements d'état de bloc :

  • leashRadius - Distance maximale par rapport au point d'apparition
  • onSpawnBlockStates - Changements de bloc lorsque le boss apparaît
  • onRemoveBlockStates - Changements de bloc lorsque le boss est retiré

Configuration du butin​

Contrôlez les drops du boss :

  • dropsEliteMobsLoot - Active les drops de butin personnalisé (par défaut : true)
  • dropsVanillaLoot - Active les drops vanilla (par défaut : true)
  • dropsRandomLoot - Active le butin aléatoire (par défaut : true)
  • uniqueLootList - Objets de butin spécifiques avec quantités

Exemple :

uniqueLootList:
  - custom_sword.yml:1
  - rare_helmet.yml:1

Contenu préconçu​

EliteMobs inclut plus de 134 configurations de boss préconçues et des modèles pour tous les types de contenu. Ceux-ci se trouvent dans les dossiers /premade/ respectifs et servent d'exemples pour créer votre propre contenu personnalisé.

Obtenir de l'aide​

  • Consultez la barre latérale pour des guides de création de contenu spécifiques
  • Visitez le Discord d'EliteMobs pour le support communautaire
  • Consultez le Dépôt GitHub pour des exemples de code source