EliteMobs

Licence

Le code source d'EliteMobs est couvert par la licence GPLV3, et ce wiki est fourni avec la licence CC0.

N'hésitez pas à redistribuer et modifier les informations de ce wiki.

Versions

Cette documentation correspond au code source actuel d'EliteMobs 10.9.10.

Le code source actuel est compilé avec l'API Spigot 26.3-R0.1-SNAPSHOT et Java 21.

EliteMobs 10 inclut le système actuel de progression des compétences d'armes, la gestion de contenu compatible Nightbreak, et le nouveau flux de configuration construit autour de /em initialize et /em setup. Les joueurs Bedrock (via Geyser) peuvent voir les boss et PNJ à modèle personnalisé, et EliteMobs expose une API LocationOwnership inter-plugins afin que d'autres plugins utilisant MagmaCore puissent demander si un emplacement est possédé/protégé par EliteMobs et à quel type de contenu il appartient.

Si vous exécutez intentionnellement une ancienne version majeure d'EliteMobs, considérez cette section du wiki comme la documentation de la ligne actuelle et vérifiez plutôt l'ancien comportement par rapport à cette branche plus ancienne.

À quoi sert EliteMobs ?

EliteMobs vise à étendre l'end-game de Minecraft en implémentant divers contenus liés aux boss.

Cela signifie :

• Boss dynamiques (Mobs à niveaux)
• Boss personnalisés
• Événements
• Arènes
• Donjons basés sur le monde
• Donjons instanciés
• Donjons dynamiques
• Donjons aléatoires en monde ouvert (avec intégration BetterStructures)
• Items personnalisés (Items/Butin Elite)
• Compétences d'armes et bonus de compétence
• Groupes de session, vérification de préparation aux donjons et butin de groupe
• ... et bien plus encore !

Le plugin ne vise pas à remplacer le contenu vanilla de Minecraft mais plutôt à le compléter, permettant aux joueurs de se désengager du contenu EliteMobs s'ils le souhaitent. Les items EliteMobs n'affectent généralement pas le PvP ni le combat vanilla de Minecraft, car leurs bonus de dégâts et de défense ne s'appliquent que pendant les combats contre EliteMobs.

Pour commencer

La documentation actuelle couvre le [Alpha] Advanced Combat System, sa référence des classes, le butin de classe personnalisé, les itinéraires de transport et les réseaux de vol. Pour mettre à jour d'anciens contenus, consultez les enchantements personnalisés avec espace de noms et les formats des objets personnalisés.

Nouveau sur EliteMobs ? Il y a deux points de départ distincts :

• les propriétaires de serveur devraient terminer le flux de configuration avec /em initialize, lier un token Nightbreak avec /nightbreaklogin <token>, puis gérer le contenu avec /em setup
• les joueurs utilisent /em et /ag une fois que le propriétaire du serveur a terminé la configuration

Votre Niveau de combat est la moyenne de vos 2 meilleures compétences d'arme et de votre compétence d'armure. Il détermine la difficulté des elites qui apparaissent autour de vous, donc votre puissance grandit naturellement au fil de votre jeu. L'équipement est lâché par les elite mobs et s'adapte à votre niveau — les items de niveau 20 et inférieur n'ont aucune restriction de compétence, donc les nouveaux joueurs peuvent librement équiper tout ce qu'ils trouvent au début.

Utilisez /em pour ouvrir le menu principal du joueur. Dans la ligne de code actuelle, il ouvre le flux de statut/menu pour les joueurs, et c'est toujours le point d'accès principal aux boutiques, quêtes, compétences, téléportations et plus encore.

À mesure que vous montez en niveau, vous débloquerez des Bonus de compétence — des capacités de combat spéciales liées à chaque type d'arme. Ils se débloquent aux niveaux de compétence 10, 25, 50 et 75, et vous pouvez sélectionner jusqu'à 3 bonus actifs par arme. Consultez la page Système de compétences pour tous les détails sur le fonctionnement des compétences et de la montée en niveau, et la page Bonus de compétence pour la liste complète des capacités.

