Description
AIOS Core
Version: 1.0.0
Author: PoorKingz
License: MIT
Compatibility: Retail, Classic Era, Mists of Pandaria Classic
AIOS Core is a deterministic, service-oriented kernel framework for World of Warcraft addon development.
It provides a structured foundation for building modular addons with:
- Lazy service resolution (ServiceRegistry)
- Reactive event handling (EventBus)
- Structured logging
- Timer scheduling (debounce/throttle support)
- Namespaced saved variables with schema support
- Cross-flavor normalization across supported WoW clients
AIOS Core is dependency-free and written in pure Lua 5.1.
The goal of AIOS is to provide a stable, cross-flavor-safe foundation where public APIs behave consistently across Retail and Classic clients.
Architecture Overview
AIOS is built around a central ServiceRegistry that provides dependency-safe initialization and lazy instantiation of services.
Core systems include:
- ServiceRegistry — Dependency container and service resolver
- EventBus — Reactive and async event system
- Timers — Deterministic scheduling layer
- Saved — Versioned persistence layer
- Logger — Structured logging with adjustable verbosity
- Lean — Optional memory pooling utilities
Optional modules (not required by core execution path):
- Codec — Compression / encoding utilities
- Locale — Localization system (currently being finalized)
- Debug tools — Internal diagnostics scaffolding
Project Status
AIOS Core is stable and production-ready as a kernel framework.
Some subsystems such as Locale translation flow are still being refined, but core services are fully functional.
Feedback and architectural review are welcome.