Pulling, Compiling and Keeping the Source Up-to-Date

Pulling, Compiling and Keeping the Source Up-to-Date

Introduction

Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install Trinity and only the Trinity updating procedures will need to be run from time to time.

Required Software

See TrinityCore Requirements

Pulling & Compiling the Source

Pulling the Source

Create a directory in which Core files will be pulled (for example: C:\Trinity).
Right-click on the directory and click on Git Extensions -> Clone.
Fill in the data as follows:

Repository to clone: https://github.com/TrinityCore/TrinityCore
Destination: C:\Trinity
Subdirectory to create: <none>
Branch: 3.3.5
Personal Repository: Yes

Note: Depending on which branch you want to compile, change the name of the branch accordingly. i.e. 3.3.5/4.3.4/6.x

Click Clone. Within a few minutes all of the TrinityCore source files will be pulled into the directory C:\Trinity.

Configuring and generating Visual C++ solutions with CMake

Before you begin, create an empty directory called Build. In this example, we will use D:\Build.

Note: If CMake do not recognize C/C++ compiler, choose Specific Native Compiler, and choose path to target vcvarsall.bat, e.g. C:\Program Files\Microsoft Visual Studio 12.0\VC\vcvarsall.bat

Click Browse Source... -> Select
the source directory (C:/Trinity)

2. Click Browse Build... -> Select
the build directory (D:/Build)

3. Click Configure

4. Make sure Use default native
compilers is checked

5. In the drop-down menu, choose the
version of the compiler you downloaded
in the Software Required section .

6. Click Finish.

7. Make sure Tools is checked. This will
compile the map extractors needed later
in the setup.

8. Click Configure again.

9. Click Generate. This will install the
selected build files into your D:/Build folder.

Note: If MySQL is not found by CMake it is required to set MYSQL_INCLUDE_DIR = C:/mysql_libs/include and MYSQL_LIBRARY= C:/lib_XX/libmysql.lib.
XX depends if you are compiling in 32 or 64 bits mode. (See the 9th point of the Windows requirement list in TrinityCore Requirements.)

Note 2: If you get linker errors (e.g "error LNK2019: unresolved external symbol mysql_server_init"), make sure MYSQL_LIBRARY is set to the version that matches your compile mode (x64 vs 32 bits).

(If you do not see the MYSQL fields in CMake, tick the Advanced box).

Compiling the Source

Browse into your D:\Build folder and open TrinityCore.sln with Visual C++ Express.
On the menu at the top, click Build and select Configuration Manager.
Set Active Solution Configuration to Release
In the list menus below "Help", set Active Solution Platform to Win32 (if you set 64-bit compilation during the CMake configuration, select Win64)
click Close (settings get saved instantly).
Right-click ALL_BUILD in the Solution Explorer on the left sidebar and select Clean.
(on some VS2013 versions, click the Build menu and select Clean Solution.)
Right-click ALL_BUILD and select Build.
1. Compilation length differs from machine to machine, you should expect it to take 5-30 minutes.
2. If you are asked to "Reload build files" during the compile, do so.
3. When the build is complete, you will find a message similar to the one below (the numbers may be different).

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

You will find your freshly compiled binaries in the C:\Build\bin\release 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. These will all be located in your C:\Build\bin\release folder:

libeay32.dll
libmySQL.dll
ssleay32.dll
worldserver.conf.dist
worldserver.exe
authserver.conf.dist
authserver.exe

There are a few DLLs that needs to be manually added to this folder, and you need to copy them over from the following installation/bin directories:

libmySQL.dll - C:\Program Files\MySQL\MySQL Server 5.x\lib
libeay32.dll, ssleay32.dll - C:\OpenSSL-Win32\bin

libzmq-v120-mt-4_0_4.dll - C:\Program Files\ZeroMQ 4.0.4\bin

Keeping the Source Up-to-Date

TrinityCore Developers are always at work fixing and adding new features to the core. You can always check them here, or by viewing them from within Git Extensions.

Open your TrinityCore repository in GitExtensions.
1. Click on the blue arrow
2. In the new window, click Pull.
This will sync your local repo to the latest commits from the branch you have setup as default.
Now you will need to re-run CMake Configure & Generate to update your SLN files.
Compile
??
Profit!!

TrinityCore : Windows