Plugin Minecraft SkBee

🔌 À propos de SkBee

SkBee est un addon pour Skript qui étend le langage Skript avec un large ensemble d’éléments exposant les internals du serveur et les fonctionnalités modernes de Minecraft aux auteurs de scripts. Il fournit des syntaxes et des utilitaires pour travailler avec le NBT, les composants de texte avancés, les scoreboards, les recettes, les données de blocs, les structures, la création de mondes et des régions/limites simples — permettant aux administrateurs de serveur d’implémenter des mécaniques complexes avec Skript plutôt qu’en Java.

🎯 Objectif

L’objectif principal de SkBee est de donner aux utilisateurs de Skript un accès direct aux fonctionnalités des API serveur Bukkit/Paper et aux internals de Minecraft, autrement difficiles ou impossibles à atteindre avec Skript vanilla. Il est destiné aux propriétaires de serveurs et aux scripteurs qui ont besoin d’un contrôle plus précis sur les objets, les entités, le formatage du texte, la manipulation du monde et la gestion des structures dans leurs scripts Skript.

⚙️ Fonctionnalités

• Éléments NBT : obtenir/définir le NBT des objets, des tile entities (blocs) et des entités (indiqué comme disponible pour les anciennes versions jusqu’en 1.8.8+ lorsque pris en charge).
• FastBoards : une implémentation de scoreboard conçue pour réduire le scintillement (disponible sur les versions plus récentes de Minecraft lorsque pris en charge).
• Recettes : ajouter des recettes personnalisées et supprimer les recettes vanilla (fonctionnalités indiquées comme disponibles à partir des versions plus récentes, par ex. 1.13+ pour les API de recettes).
• BlockData : accès simplifié pour obtenir/définir les données de bloc pour les états de bloc modernes (disponible sur les versions prises en charge).
• Structures : sauvegarder et coller des structures vanilla de Minecraft à l’aide du système de structures du jeu.
• TextComponents : créer et manipuler des messages de type JSON/TextComponent avec événements de survol et de clic, ainsi que la prise en charge du survol d’objet.
• WorldCreator : créer des mondes personnalisés avec des options configurables exposées à Skript.
• Bounds : créer des limites/régions simples, similaires à une protection légère de région, à utiliser dans Skript.
• GameEvents : s’intégrer au système GameEvent de Minecraft (utilisé par les capteurs de sculk et les mécaniques associées).

🧩 Pour qui

• Les administrateurs de serveur qui utilisent Skript et ont besoin d’un accès plus profond à l’API sans écrire de plugins Java.
• Les développeurs Skript qui créent des interfaces avancées, des objets personnalisés, des messages structurés ou des outils de monde/structure.
• Les serveurs Survival, SMP et les serveurs de jeux personnalisés qui s’appuient sur Skript pour les mécaniques de gameplay et veulent étendre les fonctionnalités.

🏗️ Exemples d’utilisation

• Un scripteur lit et modifie le NBT d’un objet pour implémenter un comportement et des attributs personnalisés dans Skript.
• Un admin crée des recettes de craft personnalisées et supprime les recettes vanilla indésirables via la syntaxe Skript.
• Des créateurs sauvegardent et collent des structures préfabriquées pendant la génération du monde ou avec des outils de construction en jeu.
• Des systèmes de chat ou d’interface qui ont besoin de composants de texte JSON avec actions de survol/clic et aperçus d’objets.

⚙️ Installation

📥 Configuration

• Récupérez le plugin SkBee .jar depuis une source officielle de téléchargement et placez-le dans le dossier plugins/ du serveur, à côté de Skript.
• Redémarrez le serveur pour que Skript et ses addons se chargent proprement.
• Vérifiez les logs de la console du serveur pour confirmer que SkBee s’est chargé avec succès et qu’il a détecté la version installée de Skript.

📦 Dépendances

• Skript (SkBee est un addon pour Skript ; les builds récents de SkBee nécessitent des versions récentes de Skript — consultez les notes de version du plugin pour connaître les versions exactes requises).

🧠 Notes techniques

• SkBee est maintenu comme un projet open source sous licence GPL-3.0.
• Différentes fonctionnalités peuvent dépendre de la version : certains éléments (par exemple la gestion du NBT) ont des notes de compatibilité pour les anciennes versions de Minecraft (la documentation d’origine mentionne une disponibilité à partir de 1.8.8+ pour certaines fonctionnalités et 1.13+ pour d’autres).
• SkBee fournit des JavaDocs et un wiki pour les syntaxes ; consultez ces références lorsque vous écrivez des fichiers Skript qui utilisent les fonctionnalités de SkBee.
• SkBee vise à prendre en charge les versions récentes de Skript et de Minecraft ; les versions requises de Skript ou de Minecraft varient selon la version de SkBee — vérifiez les notes de version du build que vous téléchargez.

🤝 Quand ce plugin est utile

Si vous utilisez Skript comme système de scripting de votre serveur et avez besoin d’accéder au NBT, à des messages texte structurés, à des recettes personnalisées, à la sauvegarde/collage de structures ou à des outils simples de création de régions et de mondes sans écrire en Java, SkBee propose un large ensemble de syntaxes et d’utilitaires confirmés pour étendre ce que vous pouvez implémenter uniquement avec Skript.