Aperçu des fonctionnalités d'EliteMobs

Dans cette section, nous allons jeter un œil à certaines des principales fonctionnalités qu'EliteMobs a à offrir, ce qu'elles sont et comment vous pouvez les désactiver. Pour une liste complète des fonctionnalités, voir cette page.

Vous pouvez aussi consulter cette page pour trouver la manière prévue dont les joueurs sont censés interagir avec EliteMobs.

Boss dynamiques

Les Boss dynamiques sont l'une des principales fonctionnalités d'EliteMobs. Ils remplacent un pourcentage des apparitions vanilla de Minecraft par des apparitions d'Elite Mobs.

Les Elites sont des mobs plus coriaces conçus pour défier les joueurs et les récompenser avec d'éventuels drops de butin lorsqu'ils sont vaincus. Le niveau des Elites est déterminé par le Niveau de combat du joueur, qui dans EliteMobs 10 est calculé uniquement à partir des niveaux de compétence d'arme et d'armure (la moyenne de vos deux meilleures compétences d'arme et de votre compétence d'armure). Meilleur est votre butin, plus il est utile au combat, mais l'équipement que vous portez ne définit plus le niveau des elites qui apparaissent autour de vous.

Le niveau des élites suit le niveau de combat du joueur. La santé de base des boss double tous les cinq niveaux avant application des limites de santé ; les ajustements liés aux compétences du joueur et l'équipement suivent des formules distinctes. Consultez le système de dégâts.

Pour les élites naturelles utilisant le combat adaptatif par défaut, ajustez scaledDamageToEliteMultiplier et scaledDamageToPlayerMultiplier dans MobCombatSettings.yml. Le combat standard utilise damageToEliteMobMultiplierV2 et damageToPlayerMultiplierV2. Choisissez les paramètres du mode de combat actif.

Si vous souhaitez désactiver entièrement cette fonctionnalité, vous pouvez le faire en réglant la valeur doNaturalEliteMobSpawning sur false.

Exemple visuel

Items/Butin Elite

EliteMobs propose des items générés aléatoirement que l'on peut trouver dans les boutiques ou qui peuvent être lâchés par les Elites. Il y a aussi des items personnalisés que l'on trouve généralement dans les donjons et autres contenus Elite.

Les items Elite sont exactement comme les items vanilla, sauf qu'ils sont généralement dotés de bonus supplémentaires et sont plus puissants que tout ce que vous pouvez trouver dans le Minecraft vanilla. Certains items Elite auront des statistiques appelées Elite Sharpness et Elite Defense ; ces statistiques ne s'appliquent que lorsque les joueurs combattent des Elites et n'affectent pas les mobs vanilla.

Les items Elite peuvent aussi avoir des enchantements, des Enchantements personnalisés et des effets de potion.

Définissez doEliteMobsLoot: false dans ItemSettings.yml pour désactiver le gestionnaire habituel du butin à la mort des mobs. Cela ne désactive pas toutes les récompenses : les récompenses personnalisées des quêtes, coffres et arènes suivent des mécanismes distincts. Les compétences continuent à gagner de l'expérience, mais retirer le butin de combat modifie la progression de l'équipement.

Exemple visuel

Événements

Les événements sont des rencontres uniques dans EliteMobs qui peuvent se déclencher aléatoirement selon un minuteur ou par des actions spécifiques du joueur, comme miner un bloc ou abattre un arbre.

Ces rencontres mettent en scène des Elites personnalisés et uniques qui représentent un plus grand défi et offrent un butin précieux lorsqu'ils sont vaincus.

Les joueurs reçoivent des notifications dans le chat lorsqu'un événement se produit, avec la possibilité de suivre la vie et l'emplacement de l'Elite via un lien cliquable. Si l'Elite n'est pas vaincu dans un certain laps de temps, l'événement se termine et l'Elite disparaît.

Vous pouvez désactiver tous les événements en ouvrant events.yml et en réglant les valeurs actionEventsEnabled et timedEventsEnabled sur false.

