Documentation

Explore the complete Firelands Core documentation. Click any card below to dive into the topic you need.

Pro tip: Start with Getting Started if you're new!
#1

Getting Started

Introduction to Firelands - WoW Cataclysm Emulator
#2

Architecture

Hexagonal architecture, layers, ports, and domain model
#3

Contributing

Development workflow, code standards, and pull request guidelines
#4

Developer Setup

Environment setup, build, configuration, and deployment
#5

Database

Schema, migrations, and persistence adapters
#6

Module: Shared

FirelandsShared — config, logging, crypto, networking helpers, DBC reader
#7

Module: Domain

FirelandsDomain — entities, world model, repository ports
#8

Module: Application

FirelandsApplication — use cases, services, and application ports
#9

Module: Infrastructure

FirelandsInfrastructure — MySQL, ASIO, Lua, REST, realm-link
#10

Module: Executables

auth and world composition roots — startup, wiring, operational flow
#11

Tools, SQL & Build

CMake layout, SQL migrations, tests, DevTools, and extractor targets
#12

Gossip & NPC Text

NPC gossip menus, dialog copy, quest lines, and Lua hooks (4.3.4)
#13

Lua Scripting

Gameplay scripting with Lua 5.4
#14

Testing

TDD workflow, GoogleTest, and test layout
#15

DevTools

FirelandsDevTools CLI for account and realm management
#16

Extractors

Client data extractors for Cataclysm 4.3.4 MPQ archives
#17

VMap Pipeline

Client data and collision extractors — server .map, vmap, mmap master plan
#18

StormLib Roadmap

MPQ extractors for Cataclysm 4.3.4 — DBC and raw map extraction plan
#19

GM Commands

Game Master commands, tickets, and console reference
#20

GM Tickets

Help desk persistence, assignment, wire format, and implementation
#21

Core Roadmap

Unified development roadmap for firelands-next — phases, parity matrix, extractors, toolchain, and status tracking
#22

C++20 Migration

Toolchain upgrade plan — Phase 1 complete, Phase 2 feature adoption
#23

Phase System

Zone phasing, creature visibility, database tables, and layer-by-layer implementation
#24

Player Create Info

Starter positions, spells, and skills for new characters (playercreateinfo tables).