Skip to content

Latest commit

 

History

History
171 lines (99 loc) · 8.58 KB

README.md

File metadata and controls

171 lines (99 loc) · 8.58 KB
Raw

logo AzerothCore

Codacy Badge core-build Coverity Scan Build Status Bountysource StackOverflow Discord

INTRODUCTION

AzerothCore (AC) is an open source game-server application for World of Warcraft, currently supporting the 3.3.5a game version.

It is written in C++ and is based on MaNGOS, TrinityCore and SunwellCore.

WHY AZEROTHCORE?

  1. Stability
  2. Authenticity of the content
  3. Modularity
  4. A lot of modules to choose from
  5. Better configuration files system
  6. Compatibility with other emulators
  7. Friendly and helpful community

Stability

As players and administrators ourselves, we take great care into the stability of our core. Other projects focus on the development side of things and tend to forget that users want stability above everything else.

Hence why nobody is allowed to push commits directly to the core. All changes are reviewed and tested before they get to the master branch which means we need as many testers as possible to avoid stalling issues.

Authenticity

Fixing and implementing missing blizzlike content is one of our priorities, and we can boast to offer the most content-complete open source emulator.

Modules

Modules are essential to AzerothCore's success. Modules allows users to plug them in and out easily, and do not require to modify the core files. It also means users can keep pulling the git changes from the main repository and only develop their own modules.

We have a lot of modules already made, some of them are very important and will ease your work:

Configuration files

Our configuration file system allows the user to use a tiny configuration file for better readability and maintenance.

Compatibility with other emulators

Not very far from its ancestor TrinityCore, most scripts can be adapted quite easily. For MaNGOS compatibility, it might require more knowledge but it shares a common base.

PHILOSOPHY

Our main goal is to create a playable game server, offering a fully working game experience.

Here are the main points we focus on:

  • Stability
  • Ease of use / Practicability
  • Playability (ingame content)
  • Customization
  • Community driven software (check our discord)

We also welcome new users (even non-english speaking users!) and help them learn / improve their skills (C++, SQL, Git, software collaboration, tutoring / wiki etc...).

Unlike other projects which focus more on the developer's side of things, we want users to be able to run their own server with as few troubles as possible. All of our contributors run their own private server (in local or not).

That's why AzerothCore is easier to use, to maintain, to understand, to develop on and to customize to suit your needs, than other emulators.

In short, we focus on the user experience (UX), whether it be the player's experience, the developer's experience or the administrator's experience.

HOW TO THANK US

Being an open source project, we rely on volunteers to pursue development. Here are ways to help us if you use AzerothCore:

Github star

Click on the "star this repository" button to help us gain more visibility on Github!

By contributing

Check the CONTRIBUTING section below.

Financially 💰

You can support the project by financing the resolution of issues using Bountysource.

Advertising

By talking about us on different platforms or to people who would like to get involved.

CONTRIBUTING

AzerothCore is a learning project, and there are lots of different ways to contribute to the project:

  • By testing our fixes (we can teach you how to correctly use Git to help us but that will also help you out tremendously)
  • By developing directly to the core or to the modules
  • By creating new modules
  • By improving our wiki
  • By providing direct support to our community (on discord, stackoverflow or specialized forums)
  • By making extra content (video tutorial for example)
  • By putting bounties on issues

If you want to contribute to the project, you will find a lot of resources that will guide you in our wiki.

Feel free to join us on [our discord chat server][discord] where we taught a lot of new people how to get started and who are now important contributors!

INSTALLATION

Installation instructions are available here.

We also have an auto-installation bash script here (Warning: try it/analyze it before running it).

Dockerization of AzerothCore is fully supported, and we have various community made tutorials (eg: AWS / Digital Ocean installation).

SUPPORT

Our self-made wiki probably has a lot of answers for you.

For help requests, it is recommended to ask your question on StackOverflow and link it in our chat.

AUTHORS & CONTRIBUTORS

This project exists thanks to:

IMPORTANT LINKS

SPONSORS

List of organizations that help AzerothCore:

JetBrains

LICENSE

  • The new AzerothCore source components are released under the GNU AGPL v3
  • The old sources based on MaNGOS/TrinityCore are released under the GNU GPL v2