Core Concepts

This section covers the fundamental concepts and architecture of MAID.

Overview

MAID is built on several key architectural patterns that work together to create a flexible, extensible game engine:

1. Architecture - Package layering, async design, network stack
2. Entity Component System (ECS) - A data-driven architecture for game objects
3. Event-Driven Design - Loose coupling through an event bus
4. Content Pack System - Modular, pluggable game content
5. Layered Commands - Priority-based command resolution
6. AI Integration - LLM-powered features

Architecture Diagram

+------------------+     +------------------+     +------------------+
|  maid-classic-   |     |   maid-stdlib    |     |  Your Content    |
|      rpg         |     |                  |     |     Pack         |
+--------+---------+     +--------+---------+     +--------+---------+
         |                        |                        |
         +------------------------+------------------------+
                                  |
                    +-------------v-------------+
                    |       maid-engine         |
                    |  +-------+  +---------+   |
                    |  |  ECS  |  | Events  |   |
                    |  +-------+  +---------+   |
                    |  +-------+  +---------+   |
                    |  |Network|  |Commands |   |
                    |  +-------+  +---------+   |
                    +--------------------------+

Quick Links

• New to MAID? Start with the Architecture Overview to understand how the pieces fit together.
• Building a game? Learn about Content Packs and ECS.
• Adding commands? See the Command System guide.
• Need AI features? Check out AI Integration.

Key Concepts

:maxdepth: 2

architecture
ecs
events
content-packs
commands
ai-integration