Configuración Inicial

Sigue estos pasos para poner AxLore en funcionamiento en tu servidor Paper/Spigot.

1. Instalación desde el Dashboard

Para garantizar la máxima seguridad y compatibilidad, AxLore utiliza un sistema de Instalación Inteligente. No descargamos un archivo genérico, sino que generamos un JAR único para tu cuenta.

1. Accede a axxtrial.space/dashboard.
2. Inicia sesión con tu cuenta y dirígete a la sección de Licencias.
3. Busca tu licencia activa de AxLore y haz clic en el botón Descargar Plugin.
4. Importante: El sistema estampará automáticamente tu licencia dentro del archivo .jar. Esto asegura que el plugin sea compatible únicamente con tu cuenta y simplifica la activación.

2. Activación Plug & Play

Gracias a nuestro sistema de "stamping", la activación es totalmente automática.

• Sin Comandos: Al encender tu servidor por primera vez, AxLore detectará la licencia embebida en el JAR.
• Validación Asíncrona: El plugin se comunicará con nuestra API en segundo plano para validar tu acceso sin afectar el rendimiento del servidor.
• Configuración Silenciosa: Se generará un archivo .key en la carpeta del plugin para persistir la activación incluso si cambias el JAR en el futuro.

3. Seguridad Inexpugnable (Zero-Secret)

AxLore está diseñado con una arquitectura de Seguridad de Confianza Cero. Esto significa que:

• Privacidad Total: Tus claves privadas y datos sensibles nunca salen de tu servidor.
• Firmas Digitales: Cada comunicación con nuestra API está firmada digitalmente, garantizando que nadie pueda interceptar o suplantar tu identidad.
• Integridad del JAR: El plugin realiza una auto-verificación de integridad al arrancar. Si el archivo ha sido modificado o "crackeado", el sistema se bloquea automáticamente para proteger tu inversión.

4. Seguridad de Credenciales

AxLore utiliza un archivo separado llamado credentials.yml para almacenar tus claves privadas (ElevenLabs API Key, Dropbox Tokens).

• Auto-migración: Si pones tus claves en config.yml, el plugin las moverá automáticamente a credentials.yml y limpiará el config por seguridad.
• Privacidad: Nunca compartas tu credentials.yml con nadie.

4. Requisitos y Dependencias

Para que AxLore funcione correctamente, debes cumplir con:

• ProtocolLib: (Obligatorio) Versión compatible con tu servidor.
• Java 17+: AxLore está optimizado para versiones modernas de Minecraft.
• WorldGuard (Opcional): Necesario si deseas usar disparadores de tipo REGION para tus escenas narrativas.

5. Configuración del Hosting

Por defecto, AxLore utiliza un servidor interno NanoHTTPD para alojar el paquete de recursos.

• Asegúrate de que el puerto (por defecto 8090) esté abierto en tu firewall.
• Si usas un panel como Pterodactyl, es posible que necesites mapear un puerto adicional y actualizar hosting.port en config.yml.