Plugin Minecraft SCore

🔌 À propos de SCore

SCore est le plugin cœur/bibliothèque produit par Ssomar pour centraliser les fonctionnalités partagées utilisées dans toute sa suite de plugins. Il fournit des éditeurs en jeu et des fonctionnalités à l’exécution dont dépendent les autres plugins Ssomar, et peut aussi être utilisé de manière autonome pour créer et lancer des projectiles personnalisés, gérer des variables et exécuter des commandes personnalisées empaquetées.

🎯 Objectif

SCore existe pour offrir une base réutilisable aux auteurs de plugins (en particulier à la famille de plugins Ssomar) afin que les fonctionnalités soient implémentées une seule fois et utilisées par plusieurs plugins. Il s’adresse aux développeurs et aux administrateurs de serveurs qui font tourner un ou plusieurs plugins Ssomar ou qui souhaitent disposer de ses mécaniques réutilisables sur leur serveur.

⚙️ Fonctionnalités

• Éditeur en jeu pour créer et modifier des projectiles personnalisés.
• Projectiles personnalisés à l’exécution pouvant être lancés ou déclenchés.
• Variables globales et par joueur avec les types (NUMBER, STRING, LIST).
• Prise en charge des placeholders pour les variables (tokens de placeholder à utiliser dans d’autres plugins/configurations).
• Cadre d’exécution de commandes empaquetées/personnalisées accessible depuis la console du serveur ou d’autres plugins.
• Conçu pour être utilisé comme dépendance par d’autres plugins Ssomar.

🧩 Pour qui

• Propriétaires de serveurs utilisant des plugins Ssomar (ExecutableItems, ExecutableBlocks, etc.).
• Développeurs ayant besoin d’une bibliothèque réutilisable pour les projectiles, les variables et l’exécution de commandes personnalisées.
• Administrateurs souhaitant des éditeurs légers intégrés au serveur pour ces fonctionnalités.

🏗️ Exemples d’utilisation

• Un serveur utilise SCore avec ExecutableItems pour définir et lancer des comportements de projectiles personnalisés.
• Un admin crée des variables globales ou par joueur et les expose comme placeholders pour des menus ou d’autres plugins.
• Un développeur de plugin s’appuie sur SCore pour réutiliser le stockage des variables et l’empaquetage des commandes à travers plusieurs plugins.

⌨️ Commandes

Remarques : la documentation officielle décrit aussi les tokens de placeholder pour les variables (par exemple, %score_variables_<var_name>% et %score_variables_<var_name>_int%). Les nœuds de permission ne sont pas listés dans les métadonnées du plugin référencé.

⚙️ Installation

📥 Configuration

• Téléchargez le fichier .jar officiel de SCore pour la version de plugin correspondante.
• Placez le fichier .jar dans le répertoire plugins/ du serveur.
• Redémarrez le serveur et vérifiez la console pour confirmer que SCore a bien été chargé.
• Si vous utilisez d’autres plugins Ssomar, installez la version de SCore qui correspond à leur suffixe de version, comme conseillé par le projet (faire correspondre la build de SCore à celle du plugin dépendant).

🧠 Notes techniques

• Plates-formes prises en charge confirmées : Bukkit, Spigot, Paper, Purpur, Folia.
• Les versions Minecraft prises en charge confirmées incluent : de 1.21.x jusqu’à 1.8.x (selon la liste du projet).
• Les métadonnées du projet indiquent une licence restrictive (ARR / All Rights Reserved), tandis que la distribution du projet fait aussi référence à un dépôt Git pour les contributions ; ces éléments apparaissent ensemble dans les métadonnées officielles.
• SCore est destiné à être installé comme bibliothèque/dépendance pour d’autres plugins Ssomar ; il expose des fonctionnalités appelées par d’autres plugins à l’exécution.

🤝 Quand ce plugin est utile

Si vous utilisez des plugins Ssomar ou avez besoin d’un système prêt à l’emploi sur le serveur pour des projectiles personnalisés et des placeholders de variables, SCore fournit l’exécution partagée et les éditeurs sur lesquels ces plugins s’appuient, sans vous obliger à réimplémenter les mêmes mécaniques.