Plugin Minecraft NBTAPI

🔌 À propos de NBT-API

NBT-API (Item-NBT-API) est une bibliothèque de plugin Minecraft qui permet aux développeurs de lire, écrire et attacher des balises NBT aux objets, entités et tile entities sans utiliser NMS. Le projet fournit un wrapper stable pour travailler avec le NBT à travers les différentes versions de serveur et propose des utilitaires pour sérialiser et conserver les données NBT.

🎯 Objectif

Fournir une API destinée aux développeurs pour manipuler les données Named Binary Tag (NBT), afin que les auteurs de plugins puissent stocker des métadonnées, des données personnalisées d’objets, des balises d’entités ou des données de tile entities sans dépendre directement des internals du serveur.

⚙️ Fonctionnalités

• Lire et écrire le NBT des objets, entités et tile entities.
• Créer et modifier des compounds NBT imbriqués et des types de balises primitives.
• Utilitaires pour stocker le NBT sous forme de texte ou dans d’autres conteneurs.
• Prise en charge de la sérialisation du NBT dans des fichiers ou sous forme de chaînes pour le stockage dans YAML/JSON/SQL/Redis.
• Vise à fournir une couche d’abstraction stable à travers les changements de version du serveur.

🧩 À qui s’adresse-t-il

• Aux développeurs de plugins qui ont besoin d’un accès fiable au NBT sans écrire de NMS.
• Aux serveurs qui nécessitent des métadonnées d’objets personnalisées ou des données persistantes d’entités/tile entities gérées par des plugins.

🏗️ Exemples d’utilisation

• Attacher des métadonnées personnalisées à un item stack qui persiste entre les sauvegardes.
• Stocker des propriétés supplémentaires sur des entités (par exemple des identifiants personnalisés) sans modifier le code du serveur.
• Sérialiser le NBT d’un objet ou d’un bloc dans une base de données ou un fichier de configuration pour le restaurer plus tard.

⚙️ Installation

📥 Configuration

• Téléchargez le JAR officiel du plugin et/ou incluez l’API comme dépendance dans votre système de build.
• Placez le JAR du plugin dans le dossier plugins/ du serveur (si vous utilisez la version plugin) ou ajoutez l’API comme dépendance de compilation/exécution pour votre plugin.
• Redémarrez le serveur et vérifiez la console pour confirmer que la bibliothèque/le plugin a bien été chargé.

🧠 Notes techniques

• Le projet est publié et maintenu sur GitHub et distribué sous licence MIT.
• Les sources officielles indiquent une prise en charge des environnements de serveur Bukkit/Spigot/Paper.
• La bibliothèque comprend des modules pour une utilisation directe dans des projets de plugins et un module de plugin pour une utilisation sur serveur.

🤝 Quand ce plugin est utile

Si vous avez besoin d’un accès fiable et tolérant aux versions au NBT des objets, entités ou tile entities sans toucher à NMS, NBT-API fournit une bibliothèque ciblée qui simplifie la lecture, l’écriture et la persistance de ces données pour les développeurs de plugins.