Guía de Documentación

Escenas y Disparadores

Aprende a crear escenas narrativas, configurar disparadores y efectos visuales.

🎬 Sistema de Escenas

Las escenas son el corazón de AxLore. Definen qué se dice, quién lo dice y cuándo sucede.

📝 Estructura de una Escena

Cada escena en config.yml sigue este esquema:

yaml
nombre_escena:
  title:
    es: "&6&lEl Despertar"
    en: "&6&lThe Awakening"
  text:
    es: "Has despertado en una tierra extraña..."
    en: "You have awakened in a strange land..."
  voice-id: "ID_OPCIONAL"         # Si no se pone, usa el global
  effect: "epic"                  # whisper, echo, dark, epic o none
  display-mode: "BOTH"            # BOTH, HOLOGRAM, BOSSBAR
  one-time: true                  # Solo una vez por jugador (opcional)
  trigger:
    type: REGION
    value: "zona_spawn"
  cooldown: 3600                  # Tiempo en segundos (1 hora)

⚡ Tipos de Disparadores (Triggers)

AxLore admite múltiples formas de activar una narrativa automáticamente. Puedes configurarlos manualmente en el YAML o usar el sistema dinámico de vínculos.

Tipo Valor Requerido Descripción
JOIN (Vacío) Se activa cuando un jugador entra al servidor.
FIRST_JOIN (Vacío) Ideal para introducciones tutoriales inmersivas.
INTERACT Material Se activa al hacer clic derecho en un bloque (ej: COAL_ORE).
NPC ID de NPC Integración con Citizens (usa el ID numérico).
ZNPC Nombre NPC Integración con ZNPCsPlus (usa el nombre del NPC).
WG_FLAG (Vacío) Se activa mediante las flags axlore-enter o axlore-leave.
REGION_ENTER ID de Región Se activa al entrar en una región de WorldGuard específica.
REGION_LEAVE ID de Región Se activa al salir de una región de WorldGuard específica.
COMMAND (Vacío) Solo se activa manualmente o mediante lógica externa.
MYTHIC_DEATH ID del Mob Se activa cuando muere un mob de MythicMobs.
MYTHIC_INTERACT ID del Mob Al hacer clic derecho en un mob de MythicMobs.
QUEST_START Título de Quest Al iniciar una misión en el plugin Quests.
QUEST_COMPLETE Título de Quest Al completar una misión en el plugin Quests.
AURASKILLS_LEVELUP habilidad:nivel Al subir de nivel en AuraSkills (valor opcional).
MCMMO_LEVELUP habilidad:nivel Al subir de nivel en mcMMO (valor opcional).
SKILL_LEVEL habilidad:nivel Disparador legacy consolidado para ambos sistemas.

🛠️ Comandos de Gestión de Escenas

Además de la configuración manual, AxLore ofrece herramientas potentes para gestionar la narrativa en tiempo real:

📢 Reproducción y Difusión

  • /axlore play <escena> [jugador]: Reproduce una escena para ti o para el jugador indicado. Útil para eventos manuales.
  • /axlore shout <escena>: ¡Difusión total! Reproduce la escena para todos los jugadores conectados a la vez. Ideal para eventos globales del servidor.

🔗 Vinculación Dinámica

Si no quieres editar el archivo YAML manualmente, puedes usar:

  • /axlore link <tipo> <escena> [valor]: Vincula una escena a un disparador en caliente.
    • Ejemplo: /axlore link region bienvenida_norte portal_norte vincula la escena a una región de WorldGuard inmediatamente.

🎙️ Generación de Audio AI

  • /axlore generate <nombre>: El comando más importante tras crear una escena. Envía el texto a ElevenLabs, descarga el audio, lo convierte a OGG (optimizado con FFmpeg) y lo inyecta en tu Resource Pack automáticamente.

👁️ Modos de Visualización (Subtítulos)

AxLore no solo tiene audio, sino también un sistema visual de subtítulos avanzado:

  1. BOSSBAR: Muestra el título y el texto en una barra superior con progreso.
  2. HOLOGRAM (Holograma): Crea un texto flotante que sigue la mirada del jugador con efecto de "máquina de escribir".
  3. BOTH: Activa ambos sistemas simultáneamente.

🎞️ Introducciones (Intros)

AxLore permite reproducir efectos de sonido ambientales (como estática de radio, campanas o suspiros) justo antes de que la narración de la IA comience.

  • Carpeta de archivos: /plugins/AxLore/intros/
  • Clave de configuración: intro-audio: "mi_sonido.mp3"

Formatos Soportados:

Categoría Formatos
Nativo (Más rápido) .ogg, .wav
Transcodificación auto .mp3, .mp4, .m4a
Important Notice Gracias a la integración con **FFmpeg**, no necesitas convertir los archivos manualmente. Simplemente coloca tu `.mp3` en la carpeta y AxLore lo procesará, detectará su duración exacta y retrasará la voz de la IA para que coincida perfectamente con el final de la intro.
Pro Tip Si prefieres una gestión visual, usa **`/axlore admin`** para abrir el editor de escenas integrado en el juego.

Editor GUI
Interfaz del editor in-game: Gestiona tus escenas de forma visual.

¿Te resultó útil?

Ayúdanos a mejorar nuestra documentación.(Anónimo y en cualquier idioma)