⚙️ Configuración del Plugin

AxLore se gestiona principalmente a través de dos archivos: config.yml (lógica y escenas) y credentials.yml (claves privadas).

📄 Archivos de Configuración

• config.yml: Define el motor de IA, el método de alojamiento y todas las escenas narrativas.
• credentials.yml: Almacena de forma segura tus API Keys de ElevenLabs y tokens de Dropbox. Nunca compartas este archivo.

🎙️ Motor de IA (ElevenLabs)

Configura la calidad y el comportamiento de las voces generadas.

elevenlabs:
  model: "eleven_v3"  # Recomendamos v3 para la mejor calidad narrativa
  voice-settings:
    stability: 0.5        # Controla la variabilidad (0.0 a 1.0)
    similarity-boost: 0.8 # Qué tanto se parece a la voz original
    speed: 1.0            # Velocidad del narrador (0.7 a 1.2)

🎭 Efectos de Audio

Añade atmósfera a tus escenas usando el nodo effect:

• whisper: Susurros ambientales.
• echo: Eco de cueva o gran salón.
• dark: Voz profunda y amenazante.
• epic: Sonido cinemático y heroico.

📦 Alojamiento del Resource Pack

Los jugadores necesitan descargar un pack para escuchar las voces. AxLore ofrece dos métodos:

🏠 Hosting Interno (hosting)

AxLore levanta su propio servidor web.

• Ideal para: VPS con puertos abiertos o redes locales.
• Configuración: Asegúrate de que el puerto (ej. 8080) esté abierto en tu firewall.

🔵 Dropbox (dropbox)

Sube el pack a la nube automáticamente. Es la opción más fiable para servidores públicos.

1. Vincula tu cuenta con /axlore dropbox auth.
2. AxLore gestionará la subida y generación de enlaces de descarga directa.

🎬 Creación de Escenas (scenes)

Las escenas son el corazón de AxLore. Cada una define qué se dice y cuándo.

⚙️ Opciones de Visualización (display)

• HOLOGRAM: El texto aparece sobre el jugador o entidad.
• BOSSBAR: El texto aparece en la barra superior de jefe.
• BOTH: Ambos métodos simultáneamente.

🚀 Disparadores (triggers)

• REGION: Se activa al entrar en una zona de WorldGuard.
• KILL: Se activa al matar a un mob específico (ej. ENDER_DRAGON).
• COMMAND: Se activa manualmente con /axlore play.