Comprehensive Server Setup Guide

Building your own private server is a rewarding journey. This guide covers the essential steps for setting up a robust environment on Windows or Linux.

1. Prerequisites

  • Operating System: Windows 10/11 or Server 2019+, Debian 11+, or Ubuntu 20.04+.
  • Hardware: Minimum 2 Cores, 4GB RAM (8GB recommended).
  • Compiler: Visual Studio 2022 (Windows) or GCC/Make (Linux).
  • Database: MariaDB 10.5+ is highly recommended over MySQL for performance.

2. Environment Preparation

Windows

Install Visual Studio 2022 Community Edition. Ensure you select "Desktop development with C++".

Install CMake (Add to PATH during installation).

Install Git for Windows.

Linux

sudo apt-get update && sudo apt-get install build-essential cmake git mariadb-server libmariadb-dev-compat libssl-dev zlib1g-dev liblua5.1-0-dev

3. Getting the Source

Clone the latest source code from the official repository (ProjectEQ or EQEmulator, depending on your preference, though we recommend sticking to the standard codebase for compatibility).

git clone https://github.com/EQEmu/Server.git

4. Compiling

Windows: Open the CMake GUI, point source code to your cloned folder, and build binaries to a 'build' folder. Open the generated solution in VS2022 and compile in 'RelWithDebInfo' mode.

Linux:

mkdir build && cd build
cmake ..
make -j$(nproc)

5. Database Setup

Log into MariaDB and create your database:

CREATE DATABASE peq;
GRANT ALL PRIVILEGES ON peq.* TO 'eqemu'@'localhost' IDENTIFIED BY 'password';

Source the base schema and then the latest PEQ database dump.

6. Configuration

Rename eqemu_config.json.full to eqemu_config.json and edit it. Ensure your login server configuration points to our public login server:

"loginserver": {
    "host": "eq-emulator.com",
    "port": "5998",
    "account": "",
    "password": ""
}