Plugin Minecraft AzLink

🔌 Informazioni su AzLink

AzLink è un plugin Minecraft che collega un server di gioco o un proxy a un sito Azuriom. Fornisce un ponte tra il runtime del server e il sito Azuriom per sincronizzare i dati relativi agli account, le integrazioni di shop e voti, ed esporre placeholder lato server da usare in plugin e messaggi.

🎯 Scopo

Lo scopo principale del plugin è l'integrazione sito-server: mantenere coerenti gli account dei giocatori e le funzionalità guidate dal sito (acquisti nello shop, ricompense per i voti, assegnazione di premi) tra un sito Azuriom e uno o più backend o proxy di server Minecraft. È pensato per i proprietari di server che gestiscono un sito Azuriom e hanno bisogno di un connettore supportato e mantenuto per le integrazioni in-game.

⚙️ Funzionalità

• Collegamento Server↔Sito per la gestione degli account e i flussi di autenticazione.
• Punti di integrazione per le estensioni shop e vote di Azuriom (attivabili tramite configurazione).
• Supporto a PlaceholderAPI sulle piattaforme basate su Bukkit (registra placeholder come il denaro del sito di un giocatore e placeholder relativi a shop/voti).
• Un singolo .jar funziona su più piattaforme server supportate (con build legacy per server molto vecchi).
• Comportamento guidato dalla configurazione (il file di configurazione controlla placeholder e opzioni di integrazione).

🧩 A chi è rivolto

• Ai proprietari di server che usano un sito Azuriom e hanno bisogno di sincronizzazione di shop, voti o account in-game.
• Alle reti che usano proxy (Bungee/Velocity) o configurazioni single-server su server della famiglia Bukkit.
• Agli amministratori che vogliono placeholder pronti per PlaceholderAPI popolati con i dati del loro sito.

🏗️ Esempi d'uso

• Esporre il saldo del sito Azuriom di un giocatore in chat o nelle scoreboard tramite PlaceholderAPI.
• Assegnare automaticamente oggetti o ranghi in-game quando viene effettuato un acquisto tramite lo shop Azuriom.
• Premiare i voti sul server quando il plugin di voto del sito registra un voto.

⚙️ Installazione

📥 Configurazione

• Scarica il JAR ufficiale del plugin AzLink adatto alla tua piattaforma e inseriscilo nella directory plugins/ del server (o nell'equivalente della piattaforma).
• Riavvia il server per caricare il plugin.
• Verifica i messaggi di avvio nella console del server per confermare che AzLink sia stato inizializzato correttamente.

📦 Dipendenze

• PlaceholderAPI — supportato e opzionale sui server basati su Bukkit per la registrazione dei placeholder.
• Per far funzionare l'integrazione è necessaria un'istanza di sito Azuriom (il plugin comunica con il sito).

🧾 Configurazione

• AzLink crea e usa un file di configurazione in cui puoi abilitare/disabilitare funzionalità come i placeholder di shop e voti e fornire le credenziali di connessione al tuo sito Azuriom.
• La registrazione dei placeholder per le funzionalità di shop e voti può essere attivata o disattivata nella configurazione sui server della famiglia Bukkit.

🧠 Note tecniche

• Le piattaforme server supportate includono i server della famiglia Bukkit (Bukkit, Spigot, Paper, Folia) e diverse piattaforme proxy/alternative (BungeeCord, Velocity, Sponge). Esistono port con loader mod/forge (Fabric/Forge/NeoForge) per ambienti modded.
• Il plugin è open source e pubblicato sotto licenza MIT.
• Le release ufficiali e i changelog sono pubblicati dal progetto Azuriom e mantenuti nel repository AzLink.

🤝 Quando questo plugin è utile

Se gestisci un sito Azuriom e hai bisogno di un connettore mantenuto per portare in gioco le funzionalità guidate dal sito (shop, voti, dati dell'account, placeholder), AzLink offre un ponte configurabile e multipiattaforma che integra questi sistemi senza sviluppo personalizzato.