mangos > the free, open source World of Warcraft server

Our community forums are the place where we discuss all things mangos, scripting mangos is discussed at scriptdev2, and content / database development is discussed at UDB/YTDB.

If you just want to see what is going on, follow us on Twitter. We frequently submit new developments and code changes via tweets.

What is MaNGOS?

The mangos project is a full featured World of Warcraft server suite, including servers for authentication, client updates, world content serving, and battlegrounds. Additional features include tools to build and develop game content. It is compatible with client version 3.3.5a.

mangos is an educational project. This means, our primary interest is to learn and teach us and our users more about C++ project development in a large scale. Our software is not intended for running public servers, and we do not support that.

Acknowledgement: this project would not be possible without bzip2, zlib, g3dlite, libmpq, and recastnavigation.

And what about older clients?

Some users prefer different game versions, and thus there are different branches of mangos available for.

Looking for client 2.4.3 support? The official mangos one repository contains code compatible with client 2.4.3. A matching database is provided by the TBC-DB project, and scriptdev2 includes a custom patch for compatibility with mangos one.
Looking for client 1.12.1 support? No need to hold your breath, there is a solution for you. mangos zero, an offspring project of mangos has your back covered. The server, the scripts, and the database are available. mangos zero has its' own forums, too

Supported platforms

mangos is available for Windows, and most — if not all — platforms where GCC is available. Both 32-bit / 64-bit builds are supported, and tested during development. We support builds using Visual Studio and the GNU build system.

Pitch in to help the project

Like any community-run project, everything that happens happens because we — the mangos community — make it happen. And there is so much more to a successful open source project than a bunch of people writing code—oh SO much more.

If you do not feel like you have the chops to contribute on the development side or would just help in additional ways to build this project and community into something special, we've got plenty of things you can do:

Help us feed the hamsters powering the website.
Help us write documentation for the project or the software.
Design a badge for people to display on their sites.
Be a wiki gnome and help us keep our wiki garden well tended.

It doesn't stop there. If you don't see something you want to do, let us know what you do want to do and we'll make you the mangos chieftain of That Thing!

Improve the software

The mangos project is powered by a powerful cast of characters comprised of several languages and technologies. These include:

a core written in C/C++,
a database backend either based on MySQL or PostgreSQL,
command line utilities to create and maintain game content,
Bash, Python, and Ruby scripts to spice up development,
and code documentation compatible with Doxygen.

If you are familiar with any one of these, you can (and, dare we say, should!) contribute to the mangos project. Here's how...

We use github for source code repositories because it's the best solution we've found to not only track projects but to make collaboration between project teams easy.

If this is your first exposure to github, just imagine a centralized home for holistic product management crossed with a bustling Turkish bazaar overlayed by Facebook. Minus the updates about what people had for lunch. We like github.

Download the code

In order to contribute, the first thing you should do is download the code. Although we strongly suggest that code contributors (especially frequent contributors) learn the basics of Git (the version control software we use), it's really important to us that anyone who has something to contribute be able to do so without barriers that might otherwise keep them on the sidelines.

So, if you're not up for Git, you can actually find tar/gz compressed downloads on the GitHub page for the MaNGOS project. Using that code, you can make your changes and then get them to us using pull requests or by posting git patches on our community forums.

And that's it! You've contributed. Congratulations and make sure to pick up your Awesome Merit Badge on the way out!

Regardless of whether your new to all of this or an old hand, we sincerely welcome and appreciate all of your contributions and the fact that you're a part of our community.