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"
  texts:
    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 /axlore link.

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 la flag axlore-scene en WorldGuard.
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.
SKILL_LEVEL habilidad:nivel Al subir de nivel en AuraSkills o McMMO.

Ejemplo de Configuración:

yaml
trigger:
  type: NPC
  value: "42"  # Se activa al hacer clic en el NPC #42

# Ejemplo RPG: Diálogo al morir un Boss
trigger:
  type: MYTHIC_DEATH
  value: "ReyEsqueleto"

⚔️ Configuración Detallada de RPG

Al usar disparadores RPG, asegúrate de que el valor coincida exactamente con lo que el plugin usa internamente.

Plugin Valor a utilizar
MythicMobs El InternalName definido en tu archivo YAML del mob.
Quests El Título de la misión tal cual aparece en tu editor de misiones.
AuraSkills El nombre de la habilidad + nivel (ej: agility:25).
McMMO El nombre de la habilidad + nivel (ej: unarmed:100).

👁️ 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)

Si colocas archivos MP3 en la carpeta /intros, puedes hacer que una escena los reproduzca antes de la narración de la IA. El sistema detectará la duración automáticamente y sincronizará la voz.

💾 Persistencia de Escenas

Si activas one-time: true, AxLore guardará el progreso del jugador en sus datos persistentes (NBT). Esto garantiza que, aunque el jugador salga y vuelva a entrar, la escena no se repetirá.

Pro Tip Usa el comando `/axlore generate ` después de crear una escena para que la IA genere los archivos de audio automáticamente y los integre en el resource pack.

¿Te resultó útil?

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