Minecraft-plugin AzLink

🔌 Om AzLink

AzLink er et Minecraft-plugin, der forbinder en spilserver eller proxy med et Azuriom-websted. Det fungerer som en bro mellem serverens runtime og Azuriom-siden for at synkronisere kontorelaterede data, shop- og vote-integrationer samt gøre server-side placeholders tilgængelige til brug i plugins og beskeder.

🎯 Formål

Pluginets primære formål er website-til-server-integration: at holde spillerkonti og website-drevne funktioner (shopkøb, vote-belønninger, tildeling af belønninger) konsistente mellem et Azuriom-websted og en eller flere Minecraft server backends eller proxies. Det er beregnet til serverejere, der kører et Azuriom-websted og har brug for en understøttet, vedligeholdt connector til in-game integrationer.

⚙️ Funktioner

• Server↔Website-linking til kontoadministration og autentificeringsflows.
• Integrationspunkter til Azuriom shop- og vote-udvidelser (kan aktiveres via konfiguration).
• Understøttelse af PlaceholderAPI på Bukkit-baserede platforme (registrerer placeholders som en spillers website-penge og shop-/vote-relaterede placeholders).
• Én .jar fungerer på tværs af flere understøttede serverplatforme (med legacy builds til meget gamle servere).
• Konfigurationsstyret adfærd (konfigurationsfilen styrer placeholders og integrationsmuligheder).

🧩 Hvem er det til

• Serverejere, der kører et Azuriom-websted og har brug for synkronisering af shop, vote eller konti i spillet.
• Netværk, der bruger proxies (Bungee/Velocity) eller single-server setups på Bukkit-familie-servere.
• Administratorer, der vil have PlaceholderAPI-klare placeholders udfyldt med data fra deres websted.

🏗️ Eksempler på brug

• Vise en spillers Azuriom-saldo i chat eller scoreboards via PlaceholderAPI.
• Automatisk give in-game items eller ranks, når et køb foretages via Azuriom-shopen.
• Give vote-belønninger på serveren, når webstedets vote-plugin registrerer en stemme.

⚙️ Installation

📥 Opsætning

• Download den officielle AzLink plugin-JAR, der passer til din platform, og læg den i serverens plugins/-mappe (eller den tilsvarende mappe på din platform).
• Genstart serveren for at indlæse pluginet.
• Tjek opstartsmeddelelserne i serverkonsollen for at bekræfte, at AzLink blev initialiseret korrekt.

📦 Afhængigheder

• PlaceholderAPI — understøttes og er valgfrit på Bukkit-baserede servere til registrering af placeholders.
• En Azuriom-webstedinstans er nødvendig for, at integrationen kan fungere (pluginet kommunikerer med webstedet).

🧾 Konfiguration

• AzLink opretter og bruger en konfigurationsfil, hvor du aktiverer/deaktiverer funktioner som shop- og vote-placeholders og angiver forbindelsesoplysninger til dit Azuriom-websted.
• Registrering af placeholders til shop- og votefunktioner kan slås til og fra i config på Bukkit-familie-servere.

🧠 Tekniske noter

• Understøttede serverplatforme inkluderer servere i Bukkit-familien (Bukkit, Spigot, Paper, Folia) og flere proxy-/alternative serverplatforme (BungeeCord, Velocity, Sponge). Der findes mod/forge loader-ports (Fabric/Forge/NeoForge) til modded miljøer.
• Pluginet er open-source og udgivet under MIT-licensen.
• Officielle releases og changelogs udgives af Azuriom-projektet og vedligeholdes i AzLink-repositoriet.

🤝 Hvornår er dette plugin nyttigt

Hvis du driver et Azuriom-websted og har brug for en vedligeholdt connector til at vise website-drevne funktioner i spillet (shop, votes, kontodata, placeholders), tilbyder AzLink en konfigurerbar, multi-platform bro, der integrerer disse systemer uden specialudvikling.