Installing MangosSharp

Disclaimer

The original instructions are from Krill, mentioned in the MaNGOS Discord server, on 2021-02-21.  I will try to improve them.

Overview

This guide will demonstrate how to setup the project for a sample modern Windows system.

Warning

This project may not be functional, for the following reasons:

• The second Wow Exe Extractor has 4 buttons, but only seems to create an empty maps folder, as that code seems to be commented out, regardless of the output in the dialog boxes,
• The GameServer will not execute due to compilation problems currently.
• Clustering has been disabled.  This is a unique feature and goal for the project, but code updates have caused a divergence from it.  Because of this, any mention can be ignored until this feature is also updated.

Step 1 - Download the source code

Clone the following projects locally:
https://github.com/MangosServer/MangosSharp
https://github.com/mangosvb/DatabaseZero

Similar Instructions:

https://www.getmangos.eu/wiki/documentation/installation-guides/guidesgeneral/downloading-the-mangos-sourcecode-r20023/

Step 2 - Populate a database server

Quote

Run install batch files and setup DB, setup realmserver in auth db like normal

Perform any needed updates found here: https://github.com/MangosServer/MangosSharp/tree/main/SQL

DB is not the same (2014, very outdated).  The source itself needs updating to use DB updates, but the plan is for it to use latest.

Locally in the `sql` folder.

Note that MangosSharp in its README under 'Requirements' claims to better support MySQL 8 more than the main C++ cores.

These actions can be similar to, or also even require, others from the following guides:
https://www.getmangos.eu/wiki/documentation/installation-guides/guideswindows/installing-mysql-57-r20057/
https://www.getmangos.eu/wiki/documentation/installation-guides/guideswindows/installing-mariadb-r40012/
https://www.getmangos.eu/wiki/documentation/installation-guides/guideswindows/configuring-the-realm-database-r20069/
https://www.getmangos.eu/wiki/documentation/installation-guides/guideswindows/updating-existing-database-with-latest-updates-r20051/

Step 3 - Compile the servers and tools

Quote

Open M# .sln here: https://github.com/MangosServer/MangosSharp/tree/main/Source

But in your locally-downloaded project, and is now at: src\server\Mangos.sln

I just used MSVS 2022 CE.

Quote

And build all projects (around 30).

Now 14.

Step 4 - Extract Game data (WIP?)

The resulting executables will then be located at src\server\GameServer\bin\Debug\net7.0\GameServer.exe and src\server\RealmServer\bin\Debug\net7.0\RealmServer.exe to run.
I'm not sure if a cluster project needs to be run, or is included as a dll when other executables are.  If it is important, then you should probably configure it using this file: src\server\Mangos.Cluster\bin\Debug\net7.0\configuration.json.

Extract data using Mangos.Extractor & Mangos.DBCExtractor tools here: https://github.com/MangosServer/MangosSharp/tree/main/Source/Tools
Build the project using the file src\tools\Mangos.Tools.sln.

Run src\tools\Mangos.DBCExtractor\bin\Debug\net7.0\DBCExtractor.exe and src\tools\Mangos.Extractor\bin\Debug\net7.0-windows\WowExeExtractor.exe by copying the files to your vanilla WoW game client directory, like in this guide:

Step 5 - Configure the servers

Quote

Setup RealmServer, WorldCluster, WorldServer configs and start servers via the RunServers batch file.

Like in this guide:

Step 6 - Install dependencies

Quote

Another thing, you will need https://dotnet.microsoft.com/download/dotnet/5.0 for it to run and compile.

Now 7.0, also as mentioned in the README under 'Requirements': https://dotnet.microsoft.com/download/dotnet/7.0

Not sure if it needs OpenSSL or not.  If it does, a useful guide can be found here: