Plugin Minecraft ItemJoin

🔌 À propos de ItemJoin

ItemJoin est un plugin Minecraft qui permet de donner automatiquement aux joueurs des objets personnalisés hautement configurables. Les objets peuvent être attribués lors d'événements comme join, first-join, respawn, world-switch, region-enter et region-leave. Le plugin se concentre sur des définitions d'objets flexibles (itemflags), des événements déclencheurs et des commandes liées aux objets afin que les serveurs puissent proposer des menus de lobby, des kits de départ ou des outils sensibles au contexte sans mods client personnalisés.

🎯 Objectif

ItemJoin résout le problème consistant à fournir de manière fiable aux joueurs des objets personnalisés ou interactifs liés aux événements et aux mondes du serveur. Il est utile pour les serveurs hub/lobby, les serveurs de mini-jeux, les réseaux de survie (où les objets doivent être limités par monde) et les réseaux qui ont besoin de menus pilotés par des objets ou d'objets qui lancent des commandes.

⚙️ Fonctionnalités

• Attribuer des objets via des déclencheurs configurables : join, first-join, respawn, world-switch, region-enter/exit et événements similaires.
• itemflags par objet qui modifient le comportement (slot, overwrite, règles de stack, blocage du déplacement/de la récupération, limites de gamemode, chance de réception, cooldowns).
• ItemCommands : associer des commandes aux objets et configurer le contexte d'exécution (console, player, server, message) ainsi que les types d'action (clic gauche/droit, clic dans l'inventaire, physique, multi-clic).
• Intégration PlaceholderAPI pour des noms/lore d'objets dynamiques et prise en charge des placeholders.
• Prise en charge des têtes de joueurs personnalisées (textures et propriétaires personnalisés), des images de cartes, des tipped arrows, des livres, des bannières, des feux d'artifice, de la personnalisation des armures en cuir et des niveaux d'enchantement personnalisés.
• Bloquer en option le déplacement ou la récupération d'objets dans des mondes spécifiques et restreindre les objets par adresse IP ou par état de first-join.
• Créateur d'interface GUI en jeu pour construire des ensembles d'objets et un flux intégré d'importation/création.
• API pour les autres plugins : disponible sous me.RockinChaos.itemjoin.api.ItemJoinAPI.

🧩 Pour qui ?

• Les propriétaires de serveurs qui ont besoin d'objets automatiques de lobby/hub ou de kits de départ.
• Les opérateurs de mini-jeux et de réseaux qui ont besoin d'objets spécifiques à un monde ou de compas de menu.
• Les développeurs qui veulent un système d'objets intégrable via une API.

🏗️ Exemples d'utilisation

• Donner aux joueurs un compas de menu à la connexion qui exécute différentes commandes lorsqu'on clique dessus.
• Fournir des kits de départ uniques au first-join tout en empêchant le transfert d'objets entre certains mondes.
• Créer des objets interactifs qui exécutent des commandes d'économie/boutique avec des cooldowns et des coûts.

⌨️ Commandes

Remarque : ces commandes et sous-commandes sont tirées de l'ensemble de commandes documenté du plugin. Le plugin fournit des sous-commandes supplémentaires dans son wiki et dans l'aide générée.

🔐 Permissions

Le comportement des permissions spécifiques aux objets est configurable ; les vérifications de permission liées aux objets sont désactivées par défaut et doivent être activées dans la configuration du plugin pour prendre effet.

⚙️ Installation

📥 Mise en place

• Téléchargez le jar officiel de ItemJoin et placez-le dans le dossier plugins/ de votre serveur.
• Assurez-vous qu'il n'existe aucun doublon du jar ItemJoin dans plugins/ (par exemple ItemJoin(1).jar).
• Redémarrez le serveur afin que le plugin puisse générer sa configuration et enregistrer ses fonctionnalités pour la version de votre serveur.
• Vérifiez les logs de la console du serveur pour confirmer le chargement du plugin et consultez le wiki du plugin pour une installation détaillée.

📦 Dépendances

Le plugin n'a pas d'exigences d'exécution obligatoires, mais répertorie plusieurs soft-dependencies et intégrations courantes (facultatives et activées lorsqu'elles sont présentes) :

• Vault
• AuthMe
• BetterNick
• HeadDatabase
• PlaceholderAPI
• SkinRestorerX
• TokenEnchant
• WorldEdit
• WorldGuard

Activez ou configurez les intégrations selon vos besoins ; le plugin fonctionne sans elles, mais des fonctionnalités comme les placeholders, les têtes/skins personnalisés et les hooks d'économie dépendent des plugins correspondants.

🧠 Notes techniques

• Plateformes : confirmé pour les serveurs de type Spigot (Spigot, Bukkit, Paper, Purpur, Folia).
• Plage Minecraft prise en charge/testée : de 1.8 à 1.21.
• Le code source et les versions sont publiés, et le projet expose une API à me.RockinChaos.itemjoin.api.ItemJoinAPI pour permettre à d'autres plugins de s'y raccorder.
• Licence : LGPL-3.0.

🤝 Quand ce plugin est utile

Si vous avez besoin d'un système flexible et configurable pour fournir aux joueurs des objets interactifs et contextuels (menus, kits de départ, outils spécifiques à un monde) et que vous voulez une API pour les intégrations, ItemJoin offre ces fonctionnalités tout en prenant en charge les plugins courants de placeholders et de skins.