Plugin Minecraft AzLink

🔌 Despre AzLink

AzLink este un plugin Minecraft care conectează un server de joc sau un proxy cu un site Azuriom. Oferă o punte între runtime-ul serverului și site-ul Azuriom pentru a sincroniza datele legate de cont, integrările shop și vote și pentru a expune placeholdere pe partea serverului, folosite în pluginuri și mesaje.

🎯 Scop

Scopul principal al pluginului este integrarea site-ului cu serverul: menținerea în sync a conturilor jucătorilor și a funcțiilor controlate de site (achiziții din shop, recompense vote, acordarea recompenselor) între un site Azuriom și unul sau mai multe backend-uri de server Minecraft sau proxy-uri. Este destinat proprietarilor de servere care rulează un site Azuriom și au nevoie de un connector suportat și întreținut pentru integrări în joc.

⚙️ Funcții

• Conectare Server↔Website pentru administrarea conturilor și fluxurile de autentificare.
• Puncte de integrare pentru extensiile shop și vote din Azuriom (pot fi activate din configurație).
• Suport PlaceholderAPI pe platformele bazate pe Bukkit (înregistrează placeholdere precum banii din website ai unui jucător și placeholdere legate de shop/vote).
• Un singur .jar funcționează pe mai multe platforme de servere suportate (cu builduri legacy pentru servere foarte vechi).
• Comportament controlat din configurare (fișierul de configurare controlează placeholderele și opțiunile de integrare).

🧩 Pentru cine este

• Proprietari de servere care rulează un site Azuriom și au nevoie de sincronizare pentru shop, vote sau conturi în joc.
• Rețele care folosesc proxy-uri (Bungee/Velocity) sau configurații single-server pe servere din familia Bukkit.
• Administratori care vor placeholdere pregătite pentru PlaceholderAPI, populate cu datele de pe website-ul lor.

🏗️ Cazuri de utilizare

• Afișarea balanței unui jucător de pe website-ul Azuriom în chat sau pe scoreboard-uri prin PlaceholderAPI.
• Acordarea automată de obiecte sau rankuri în joc atunci când se face o achiziție prin shop-ul Azuriom.
• Oferirea recompenselor vote pe server atunci când pluginul de vote de pe site înregistrează un vot.

⚙️ Instalare

📥 Configurare

• Descarcă JAR-ul oficial al pluginului AzLink potrivit pentru platforma ta și pune-l în directorul plugins/ al serverului (sau echivalentul platformei tale).
• Repornește serverul pentru a încărca pluginul.
• Verifică mesajele de pornire din consola serverului pentru a confirma că AzLink s-a inițializat corect.

📦 Dependențe

• PlaceholderAPI — este suportat și opțional pe serverele bazate pe Bukkit pentru înregistrarea placeholderelor.
• Este necesară o instanță a website-ului Azuriom pentru ca integrarea să funcționeze (pluginul comunică cu site-ul).

🧾 Configurare

• AzLink creează și folosește un fișier de configurare în care activezi/dezactivezi funcții precum placeholderele pentru shop și vote și furnizezi credențialele de conectare la website-ul tău Azuriom.
• Înregistrarea placeholderelor pentru funcțiile shop și vote poate fi activată sau dezactivată în config pe serverele din familia Bukkit.

🧠 Note tehnice

• Platformele de servere suportate includ serverele din familia Bukkit (Bukkit, Spigot, Paper, Folia) și mai multe platforme proxy/alternative (BungeeCord, Velocity, Sponge). Există porturi pentru mod/loadere Mod/forge (Fabric/Forge/NeoForge) pentru medii modded.
• Pluginul este open-source și publicat sub licența MIT.
• Lansările oficiale și changelogurile sunt publicate de proiectul Azuriom și menținute în repository-ul AzLink.

🤝 Când este util acest plugin

Dacă rulezi un site Azuriom și ai nevoie de un connector întreținut pentru a expune în joc funcțiile controlate de website (shop, vote, date de cont, placeholdere), AzLink oferă o punte configurabilă, multi-platformă, care integrează aceste sisteme fără dezvoltare personalizată.