Si vous souhaitez désactiver des événements individuels, vous pouvez aller dans ~plugins\EliteMobs\customevents. Vous y trouverez des configs pour chaque événement et vous pouvez désactiver n'importe quel événement en ouvrant sa config et en réglant la valeur isEnabled sur false.

Exemple visuel

Guilde des Aventuriers

La Guilde des Aventuriers est un monde hub supplémentaire que vous pouvez installer et c'est aussi un ensemble de commandes que les joueurs peuvent utiliser.

Si le monde hub n'est pas installé, les joueurs devront utiliser des commandes ; sinon, exécuter des commandes avec le monde hub installé téléportera les joueurs vers le monde hub, où ils pourront interagir avec les PNJ au lieu d'avoir à taper des commandes.

Quelles commandes ? EliteMobs possède plusieurs commandes que les joueurs peuvent utiliser pour vendre et acheter des items, réparer des items, enchanter des items et plus encore. Apprenez-en plus sur l'ensemble actuel des commandes ici.

La Guilde des Aventuriers comprend également des PNJ spécialisés tels que des PNJ de jeux d'argent (Blackjack, Pile ou Face, Machines à sous, Plus Haut/Plus Bas) et un PNJ de Boutique de Flèches pour acheter des flèches spéciales.

Pour plus d'informations sur la Guilde des Aventuriers et sur la façon d'installer le monde hub, consultez cette page.

Exemple visuel

Compétences d'armes et progression de l'équipement

Depuis EliteMobs 10, les compétences d'armes remplacent les rangs de guilde et le prestige. Onze compétences progressent au combat : Épées, Haches, Arcs, Arbalètes, Tridents, Houes, Masses, Lances, Bâtons, Baguettes et Armure. Chaque compétence propose des bonus sélectionnables aux niveaux 10, 25, 50 et 75 ; les joueurs peuvent en sélectionner jusqu'à trois par compétence. Bâtons et Baguettes disposent chacun de dix bonus et nécessitent FreeMinecraftModels pour leurs armes magiques.

Lorsque les restrictions d’équipement sont activées, le matériel élite au-dessus du niveau 20 exige le niveau de compétence correspondant plutôt qu’un rang de guilde. Les objets de niveau 20 ou inférieur sont exemptés.

Les restrictions de compétence déterminent l'équipement utilisable par les joueurs. Soulbind contrôle séparément la propriété et les échanges.

Exemple visuel

Arènes

Les arènes sont des défis par vagues où les joueurs peuvent s'engager dans le combat. Un ou plusieurs joueurs peuvent rejoindre une arène et affronter des vagues d'ennemis de plus en plus difficiles, avec des récompenses qui s'améliorent à mesure que le défi progresse.

Une fois le monde hub de la Guilde des Aventuriers installé, les joueurs accèdent à la Wood League Arena, une arène gratuite accessible via l'interaction avec un PNJ dans le monde hub ou via le menu /em.

Vous pouvez obtenir des arènes supplémentaires en vous rendant sur : Itch.io ou en vous abonnant sur Patreon.

Vous pouvez désactiver les arènes en vous rendant dans ~plugins\EliteMobs\customarenas puis en ouvrant la config de l'arène, par exemple wood_league.yml, puis en trouvant la valeur isEnabled et en la réglant sur false.

Exemple visuel

Donjons de monde

Les Donjons de monde sont du contenu personnalisé supplémentaire que vous pouvez télécharger pour EliteMobs. Les donjons ont généralement des boss Elite personnalisés, des mondes personnalisés, du butin personnalisé et des pouvoirs de boss personnalisés.

Tous les donjons de monde sont des donjons situés dans leur propre monde, ce qui signifie que lorsque les joueurs y accèdent, ils sont téléportés dans un monde qui ne contient rien d'autre que ce donjon.

Il existe plusieurs types de donjons de monde ; pour en savoir plus sur les types, cliquez ici.

