🤖 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
SYNCED1. 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 Bot2. 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.