EventAlertMod Remake Documentation Hub

Welcome to the EventAlertMod (EAM) Retail Rewrite Documentation Hub. This center provides tailored entry portals for both AddOn users/players and AI/Human developers.

🎮 Players & Users Portal

If you are a player using this AddOn, please visit the following documents to learn about installation, usage, and recent update logs:

• 📖 Quick Start Guide (README)
  • AddOn installation, slash commands, frame adjustments, and feature highlights (Pandemic glow, hero talent support).
• 📜 Changelog (Updates)
  • Full details of rewrite updates in 12.0.7 and 12.1.0, including zero-allocation JIT optimizations and shadow host CDM bypass rendering history.

🤖 AI & Human Developers Portal

If you are an AI coding agent or a human developer contributing to this project, please read the system architecture and development guidelines carefully:

🛠️ Core Guidelines

• 🔑 AI Entrance & Hard Constraints (AGENTS)
  • The absolute Fact-of-Truth guide for developers. Includes combat Secret check protocols, Taint control rules, OnUpdate scheduler limits, and package building scripts.
• 🔄 Subagent Workflows (Collab)
  • Multi-agent collaboration procedures, RACI expert matrix, and QA root cause analysis guidelines.

🏗️ Architecture & APIs

• 📐 System Architecture (Decoupled Design)
  • Complete decoupling between data layers and the Renderer, EventRouter dispatching, and AlertManager batch throttle mechanism.
• 🛡️ Retail 12.x API Boundaries
  • The 4 core Secret/Protected value checking functions, secure table indexing guards, and C++ DurationObject rendering pipelines.
• 🧩 Retail 12.1 AuraContainer Native Backend
  • Build 68914 contracts, Native/Legacy routing, Slot/Group, Aura Sound, schema v2, and pending PTR RQA acceptance.
• 💾 Data State Schema
  • Data structures of the zero-allocation cache pool (AuraStatePool), countdown states, and memory recycling strategies.
• 📜 Module Contracts
  • API contract interfaces between the 5 core data services and the Renderer/AlertManager.

⚡ Performance & Quality

• 🏎️ JIT Optimization & Performance Guide
  • Heap garbage prevention in hot paths (avoiding anonymous closures), pcall crash isolation, and JIT compiler friendly StatePool practices.
• 📋 Retail Smoke Test Plan
  • Smoke test scenarios, in-combat taint checks, and local development package verification.
• 🧪 Flow Validation and Developer Feedback
  • Shared offline/live cases, in-game controls, JSON/Markdown reports, and WTF feedback import.
• 🖥️ Local WoW Development Environment
  • Local 12.0.7/12.1.0 version mapping under D:\World of Warcraft, WTF path derivation, and protection rules for Windows symbolic links targeting D:\EventAlertMod.
• 📓 Development Issue Log
  • A comprehensive log of resolved JIT Aborts, Blizzard protected frame restrictions, and frame clipsChildren issues.