• Notepad++ http://notepad-plus-plus.org/ - An advanced text-editor with syntax highlighting for most that you can wish for :)

After having opened Git bash, simply type:

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

Versions for different clients:

And submit this git command with return. This will take a little time, but after you will have created a subdirectory into C:\Mangos named "mangos" into which the CMaNGOS sources are cloned.

git clone git://github.com/ACID-Scripts/WOTLK.git acid

Versions for different clients:

This is considered optional, as ACID is usually included by the database providers.

Now you should have the following subfolders:

• mangos (containing the sources of CMaNGOS and optionally ScriptDev2)

• acid (containing the content of ACID, this is optional)

• unifieddb OR ytdbase OR psmdb_wotlk OR tbc-db OR classicdb containing the content of your database-provider

For windows we suggest creating an additional "run" folder, on *nix this can be useful if you don’t want to install to /opt or so

• run

For *nix or cmake compile we suggest creating an additional "build" folder, this is not required for Visual C++

• build

For instructions on how to compile boost from source code, see here.

For Windows users who would prefer to simply download the binaries, you can find installers here. You have to download the binaries corresponding to your VisualStudio version (VS2015→msvc-14, VS2013→msvc-12) and your desired architecture (Win32 or x64). To make it easy you can put thoses files in your boost path in subfolder named lib/win32 for 32 bit version and lib/x64 for 64 bit version. Both can be installed together.

If you have already boost in another folder schema you can also define BOOST_LIBRARYDIR to point to the right folder. Then only win32 or x64 will work according to the file you have on that folder.

The CMaNGOS cmake scripts should automatically detect the location of your boost installation, and configure the build accordingly. If it is not detected, please ensure that your BOOST_ROOT environment variable is set properly. For more information, see here.

If you are using cmake to generate a solution and project files, the CMaNGOS cmake scripts should automatically detect the location of your boost installation, and configure the build accordingly. If it is not detected, please ensure that your BOOST_ROOT environment variable is set properly. For more information, see here.

If you are not using cmake, the built-in project files assume that BOOST_ROOT environment variable is set. Demonstrating how to set an environment variable is beyond the scope of this document, but numerous examples can be found online.

Note: In a typical boost installation environment with Visual Studio, the user will configure their Visual Studio property sheets to point to the boost installation. This will allow boost to be found by all projects on that system. For information on configuring property sheets, look here.

• Go to your C:\Mangos\mangos\win folder

• Open the "sln" file that fits your version of Visual C++

  • mangosdVC120.sln for Visual C++ 2013

  • mangosdVC140.sln for Visual C++ 2015

• Wait for Visual C++ to finish loading.

• Open the menu "Build" → "Configuration Manager"

  • Choose "Release" in the drop down box for "Active Solution Configuration"

  • The drop down box "Active Solution Platform" should already be set to "Win32"

  • Close the window

• Click the menu "Build" → "Build Solution"

  • This will take some time.

  • You might get some warning messages. Don’t worry about it, that’s normal.

  • You must not get any error messages, although if you do so, you could click the menu "Build" → "Clean Solution" to restart the compile. If you cannot solve an error, please use the official forums or IRC channels to ask for help

• Go to your /home/mangos folder

• Enter the build folder: cd build

• Invoke cmake ../mangos, suggested options are:

  • -DCMAKE_INSTALL_PREFIX=\../mangos/run to install into the "run" subfolder of /home/mangos folder, otherwise this will install to /opt/mangos

  • -DPCH=1 to compile with PCH mode (much faster after updates)

  • -DDEBUG=0 to remove debug mode from compiling

  • example: cmake ../mangos -DCMAKE_INSTALL_PREFIX=\../mangos/run -DPCH=1 -DDEBUG=0 (currently DPH doesn’t work, set to 0)

• Invoke make to compile CMaNGOS and ScriptDev2

• Invoke make install to install to your "run" directory

Either use a GUI tool for mysql and open the SQL-files, or do it by command-line as this guide shows.

