Plugin Minecraft eco

🔌 À propos de eco

eco est une bibliothèque de développement Spigot (un plugin Minecraft autonome) conçue pour simplifier le développement de plugins et fournir des fonctionnalités de moteur réutilisables pour d’autres plugins. Elle expose des API pour les commandes et la configuration, des adaptateurs de stockage persistant, des systèmes d’interface graphique et d’objets personnalisés, ainsi que de nombreuses intégrations, afin que les auteurs de plugins puissent réutiliser des fonctionnalités communes au lieu de les réimplémenter.

🎯 Objectif

eco existe pour centraliser les systèmes courants destinés aux développeurs dont les plugins modernes ont besoin : analyse des commandes, formats de couleurs et de messages, formats de configuration, accès aux données persistantes, composants d’interface, gestion des objets et intégrations avec d’autres systèmes côté serveur. Il est destiné aux auteurs de plugins qui veulent créer des fonctionnalités rapidement sur une base partagée et maintenue.

⚙️ Fonctionnalités

• API de commandes moderne et analyse
• Analyse native des couleurs avec prise en charge de hex / RGB / MiniMessage
• Système de configuration compatible avec YAML, JSON et TOML
• API de stockage de données persistantes avec backends YAML, MySQL et MongoDB
• API de GUI et composants préconstruits
• Objets personnalisés et gestion ultra-rapide de ItemStack
• Affichage d’objets via packets et boucle d’événements de packets légère
• API d’IA d’entités avec des mappages NMS presque 1:1
• API Placeholder et intégrations natives (plus de 30 intégrations listées par le projet)
• Abstraction prix/économie (système de prix prenant en charge les plugins d’économie, l’XP et les objets)
• Prise en charge native de bStats et vérification des mises à jour du plugin
• Système d’extensions (plugins pour plugins) et outils d’injection de dépendances pour les développeurs

🧩 À qui cela s’adresse

• Développeurs de plugins créant des plugins compatibles Spigot/Paper et recherchant une base réutilisable
• Propriétaires de serveurs exécutant des plugins qui dépendent de eco (eco doit être installé comme dépendance)
• Projets nécessitant des objets personnalisés, des GUIs ou des outils unifiés de persistance et de commandes

🏗️ Exemples d’utilisation

• Un développeur implémente un pack d’objets personnalisés qui utilise la recherche d’objets et les API de GUI de eco.
• Un plugin utilise l’API de stockage de eco pour prendre en charge à la fois un YAML local et un backend MongoDB distant sans dupliquer de code.
• Plusieurs petits plugins partagent eco pour assurer une gestion cohérente des commandes et de l’analyse des couleurs.

⚙️ Installation

📥 Configuration

• Installez eco comme plugin sur tout serveur qui en a besoin en plaçant le JAR dans le dossier plugins/ du serveur, puis en redémarrant le serveur.
• Si un autre plugin dépend de eco, déclarez-le dans le plugin.yml de ce plugin sous depend: avec - eco afin que le serveur charge eco en premier.

📦 Dépendance (pour les développeurs de plugins)

• Le projet publie un dépôt Maven et des coordonnées Gradle pour une utilisation compile-only. Le projet propose un artefact publié (par exemple avec le groupe com.willfp et des tags de version) afin que les développeurs ajoutent eco comme dépendance fournie pendant la compilation.

🧠 Notes techniques

• Logiciels serveur pris en charge : le projet officiel indique la prise en charge de Spigot, Paper, Purpur et Folia.
• Versions Minecraft prises en charge : le projet indique une prise en charge à partir de la 1.21.4, et les versions ultérieures visent la série moderne 1.21.x.
• Backends de stockage : des adaptateurs YAML, MySQL et MongoDB sont fournis par le framework.
• Licence : eco est distribué sous licence MIT.

🤝 Quand ce plugin est utile

Si vous développez plusieurs fonctionnalités ou plugins qui partagent des besoins communs (commandes, formats de configuration, composants de GUI, stockage, objets personnalisés), eco réduit le travail en double en fournissant un framework maintenu et des intégrations dont d’autres plugins peuvent dépendre.