Guía de Documentación

Integraciones Profesionales

Conecta AxLore con Citizens, WorldGuard y PlaceholderAPI.

🔌 Integraciones Profesionales

AxLore está diseñado para funcionar en perfecta armonía con los ecosistemas más populares de Minecraft. En lugar de usar comandos complejos, AxLore utiliza hooks nativos basados en eventos para un rendimiento y fiabilidad superiores.

👥 Integración con NPCs

AxLore detecta automáticamente y se conecta con:

  • Citizens: Usa el ID numérico del NPC como valor del disparador.
  • ZNPCsPlus / ServersNPC: Usa el nombre del NPC como valor del disparador.

Configuración rápida:

Puedes hacerlo manualmente en el YAML o usar el comando simplificado:
/axlore link npc <nombre_escena> <id_o_nombre_npc>

🚩 Regiones de WorldGuard

La forma más potente de crear entornos inmersivos es mediante regiones de WorldGuard. AxLore registra una "flag" personalizada para este propósito.

La Flag axlore-scene

  1. Selecciona una región.
  2. Ejecuta: /rg flag <nombre_region> axlore-scene <nombre_escena>
  3. Cada vez que un jugador entre en esa región, la historia comenzará automáticamente.
Pro Tip Este método es superior al tipo de disparador `REGION` tradicional porque es manejado nativamente por WorldGuard, garantizando cero lag.

📊 PlaceholderAPI

AxLore expone su estado interno para que puedas mostrarlo en scoreboards, menús o en el chat.

Placeholder Descripción
%axlore_lang% Muestra el idioma seleccionado por el jugador.
%axlore_is_playing% Devuelve true o false (si está en una escena).
%axlore_current_scene% El nombre técnico de la escena activa.
%axlore_current_title% El título traducido de la escena activa.
%axlore_is_muted% Devuelve true si el jugador tiene las voces silenciadas.
%axlore_active_sessions% (Global) Cuántos jugadores están escuchando escenas ahora.

💻 API para Desarrolladores y ConditionalEvents

Para usuarios avanzados, AxLore dispara un evento personalizado cada vez que se activa una escena:
com.axxtrial.license.event.AxLoreSceneTriggerEvent

Integración con ConditionalEvents

¡Puedes usar ConditionalEvents para escuchar este evento, añadir condiciones extra (como "solo si el jugador tiene el item X"), y luego permitir que la historia proceda o cancelarla!

Nombre del Evento: AxLoreSceneTriggerEvent
Variables:

  • %scene%: El nombre de la escena.
  • %player%: El jugador que activa la escena.

⚔️ Suite de Integración RPG

AxLore cuenta con un puente nativo de alto rendimiento para los plugins RPG gratuitos más populares. Estas integraciones son pasivas; solo consumen recursos cuando se detecta un evento específico.

MythicMobs

Transforma las batallas contra jefes en experiencias cinematográficas.

  • MYTHIC_DEATH: Activa una cinemática cuando un jefe es derrotado. Valor: NombreInterno.
  • MYTHIC_INTERACT: Activa un diálogo al hacer clic derecho en un mob. Valor: NombreInterno.
    • Consejo: El NombreInterno es el nombre del archivo YAML o el ID superior en tu configuración de MythicMobs (ej: ReyEsqueleto:).

Quests (PikaMug)

Integra diálogos de NPCs directamente en tu sistema de misiones.

  • QUEST_START: Dispara una intro narrativa al aceptar una misión.
  • QUEST_COMPLETE: Dispara una cinemática de victoria al terminar una misión.
    • Valor: Usa el Título exacto de la misión tal cual está definido en el editor de Quests.

AuraSkills y McMMO

Recompensa el progreso del jugador con lore único o tutoriales.

  • SKILL_LEVEL: Se activa cuando un jugador alcanza un hito específico.
  • Formato: habilidad:nivel (ej: mining:10 o swords:50).
  • Lógica: AxLore escucha los eventos de subida de nivel y los mapea automáticamente a tus escenas locales.

Rendimiento y Estabilidad

La Suite RPG utiliza una Arquitectura Basada en Reflexión. Esto permite que AxLore soporte estos plugins sin requerirlos como una "dependencia obligatoria". Si actualizas o cambias tus plugins RPG, AxLore seguirá funcionando perfectamente, detectando las nuevas versiones automáticamente en tiempo de ejecución.

Important Notice Todos los hooks son **opcionales**. Si no usas Citizens o WorldGuard, AxLore simplemente desactivará esos módulos y funcionará normalmente sin ningún impacto en el rendimiento.

¿Te resultó útil?

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