Plugin de Minecraft AzLink

🔌 Acerca de AzLink

AzLink es un plugin de Minecraft que conecta un servidor de juego o proxy con un sitio web de Azuriom. Proporciona un puente entre el runtime del servidor y el sitio de Azuriom para sincronizar datos relacionados con la cuenta, integraciones de tienda y votos, y exponer placeholders del lado del servidor para usarlos en plugins y mensajes.

🎯 Propósito

El propósito principal del plugin es la integración entre sitio y servidor: mantener coherentes las cuentas de los jugadores y las funciones impulsadas por el sitio (compras en la tienda, recompensas por voto, entrega de recompensas) entre un sitio web de Azuriom y uno o más backends o proxies de servidor Minecraft. Está pensado para propietarios de servidores que usan un sitio Azuriom y necesitan un conector compatible y mantenido para integraciones dentro del juego.

⚙️ Características

• Enlace Servidor↔Sitio para la gestión de cuentas y los flujos de autenticación.
• Puntos de integración para las extensiones de tienda y votos de Azuriom (se pueden activar mediante configuración).
• Compatibilidad con PlaceholderAPI en plataformas basadas en Bukkit (registra placeholders como el dinero del sitio del jugador y placeholders relacionados con tienda/votos).
• Un solo .jar funciona en varias plataformas de servidor compatibles (con versiones heredadas para servidores muy antiguos).
• Comportamiento controlado por configuración (el archivo de configuración controla los placeholders y las opciones de integración).

🧩 Para quién es

• Propietarios de servidores que usan un sitio Azuriom y necesitan sincronización de tienda, votos o cuentas dentro del juego.
• Redes que usan proxies (Bungee/Velocity) o configuraciones de servidor único en servidores de la familia Bukkit.
• Administradores que quieren placeholders listos para PlaceholderAPI alimentados con datos de su sitio web.

🏗️ Casos de uso de ejemplo

• Mostrar el saldo del sitio Azuriom de un jugador en el chat o en los tableros mediante PlaceholderAPI.
• Otorgar automáticamente objetos o rangos dentro del juego cuando se realiza una compra a través de la tienda Azuriom.
• Entregar recompensas por voto en el servidor cuando el plugin de votos del sitio registra un voto.

⚙️ Instalación

📥 Configuración

• Descarga el JAR oficial del plugin AzLink adecuado para tu plataforma y colócalo en el directorio plugins/ del servidor (o el equivalente de la plataforma).
• Reinicia el servidor para cargar el plugin.
• Verifica los mensajes de inicio en la consola del servidor para confirmar que AzLink se inicializó correctamente.

📦 Dependencias

• PlaceholderAPI — compatible y opcional en servidores basados en Bukkit para el registro de placeholders.
• Se requiere una instancia de sitio Azuriom para que la integración funcione (el plugin se comunica con el sitio).

🧾 Configuración

• AzLink crea y usa un archivo de configuración donde activas o desactivas funciones como los placeholders de tienda y votos, y proporcionas las credenciales de conexión a tu sitio Azuriom.
• El registro de placeholders para las funciones de tienda y votos puede activarse o desactivarse en la configuración en servidores de la familia Bukkit.

🧠 Notas técnicas

• Las plataformas de servidor compatibles incluyen servidores de la familia Bukkit (Bukkit, Spigot, Paper, Folia) y varias plataformas de proxy/alternativas (BungeeCord, Velocity, Sponge). Existen ports con loaders de mod/forge (Fabric/Forge/NeoForge) para entornos modded.
• El plugin es de código abierto y se publica bajo la licencia MIT.
• Las versiones oficiales y los changelogs son publicados por el proyecto Azuriom y mantenidos en el repositorio de AzLink.

🤝 Cuándo es útil este plugin

Si gestionas un sitio Azuriom y necesitas un conector mantenido para llevar al juego funciones impulsadas por el sitio (tienda, votos, datos de cuenta, placeholders), AzLink ofrece un puente configurable y multiplataforma que integra esos sistemas sin desarrollo personalizado.