Plugin Minecraft AzLink

🔌 Sobre o AzLink

O AzLink é um plugin de Minecraft que conecta um servidor de jogo ou proxy a um site Azuriom. Ele faz a ponte entre o runtime do servidor e o site Azuriom para sincronizar dados relacionados à conta, integrações de loja e votos, além de expor placeholders do lado do servidor para uso em plugins e mensagens.

🎯 Objetivo

O principal objetivo do plugin é a integração entre site e servidor: manter as contas dos jogadores e os recursos acionados pelo site (compras na loja, recompensas por voto, concessão de recompensas) consistentes entre um site Azuriom e um ou mais backends ou proxies de servidor Minecraft. Ele foi pensado para donos de servidor que usam um site Azuriom e precisam de um conector com suporte e manutenção para integrações no jogo.

⚙️ Recursos

• Ligação entre Servidor↔Site para gerenciamento de contas e fluxos de autenticação.
• Pontos de integração para as extensões de loja e votos do Azuriom (podem ser ativados via configuração).
• Suporte ao PlaceholderAPI em plataformas baseadas em Bukkit (registra placeholders como o dinheiro do site do jogador e placeholders relacionados à loja/votos).
• Um único .jar funciona em várias plataformas de servidor suportadas (com builds legados para servidores muito antigos).
• Comportamento guiado por configuração (o arquivo de configuração controla placeholders e opções de integração).

🧩 Para quem é

• Donos de servidor que usam um site Azuriom e precisam de sincronização de loja, votos ou contas no jogo.
• Redes que usam proxies (Bungee/Velocity) ou configurações de servidor único em servidores da família Bukkit.
• Administradores que querem placeholders prontos para o PlaceholderAPI, alimentados pelos dados do site.

🏗️ Casos de uso de exemplo

• Exibir o saldo do site Azuriom de um jogador no chat ou nos placares via PlaceholderAPI.
• Conceder automaticamente itens ou cargos no jogo quando uma compra é feita pela loja Azuriom.
• Distribuir recompensas de voto no servidor quando o plugin de votos do site registra um voto.

⚙️ Instalação

📥 Configuração

• Baixe o JAR oficial do plugin AzLink apropriado para a sua plataforma e coloque-o no diretório plugins/ do servidor (ou equivalente na plataforma).
• Reinicie o servidor para carregar o plugin.
• Verifique as mensagens de inicialização no console do servidor para confirmar que o AzLink foi inicializado corretamente.

📦 Dependências

• PlaceholderAPI — suportado e opcional em servidores baseados em Bukkit para registrar placeholders.
• É necessária uma instância de site Azuriom para que a integração funcione (o plugin se comunica com o site).

🧾 Configuração

• O AzLink cria e usa um arquivo de configuração no qual você ativa/desativa recursos como placeholders de loja e votos e informa as credenciais de conexão para o seu site Azuriom.
• O registro de placeholders para os recursos de loja e votos pode ser ativado ou desativado na configuração em servidores da família Bukkit.

🧠 Notas técnicas

• As plataformas de servidor suportadas incluem servidores da família Bukkit (Bukkit, Spigot, Paper, Folia) e várias plataformas de proxy/alternativas (BungeeCord, Velocity, Sponge). Existem ports com loaders de mod/forge (Fabric/Forge/NeoForge) para ambientes modded.
• O plugin é open-source e publicado sob a licença MIT.
• Os lançamentos oficiais e changelogs são publicados pelo projeto Azuriom e mantidos no repositório AzLink.

🤝 Quando este plugin é útil

Se você administra um site Azuriom e precisa de um conector mantido para levar recursos do site para o jogo (loja, votos, dados de conta, placeholders), o AzLink oferece uma ponte configurável e multiplataforma que integra esses sistemas sem desenvolvimento personalizado.