Les donjons de monde à niveau fixe ont des plages de niveaux recommandées. Les donjons dynamiques utilisent aussi des mondes, mais créent des copies privées et adaptent le contenu au niveau choisi.

Vous pouvez obtenir des donjons en vous rendant sur : Itch.io ou en vous abonnant sur Patreon. Il existe plusieurs donjons gratuits que vous pouvez télécharger ici.

Vous pouvez désactiver des donjons individuels en vous rendant dans ~plugins\EliteMobs\content_packages et en ouvrant la config du donjon que vous souhaitez désactiver, puis en réglant la valeur isEnabled sur false.

Exemple visuel

Donjons instanciés

Les Donjons instanciés diffèrent des Donjons de monde de plusieurs façons. Ils sont instanciés, ce qui signifie qu'un nouveau monde est créé dynamiquement à partir d'un plan, offrant aux joueurs et à leurs amis une expérience de donjon privée similaire à celles que l'on trouve dans les MMO.

Les donjons instanciés peuvent définir la santé, les pouvoirs, le butin et les vies pour chaque difficulté. Les enchantements d'aggro sur l'armure permettent des rôles de tank et de dégâts ; les classes de combat avancé facultatives ajoutent leurs propres capacités. Les récompenses et mécanismes exacts dépendent du pack. Consultez la difficulté.

De plus, les joueurs peuvent se ressusciter mutuellement au sein des Donjons instanciés, leur permettant de reprendre rapidement le combat s'ils agissent assez vite.

Vous pouvez obtenir des donjons instanciés en vous rendant sur : Itch.io ou en vous abonnant sur Patreon. Il existe des donjons instanciés gratuits que vous pouvez télécharger ici.

Vous pouvez désactiver des donjons individuels en vous rendant dans ~plugins\EliteMobs\content_packages et en ouvrant la config du donjon que vous souhaitez désactiver, puis en réglant la valeur isEnabled sur false.

Exemple visuel

Donjons dynamiques

Les Donjons dynamiques sont un nouveau type de donjon introduit dans EliteMobs 9.6.0. Contrairement aux Donjons de monde ou aux Donjons instanciés à niveaux de difficulté fixes, les Donjons dynamiques permettent aux joueurs de sélectionner leur propre niveau de difficulté avant d'entrer.

Les joueurs choisissent d'abord un niveau de contenu, puis une difficulté. Le menu utilise le niveau actuel de compétence de combat et propose des niveaux par pas de cinq autour de celui-ci, dans les limites de 5 à 200. L'équipement et le rang de guilde ne déterminent pas ces choix. Les mobs s'adaptent au niveau de contenu choisi ; la difficulté contrôle séparément la synchronisation du niveau et les filtres de pouvoirs et de butin définis par l'auteur.

Ce système offre de la flexibilité aux joueurs à différents stades de progression pour vivre le même contenu à un niveau de défi approprié. Que vous cherchiez une partie tranquille ou un défi hardcore, les Donjons dynamiques s'adaptent à vos préférences.

Vous pouvez obtenir des donjons dynamiques en vous rendant sur : Itch.io ou en vous abonnant sur Patreon.

Vous pouvez désactiver des donjons individuels en vous rendant dans ~plugins\EliteMobs\content_packages et en ouvrant la config du donjon que vous souhaitez désactiver, puis en réglant la valeur isEnabled sur false.

Exemple visuel

Aventures

Les Aventures représentent le contenu supplémentaire le plus vaste disponible pour EliteMobs, arborant un monde immense doté d'un scénario captivant et d'une multitude de quêtes que les joueurs peuvent entreprendre.

Comportant des centaines de boss, pouvoirs et items personnalisés, les Aventures offrent une expérience de jeu immersive. Les quêtes au sein des Aventures fonctionnent de manière similaire à celles des MMO traditionnels, chargeant les joueurs d'objectifs tels que vaincre des mobs, localiser des items, interagir avec des PNJ, ou toute combinaison de ces éléments.

Les Aventures sont si grandes qu'elles contiennent même d'autres sous-donjons ou sous-arènes en leur sein.

