At AzerothCore we care about game quality and stability. Because of this, we do not push changes directly to the master branch. Instead, whenever introducing a new change, we create a new Pull Request (often shortened in PR).
This allow us to properly review and test any change before it gets into production environments. Everyone who is able to install AzerothCore is also able to contribute by testing PRs. This guide will explain how to do it.
The more users help us with testing the PRs, the better will be our development activity in terms of speed and quality.
We label as Waiting to be tested all PRs that have already been completed by the author and had their code reviewed.
Clicking on the label above will show you the list of all PRs that need to be tested in order to get to the
You need to:
Some PRs have only database changes (no C++ changes). If that's the case, there is a simplified procedure to test such changes.
If you're not sure, just keep reading here and do the traditional PR test which will work for all kind of PRs.
It is typical to create and clone your own fork of AzerothCore if you are also a developer. If that is your case, then you have to
git remote add upstream https://github.com/azerothcore/azerothcore-wotlk.git
upstreamin all commands listed below
Here we assume that you are starting from a clean, updated
master branch. You can verify which branch you are in by typing
git checkout. If you are not in master already, go back to master using
git checkout master. While you're here, you can also
git pull to make sure you have the latest master. And remember, never add custom changes to the master branch (always create a new, separate branch if you have to).
Check the ID of the PR that you want to test, it will appear in the URL and title of the PR. For example the ID of this PR is 1383: https://github.com/azerothcore/azerothcore-wotlk/pull/1383
git checkout -b pr-XXXX
git pull origin pull/XXXX/head
The commands above will create a new local branch called
pr-XXXX which will contain all the changes that need to be tested.
The terminal will prompt an editor (usually
vim) that asks to save the merge commit message. Just save the changes and exit the editor.
nano, you can do it by simply using
ENTERto save then
vimyou can hold the
SHIFTkey and press two times
Zto save and exist.
You can read more about the
git configuration and its default editor here.
Now you simply need to update your local server with the new changes. The procedure is analogue to a normal server update.
Basically you need to recompile your sources and update the DB.
If you are using the traditional setup, you have to recompile following the steps of the 3) Compiling from the main setup guide.
You also need to update your DB. You can use the DB assembler to do that, but usually it's quicker to just manually importing the pending sql file(s) that the PR includes. Such file(s) are located under
Tip: typically a PR consists of one new world update file located under
data/sql/updates/pending_db_world. You can check which files have been added to spot any added sql files going to the "Files changed" tab of the PR page:
Then start the server just the way you always do.
If you are using the Docker setup, you can simply trigger the recompilation by running:
./acore.sh docker build
then to launch the server you have to destroy and recreate the containers using
docker-compose down and
Note: this will also automatically update your DB.
To make sure you are correctly running your server with the PR, check the date and branch name in the output of the
server info command. They should match with the PR.
Now log in game and do your tests!
Instructions about what needs to be tested in the scope of a PR should be provided by the PR's author in the PR description. If that is not the case, feel free to leave a comment in the PR description asking for testing istructions.
For advanced users: you can also have a look at what has actually been changed in the PR and decide yourself what to test. Sometimes it's good to have a different point of view! Just make sure you describe what you have tested in your report.
It is important to report your test results by leaving a comment in the PR page.
You should write:
Once you have left a test report, you will want to revert your AC installation back to the base state for further testing. To do this, use
git reset --hard to remove all unstaged changes, followed by
git checkout master to go back to the master branch. To tidy up, you can also use
git clean -fd to get rid of any untracked files. Finally, you can then type
git status to make sure everything is back to normal.