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.3.x).

L'arbre source actuel est construit sur l'API Minecraft 1.21.4 et Java 21.

EliteMobs 10 comprend le système de progression des compétences d'armes actuel, la gestion de contenu intégrée à Nightbreak, et le nouveau flux d'installation basé sur /em initialize et /em setup. Les joueurs Bedrock (via Geyser) peuvent voir les boss et PNJ avec modèles personnalisés, et EliteMobs expose une API inter-plugins LocationOwnership afin que d'autres plugins utilisant MagmaCore puissent demander si une location appartient à EliteMobs/est protégée par EliteMobs et à quel type de contenu elle appartient.

Si vous exécutez intentionnellement une version majeure plus ancienne d'EliteMobs, considérez cette section du wiki comme étant la documentation de la ligne actuelle et vérifiez le comportement plus ancien dans cette branche-là à la place.

À quoi sert EliteMobs ?

EliteMobs a pour but d'étendre l'end-game de Minecraft en implémentant divers contenus liés aux boss.

Cela signifie :

• Boss Dynamiques (Mobs avec 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 l'intégration BetterStructures)
• Objets personnalisés (Objets/Butin Elite)
• Compétences d'armes et Bonus de compétence
• ... et bien plus encore !

Le plugin n'a pas pour but de remplacer le contenu vanilla de Minecraft mais plutôt de le compléter, ce qui permet aux joueurs de se désengager du contenu EliteMobs s'ils le souhaitent. Les objets EliteMobs n'affectent généralement pas le PvP ou le combat vanilla de Minecraft, car leurs bonus de dégâts et de défense ne s'appliquent que pendant les combats contre des EliteMobs.

Premiers pas

Vous découvrez EliteMobs ? Il existe deux points de départ distincts :

• les propriétaires de serveur doivent compléter le flux d'installation 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é l'installation

Votre Niveau de Combat est la moyenne de vos 2 meilleures compétences d'arme et de votre compétence d'armure. Cela détermine la difficulté des elites qui apparaissent autour de vous, votre puissance augmente donc naturellement à mesure que vous jouez. L'équipement est obtenu en tuant des elite mobs et son niveau évolue avec le vôtre — les objets de niveau 20 ou inférieur n'ont aucune restriction de compétence, ce qui permet aux nouveaux joueurs d'équiper librement tout ce qu'ils trouvent au début.

Utilisez /em pour ouvrir le menu principal du joueur. Dans la ligne de code actuelle, cela ouvre le flux de menu/statut pour les joueurs, et c'est toujours le point d'accès principal aux boutiques, quêtes, compétences, téléporteurs, 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. Celles-ci 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 progression, et la page Bonus de compétences pour la liste complète des capacités.

Aperçu des fonctionnalités d'EliteMobs

Dans cette section, nous allons examiner certaines des fonctionnalités majeures qu'EliteMobs propose, ce qu'elles sont et comment vous pouvez les désactiver. Pour une liste complète des fonctionnalités, voir cette page.

Vous pouvez également consulter cette page pour découvrir la manière dont les joueurs sont censés interagir avec EliteMobs.

Boss Dynamiques

Les Boss Dynamiques sont l'une des principales fonctionnalités d'EliteMobs. Cela remplace un pourcentage des apparitions vanilla de Minecraft par des apparitions d'Elite Mobs.

Les Elites sont des mobs plus puissants conçus pour défier les joueurs et les récompenser avec d'éventuels drops de butin après leur défaite. Le niveau des Elites est déterminé par la qualité de l'armure et de l'équipement portés par le joueur. L'équipement Minecraft normal a un niveau déterminé par la qualité du matériau, comme expliqué ici. Cependant, à mesure que les joueurs vainquent des Elites et acquièrent un meilleur butin, ils commenceront à obtenir des objets Elite avec des niveaux définis, ce qui facilite la prévision des niveaux des Elites qui apparaîtront.

Cela implique que les niveaux des joueurs sont déterminés par l'équipement qu'ils portent et leurs niveaux de compétence d'arme, tandis que les niveaux des Elites sont déterminés par les niveaux des joueurs. Depuis EliteMobs 10, les compétences d'armes contribuent à 50 % au niveau de combat effectif d'un joueur, en complément du niveau d'objet, 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 sont disponibles ici.

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

Exemple visuel

Objets/Butin Elite

EliteMobs propose des objets générés aléatoirement qui peuvent être trouvés dans les boutiques ou lâchés par les Elites. Il existe également des objets personnalisés que l'on trouve généralement dans les donjons et autres contenus Elite.

Les objets Elite sont comme les objets vanilla sauf qu'ils sont généralement équipés d'extras et sont plus puissants que tout ce que vous pouvez trouver dans Minecraft vanilla. Certains objets Elite auront des stats appelées Elite Sharpness et Elite Defense, ces stats ne s'appliquent que lorsque les joueurs combattent des Elites et n'affectent pas les mobs vanilla.

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

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

Exemple visuel

Événements

Les Événements sont des rencontres uniques dans EliteMobs qui peuvent se déclencher aléatoirement en fonction d'un minuteur ou d'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 posent un plus grand défi et offrent un butin précieux après leur défaite.

Les joueurs reçoivent des notifications dans le chat lorsqu'un événement se produit, avec la possibilité de suivre la santé 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 configurations pour chaque événement et vous pourrez désactiver n'importe quel événement en ouvrant sa configuration 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 des PNJ au lieu d'avoir à taper des commandes.

Quelles commandes ? EliteMobs dispose de plusieurs commandes que les joueurs peuvent utiliser pour vendre et acheter des objets, réparer des objets, enchanter des objets et plus encore. Apprenez-en plus sur les commandes actuelles 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 comment installer le monde hub, consultez cette page.

Exemple visuel

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

Depuis EliteMobs 10, l'ancien système de niveau/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 paliers de niveau, avec des types de bonus incluant passif, conditionnel, proc, cumulatif et avec 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 d'équipement au-dessus de leur niveau de compétence, ce qui empêche le powerleveling et assure une progression équilibrée.

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

Exemple visuel

Arènes

Les Arènes sont des défis par vagues où les joueurs peuvent s'engager dans des combats. 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.

Lors de l'installation du monde hub Guilde des Aventuriers, les joueurs ont accès à 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 sur : Itch.io ou en vous abonnant sur Patreon.

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

Exemple visuel

Donjons mondiaux

Les Donjons mondiaux 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 mondiaux 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 vers un monde qui ne contient rien d'autre que ce donjon.

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

Tous les donjons mondiaux ont un niveau défini et les joueurs qui tentent les donjons devraient être à peu près à ce niveau pour la meilleure expérience.

Vous pouvez obtenir des donjons en allant 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 allant dans ~plugins\EliteMobs\content_packages et en ouvrant la configuration 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 mondiaux à plusieurs égards. 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 santé augmentée et un butin supérieur à mesure que la difficulté augmente. Ils introduisent également des rôles, permettant aux joueurs d'adopter des rôles de tank ou DPS en fonction de leur équipement (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 dans les Donjons instanciés, leur permettant de reprendre rapidement le combat s'ils agissent assez vite.

Vous pouvez obtenir des donjons instanciés en allant 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 allant dans ~plugins\EliteMobs\dungeonpackages et en ouvrant la configuration 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 mondiaux ou aux Donjons instanciés avec des niveaux de difficulté fixes, les Donjons dynamiques permettent aux joueurs de sélectionner leur propre niveau de difficulté avant d'y entrer.

Une fois que les joueurs choisissent une difficulté, tous les mobs du donjon sont définis 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 une flexibilité aux joueurs de différents stades de progression pour vivre le même contenu à un niveau de défi approprié. Que vous cherchiez une session décontractée ou un défi hardcore, les Donjons dynamiques s'adaptent à vos préférences.

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

Vous pouvez désactiver des donjons individuels en allant dans ~plugins\EliteMobs\dungeonpackages et en ouvrant la configuration 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, comprenant un monde immense doté d'une intrigue captivante et d'une multitude de quêtes pour les joueurs.

Avec des centaines de boss, pouvoirs et objets personnalisés, les Aventures offrent une expérience de jeu immersive. Les quêtes dans les Aventures fonctionnent de manière similaire à celles des MMO traditionnels, demandant aux joueurs d'accomplir des objectifs tels que vaincre des mobs, localiser des objets, 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 situés à l'intérieur.

Bien que les Aventures recommandent généralement une plage de niveau définie pour les joueurs, il est conseillé aux joueurs de commencer leur aventure au bas de la plage de niveaux pour un plaisir optimal.

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

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

Exemple visuel

Téléporteurs Wormhole

EliteMobs propose également de simples téléporteurs de A à B appelés wormholes. Vous les verrez principalement utilisés dans le monde hub Guilde des Aventuriers comme moyen de téléporter les joueurs depuis cet endroit 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 diamant fait de particules. Ces particules peuvent parfois causer du lag aux clients Bedrock, vous pouvez donc vouloir 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 également la possibilité de créer votre propre contenu, y compris des boss, donjons, pouvoirs, PNJ, quêtes, arènes, et bien plus encore ! Vous pouvez trouver des guides pour créer d'autres types de contenu que ceux énumérés ci-dessus dans le menu latéral 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, accessoires et meubles. Cette intégration permet aux créateurs de contenu de concevoir des expériences visuelles uniques au-delà des entités Minecraft standards. FreeMinecraftModels 2.3.14+ est recommandé pour une compatibilité totale avec le contenu EliteMobs le plus récent.

Pour les administrateurs et propriétaires de serveurs

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

Le plugin est conçu pour être facilement utilisable en faisant simplement glisser-déposer 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 d'évoluer avec le temps.

Cependant ! La personnalisation a été une priorité majeure 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 cherche pas et n'accepterai pas d'ajouts ou modifications de code à ce stade. J'accueille volontiers les forks du plugin et serais ravi de voir ce que vous pourriez en faire ; cependant, c'est mon premier projet de programmation massif et c'est aussi une expérience d'apprentissage.

Cependant ! Ne prenez pas cela comme moi prétendant être au-dessus de toute critique ou que je n'écouterai pas les retours - bien au contraire, j'adore quand les gens soulignent de meilleures façons d'accomplir des 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 extraits de code dont je ne suis pas conscient ou que je ne comprends pas.