Plugin Minecraft AzLink

🔌 À propos d'AzLink

AzLink est un plugin Minecraft qui relie un serveur de jeu ou un proxy à un site Azuriom. Il fournit un pont entre l'exécution du serveur et le site Azuriom afin de synchroniser les données liées aux comptes, les intégrations de boutique et de votes, et d'exposer des placeholders côté serveur utilisables dans les plugins et les messages.

🎯 Objectif

L'objectif principal du plugin est l'intégration site-vers-serveur : conserver la cohérence des comptes joueurs et des fonctionnalités pilotées par le site (achats en boutique, récompenses de vote, attribution de récompenses) entre un site Azuriom et un ou plusieurs backends ou proxies de serveurs Minecraft. Il est destiné aux propriétaires de serveurs qui utilisent un site Azuriom et qui ont besoin d'un connecteur pris en charge et maintenu pour les intégrations en jeu.

⚙️ Fonctionnalités

• Liaison serveur↔site pour la gestion des comptes et les flux d'authentification.
• Points d'intégration pour les extensions de boutique et de vote Azuriom (activables via la configuration).
• Prise en charge de PlaceholderAPI sur les plateformes basées sur Bukkit (enregistre des placeholders comme l'argent du site du joueur et des placeholders liés à la boutique/aux votes).
• Un seul .jar fonctionne sur plusieurs plateformes de serveur prises en charge (avec des builds hérités pour les très anciens serveurs).
• Comportement piloté par la configuration (le fichier de configuration contrôle les placeholders et les options d'intégration).

🧩 À qui cela s'adresse

• Aux propriétaires de serveurs utilisant un site Azuriom et ayant besoin d'une synchronisation de boutique, de votes ou de comptes en jeu.
• Aux réseaux utilisant des proxys (Bungee/Velocity) ou des configurations mono-serveur sur des serveurs de la famille Bukkit.
• Aux administrateurs qui veulent des placeholders prêts pour PlaceholderAPI et alimentés par les données de leur site.

🏗️ Exemples d'utilisation

• Afficher le solde du site Azuriom d'un joueur dans le chat ou sur les tableaux de score via PlaceholderAPI.
• Attribuer automatiquement des objets ou des rangs en jeu lorsqu'un achat est effectué via la boutique Azuriom.
• Accorder des récompenses de vote sur le serveur lorsque le plugin de vote du site enregistre un vote.

⚙️ Installation

📥 Installation

• Téléchargez le JAR officiel du plugin AzLink adapté à votre plateforme et placez-le dans le dossier plugins/ du serveur (ou son équivalent selon la plateforme).
• Redémarrez le serveur pour charger le plugin.
• Vérifiez les messages de démarrage dans la console du serveur pour confirmer qu'AzLink s'est initialisé correctement.

📦 Dépendances

• PlaceholderAPI — pris en charge et optionnel sur les serveurs basés sur Bukkit pour l'enregistrement des placeholders.
• Une instance de site Azuriom est requise pour que l'intégration fonctionne (le plugin communique avec le site).

🧾 Configuration

• AzLink crée et utilise un fichier de configuration dans lequel vous activez/désactivez des fonctionnalités comme les placeholders de boutique et de vote, et fournissez les identifiants de connexion à votre site Azuriom.
• L'enregistrement des placeholders pour les fonctionnalités de boutique et de vote peut être activé ou désactivé dans la configuration sur les serveurs de la famille Bukkit.

🧠 Notes techniques

• Les plateformes de serveur prises en charge incluent les serveurs de la famille Bukkit (Bukkit, Spigot, Paper, Folia) ainsi que plusieurs plateformes de proxy/alternatives (BungeeCord, Velocity, Sponge). Il existe des ports avec chargeurs mod/forge (Fabric/Forge/NeoForge) pour les environnements moddés.
• Le plugin est open source et publié sous licence MIT.
• Les versions officielles et les journaux des modifications sont publiés par le projet Azuriom et maintenus dans le dépôt AzLink.

🤝 Quand ce plugin est utile

Si vous exploitez un site Azuriom et avez besoin d'un connecteur maintenu pour exposer en jeu les fonctionnalités pilotées par le site (boutique, votes, données de compte, placeholders), AzLink fournit un pont configurable et multiplateforme qui intègre ces systèmes sans développement personnalisé.