From the C:\Mangos folder invoke (in Git bash):

• mysql -uroot -p < mangos/sql/create/db_create_mysql.sql

  And enter your password in the following dialogue (similar in all other next steps)

  This will create a user (name mangos, password mangos) with rights to the databases "mangos" (world-db), characters and realmd

From the C:\Mangos folder invoke (in Git bash):

• mysql -uroot -p mangos < mangos/sql/base/mangos.sql

  This will create and fill the Mangos database with some values.

From the C:\Mangos folder invoke (in Git bash):

• mysql -uroot -p characters < mangos/sql/base/characters.sql

  This will create an empty characters database.

From the C:\Mangos folder invoke (in Git bash):

• mysql -uroot -p realmd < mangos/sql/base/realmd.sql

  This will create an empty realmd database.

Support for UDB.

• Unzip the zip file in C:\Mangos\unifieddb\trunk\Full_DB

From the C:\Mangos folder invoke (in Git bash or depending on installation with double-click!)

• cd unifieddb/trunk

• InstallFullUDB.sh

  This will create a config file named "InstallFullUDB.config", looking like:

  ####################################################################################################
  # This is the config file for the './InstallFullDB.sh' script
  #
  # You need to insert
  #   MANGOS_DBHOST:      Your MANGOS database host
  #   MANGOS_DBNAME:      Your MANGOS database schema
  #   MANGOS_DBUSER:      Your MANGOS username
  #   MANGOS_DBPASS:      Your MANGOS password
  #   CORE_PATH:          Your path to core's directory (OPTIONAL: Use if you want to apply remaining core updates automatically)
  #   ACID_PATH:          Your path to a git-clone of ACID (OPTIONAL: Use it if you want to install recent downloaded acid)
  #   MYSQL:              Your mysql command (usually mysql)
  #
  ####################################################################################################
  
  ## Define the host on which the mangos database resides (typically localhost)
  MANGOS_DBHOST="localhost"
  
  ## Define the database in which you want to add clean UDB
  MANGOS_DBNAME="mangos"
  
  ## Define your username
  MANGOS_DBUSER="mangos"
  
  ## Define your password (It is suggested to restrict read access to this file!)
  MANGOS_DBPASS="mangos"
  
  ## Define the path to your core's folder (This is optional)
  ##   If set the core updates located under sql/updates/mangos from this mangos-directory will be added automatically
  CORE_PATH=""
  
  ## Define the path to the folder into which you cloned ACID (This is optional)
  ##   If set the file acid_wotlk.sql will be applied from this folder
  ACID_PATH=""
  
  ## Define your mysql programm if this differs
  MYSQL="mysql"
  
  # Enjoy using the tool

• Change configuration in any text-editor

  With the default configuration, you only need to change CORE_PATH to:

  CORE_PATH="/c/Mangos/mangos"
  (for *nix /home/mangos/mangos)

  * You may actually have to set CORE_PATH="../mangos" (assuming default paths from this guide), if the tilde is not properly resolved into your home folder path, causing InstallFullUDB.sh to complain about not finding "/home/mangos/mangos". Tested on openSUSE 12.3.

• Now the helper tool is configured, and you only need to run the helper script, whenever you want to set your world database to a clear state!

• sh ./InstallFullUDB.sh

  And check the output if the database could be set up correctly. If the helper script complains about not finding the config file, just open InstallFullUDB.sh in a text editor and set

  SCRIPT_FILE="./InstallFullDB.sh"
  CONFIG_FILE="./InstallFullUDB.config"

• You can now run the script again, and it should start filling your world database.

• cd ../..

Support for PSDB.

• Execute PSDB_Installer in psmdb_wotlk svn folder.

• Type your info when prompted.