Bien que les Aventures recommandent généralement une plage de niveaux définie pour les joueurs, il est conseillé aux joueurs de commencer leur aventure dans le bas de l'échelle de niveaux pour un plaisir optimal.

Vous pouvez obtenir des aventures en vous rendant sur : Itch.io ou en vous abonnant sur Patreon.

Vous pouvez désactiver des aventures individuelles en vous rendant dans ~plugins\EliteMobs\content_packages et en ouvrant la config de l'aventure que vous souhaitez désactiver, puis en réglant la valeur isEnabled sur false. Les Aventures peuvent comporter des sous-donjons et des sous-arènes supplémentaires qui accompagnent les aventures, alors assurez-vous de les désactiver également si vous désactivez une aventure.

Exemple visuel

Téléports par wormhole

EliteMobs propose également de simples téléporteurs de A à B appelés wormholes. Vous les verrez surtout utilisés dans le monde hub de la Guilde des Aventuriers comme moyen de téléporter les joueurs de là vers un donjon ou de retour au spawn du serveur.

Leurs styles intégrés sont un cube, un cristal ou un icosaèdre dessinés avec des entités d'affichage de blocs et des particules. Définissez noParticlesMode: true dans Wormholes.yml pour désactiver ces formes et particules. Les wormholes peuvent aussi utiliser des modèles décoratifs FreeMinecraftModels.

Vous pouvez créer vos propres wormholes et les utiliser comme bon vous semble. Cliquez ici pour savoir comment.

Exemple visuel

Contenu personnalisé

EliteMobs vous offre aussi la possibilité de créer votre propre contenu, y compris des boss, des donjons, des pouvoirs, des PNJ, des quêtes, des arènes, et bien plus encore ! Vous pouvez trouver des guides pour créer d'autres types de contenu que ceux listés ci-dessus dans le menu de la barre latérale du wiki.

Pour l'expérience de création de contenu la plus simple et la plus efficace, nous recommandons d'utiliser la WebApp. Cet outil vous permet de générer des fichiers de configuration prêts à l'emploi sans avoir besoin de parcourir abondamment le wiki pour vous assurer de leur exactitude, en particulier si vous envisagez de créer des pouvoirs de boss EliteScript. Accédez à la WebApp ici.

EliteMobs intègre FreeMinecraftModels pour les modèles 3D de boss. Le code actuel est compilé avec FreeMinecraftModels 2.12.2 ; cette dépendance de compilation ne prouve pas la compatibilité avec tous les serveurs ou toutes les versions ultérieures du plugin.

Pour les administrateurs et propriétaires de serveur

Ce plugin est conçu pour les serveurs survie et de type survie (tels que Skyblock, Skywars et les variantes survie fortement moddées).

Le plugin est prévu pour être facilement utilisable simplement en glissant-déposant le jar du plugin dans le serveur. Les paramètres par défaut sont ceux que j'utilise sur mes propres serveurs et sont susceptibles de changer au fil du temps.

Cependant ! La personnalisation a été une priorité absolue tout au long du processus de développement d'EliteMobs. Presque tous les aspects du plugin peuvent être traduits, personnalisés, désactivés ou modifiés.

Pour les autres développeurs

Malgré la nature GPLV3 et open-source de ce projet, je ne recherche ni n'accepterai aucun ajout ou changement de code pour le moment. J'accueille les forks du plugin, et je prendrais un immense plaisir à voir ce que vous pourriez en faire ; cependant, c'est mon premier projet de programmation d'envergure et, en tant que tel, c'est aussi une expérience d'apprentissage.

Cependant ! Ne prenez pas cela comme si je prétendais être au-dessus de toute critique ou que je n'écouterai pas les retours - bien au contraire, j'adore quand les gens me signalent de meilleures façons d'accomplir les choses que j'ai faites dans le plugin. Je souhaite que ce projet soit quelque chose que j'ai écrit de bout en bout, sans aucun bout de code dont je ne suis pas conscient ou que je ne comprends pas.