Minecraft-Plugin AzLink

🔌 Über AzLink

AzLink ist ein Minecraft-Plugin, das einen Spielserver oder Proxy mit einer Azuriom-Website verbindet. Es stellt eine Brücke zwischen der Server-Laufzeit und der Azuriom-Seite her, um kontobezogene Daten, Shop- und Vote-Integrationen zu synchronisieren und serverseitige Platzhalter für die Verwendung in Plugins und Nachrichten bereitzustellen.

🎯 Zweck

Der Hauptzweck des Plugins ist die Integration zwischen Website und Server: Spieleraccounts und von der Website gesteuerte Funktionen (Shop-Käufe, Vote-Belohnungen, Belohnungsvergabe) zwischen einer Azuriom-Website und einem oder mehreren Minecraft-Server-Backends oder Proxys konsistent zu halten. Es richtet sich an Serverbetreiber, die eine Azuriom-Website betreiben und einen unterstützten, gepflegten Connector für In-Game-Integrationen benötigen.

⚙️ Funktionen

• Server↔Website-Verknüpfung für Kontoverwaltung und Authentifizierungsabläufe.
• Integrationspunkte für Azuriom-Shop- und Vote-Erweiterungen (kann per Konfiguration aktiviert werden).
• PlaceholderAPI-Unterstützung auf Bukkit-basierten Plattformen (registriert Platzhalter wie das Website-Guthaben eines Spielers und shop-/vote-bezogene Platzhalter).
• Eine einzelne .jar funktioniert auf mehreren unterstützten Serverplattformen (mit Legacy-Builds für sehr alte Server).
• Konfigurationsgesteuertes Verhalten (die Konfigurationsdatei steuert Platzhalter und Integrationsoptionen).

🧩 Für wen es gedacht ist

• Serverbetreiber mit einer Azuriom-Website, die In-Game-Shop-, Vote- oder Kontosynchronisierung benötigen.
• Netzwerke mit Proxys (Bungee/Velocity) oder Einzelserver-Setups auf Servern der Bukkit-Familie.
• Administratoren, die mit PlaceholderAPI kompatible Platzhalter möchten, die mit Daten von ihrer Website gefüllt werden.

🏗️ Beispielanwendungen

• Das Azuriom-Website-Guthaben eines Spielers über PlaceholderAPI im Chat oder auf Scoreboards anzeigen.
• Automatisch In-Game-Gegenstände oder Ränge vergeben, wenn über den Azuriom-Shop ein Kauf getätigt wird.
• Vote-Belohnungen auf dem Server vergeben, wenn das Website-Vote-Plugin eine Stimme erfasst.

⚙️ Installation

📥 Einrichtung

• Lade das offizielle AzLink-Plugin-JAR für deine Plattform herunter und lege es im Verzeichnis plugins/ des Servers (oder dem plattformspezifischen Gegenstück) ab.
• Starte den Server neu, um das Plugin zu laden.
• Prüfe die Startmeldungen in der Serverkonsole, um zu bestätigen, dass AzLink korrekt initialisiert wurde.

📦 Abhängigkeiten

• PlaceholderAPI — auf Bukkit-basierten Servern unterstützt und optional für die Platzhalterregistrierung.
• Eine Azuriom-Website-Instanz ist erforderlich, damit die Integration funktioniert (das Plugin kommuniziert mit der Website).

🧾 Konfiguration

• AzLink erstellt und verwendet eine Konfigurationsdatei, in der du Funktionen wie Shop- und Vote-Platzhalter aktivieren/deaktivieren und Verbindungsdaten für deine Azuriom-Website angeben kannst.
• Die Platzhalterregistrierung für Shop- und Vote-Funktionen kann in der Konfiguration auf Servern der Bukkit-Familie umgeschaltet werden.

🧠 Technische Hinweise

• Unterstützte Serverplattformen umfassen Server der Bukkit-Familie (Bukkit, Spigot, Paper, Folia) sowie mehrere Proxy-/Alternative-Serverplattformen (BungeeCord, Velocity, Sponge). Für modifizierte Umgebungen gibt es Ports mit Mod-/Forge-Loadern (Fabric/Forge/NeoForge).
• Das Plugin ist Open Source und unter der MIT-Lizenz veröffentlicht.
• Offizielle Releases und Changelogs werden vom Azuriom-Projekt veröffentlicht und im AzLink-Repository gepflegt.

🤝 Wann dieses Plugin nützlich ist

Wenn du eine Azuriom-Website betreibst und einen gepflegten Connector benötigst, um von der Website gesteuerte Funktionen im Spiel bereitzustellen (Shop, Votes, Kontodaten, Platzhalter), bietet AzLink eine konfigurierbare, plattformübergreifende Brücke, die diese Systeme ohne eigene Entwicklung integriert.