AI Agent Manual

MU3 THEME v3.0
CLUSTER SYNC: OK
DESIGN SYSTEM: MU3

🤖 AI Agent & Developer Operating Manual (AGENTS.md)SYSTEM ARCHITECTURE

Master reference manual for automated AI coding agents, subagents, and human server architects.

FILE: F:\GAMES-Reborn\AGENTS.md
SYNCED

1. Ecosystem & Directory Layout

F:\GAMES-Reborn\
├── games/
│   ├── mu3/                 # MU Origin 3 Core Server (Port 8001 / XOR 0xBE / Protobuf / DES)
│   ├── aion/                # Aion 5.8 & 7.x Server (Port 2106 / RSA-1024 / Blowfish)
│   └── lineagew/            # Lineage W Server (Port 7000 / Length-Prefixed Protobuf)
├── services/
│   ├── auth/                # Universal Cross-Game Auth (gRPC 50051 / REST 4000)
│   ├── billing/             # Multi-game Currency Ledger & Stripe/PayPal (Port 4001)
│   ├── promotions/          # Axum REST Giftcode & In-Game News Engine (Port 4002)
│   └── crawler/             # Autonomous Market & Game Intelligence Scraper (Port 4003)
├── packages/
│   ├── shared/              # Common Types, Packet Utilities & Vendored Protoc Builder
│   ├── auth-client/         # Client SDK for connecting to Universal Auth
│   ├── packet-calc/         # High-precision combat, drop, & EXP rate calculator
│   └── core-tools/          # Directboot game process launcher & CLI utilities
└── apps/
    ├── web-platform/        # Next.js 14 Web Portal, Admin Control Center & VIP Alpha Page
    ├── launcher/            # .NET 9 WPF + Kotlin Compose Multiplatform Game Launcher
    └── bot/                 # Discord Slash Command Administration & Alert Bot

2. Core Operational Commands

WORKSPACE COMPILATION CHECK
cargo check --workspace
Verifies all 10 crates with 0 errors
WEB PLATFORM & ADMIN
cd apps/web-platform; npm run dev
Spins up admin center on :3000

3. Protocol & Cryptographic Specifications

• MU Origin 3: Port 8001. DES login handshake (`Ourpalm`), dynamic XOR `0xBE` frame cipher, opcode `0x07E1` Enter-World builder with 28 skill map entities compressed via zlib (`0x78 0x9C`).

• Aion 5.8 / 7.x: Port 2106. RSA-1024 login encryption, dynamic 8-byte Blowfish block cipher initiated via `SM_INIT (0x00)`, GameGuard 0x07 anti-cheat token bypass active.

• Lineage W: Port 7000. Length-prefixed TCP streaming, protobuf state machine transitions from unauthenticated to in-world.