Aller au contenu principal

EliteScript

webapp_banner.jpg

EliteScript est un système de script complet pour les plugins de MagmaGuy, offrant des options de personnalisation avancées pour créer des comportements dynamiques pour les boss et autres entités dans Minecraft.

Aperçu​

EliteScript permet aux administrateurs de serveurs de créer des comportements complexes basés sur des événements pour des boss et des mobs personnalisés. Le système de script repose sur cinq composants principaux :

  • Events : Déclencheurs qui lancent l'exécution du script (dégâts, apparition, mort, etc.)
  • Conditions : Exigences qui doivent être remplies pour que les actions s'exécutent
  • Actions : Les comportements à effectuer (dégâts, téléportation, apparition de particules, etc.)
  • Targets : Quelles entités ou emplacements sont affectés par les actions
  • Zones : Zones définies dans le monde pour le ciblage et la détection
  • Cooldowns : Restrictions de temps pour empêcher le spam de scripts

Les Elite Scripts peuvent être ajoutés comme fichiers de pouvoir autonomes ou directement dans les fichiers de configuration de boss personnalisés.

Exemple de démarrage rapide​

Voici un EliteScript simple qui fait qu'un boss frappe les joueurs avec la foudre lorsqu'il est endommagé :

eliteScript:
  LightningStrike:
    Events:
    - EliteMobDamagedByPlayerEvent
    Actions:
    - action: STRIKE_LIGHTNING
      Target:
        targetType: DIRECT_TARGET
      repeatEvery: 20
      times: 3
    Cooldowns:
      local: 60
      global: 20

Ce script se déclenche quand un joueur endommage le boss, puis frappe le joueur avec la foudre 3 fois (une fois par seconde), avec un temps de recharge de 60 ticks avant de pouvoir se déclencher à nouveau.

Composants du script​

EliteScript offre une personnalisation étendue grâce à son système de composants. Pour des informations détaillées sur chaque composant, consultez les pages suivantes :

Composants principaux​

  • Events - 13 types d'événements incluant dégâts, mort, apparition, combat et déclencheurs basés sur les zones
  • Actions - 35 types d'actions pour créer des comportements complexes
  • Targets - 17 types de cibles pour sélectionner des entités et des emplacements
  • Conditions - Conditions de filtrage et de blocage avec plusieurs types de vérification
  • Zones - 8 formes de zones (sphères, cylindres, cuboïdes, rayons, cônes, etc.)
  • Cooldowns - Systèmes de temps de recharge local et global
  • Vecteurs relatifs - Positionnement et mouvement avancés

Cas d'utilisation courants​

EliteScript est couramment utilisé pour :

  • Combats de boss par phases : Différents schémas d'attaque à différents pourcentages de santé
  • Mécaniques d'arène : Dégâts basés sur les zones, améliorations ou apparitions dans des zones spécifiques
  • Attaques personnalisées : Effets de particules uniques, projectiles et attaques de zone
  • Dangers environnementaux : Foudre périodique, blocs tombants ou feu
  • Mécaniques interactives : Téléportation, apparition de mobs et modification du monde
  • Communication avec les joueurs : Messages, titres, barres d'action et barres de boss
  • Comportements conditionnels : Différentes actions basées sur le nombre de joueurs, l'emplacement ou l'état du boss

Implémentation​

Les scripts peuvent être implémentés de deux façons :

  1. Fichiers de pouvoir : Créez des fichiers .yml autonomes dans ~/plugins/EliteMobs/powers/
  2. Fichiers de boss personnalisés : Ajoutez des sections eliteScript: directement aux configurations de boss personnalisés

Pour des instructions détaillées sur la création de pouvoirs et de boss personnalisés, consultez :

Considérations de performance​

Lors de la création de scripts, gardez ces bonnes pratiques à l'esprit :

  • Utilisez des temps de recharge pour éviter les problèmes de performance liés aux scripts à déclenchement rapide
  • Les événements basés sur les zones (ZoneEnterEvent, ZoneLeaveEvent) sont coûteux en calcul - utilisez de petites zones et des temps de recharge appropriés
  • Utilisez des conditions de filtrage pour réduire les vérifications inutiles
  • Testez les scripts de manière approfondie avant de les déployer sur des serveurs de production

Prochaines étapes​

Pour commencer à créer vos propres EliteScripts :

  1. Consultez la page des Events pour comprendre ce qui peut déclencher des scripts
  2. Explorez la page des Actions pour voir quels comportements vous pouvez créer
  3. Apprenez les Targets pour contrôler ce que vos actions affectent
  4. Étudiez les exemples de chaque page de composant
  5. Commencez par des scripts simples et augmentez progressivement la complexité