• You can also edit PSDB_Installer.bat for quick re-install of PSDB & Scriptdev2 DB by changing "set quick=on" & "set pass=".

  Example of PSDB_Installer.bat:

  ####################################################################################################
  8888888b.   .d8888b.  8888888b.  888888b.  (LK)
  888   Y88b d88P  Y88b 888  "Y88b 888  "88b
  888    888 Y88b.      888    888 888  .88P
  888   d88P  "Y888b.   888    888 8888888K.
  8888888P"      "Y88b. 888    888 888  "Y88b
  888              "888 888    888 888    888
  888        Y88b  d88P 888  .d88P 888   d88P
  888         "Y8888P"  8888888P"  8888888P"
  
  Credits to: Factionwars, Nemok and BrainDedd
  
  What is your MySQL host name?           [localhost]   :
  What is your MySQL user name?           [root]        :
  What is your MySQL password?            [ ]           :
  What is your MySQL port?                [3306]        :
  What is your World database name?       [mangos]      :
  What is your ScriptDev2 database name?  [scriptdev2]  :
  What is your Characters database name?  [characters]  :
  What is your Realmd database name?      [realmd]      :
  
  This will wipe out your current World database and replace it.
  Do you wish to continue? (y/n)
  
  This will wipe out your current ScriptDev2 database and replace it.
  Do you wish to continue? (y/n)
  
  This will wipe out your current Characters database and replace it.
  Do you wish to continue? (y/n)
  
  This will wipe out your current Realm database and replace it.
  Do you wish to continue? (y/n)
  
  This will optimize your current database.
  Do you wish to continue? (y/n)
  ####################################################################################################

  Support for YTDB Needed. Support for TBCDB.

• Support is for Linux (Debian)

• Go to root

  cd tbc-db

  cd Current_Release

  cd Full_DB

  mysql -uroot -p mangos < ~/tbc-db/Current_Release/Full_DB/TBCDB_1.4.0_cmangos-tbc_s1982_SD2-TBC_s2720.sql

• Enter Password

Support for ClassicDB.

• Enter your classicDB directory (by default C:\Mangos)

• Invoke

  cd classicdb

  ./InstallFullDB.sh

• Edit the created conf file InstallFullDB.config. See above on Installing UDB for explanation of the options.

• Rerun the installer script, invoke

  ./InstallFullDB.sh

• Exit the classicDB directory with

  cd ..

Also consider https://github.com/classicdb/database/blob/classic/README.mdown for further information.

• Invoke mysql -uroot -p mangos < mangos/sql/scriptdev2/scriptdev2.sql

This is considered optional, as ACID is usually included by the database providers.

But if you prefer bleeding edge, invoke (from C:\Mangos)

• mysql -uroot -p mangos < acid/acid_wotlk.sql

You will need to manually update the configuration files within your "run" directory (ie C:\Mangos\run ).

The files are: * mangosd.conf: Holds configuration for the mangosd executable * realmd.conf: Holds configuration for the realmd executable * scriptdev2.conf: Holds configuration for ScriptDev2’s settings(no longer used and may not exist) * (Very optional) ahbot.conf: Holds configuration for AHBot (by default disabled)

Most important to configure are the database settings. You will need this if you decided to use a different password/user then the "default" combination of mangos/mangos.

These settings are relatively self-explaining, you should look for the settings of "LoginDatabaseInfo", "WorldDatabaseInfo", "CharacterDatabaseInfo" and "ScriptDev2DatabaseInfo" (no file contains all of these options)

You need to change this only if you changed the mangosd.conf settings "WorldServerPort" or "RealmID"

This information is required so that the realmd "knows" to which mangosd he should forward a player after authentication

Apply code to realmd database, adapt to your wishes

Where of course the data must match the configs:

• port (above 8085) must match the value in the mangosd.conf (Config option: "WorldServerPort")

• id (above 1) must match the value in the mangosd.conf (Config option: "RealmID")

You should:

1. Use a patched wow.exe

2. Add set patchlist localhost line in addition to realmlist line in realmlist.wtf

3. Delete or rename wow.mfil and wow.tfil files