Skip to content

Latest commit

 

History

History
43 lines (30 loc) · 2.3 KB

API.md

File metadata and controls

43 lines (30 loc) · 2.3 KB

🔌 Especificación Técnica y API — ProjectJaina_LoreHUD

GitHub Ecosistema

📌 Resumen Arquitectónico

HUD inmersivo de diálogos cinemáticos y burbujas narrativas 3D sincronizado con el motor LoreEngine y los LoreBots del servidor (Jaina Proudmoore en Theramore).

  • Rol en el Ecosistema: Módulo Oficial #10 — Narrativa y Cinemáticas LoreBots
  • Archivo Principal TOC: LoreHUD.toc
  • Compatibilidad del Motor: World of Warcraft 3.3.5a (Build 12340)

⌨️ Comandos de Consola (Slash Commands)

  • /lorehud: Acceso principal o comando del addon.

📡 Protocolo de Red y Eventos

  • LOREWOW: Prefijo registrado para sincronización de datos.

Cargas Útiles del Protocolo LOREWOW (CHAT_MSG_ADDON)

  • JAINA_STATE|<Mood>|<Location>|<Activity>: Actualización de panel HUD de Lady Jaina en Theramore.
  • JAINA_EVENT|<Título>|<Duración>|<Descripción>: Despliega el banner cinematográfico animado en pantalla con borde dorado y aviso sonoro (utilizado por el Galeón de los Desertores y la conquista de Baluartes de Hermandad).
  • JAINA_EXP|<ExpKey>|<District>|<Duration>: Misión diplomática y expedición de Lady Jaina (Ventormenta, Dalaran, Cumbre de Paz).

Eventos del Motor 3.3.5a Gestionados

  • PLAYER_LOGIN / ADDON_LOADED: Inicialización atómica de tablas de configuración y hooks.
  • PLAYER_ENTERING_WORLD: Sincronización de estado tras transiciones de pantalla o mapa.
  • PLAYER_LOGOUT: Guardado seguro en disco de las variables locales.

💾 Persistencia de Datos (SavedVariables)

  • LoreHUDDB: Almacenamiento estructurado de configuración y estado persistente.

🛠️ Buenas Prácticas de Integración

  1. Toda invocación a funciones públicas debe verificar previamente la existencia del espacio de nombres en _G.
  2. Las tablas de configuración deben consultarse en modo lectura sin sobreescribir valores por omisión no validados.
  3. El intercambio de datos con otros addons debe efectuarse a través del bus oficial ProjectJaina_Companion o hooks de eventos estándar.