TrinityCore README

The project's README from github.com/TrinityCore/TrinityCore. As one markdown file: README.md.

logo TrinityCore (master)

Average time to resolve an issue Percentage of issues still open


Build Status

master 3.3.5 cata_classic
master Build Status 3.3.5 Build Status cata_classic Build Status
master Build status Build status Build status
master Windows Build status 3.3.5 Windows Build status cata_classic GCC Build status
master Ubuntu Build status 3.3.5 Ubuntu Build status cata_classic GCC Build status
master macOS arm64 Build status 3.3.5 macOS arm64 Build status cata_classic macOS arm64 Build status
Coverity Scan Build Status Coverity Scan Build Status

Introduction

TrinityCore is a MMORPG Framework based mostly in C++.

It is derived from MaNGOS, the Massive Network Game Object Server, and is based on the code of that project with extensive changes over time to optimize, improve and cleanup the codebase at the same time as improving the in-game mechanics and functionality.

It is completely open source; community involvement is highly encouraged.

If you wish to contribute ideas or code, please visit our site linked below or make pull requests to our Github repository.

For further information on the TrinityCore project, please visit our project website at TrinityCore.org.

Requirements

Software requirements are available in the wiki for Windows, Linux and macOS.

Install

Detailed installation guides are available in the wiki for Windows, Linux and macOS.

Reporting issues

Issues can be reported via the Github issue tracker.

Please take the time to review existing issues before submitting your own to prevent duplicates.

In addition, thoroughly read through the issue tracker guide to ensure your report contains the required information. Incorrect or poorly formed reports are wasteful and are subject to deletion.

Submitting fixes

C++ fixes are submitted as pull requests via Github. For more information on how to properly submit a pull request, read the how-to: maintain a remote fork. For SQL only fixes, open a ticket; if a bug report exists for the bug, post on an existing ticket.

License: GPL 2.0

Read file COPYING.

Authors & Contributors

Read file AUTHORS.

TrinityCore (TrinityCore/TrinityCore)

Searching Database…

What is this?TrinityCore is an open-source MMORPG server framework written in C++ that lets you run your own World of Warcraft game server. It began as a fork of the MaNGOS project and has been heavily rewritten and optimized since.
How do I get it running?There's no single command in the README; you follow the OS-specific install guide in the TrinityCore wiki, which covers compiling, configuring, and importing game data for Windows, Linux, or macOS.
What do I need before I start, besides a C++ compiler?The README doesn't list requirements directly — compiler, CMake, database tools, etc. are documented per operating system in the project wiki.
Does one build work for every version of World of Warcraft?No — TrinityCore maintains separate branches tied to exact client builds: master targets build 12.1.0.69933, the 3.3.5 branch targets 3.3.5a.12340, and the Cataclysm Classic branch targets 4.4.2.60895, so your client and server branch must match.
Does it only run on Linux, or also Windows and macOS?All three — the repo's CI pipelines build for Linux, macOS (ARM), and Windows x64, and the wiki has a dedicated install guide for each.
How does TrinityCore relate to MaNGOS?TrinityCore started as a fork of MaNGOS (Massive Network Game Object Server) and has since been extensively rewritten for better performance, cleaner code, and more accurate in-game mechanics.
Does running a server require a SQL database?Yes — the project explicitly separates C++ fixes from SQL-only fixes, meaning core game data and configuration live in SQL databases you need to set up and import.
What are similar projects?luanti, OpenRCT2, openage, ReSkate, WoWee, AnyPS5, rpcs3, godot
Size
1.4 GB
Stars
10.8K
Age
15y
Commits · 90 Days