-
-
-
-Build Status:
Linux -
- Windows
- |
-
-
-
-
-
- Build Status: Linux -
- Windows
- |
](https://www.getmangos.eu)
+[](https://www.getmangos.eu)
-Mists of Pandaria WOW BRANCH
+ Build Status:
+ Linux/MAC: [](https://travis-ci.org/mangosfour/server/builds)
+ Windows: [
](http://makeapullrequest.com)
+[
](https://discord.gg/fPxMjHS8xs "Our community hub on Discord")
+
+---
+
+[
](http://getmangos.eu)
+ **MangosFour - The Mists of Pandaria WoW server**
===
-### A World of Warcraft server for the Mists of Pandaria Expansion of WoW
-----
-*Mangos* is open source project, built in [C++][7], it's fast, runs on multiple
-platforms, can store game data in [MySQL][40] and [MariaDB][41]. It also has
-optional support for SOAP, and aims to be 100% compatible with [World of Warcraft][2]
-in its Cataclysm version supporting clients from the [patch 4.3.4][5] branch,
-specifically patch 4.3.4.
-If you liked the fourth incarnation of [World of Warcraft][2] and still want to play
-[cata WoW][5], this is the branch for you. We provide an authentication
-server where you can manage your users, and a world server which serves game
-content just like the original did back then.
+**Mangos** is an open source project written in [C++][7]. It's fast, runs on multiple
+platforms and stores game data in [MySQL][40] or [MariaDB][41]. It also has
+optional support for SOAP.
-On top of that each update is built by [Travis CI][16] as you can see by the
-image next to the chapter's heading! We do love green builds, and working things.
-To complement this, we push builds through [Coverity][17] to find and fix any
-possible security issues.
+If you liked the fifth incarnation of [World of Warcraft][2] and still want to play it,
+this is the branch for you. We provide an authentication server where you can manage your users,
+and a world server which serves game content just like the original did back then.
-World of Warcraft, and all World of Warcraft or Warcraft art, images, and lore are
-copyrighted by [Blizzard Entertainment, Inc.][1]
+It aims to be 100% compatible with the final version of MOP [World of Warcraft][2]
+namely [patch 5.4.8][4].
+
+On top of that each update is automatically built by [Travis CI][16] (Linux/MAC) and [AppVeyor][17] (Windows)
+as you can see by the images in the heading above! We do love green builds, and working things.
Requirements
------------
-The *Mangos* server supports a wide range of operating systems, and various
-compiler platforms. In order to do that, we use various free cross-platform
-libraries and use [CMake][19] to provide a cross-platform build system which
-adapts to your chosen operating system and compiler.
+The server supports a wide range of operating systems, and various compiler platforms.
+In order to do that, we use various free cross-platform libraries and use [CMake][19] to provide
+a cross-platform build system which adapts to your chosen operating system and compiler.
Operating systems
-----------------
-Currently we support running *Mangos* on these operating systems:
+Currently we support running the server on the following operating systems:
* **Windows**, 32 bit and 64 bit. [Windows][20] Server 2008 (or newer) or Windows 7 (or newer) is recommended.
* **Linux**, 32 bit and 64 bit. [Debian 7][21] and [Ubuntu 12.04 LTS][22] are
@@ -56,66 +50,81 @@ server versions will work, too.
Compilers
---------
-Building *Mangos* is currently possible with these compilers:
+Building the server is currently possible with these compilers:
-* **Microsoft Visual Studio (Express[^1])**, 32 bit and 64 bit. Both
- [Visual Studio][30] and the Express editions of [Visual Studio][31] are
- supported. Only Visual Studio 2012 and above are now officially supported.
* **Microsoft Visual Studio 32 bit and 64 bit.** All editions of [Visual Studio][31]
- are supported. Only Visual Studio 2015 and above are now officially supported.
+from 2015 upwards are officially supported.
+
* **Clang**, 32 bit and 64 bit. The [Clang compiler][33] can be used on any
- supported operating system.[^2]
+ supported operating system.
Dependencies
------------
-The *Mangos* server stands on the shoulders of well-known Open Source
-libraries, and a few awesome, but less known libraries to prevent us from
-inventing the wheel again.
+The server stands on the shoulders of several well-known Open Source libraries plus
+a few awesome, but less known libraries to prevent us from inventing the wheel again.
-*Please note that Linux and Mac OS X users should install packages using
-their systems package management instead of source packages.*
+**Please note that Linux and Mac OS X users should install packages using
+their systems package management instead of source packages.**
-* **MySQL** / **MariaDB**: to store content, and user data, we rely on
- [MySQL][40]/[MariaDB][41] to handle data.
-* **ACE**: the [ADAPTIVE Communication Environment][43] aka. *ACE* provides us
- with a solid cross-platform framework for abstracting operating system
- specific details.
-* **Recast**: in order to create navigation data from the client's map files,
- we use [Recast][44] to do the dirty work. It provides functions for
- rendering, pathing, etc.
-* **G3D**: the [G3D][45] engine provides the basic framework for handling 3D
- data, and is used to handle basic map data.
-* **libmpq**: [libmpq][46] provides an abstraction layer for reading from the
- client's data files.
-* **Zlib**: [Zlib][53] ([Zlib for Windows][51]) provides compression algorithms
- used in both MPQ archive handling and the client/server protocol.
-* **Bzip2**: [Bzip2][54] ([Bzip2 for Windows][52]) provides compression
- algorithms used in MPQ archives.
-* **OpenSSL**: [OpenSSL][48] ([OpenSSL for Windows][55]) provides encryption
- algorithms used when authenticating clients.
-* **Lua**: [Lua 5.2][56] ([Lua 5.2 for Windows][57]) provides a convenient, fast
- scripting environment, which allows us to make live changes to scripted
- content.
+* **[MySQL][40]** / **[MariaDB][41]**: These databases are used to store content and user data.
+* **[ACE][43]**: aka Adaptive Communication Environment, provides us with a solid cross-platform framework for abstracting operating system specific details.
+* **[Recast][44]**: In order to create navigation data from the client's map files Recast is userd to do the dirty work. It provides functions for rendering, pathing, etc.
+* **[G3D][45]**: This engine provides the basic framework for handling 3D data and is used to handle basic map data.
+* **[Stormlib][46]**: Provides an abstraction layer for reading from the client's data files.
+* **[Zlib][53]/[Zlib for Windows][51]** provides compression algorithms used in both MPQ archive handling and the client/server protocol.
+* **[Bzip2][54]/[Bzip2 for Windows][52]** provides compression algorithms used in MPQ archives.
+* **[OpenSSL][48]/[OpenSSL for Windows][55]** provides encryption algorithms used when authenticating clients.
-*ACE*, *Recast*, *G3D* and *libmpq* are included in the *Mangos* distribution as
+**ACE**, **Recast**, **G3D**, **Stormlib**, **Zlib** and **Bzip2** are included in the standard distribution as
we rely on specific versions.
Optional dependencies
---------------------
* **Doxygen**: if you want to export HTML or PDF formatted documentation for the
- *Mangos* API, you should install [Doxygen][49].
-* **Lua**: if you want to test drive how *Mangos* feels with [Lua][50] as
- scripting language instead of the scripting library, you will need Lua **5.2.3**
- installed. Although an internal version is included.
+ Mangos API, you should install [Doxygen][49].
-Discuss
--------
-If you need help with building and installing *Mangos* there are thousands of
-users out there already running *Mangos* and many more you can find on our
-project website and discussion forum to assist with any issues you may have.
-* [getmangos.eu][10]
+