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 cible la ligne de code actuelle d'EliteMobs 10 (10.6.x).

L'arbre source actuel est compilé contre l'API Minecraft 1.21.4 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
• ... 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

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.

Cela signifie que les niveaux d'Elite sont déterminés par le niveau de combat du joueur (sa progression de compétences), et le système de combat utilise une mise à l'échelle exponentielle où chaque tranche de 5 niveaux équivaut à une puissance multipliée par 2.

Vous pouvez ajuster la difficulté des elites en modifiant les valeurs damageToEliteMobMultiplierV2 et damageToPlayerMultiplierV2 dans MobCombatSettings.yml. Plus d'informations à ce sujet ici.

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.

Vous pouvez désactiver les items Elite en ouvrant ItemSettings.yml et en réglant la valeur doEliteMobsLoot sur false. (Non recommandé, rend impossible la progression de niveau de type MMORPG.)

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

À partir d'EliteMobs 10, l'ancien système de palier/rang de guilde et de prestige a été remplacé par un système de compétences d'armes. Il existe 9 types de compétences -- Épées, Haches, Arcs, Arbalètes, Tridents, Houes, Masses, Lances et Armure -- qui montent en niveau grâce au combat. Chaque type d'arme possède des bonus de compétence uniques qui se débloquent à différents seuils de niveau, avec des types de bonus incluant passif, conditionnel, proc, cumulatif et à temps de recharge. Les joueurs peuvent sélectionner jusqu'à 3 bonus de compétence actifs par type d'arme.

L'équipement est désormais limité par le niveau de compétence plutôt que par le rang de guilde. Les joueurs ne peuvent pas équiper du matériel au-dessus de leur niveau de compétence, ce qui empêche le powerleveling et garantit une progression équilibrée.

Ce système, combiné à l'enchantement soulbind, maintient l'équilibre du serveur et favorise l'attachement des joueurs au butin qu'ils ont acquis.

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.

Tous les donjons de monde ont un niveau défini et tout joueur tentant les donjons devrait être à peu près à ce niveau pour la meilleure expérience.

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 offrent diverses difficultés avec des pouvoirs de boss uniques, une vie accrue et un meilleur butin à mesure que la difficulté augmente. Ils introduisent aussi des rôles, permettant aux joueurs d'adopter des rôles de tank ou de DPS selon l'équipement qu'ils portent (l'équipement spécifique aux rôles est exclusif aux Donjons instanciés). Apprenez-en plus sur le fonctionnement de la difficulté ici.

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\dungeonpackages 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.

Une fois que les joueurs choisissent une difficulté, tous les mobs du donjon sont réglés pour correspondre au niveau sélectionné. Le menu de sélection de difficulté est basé sur votre progression actuelle de compétences et d'équipement, avec des recommandations fournies pour des options plus faciles ou plus difficiles afin de vous aider à faire le meilleur choix pour votre niveau.

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\dungeonpackages 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\dungeonpackages 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.

Ils ont généralement la forme d'un hexagone, d'un cube ou d'un losange fait de particules. Ces particules peuvent parfois causer du lag aux clients bedrock, vous voudrez donc peut-être désactiver les effets de particules en ouvrant Wormholes.yml et en réglant noParticlesMode sur true.

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.

Pour une personnalisation visuelle améliorée, EliteMobs s'intègre avec FreeMinecraftModels, vous permettant d'utiliser des modèles 3D entièrement personnalisés pour les boss, les props et le mobilier. Cette intégration permet aux créateurs de contenu de concevoir des expériences visuelles uniques au-delà des entités standard de Minecraft. FreeMinecraftModels 2.3.14+ est recommandé pour une compatibilité complète avec le dernier contenu EliteMobs.

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.