Minecraft plugin AzLink

🔌 Over AzLink

AzLink is een Minecraft-plugin die een game-server of proxy verbindt met een Azuriom-website. Het biedt een brug tussen de server-runtime en de Azuriom-site om accountgerelateerde gegevens, shop- en vote-integraties te synchroniseren en server-side placeholders beschikbaar te maken voor gebruik in plugins en berichten.

🎯 Doel

Het belangrijkste doel van de plugin is website-naar-server-integratie: het consistent houden van spelersaccounts en door de site aangestuurde functies (shop-aankopen, vote-beloningen, toekennen van rewards) tussen een Azuriom-website en een of meer Minecraft-server-backends of proxies. Deze is bedoeld voor servereigenaren die een Azuriom-website draaien en een ondersteunde, onderhouden connector nodig hebben voor in-game integraties.

⚙️ Functies

• Server↔Website-koppeling voor accountbeheer en authenticatiestromen.
• Integratiepunten voor Azuriom shop- en vote-extensies (kunnen via configuratie worden ingeschakeld).
• Ondersteuning voor PlaceholderAPI op Bukkit-gebaseerde platforms (registreert placeholders zoals het websitegeld van een speler en shop-/vote-gerelateerde placeholders).
• Eén .jar werkt op meerdere ondersteunde serverplatforms (met legacy-builds voor heel oude servers).
• Gedrag op basis van configuratie (configuratiebestand bepaalt placeholders en integratie-opties).

🧩 Voor wie is dit

• Servereigenaren die een Azuriom-website draaien en in-game shop-, vote- of accountsynchronisatie nodig hebben.
• Netwerken die proxies gebruiken (Bungee/Velocity) of single-server setups op servers uit de Bukkit-familie.
• Beheerders die placeholders willen die klaar zijn voor PlaceholderAPI en gevuld worden met gegevens van hun website.

🏗️ Voorbeeldgebruik

• Het saldo van een speler op de Azuriom-website tonen in chat of scorebords via PlaceholderAPI.
• Automatisch in-game items of rangen toekennen wanneer er een aankoop wordt gedaan via de Azuriom-shop.
• Vote-beloningen op de server toekennen wanneer de vote-plugin op de site een stem registreert.

⚙️ Installatie

📥 Setup

• Download de officiële AzLink-plugin JAR die geschikt is voor jouw platform en plaats deze in de map plugins/ van de server (of de equivalente map op jouw platform).
• Herstart de server om de plugin te laden.
• Controleer de opstartberichten in de serverconsole om te bevestigen dat AzLink correct is geïnitialiseerd.

📦 Afhankelijkheden

• PlaceholderAPI — ondersteund en optioneel op Bukkit-gebaseerde servers voor placeholderregistratie.
• Een Azuriom-website is vereist om de integratie te laten werken (de plugin communiceert met de site).

🧾 Configuratie

• AzLink maakt een configuratiebestand aan en gebruikt dit waarin je functies zoals shop- en vote-placeholders in- of uitschakelt en verbindingsgegevens voor je Azuriom-website opgeeft.
• Het registreren van placeholders voor shop- en votefuncties kan in de config op servers uit de Bukkit-familie worden aan- of uitgezet.

🧠 Technische opmerkingen

• Ondersteunde serverplatforms zijn onder andere servers uit de Bukkit-familie (Bukkit, Spigot, Paper, Folia) en verschillende proxy-/alternatieve serverplatforms (BungeeCord, Velocity, Sponge). Er zijn mod/forge-loaderports beschikbaar (Fabric/Forge/NeoForge) voor gemodde omgevingen.
• De plugin is open-source en gepubliceerd onder de MIT-licentie.
• Officiële releases en changelogs worden gepubliceerd door het Azuriom-project en onderhouden in de AzLink-repository.

🤝 Wanneer is deze plugin nuttig

Als je een Azuriom-website runt en een onderhouden connector nodig hebt om functies van de website in-game zichtbaar te maken (shop, votes, accountgegevens, placeholders), biedt AzLink een configureerbare, multiplatform brug die deze systemen integreert zonder maatwerkontwikkeling.