cmangos-help

Debian 10 CMaNGOS Installation Instructions

How to install & run C(ontinued)-MaNGOS from source code

server core: cmangos/mangos-classic
server data: cmangos/classic-db
server host: debian 10 (buster)
goal: Doing WoW-Emulation Right!

The following variables are used in this document:

db-new-password - You new MariaDB password for new user with root privileges

If you are an absolute beginner to programming and compiling then you may want to go through the Beginner’s Guide first.

1. Links

CMaNGOS: site forum git repositories discord
Classic-DB: forum git repository
Author of this guide: @biosfree

2. Software requirements

Debian 10 Installed and Configured
Client World of Warcraft Classic (vanilla version 1.12.x)
MariaDB (community-developed fork of the MySQL) database management system for server. This guide will also help you install and configure MariaDB.
Some tools: Git, GCC, CMake, Boost and a few libraries (see below)

2.1 Install help tools and some libraries

sudo apt update
sudo apt install build-essential automake git cmake default-libmysqlclient-dev libtool libssl-dev zlibc libbz2-dev subversion libboost-all-dev

or full list without dependencies:

sudo apt install grep build-essential gcc g++ automake git autoconf make patch cmake default-libmysqlclient-dev libtool libssl-dev binutils zlibc libc6 libbz2-dev subversion libboost-all-dev

2.2 Install and Configure MariaDB

Installing MariaDB version 10.3 from standart debian buster repo

sudo apt install mariadb-server

or MariaDB version 10.4 stable from mariadb repo

sudo apt-get install software-properties-common dirmngr
sudo apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 0xF1656F24C74CD1D8
sudo add-apt-repository 'deb [arch=amd64] http://mariadb.mirror.serveriai.lt/repo/10.4/debian buster main'

sudo apt update
sudo apt upgrade
sudo apt install mariadb-server

Check all available versions and mirrors on the official MariaDB Foundation page

Run this script to increase the security of your MariaDB installation
```
sudo mysql_secure_installation
```
- The script will prompt you to determine which actions to perform
  
  Enter current password for root (enter for none): ENTER
  
  Switch to unix_socket authentication [Y/n] N
  
  This request become available only if you installed the latest version from MariaDB repositories
  
  You already have your root account protected with unix_socket authentication, so you can safely answer ‘n’
  
  Set root password? [Y/n] N
  
  In Debian, the root account for MariaDB is tied closely to automated system maintenance, so we should not change the configured authentication methods for that account.
  
  You already have your root account protected with unix_socket authentication, so you can safely answer ‘n’
  
  Remove anonymous users? [Y/n] Y
  
  Disallow root login remotely? [Y/n] Y
  
  Remove test database and access to it? [Y/n] Y
  
  Reload privilege tables now? [Y/n] Y
Optionally set up an additional administrative account dbadmin with password db-new-password for password access (e.g. for remote full access to the database through SSH-tunnel)
```
sudo mysql
```
- the command prompt line changes to MariaDB [(none)]>
```
GRANT ALL ON *.* TO 'dbadmin'@'localhost' IDENTIFIED BY 'db-new-password' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT
```
  Don’t forget to change the db-new-password variable to a really complicated password!

3. Get the remote data to your system

Create a new user to run your mangos server under
```
sudo adduser mangos
```
Switch to mangos user in a shell
```
su mangos
```

Create a source dir

mkdir /home/mangos/source
cd /home/mangos/source

Git mangos-classic

git clone git://github.com/cmangos/mangos-classic.git

Git classic-DB

git clone git://github.com/cmangos/classic-db.git

4. Compiling CMaNGOS

Create a build dir

mkdir /home/mangos/source/build
cd /home/mangos/source/build

Choose build options

options that may interest us:

-DCMAKE_INSTALL_PREFIX=\  Path where the server should be installed to
-DPCH=1                   Use precompiled headers (much faster after updates)
-DDEBUG=0                 Remove debug mode from compiling
-DBUILD_EXTRACTORS=ON     Build map/dbc/vmap/mmap extractor
-DBUILD_PLAYERBOT=ON      Build with playerbots mod enabled

example:

Example1: command to just compile mangos-classic and install in /home/mangos/wow-vanilla-run dir:
cmake ../mangos-classic -DCMAKE_INSTALL_PREFIX=\../../wow-vanilla-run -DPCH=1 -DDEBUG=0

Example2: command to compile same as in Example1 + build map extraction tools:
cmake ../mangos-classic -DCMAKE_INSTALL_PREFIX=\../../wow-vanilla-run -DBUILD_EXTRACTORS=ON -DPCH=1 -DDEBUG=0

Example3: command to compile same as in Example1 + build map extraction tools + playerbots mod
cmake ../mangos-classic -DCMAKE_INSTALL_PREFIX=\../../wow-vanilla-run -DBUILD_EXTRACTORS=ON -DPCH=1 -DDEBUG=0 -DBUILD_PLAYERBOT=ON

Configure building utility use Example3 settings
```
cmake ../mangos-classic -DCMAKE_INSTALL_PREFIX=\../../wow-vanilla-run -DBUILD_EXTRACTORS=ON -DPCH=1 -DDEBUG=0 -DBUILD_PLAYERBOT=ON
```
(installing in the /home/mangos/wow-vanilla-run dir, with map extraction tools and enabled playerbots mod)
Make building CMaNGOS binary files
```
make
```
Install CMaNGOS binary files
```
make install
```