AzerothCore
Pages :

Windows Core Installation

Installation Guide
This article is a part of the Installation Guide. You can read it alone or click on the previous link to easily move between the steps.
<< Step 1: Requirements Step 3: Server Setup >>

Required software

See Requirements before you continue.

Pulling & Compiling the source

Pulling the code

  1. Create the directory where the source files will be located. In this guide, we will use C:\Azerothcore.

  2. Open up Github Desktop

  3. Click File -> Clone repository... in the top left

  4. Click URL

  5. Fill in the data as follow:

Repository URL or GitHub username and repository: https://github.com/azerothcore/azerothcore-wotlk
Local path: C:\Azerothcore

Click Clone. Within a few minutes, Azerothcore's source files will be cloned into C:\Azerothcore.

Configuring and generating Visual C++ solution with CMake

Before you begin, create a new directory called Build. In this guide, we will use C:\Build.

  1. Open CMake

  2. Click Browse Source... → Select the source directory (C:\Azerothcore)

  3. Click Browse Build... → Select the build directory (C:\Build)

  4. Click Configure.

  5. In the dropdown menu, choose the version of the compiler you downloaded in the Requirements section. Be sure to choose the Win64 version if you work on a 64-bit compilation.

  6. Make sure that Use default native compilers is checked.

  7. Click Finish.

  8. Make sure TOOLS_BUILD is set to all. This will compile the extractors needed later in the setup.

  9. Click Configure again. As long as you have error(s) typed in red in the log window you will need to check your parameters and re-run it.

  10. Click Generate. This will install the selected build files into your C:\Build folder.

Compiling the Source

  1. In CMake press Open Project to open the AzerothCore.sln file directly with Visual Studio.

  2. In the menu at the top, click Build and select Configuration Manager.

    1. Set Active Solution Configuration to RelWithDebInfo.

    2. Set Active Solution Platform to x64 and then click Close (settings automatically save).

  3. Right-click ALL_BUILD in the Solution Explorer on the right sidebar and select Clean.

  4. Right-click ALL_BUILD and select Build. (Ctrl + Shift + B)

    1. If your GUI does not show Solution Explorer, click the Build menu and select Clean Solution, and then Build.

Build time differs from machine to machine, but you can expect it to take between 5 and 30 minutes.

If you are asked to "Reload build files" during or after the compilation, do so.

When the build is complete you will find a message in the output that looks similar to this:

========== Build: 22 succeeded, 0 failed, 0 up-to-date, 1 skipped ==========

You will find your freshly compiled binaries in the C:\Build\bin\RelWithDebInfo or C:\Build\bin\Debug folder. These are all used to run your server at the end of this instruction.

You will need the following files in order for the core to function properly:

\configs\
authserver.exe
authserver.pbd
worldserver.exe
worldserver.pdb
libmysql.dll

---------
For OpenSSL 1.1.x

libeay32.dll / libcrypto-1_1.dll / libcrypto-1_1-x64.dll
ssleay32.dll / libssl-1_1.dll / libssl-1_1-x64.dll

---------
For OpenSSL 3.0 and later

legacy.dll
libcrypto-3.dll / libcrypto-3-x64.dll
libssl-3.dll / libssl-3-x64.dll

In the configs folder you should find:

authserver.conf.dist
worldserver.conf.dist

There are two/three DLL files that need to be manually added to this folder, and you need to copy them from the following installation/bin directories:

libmysql.dll → C:\Program Files\MySQL\MySQL Server 8.x\lib

OpenSSL before version 1.1.0:

libeay32.dll and ssleay32.dll → C:\OpenSSL-Win64\ or C:\OpenSSL-Win32\ (depends on if your core is 64-bit or 32-bit).

OpenSSL 1.1.x names have changed:

libssl-1_1-x64.dll and libcrypto-1_1-x64.dll → C:\OpenSSL-Win64\bin

OpenSSL 3.0 and more recent installed, you need to copy:

legacy.dll → C:\OpenSSL-Win(32/64)\bin
libcrypto-3-x64.dll and libssl-3-x64.dll → C:\OpenSSL-Win64\bin

About compilation log and report

pdb files only exist if you compile with Debug or RelWithDebInfo configuration. It is not mandatory but it is recommended to compile core with at least the RelWithDebInfo configuration to get proper crash logs.


Help

If you are still having problems, check:

Installation Guide
This article is a part of the Installation Guide. You can read it alone or click on the previous link to easily move between the steps.
<< Step 1: Requirements Step 3: Server Setup >>