Getting Started Comenzar

Jan 1, 2025

Getting StartedComenzar

Firelands is a WoW Cataclysm Emulator (4.3.4) built with modern software engineering practices. It features a clean hexagonal architecture and comprehensive test coverage.

Firelands es un Emulador de WoW Cataclysm (4.3.4) construido con prácticas modernas de ingeniería de software. Cuenta con una arquitectura hexagonal limpia y cobertura de pruebas completa.

Tech StackTecnologías


Language	C++17
Build	CMake + Ninja
Database	MySQL 8.0
Testing	GoogleTest
Scripting	Lua 5.4


Lenguaje	C++17
Build	CMake + Ninja
Base de datos	MySQL 8.0
Pruebas	GoogleTest
Scripting	Lua 5.4

Architecture

Firelands follows Hexagonal Architecture (Ports & Adapters):

Arquitectura

Firelands sigue la Arquitectura Hexagonal (Ports & Adapters):

src/
├── shared/           # Common utilities
├── domain/           # Entities, Ports
├── application/      # Use cases
├── infrastructure/   # Adapters
├── auth/             # Auth server
├── world/            # Game server
└── tools/            # DevTools

Servers

Server	Binary	Purpose
Auth	`build/bin/auth`	Authentication, sessions
World	`build/bin/world`	Gameplay, characters

Servidores

Servidor	Binario	Propósito
Auth	`build/bin/auth`	Autenticación, sesiones
World	`build/bin/world`	Juego, personajes

DocumentationDocumentación

Developer Setup - Environment and build
Architecture - Hexagonal architecture
Database - Schema and migrations
Lua Scripting - Gameplay scripting
Testing - Unit tests
GM Commands - GM commands

Developer Setup - Entorno y construcción
Architecture - Arquitectura hexagonal
Database - Esquema y migraciones
Lua Scripting - Scripting de juego
Testing - Pruebas unitarias
GM Commands - Comandos de GM