Documentation
Everything you need to get your CypherCore server up and running
Prerequisites
Installation Guide
Clone the Repository
Download the CypherCore source code from GitHub
git clone https://github.com/CypherCore/CypherCore.git
cd CypherCoreBuild the Project
Compile CypherCore using the .NET CLI or your preferred IDE
dotnet build CypherCore.sln --configuration ReleaseExtract Game Data
Use TrinityCore extractors to extract game data from your WoW client. Download the extractors ([here](https://ci.appveyor.com/project/DDuarte/trinitycore/branch/master/artifacts) / [tools](https://github.com/CypherCore/Tools)) and run all extractors in the wow directory.
Copy Extracted Data
Copy all created folders (dbc, maps, mmaps, vmaps) to your server directory data folder.
# Example paths:
# From: C:\Program Files\World of Warcraft\
# To: C:\CypherCore\Data\Install the Database
Download the full Trinity Core database (TDB 1120.25081) and import it into MariaDB.
# Download TDB from https://github.com/TrinityCore/TrinityCore/releases
# Extract SQL files to sql/ folder (ex: C:\CypherCore\sql)
# Import using your preferred MariaDB clientConfigure the Server
Update configuration files with your database credentials and paths
# Edit worldserver.conf
LoginDatabaseInfo = "127.0.0.1;3306;root;password;auth"
WorldDatabaseInfo = "127.0.0.1;3306;root;password;world"
CharacterDatabaseInfo = "127.0.0.1;3306;root;password;characters"
# Update DataDir path
DataDir = "C:/CypherCore/Data"Run the Server
Start the world server and auth server
# Run worldserver
dotnet run --project Source/Game/Server
# Run authserver (in a separate terminal)
dotnet run --project Source/Server/AuthServerConnect with Client
You must use the Arctium WoW Client Launcher to connect to your server. Download it from arctium.io.
# arctium.io/wowConfiguration
Important Configuration Files
worldserver.conf
Main configuration file for the world server, including database connections, network settings, and gameplay options.
authserver.conf
Configuration for the authentication server that handles login and realm list.
Database Settings
Make sure your database credentials match your MariaDB installation and that all three databases (auth, characters, world) are properly created.
Common Issues & Solutions
Server won't start or crashes immediately
• Check that all prerequisites are installed (.NET 8.0, MariaDB)
• Verify database connection strings in configuration files
• Ensure game data files are extracted and in the correct directory
• Check server logs for specific error messages
Can't connect to the server
• Make sure both authserver and worldserver are running
• Verify your realmlist is set correctly in the client
• Check firewall settings allow connections on required ports
• Use Arctium WoW Client Launcher for proper client connection
Database import errors
• Ensure you're using MariaDB 10.6 or higher
• Download the correct TDB version (TDB 1120.25081)
• Import base database structure before updates
• Check MariaDB error logs for specific issues
Maps or data files missing
• Run all extractors in your WoW client directory
• Copy ALL generated folders (dbc, maps, mmaps, vmaps) to Data directory
• Verify DataDir path in worldserver.conf is correct
• Ensure you're using extractors compatible with your game version
Additional Resources
Legal
Blizzard, Battle.net, World of Warcraft, and all associated logos and designs are trademarks or registered trademarks of Blizzard Entertainment.
All other trademarks are the property of their respective owners. This project is not affiliated with Blizzard Entertainment or any of their family of sites.