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.

Editor GUI
Interfaz de edición in-game: Gestiona tus NPCs y escenas visualmente.

Configuración rápida:

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

Flags de WorldGuard

AxLore registra tres flags personalizadas para un control narrativo detallado:

  • axlore-enter: (Nueva) Dispara una escena cuando un jugador entra en la región.
  • axlore-leave: (Nueva) Dispara una escena cuando un jugador sale de la región.
  • axlore-scene: (Legacy) Un alias para entrar en la región, mantenido por compatibilidad.
  1. Selecciona una región.
  2. Ejecuta: /rg flag <nombre_region> axlore-enter <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 el máximo rendimiento.

📊 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.

PAPI Integration
Ejemplo de integración con AuraSkills y Placeholders dinámicos.

💻 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.

MythicMobs

  • 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.

Quests (PikaMug / Blackvein)

Quests Integration
Validación de misiones y disparadores narrativos en tiempo real.

  • 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.

AuraSkills y McMMO

  • AURASKILLS_LEVELUP / MCMMO_LEVELUP: Disparadores específicos para cada sistema de habilidades.
  • SKILL_LEVEL: Tipo de disparador consolidado para ambos sistemas.
Important Notice Todos los hooks son **opcionales**. Si no usas Citizens o WorldGuard, AxLore simplemente desactivará esos módulos sin impacto en el rendimiento.

¿Te resultó útil?

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