Minecraft-plugin AzLink

🔌 Om AzLink

AzLink är ett Minecraft-plugin som kopplar ihop en spelserver eller proxy med en Azuriom-webbplats. Det fungerar som en brygga mellan serverns runtime och Azuriom-sidan för att synkronisera kontorelaterad data, shop- och vote-integrationer, samt exponera server-side placeholders för användning i plugins och meddelanden.

🎯 Syfte

Pluginets huvudsakliga syfte är webbplats-till-server-integration: att hålla spelarkonton och webbdrivna funktioner (shopköp, vote-belöningar, utdelning av belöningar) konsekventa mellan en Azuriom-webbplats och en eller flera Minecraft-server-backends eller proxies. Det är avsett för serverägare som kör en Azuriom-webbplats och behöver en stödd, underhållen connector för integrationer i spelet.

⚙️ Funktioner

• Server↔Website-länkning för kontohantering och autentiseringsflöden.
• Integrationspunkter för Azuriom shop- och vote-tillägg (kan aktiveras via konfiguration).
• Stöd för PlaceholderAPI på Bukkit-baserade plattformar (registrerar placeholders som en spelares webbplatsvaluta och shop-/vote-relaterade placeholders).
• En enda .jar fungerar på flera stödda serverplattformar (med legacy-byggnader för mycket gamla servrar).
• Konfigurationsstyrt beteende (konfigurationsfilen styr placeholders och integrationsalternativ).

🧩 Vem det är för

• Serverägare som kör en Azuriom-webbplats och behöver synkronisering av shop, vote eller konton i spelet.
• Nätverk som använder proxies (Bungee/Velocity) eller single-server-installationer på Bukkit-familjens servrar.
• Administratörer som vill ha PlaceholderAPI-redo placeholders fyllda med data från sin webbplats.

🏗️ Exempel på användning

• Visa en spelares Azuriom-saldo i chatt eller scoreboards via PlaceholderAPI.
• Automatiskt ge föremål eller ranker i spelet när ett köp görs via Azuriom-shopen.
• Dela ut vote-belöningar på servern när sajtens vote-plugin registrerar en röst.

⚙️ Installation

📥 Setup

• Ladda ner den officiella AzLink-plugin-JAR:en som passar din plattform och lägg den i serverns katalog plugins/ (eller motsvarande på din plattform).
• Starta om servern för att ladda pluginet.
• Kontrollera startmeddelandena i serverkonsolen för att bekräfta att AzLink initierades korrekt.

📦 Beroenden

• PlaceholderAPI — stöds och är valfritt på Bukkit-baserade servrar för registrering av placeholders.
• En Azuriom-webbplats krävs för att integrationen ska fungera (pluginet kommunicerar med webbplatsen).

🧾 Konfiguration

• AzLink skapar och använder en konfigurationsfil där du aktiverar/inaktiverar funktioner som shop- och vote-placeholders och anger anslutningsuppgifter till din Azuriom-webbplats.
• Registrering av placeholders för shop- och votefunktioner kan slås på eller av i config på Bukkit-familjens servrar.

🧠 Tekniska notiser

• Stödda serverplattformar inkluderar servrar i Bukkit-familjen (Bukkit, Spigot, Paper, Folia) och flera proxy-/alternativa serverplattformar (BungeeCord, Velocity, Sponge). Det finns mod/forge-loader-portar (Fabric/Forge/NeoForge) för moddade miljöer.
• Pluginet är open-source och publicerat under MIT-licensen.
• Officiella releaser och changelogs publiceras av Azuriom-projektet och underhålls i AzLink-repot.

🤝 När detta plugin är användbart

Om du driver en Azuriom-webbplats och behöver en underhållen connector för att visa webbplatsdrivna funktioner i spelet (shop, votes, kontodata, placeholders), erbjuder AzLink en konfigurerbar brygga för flera plattformar som integrerar dessa system utan egen utveckling.