macOS Server Setup

Table of contents

• Client Data Files (Download Pre-Extracted)
• Client Data Extractors (Extract Files Yourself)
• Config Files: Worldserver and Authserver

Now that you have the source compiled, you need to add the necessary client data. You can either download pre-extracted files or use the compiled extractors to extract the files yourself. Once the data is ready, you must update the DataDir option in your worldserver.conf file to point to the directory containing the data.

Some files are optional but highly recommended:

Directory
dbc	Mandatory
maps	Mandatory
vmaps	HIGHLY RECOMMENDED
mmaps	HIGHLY RECOMMENDED
cameras	Recommended

Option 1: Download Pre-Extracted Files

If you intend to use an enUS client you can download the data files below. If you intend to use any other language client you will need to extract the data yourself.

Data files enUS (AC Data v17)

1. Download the files above.

2. Create a new folder within the build folder called data. i.e. $HOME/azeroth-server/data/

3. Extract the files from the zip file and place them within the data folder.

4. Edit your the DataDir config option to the location of your folder.

Option 2: Extract Files Yourself

(Not needed if you downloaded the files above)

Go to your AzerothCore build directory (e.g. $HOME/azeroth-server/bin/) and copy the following files to your World of Warcraft binaries directory.

• mapextractor
• mmaps_generator
• vmap4assembler
• vmap4extractor

DBC and Maps files

cd <your WoW client directory>
./mapextractor

Visual Maps (aka vmaps) Note: If you stop vmap4extractor before finish you will need to delete the Buildings directory before start again.

You can also extract vmaps which will take quite a while depending on your machine (up to hours on ancient hardware).

cd <your WoW client directory>
./vmap4extractor
mkdir vmaps;
./vmap4assembler Buildings vmaps

When this is complete you will receive the following message which can be safely ignored.

Processing Map 724
[################################################################]
Extracting GameObject models...Extracting World\Wmo\Band\Final_Stage.wmo
No such file.
Couldn't open RootWmo!!!
Done!

Extract V4.00 2012_02. Work complete. No errors.

Movement Maps (aka mmaps - optional RECOMMENDED)

Extracting mmaps will take quite a while depending on your machine (up to hours).

cd <your WoW client directory>
mkdir mmaps;
./mmaps_generator

Now that everything is completed, you need to copy dbc, maps, vmaps and mmaps folders to your AzerothCore build directory (e.g. $HOME/azeroth-server/data/).

Config Files: Worldserver and Authserver

First of all you need to find the two default config files (named worldserver.conf.dist and authserver.conf.dist) and copy them. Then rename the copies their namesakes without the .dist extension. You can find them within /build/configs/ (may vary).

Open the .conf files and scroll down to LoginDatabaseInfo, WorldDatabaseInfo, and CharacterDatabaseInfo and enter MySQL login information for the server to be able to access your database.

On a newly compiled configuration, you will have the following values by default

LoginDatabaseInfo     = "127.0.0.1;3306;acore;acore;acore_auth" worldserver.conf / authserver.conf
WorldDatabaseInfo     = "127.0.0.1;3306;acore;acore;acore_world" worldserver.conf
CharacterDatabaseInfo = "127.0.0.1;3306;acore;acore;acore_characters" worldserver.conf

They follow this structure:

Variablename = "MySQLIP;Port;Username;Password;database"

The following steps must be verified:

• The hostname (127.0.0.1) can stay the same if AzerothCore is being installed on the same computer that you run WoW on. If not, follow the instruction in Realmlist Table.
• The port (3306) is the standard configured value. If you changed the default port in your MySQL settings, you must change it accordingly. The username and password can be variable. You can choose to either:
  • use default acore / acore username and password pair.
  • create a unique login within a User Manager within your preferred database management tool (commonly identified by an icon that looks like a person or people) and give it the necessary permissions (SELECT, INSERT, UPDATE, DELETE permissions are sufficient, and is much safer).

Updating DataDir

1. In your worldserver.conf file locate the DataDir option.

2. Edit it to the path of your folder. i.e $HOME/azeroth-server/data/

TIP

For most worldserver.conf setting changes, you can simply type .reload config in-game to see changes instantly without restarting the server.

WARNING

The AzerothCore Team and Owners DO NOT in any case sponsor nor support illegal public servers. If you use these projects to run an illegal public server and not for testing and learning it is your own personal choice.

(Optional) Config options by environment variable

It is possible to load config options via environment variables, which you can read about here.

Help

If you are still having problems, check:

• FAQ
• Common Errors
• How to ask for help
• Join our Discord Server, but it is not a 24/7 support channel. A staff member will answer you whenever they have time.