Skip to content

windows-core-installation.md

Latest commit

 

History

History
155 lines (92 loc) · 6.78 KB

windows-core-installation.md

File metadata and controls

155 lines (92 loc) · 6.78 KB

Windows Core Installation

Installation Guide
This article is a part of the Installation Guide. You can read it alone or click 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.

{{site.data.alerts.note}} When using Github Desktop if you encounter errors cloning either refering to fatal: early EOF or fatal: fetch-pack: invalid index-pack output or anything similiar, right after starting the cloning or after a while, consider in using git bash to clone azerothcore-wotlk repository, you only need to do this once, updating the core can be done via Github Desktop with no issues. {{site.data.alerts.end}}

In the case of errors during the cloning with Github Desktop follow the following steps:

We are using C:\Azerothcore as the example directory.

  1. Open Git Bash as Adminstrator

  2. Type cd C: and press ENTER (instead of C: you can use the path cd "F:\MyFolder\MyOtherFolder" make sure the path is between quotes " ")

  3. Type mkdir Azerothcore and press ENTER

  4. Type cd Azerothcore and press ENTER

  5. Type git clone https://github.com/azerothcore/azerothcore-wotlk and press ENTER

  6. When the cloning finishes go back to your Github Desktop and File -> Add local repository -> C:\Azerothcore\azerothcore-wotlk (or use the choose button and use the windows interface.

  7. You're done with cloning the core.

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.

{{site.data.alerts.note}} If you were to encounter errors in CMake see Common Errors. {{site.data.alerts.end}}

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
legacy.dll
libcrypto-3-x64.dll
libssl-3-x64.dll

There are four DLL files that need to be manually added to this folder, and you need to copy them from the following directories:

{% include callout.html content="libmysql.dll → C:\Program Files\MySQL\MySQL Server 8.x\lib" type="primary" %}

{% include note.html content="Your libmysql.dll version need to match the MySQL Server version you run. If you update your MySQL server you need to recompile the core and copy the new dll file over." %}

{% include callout.html content="legacy.dll, libcrypto-3-x64.dll and libssl-3-x64.dll → C:\OpenSSL-Win64\bin" type="primary" %}

In the configs folder you should find:

authserver.conf.dist
worldserver.conf.dist

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.

{% include important.html content="To report crash logs it's MANDATORY to compile with Debug or RelWithDebInfo configuration." %}


Help

{% include help.html %}

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