Project Skyfire - User contributions [en]

Installation Windows

2025-09-03T00:29:42Z

Digid702: /* PULLING AND COMPILING THE SOURCE */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL] [https://slproweb.com/download/Win64OpenSSL-3_5_2.exe X64]
* '''DO NOT USE LIGHT VERSION'''
*OpenSSL 3.5.x or higher is needed, Place in "C:\Program Files\OpenSSL-Win64" folder
 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2022 ===

Microsoft Visual Studio 2022 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].


== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFire_548\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548\Core</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*Select Visual Studios 17 2022</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>https://codeberg.org/ProjectSkyfire/database.git</pre>

This will create a directory called Database that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''Database'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation Windows

2025-09-03T00:26:57Z

Digid702: /* Microsoft Visual Studio 2019 */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL] [https://slproweb.com/download/Win64OpenSSL-3_5_2.exe X64]
* '''DO NOT USE LIGHT VERSION'''
*OpenSSL 3.5.x or higher is needed, Place in "C:\Program Files\OpenSSL-Win64" folder
 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2022 ===

Microsoft Visual Studio 2022 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].


== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFire_548\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548\Core</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2008, your compiler would be "Visual Studio 9"
**If you are using Visual Studio 2010, your compiler would be "Visual Studio 10"
**If you are using Visual Studio 2012, your compiler would be "Visual Studio 11"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>https://codeberg.org/ProjectSkyfire/database.git</pre>

This will create a directory called Database that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''Database'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation Windows

2025-09-03T00:26:47Z

Digid702: /* Microsoft Visual C++ Redistributable Packages */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL] [https://slproweb.com/download/Win64OpenSSL-3_5_2.exe X64]
* '''DO NOT USE LIGHT VERSION'''
*OpenSSL 3.5.x or higher is needed, Place in "C:\Program Files\OpenSSL-Win64" folder
 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2022 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].


== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFire_548\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548\Core</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2008, your compiler would be "Visual Studio 9"
**If you are using Visual Studio 2010, your compiler would be "Visual Studio 10"
**If you are using Visual Studio 2012, your compiler would be "Visual Studio 11"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>https://codeberg.org/ProjectSkyfire/database.git</pre>

This will create a directory called Database that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''Database'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation Windows

2025-09-03T00:25:29Z

Digid702: /* Software Required */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL] [https://slproweb.com/download/Win64OpenSSL-3_5_2.exe X64]
* '''DO NOT USE LIGHT VERSION'''
*OpenSSL 3.5.x or higher is needed, Place in "C:\Program Files\OpenSSL-Win64" folder
 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual C++ Redistributable Packages ===

*If you use different PCs for compile/run SkyFireEMU, install one of the following packages on your Server-PC to avoid missing dependencies (dependig on your Visual Studio Version and your Server-PC Operating System) Microsoft Visual C++ 2008 Redistributable Package SP1 MFC Security Update [[http://www.microsoft.com/downloads/en/details.aspx?familyid=05ce856d-8128-408b-96fa-5e1f57b097d8&displaylang=en x86 / x64 / ia64]] Microsoft Visual C++ 2010 Redistributable Package SP1 [[http://www.microsoft.com/downloads/details.aspx?familyid=C32F406A-F8FC-4164-B6EB-5328B8578F03&displaylang=en x86]] / [[http://www.microsoft.com/downloads/details.aspx?familyid=C68CCBB6-75EF-4C9D-A326-879EAB4FCDF8&displaylang=en x64]] / [[http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=647A8A36-A058-41A4-88B2-D4A05CC0B6B3 ia64]]
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFire_548\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548\Core</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2008, your compiler would be "Visual Studio 9"
**If you are using Visual Studio 2010, your compiler would be "Visual Studio 10"
**If you are using Visual Studio 2012, your compiler would be "Visual Studio 11"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>https://codeberg.org/ProjectSkyfire/database.git</pre>

This will create a directory called Database that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''Database'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows 5xx)

2025-09-03T00:23:34Z

Digid702: /* Software Required */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL] [https://slproweb.com/download/Win64OpenSSL-3_5_2.exe X64]
* '''DO NOT USE LIGHT VERSION'''
*OpenSSL 3.5.x or higher is needed, Place in "C:\Program Files\OpenSSL-Win64" folder
 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows 5xx)

2025-09-03T00:22:45Z

Digid702: /* INTRODUCTION */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL] [https://slproweb.com/download/Win64OpenSSL-3_5_2.exe X64]
* DO NOT USE LIGHT VERSION
*OpenSSL 3.5.x or higher is needed, Place in "C:\Program Files\OpenSSL-Win64" folder
 
'''-- OLD CONTENT BELOW NOT NEEDED --'''
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows 5xx)

2025-09-03T00:21:40Z

Digid702: /* Software Required */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL] [https://slproweb.com/download/Win64OpenSSL-3_5_2.exe X64]
*OpenSSL 3.5.x or higher is needed, Place in "C:\Program Files\OpenSSL-Win64" folder
 
'''-- OLD CONTENT BELOW NOT NEEDED --'''
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows Clang)

2025-08-07T02:07:45Z

Digid702: /* PULLING AND COMPILING THE SOURCE */

Installation (Windows Clang)

2025-08-07T02:07:28Z

Digid702: /* SKYFIRE WOW.EXE PATCHER */

Installation (Windows 5xx)

2025-08-07T02:06:47Z

Digid702: /* Patching */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*We supply OpenSSL 3.3.0 which is needed to build the core, it is within SkyFire_548\contrib\openssl folder. Extract and place the OpenSSL-Win64 in C:\OpenSSL-Win64
 
'''-- OLD CONTENT BELOW NOT NEEDED --'''
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows 5xx)

2025-08-07T02:06:27Z

Digid702: /* PULLING AND COMPILING THE SOURCE */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*We supply OpenSSL 3.3.0 which is needed to build the core, it is within SkyFire_548\contrib\openssl folder. Extract and place the OpenSSL-Win64 in C:\OpenSSL-Win64
 
'''-- OLD CONTENT BELOW NOT NEEDED --'''
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Debian 10)

2025-08-07T02:05:51Z

Digid702: /* Extractor and VMAPs */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-gplv2-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz
tar -xvf openssl-1.1.1j.tar.gz
cd openssl-1.1.1j
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb
dpkg -i mysql-apt-config_0.8.14-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 10)

2025-08-07T02:05:33Z

Digid702: /* SkyFire Patcher */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-gplv2-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz
tar -xvf openssl-1.1.1j.tar.gz
cd openssl-1.1.1j
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb
dpkg -i mysql-apt-config_0.8.14-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 10)

2025-08-07T02:05:19Z

Digid702: /* Installing SkyFireDataBase (SFDB) */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-gplv2-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz
tar -xvf openssl-1.1.1j.tar.gz
cd openssl-1.1.1j
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb
dpkg -i mysql-apt-config_0.8.14-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 10)

2025-08-07T02:05:02Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-gplv2-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz
tar -xvf openssl-1.1.1j.tar.gz
cd openssl-1.1.1j
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb
dpkg -i mysql-apt-config_0.8.14-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 10)

2025-08-07T02:04:51Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-gplv2-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz
tar -xvf openssl-1.1.1j.tar.gz
cd openssl-1.1.1j
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb
dpkg -i mysql-apt-config_0.8.14-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Fedora 39)

2025-08-07T02:03:46Z

Digid702: /* SkyFire Patcher */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Fedora use the following command:
<pre>
sudo yum install g++ make cmake git wget git-core openssl openssl-devel readline-devel zlib-devel bzip2 bzip2-devel
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
Start by downloading the rpm.
<pre>
wget https://dev.mysql.com/get/mysql80-community-release-fc39-2.noarch.rpm
sudo yum localinstall mysql80-community-release-fc39-2.noarch.rpm
</pre>
<pre>
sudo yum install mysql-server mysql-devel
</pre>

'''Installing ACE'''

<pre>
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-7.0.4-89.181.x86_64.rpm
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-devel-7.0.4-89.181.x86_64.rpm
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_23_STD Use c++23 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Fedora 39)

2025-08-07T02:03:31Z

Digid702: /* Extractor and VMAPs */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Fedora use the following command:
<pre>
sudo yum install g++ make cmake git wget git-core openssl openssl-devel readline-devel zlib-devel bzip2 bzip2-devel
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
Start by downloading the rpm.
<pre>
wget https://dev.mysql.com/get/mysql80-community-release-fc39-2.noarch.rpm
sudo yum localinstall mysql80-community-release-fc39-2.noarch.rpm
</pre>
<pre>
sudo yum install mysql-server mysql-devel
</pre>

'''Installing ACE'''

<pre>
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-7.0.4-89.181.x86_64.rpm
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-devel-7.0.4-89.181.x86_64.rpm
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_23_STD Use c++23 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Fedora 39)

2025-08-07T02:03:16Z

Digid702: /* Installing SkyFireDataBase (SFDB) */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Fedora use the following command:
<pre>
sudo yum install g++ make cmake git wget git-core openssl openssl-devel readline-devel zlib-devel bzip2 bzip2-devel
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
Start by downloading the rpm.
<pre>
wget https://dev.mysql.com/get/mysql80-community-release-fc39-2.noarch.rpm
sudo yum localinstall mysql80-community-release-fc39-2.noarch.rpm
</pre>
<pre>
sudo yum install mysql-server mysql-devel
</pre>

'''Installing ACE'''

<pre>
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-7.0.4-89.181.x86_64.rpm
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-devel-7.0.4-89.181.x86_64.rpm
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_23_STD Use c++23 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Fedora 39)

2025-08-07T02:02:56Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Fedora use the following command:
<pre>
sudo yum install g++ make cmake git wget git-core openssl openssl-devel readline-devel zlib-devel bzip2 bzip2-devel
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
Start by downloading the rpm.
<pre>
wget https://dev.mysql.com/get/mysql80-community-release-fc39-2.noarch.rpm
sudo yum localinstall mysql80-community-release-fc39-2.noarch.rpm
</pre>
<pre>
sudo yum install mysql-server mysql-devel
</pre>

'''Installing ACE'''

<pre>
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-7.0.4-89.181.x86_64.rpm
sudo yum install https://download.opensuse.org/repositories/devel:/libraries:/ACE:/micro/Fedora_Rawhide/x86_64/ace-devel-7.0.4-89.181.x86_64.rpm
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_23_STD Use c++23 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://codeberg.org/ProjectSkyfire/database/tags
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2025-08-07T02:02:20Z

Digid702: /* SkyFire Patcher */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==
Now we will set up the database framework for which SkyFire will be installed into:
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''
Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2025-08-07T02:02:02Z

Digid702: /* Extractor and VMAPs */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==
Now we will set up the database framework for which SkyFire will be installed into:
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''
Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2025-08-07T02:01:47Z

Digid702: /* Installing SkyFireDataBase (SFDB) */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==
Now we will set up the database framework for which SkyFire will be installed into:
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''
Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://github.com/ProjectSkyfire/SkyFire_548/releases
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2025-08-07T02:01:28Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==
Now we will set up the database framework for which SkyFire will be installed into:
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''
Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://codeberg.org/ProjectSkyfire/database/tags
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-08-07T02:00:58Z

Digid702: /* Installing SkyFireDataBase (SFDB) */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the text file with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
sudo apt-get install gnupg

wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://github.com/ProjectSkyfire/SkyFire_548/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://github.com/ProjectSkyfire/SkyFire_548/releases/download/24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-08-07T01:59:57Z

Digid702: /* SkyFire Patcher */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the text file with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
sudo apt-get install gnupg

wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-08-07T01:59:39Z

Digid702: /* Extractor and VMAPs */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the text file with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
sudo apt-get install gnupg

wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-08-07T01:58:55Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the text file with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
sudo apt-get install gnupg

wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://github.com/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-07-08T03:51:23Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the text file with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
sudo apt-get install gnupg

wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://codeberg.org/ProjectSkyfire/SkyFire_548
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-07-08T03:44:32Z

Digid702: /* Prerequisites */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the text file with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
sudo apt-get install gnupg

wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://codeberg.org/ProjectSkyfire/SkyFire_548
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-07-08T02:05:46Z

Digid702: /* Introduction */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the text file with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://codeberg.org/ProjectSkyfire/SkyFire_548
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-07-08T02:05:31Z

Digid702: /* Introduction */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download the notepad with all commands used in the guide above [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://codeberg.org/ProjectSkyfire/SkyFire_548
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-07-08T02:04:44Z

Digid702: /* Introduction */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

Download to the notepad with all commands to follow along with the video available [https://www.youtube.com/redirect?event=video_description&redir_token=QUFFLUhqbFFJT282VmEybmZCcWVneGZjcGZtQUNwSmMwQXxBQ3Jtc0tseXFtcUN4THVNR0tQTmxkVUNsX2FBQkxJa3QwbGsycEg4X0YtanEya01pMDJSeGZaUW9VQlliZVNFa2d4b19ZVk9xZlpQVVNCQWFjc2FSNjB6elVZbG9tLXI1VldITTlhWWpGVXJ0VXFzM0VVNFU2RQ&q=https%3A%2F%2Fwww.mediafire.com%2Ffile_premium%2F31kg4a4vnt5ypja%2FMOP_v3.txt%2Ffile&v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://codeberg.org/ProjectSkyfire/SkyFire_548
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-07-08T02:03:25Z

Digid702: /* Introduction */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Follow along with the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://codeberg.org/ProjectSkyfire/SkyFire_548
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 13)

2025-07-08T02:02:31Z

Digid702: Created page with "== Introduction == This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux. Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page! Check out the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here] == Prerequisites == The compilat..."

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

Special thanks to Digital Scriptorium ([https://www.youtube.com/@Digital-Scriptorium YouTube]) for the video guide and outline of this Wiki page!
Check out the video guide [https://www.youtube.com/watch?v=5RDYNhFhPYM here]
== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. This is for Debian 13:

'''Installing MySQL'''
(For latest mysql-apt repository, check url from https://dev.mysql.com/downloads/repo/apt/ )
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.34-1_all.deb -O /tmp/mysql-apt-config_all.deb

sudo DEBIAN_FRONTEND=noninteractive dpkg -i /tmp/mysql-apt-config_all.deb

sudo dpkg-reconfigure mysql-apt-config

(Debian Bookworm)
(mysql-8.4-lts)
(overwite? y)
</pre>

Confirm you are seeing Bookworm and not Trixie until Debian 13 is officially released
<pre>
sudo nano /etc/apt/sources.list.d/mysql.list
</pre>

'''Install MySQL keys'''
<pre>
wget https://repo.mysql.com/RPM-GPG-KEY-mysql-2023
gpg --dearmor < RPM-GPG-KEY-mysql-2023 | sudo tee /usr/share/keyrings/mysql.gpg > /dev/null

sudo nano /etc/apt/sources.list.d/mysql.list

sudo apt-get update
</pre>

'''Install Libaio'''
<pre>
wget http://ftp.debian.org/debian/pool/main/liba/libaio/libaio1_0.3.113-4_amd64.deb

sudo dpkg -i libaio1_0.3.113-4_amd64.deb
</pre>

'''Other prerequisites'''
<pre>
sudo apt-get install git build-essential g++ cmake make libace-dev libmysqlclient-dev libssl-dev libbz2-dev libreadline-dev libncurses-dev mysql-server p7zip zlib1g-dev -y

sudo reboot
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b main https://codeberg.org/ProjectSkyfire/SkyFire_548
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1) or $(nproc)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>sudo mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
sudo mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
sudo mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

(For latest world database, check url from https://codeberg.org/ProjectSkyfire/database/releases)
 
'''In the terminal window:'''
<pre>
cd $HOME/SkyFire_548/sql/base

wget https://codeberg.org/ProjectSkyfire/database/releases/download/R24.001/SFDB_full_548_24.001_2024_09_04_Release.zip

7z x SFDB_full_548_24.001_2024_09_04_Release.zip && sudo chmod -R 755 $HOME/SkyFire_548/sql/base

cd $HOME/SkyFire_548/sql/base/SFDB_full_548_24.001_2024_09_04_Release

nano linux_installer.sh
</pre>
'''(skyfire credentials & adjust world DB name)'''

'''Example of linux_installer.sh'''
<pre>
#!/bin/bash
# Modified script from WhyDB
############################################################################
#
# Tool Configuration
#
# user - root
# pass - password
# wdb - world
#
############################################################################
user="mysql_user" CHANGE ME!!!
pass="mysql_password" CHANGE ME!!!
wdb="wow_world" CHANGE ME!!!

############################################################################
#
# Server configuration, do not edit past this point
#
############################################################################
server="localhost"
port="3306"
devpath="./main_db/world"
procpath="./main_db/procs"
uppath="./world_updates"
bkpath="dump"
</pre>
<pre>
./linux_installer.sh #Option "i" to Install clean World Database, "x" to close
</pre>

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

'''Auth'''
<pre>
cd ~/SkyFire_548/sql/updates/auth
cat *.sql | mysql -u root -p auth > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''Characters'''
<pre>
cd ~/SkyFire_548/sql/updates/characters
cat *.sql | mysql -u root -p characters > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>
'''World'''
<pre>
cd ~/SkyFire_548/sql/updates/world
cat *.sql | mysql -u root -p world > "update_log_$(date +%F_%H-%M-%S).txt" 2>&1
</pre>

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Starting The Server ==
<pre>
cd /usr/local/skyfire-server/bin

./authserver

./worldserver
</pre>

''' To start in the background install "screen" '''
<pre>
sudo apt-get install screen
</pre>
<pre>
cd /usr/local/skyfire-server/bin

screen -AmdS authserver ./authserver

screen -AmdS worldserver ./worldserver
</pre>

'''To get back to the screen session use the below commands'''
<pre>
screen -r worldserver
screen -r authserver
</pre>

Using the key combination of CTRL+A+D will detach from the screens session

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Main Page

2025-07-08T01:18:57Z

Digid702:

{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"
| style="width:61%; color:#000;" |
{| style="width:100%; border:none; background:none;"
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to [[Project Skyfire]] wiki!</div>
<div style="top:+0.2em; font-size:95%;">We have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles. [[Special:UserLogin|Join]] and feel free to improve us.</div>
|}
|}

{| width="100%" cellspacing="0" cellpadding="0"
| colspan="2" |

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; box-shadow: 0 6px 8px 0 rgba(0, 0, 0, 0.5); border-radius: 5px 5px 0px 0px;">
<h3>Getting started : Install the server 5.x.x SUPPORTED</h3>
----

* Windows:
** [[Installation (Windows_Clang)]] -- EXPERIMENTAL
** [[Installation (Windows_5xx)]] -- UPDATED
* Linux:
** [[Installation (Ubuntu 24.04_LTS)]] -- NEW
** [[Installation (Fedora 39)]] -- NEW
** [[Installation (Debian 13)]] -- NEW
** [[Installation (Debian 10)]] -- NEW
** [[Installation (CentOS 7/8)]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; box-shadow: 0 6px 8px 0 rgba(0, 0, 0, 0.5); border-radius: 5px 5px 0px 0px;">
<h3>SkyFire Database Structure 5.4.8 Build 18414</h3>
----

You can always help us developing our wiki and improving our community.

*[[DB:Auth_18414|Description and database structure for Skyfire: `'''auth'''`]]
*[[DB:Characters_18414|Description and database structure for Skyfire: `'''characters'''`]]
*[[DB:World_18414|Description and database structure for Skyfire: `'''world'''`]]

</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; box-shadow: 0 6px 8px 0 rgba(0, 0, 0, 0.5); border-radius: 5px 5px 0px 0px;">
<h3>AI Scripting</h3>
----

* [[Smart AI (DB Scripting) reference]]
* [[Guide on ScriptDev2's Event AI DB script]]
</div>

| width="50%" style="vertical-align:top;" |

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; box-shadow: 0 6px 8px 0 rgba(0, 0, 0, 0.5); border-radius: 5px 5px 0px 0px;">
<h3>Development</h3>
----

*[[Linux GDB Debugging]]
*[[Mmaps Information]]
*[[Opcode list]] -- Not Updated
*[[DBC list]] -- Not Updated
*[[SkyFire DB|Database Changelog]] -- Not Updated
*[[Reporting Bugs|Reporting Bugs]]
*[[DBC Files|DBC Files]] -- Not Updated
*[[DBC Files 542|DBC Files (542)]] -- Not Updated
*[[IRC Rules|IRC Rules]]
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; box-shadow: 0 6px 8px 0 rgba(0, 0, 0, 0.5); border-radius: 5px 5px 0px 0px;">
<h3>Advanced Features</h3>
----

*[[How-to:Advanced|Advanced Guides]]
*[[How-to:MySQLStoredProcedures|How to use MySQL Stored Procedures]]
*[[How-to:Advanced:Xampp|How to use Xampp with MySQL 8.0]]

{{Pp-vandalism}}
</div>

<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; box-shadow: 0 6px 8px 0 rgba(0, 0, 0, 0.5); border-radius: 5px 5px 0px 0px;">
<h3>Scripting Assets</h3>
----

This is a placeholder.
</div>
<div style="border: 1px solid #D8D8D8; padding:4px 8px 8px 8px; margin:10px; box-shadow: 0 6px 8px 0 rgba(0, 0, 0, 0.5); border-radius: 5px 5px 0px 0px;">
<h3>Unsupported Legacy Information</h3>
----
Install the server 4.0.6 a Archived
----

* [[Installation (Windows)]]
* [[Installation (Linux)]]
----
Install the server 2.4.3 Archived
----

* [[Installation (Windows_243)]] -- Work In Progress
* [[Installation Debian 9 (Linux_243 (General))]] -- Work In Progress
** Ubuntu:
*** [[Installation (Ubuntu 18.04LTS)]] -- Work In Progress

----
SkyFire Database Structure Legacy 4.0.6a
----

'''{{revision-number}}'''

*[[DB:World|Description of the SkyFire `'''world'''` database structure]]
*[[DB:Characters|Description of the SkyFire `'''characters'''` database structure]]
*[[DB:Auth|Description of the SkyFire `'''auth'''` database structure]]

----
SkyFire Database Structure 2.4.3 Build 8606
You can always help us developing our wiki and improving our community.

*[[DB:World_243|Description of the SkyFire One `'''world'''` database structure]]
*[[DB:Characters_243|Description of the SkyFire One `'''characters'''` database structure]]
*[[DB:Auth_243|Description of the SkyFire One `'''auth'''` database structure]]
----

</div>
</div>
|}

{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"
| style="width:61%; color:#000;" |
{| style="width:100%; border:none; background:none;"
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;" class="plainlinks">
<ul> {{NUMBEROFARTICLES}} Articles</ul>
<ul> {{NUMBEROFPAGES}} Pages</ul>
<ul> {{NUMBEROFUSERS}} Registered Users</ul>
</div>
|}
|}

Installation Windows

2024-12-16T21:13:03Z

Digid702: /* PULLING AND COMPILING THE SOURCE */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>C++/C# Compiler: [http://www.microsoft.com/downloads/details.aspx?familyid=F3FBB04E-92C2-4701-B4BA-92E26E408569&displaylang=en#filelist Visual Studio 2008 Express] / [http://www.microsoft.com/express/Downloads/#2010-Visual-CPP Visual Studio 2010 Express] (Both free)
*'''Beware''', Express editions do not support 64-bit compilation by default and making them do so is arduous at best.
*You will need C++ for the Core and C# for the wow.exe patcher. (The patcher is now pre-compiled if you do not want to install C#)
*NOTE: Currently there is a bug with CMake & Some Versions of Visual Studio 2010. If you experience problems (errors) with CMake Configure using VS 2010, it might be better to use the 2008 OR 2012 version.
**For Visual Studios 2012 Express (Recommended for Beginners), download here [http://www.microsoft.com/visualstudio/eng/downloads Visual Studio 2012 Express].
**You will need to select the best option for your platform (most likely "Visual Studio 2012 Express for Windows Desktop").
**Once Installed, you will be required to register the software or the program will only work for 30 days.
**NOTE: Currently Visual Studios 2012 does NOT support C++ Compiling for Windows XP Environment. This means if you compile on your Windows 7 Machine, the server will NOT operate on your Windows XP Machine!.</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*'''Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]</li> 

<li>MySQL Server
*You can use [http://dev.mysql.com/downloads/mysql/ MySQL Community Server] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 5.5.9
*'''Do NOT download the Essentials package''' or compiling will NOT happen and you will have problems. ''As quoted on the MySQL page:''<pre>The Windows "msi-essential-*" installers do not include: Instance Manager tool, Documentation, Development headers etc.</pre>
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual C++ Redistributable Packages ===

*If you use different PCs for compile/run SkyFireEMU, install one of the following packages on your Server-PC to avoid missing dependencies (dependig on your Visual Studio Version and your Server-PC Operating System) Microsoft Visual C++ 2008 Redistributable Package SP1 MFC Security Update [[http://www.microsoft.com/downloads/en/details.aspx?familyid=05ce856d-8128-408b-96fa-5e1f57b097d8&displaylang=en x86 / x64 / ia64]] Microsoft Visual C++ 2010 Redistributable Package SP1 [[http://www.microsoft.com/downloads/details.aspx?familyid=C32F406A-F8FC-4164-B6EB-5328B8578F03&displaylang=en x86]] / [[http://www.microsoft.com/downloads/details.aspx?familyid=C68CCBB6-75EF-4C9D-A326-879EAB4FCDF8&displaylang=en x64]] / [[http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=647A8A36-A058-41A4-88B2-D4A05CC0B6B3 ia64]]
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFire_548\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548\Core</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2008, your compiler would be "Visual Studio 9"
**If you are using Visual Studio 2010, your compiler would be "Visual Studio 10"
**If you are using Visual Studio 2012, your compiler would be "Visual Studio 11"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>https://codeberg.org/ProjectSkyfire/database.git</pre>

This will create a directory called Database that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''Database'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation Windows

2024-12-16T21:12:42Z

Digid702: /* Configuring and Generating Visual C++ solutions with CMake */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>C++/C# Compiler: [http://www.microsoft.com/downloads/details.aspx?familyid=F3FBB04E-92C2-4701-B4BA-92E26E408569&displaylang=en#filelist Visual Studio 2008 Express] / [http://www.microsoft.com/express/Downloads/#2010-Visual-CPP Visual Studio 2010 Express] (Both free)
*'''Beware''', Express editions do not support 64-bit compilation by default and making them do so is arduous at best.
*You will need C++ for the Core and C# for the wow.exe patcher. (The patcher is now pre-compiled if you do not want to install C#)
*NOTE: Currently there is a bug with CMake & Some Versions of Visual Studio 2010. If you experience problems (errors) with CMake Configure using VS 2010, it might be better to use the 2008 OR 2012 version.
**For Visual Studios 2012 Express (Recommended for Beginners), download here [http://www.microsoft.com/visualstudio/eng/downloads Visual Studio 2012 Express].
**You will need to select the best option for your platform (most likely "Visual Studio 2012 Express for Windows Desktop").
**Once Installed, you will be required to register the software or the program will only work for 30 days.
**NOTE: Currently Visual Studios 2012 does NOT support C++ Compiling for Windows XP Environment. This means if you compile on your Windows 7 Machine, the server will NOT operate on your Windows XP Machine!.</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*'''Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]</li> 

<li>MySQL Server
*You can use [http://dev.mysql.com/downloads/mysql/ MySQL Community Server] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 5.5.9
*'''Do NOT download the Essentials package''' or compiling will NOT happen and you will have problems. ''As quoted on the MySQL page:''<pre>The Windows "msi-essential-*" installers do not include: Instance Manager tool, Documentation, Development headers etc.</pre>
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual C++ Redistributable Packages ===

*If you use different PCs for compile/run SkyFireEMU, install one of the following packages on your Server-PC to avoid missing dependencies (dependig on your Visual Studio Version and your Server-PC Operating System) Microsoft Visual C++ 2008 Redistributable Package SP1 MFC Security Update [[http://www.microsoft.com/downloads/en/details.aspx?familyid=05ce856d-8128-408b-96fa-5e1f57b097d8&displaylang=en x86 / x64 / ia64]] Microsoft Visual C++ 2010 Redistributable Package SP1 [[http://www.microsoft.com/downloads/details.aspx?familyid=C32F406A-F8FC-4164-B6EB-5328B8578F03&displaylang=en x86]] / [[http://www.microsoft.com/downloads/details.aspx?familyid=C68CCBB6-75EF-4C9D-A326-879EAB4FCDF8&displaylang=en x64]] / [[http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=647A8A36-A058-41A4-88B2-D4A05CC0B6B3 ia64]]
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFireEMU''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFireEMU\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548\Core</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2008, your compiler would be "Visual Studio 9"
**If you are using Visual Studio 2010, your compiler would be "Visual Studio 10"
**If you are using Visual Studio 2012, your compiler would be "Visual Studio 11"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>https://codeberg.org/ProjectSkyfire/database.git</pre>

This will create a directory called Database that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''Database'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation Windows

2024-12-16T21:12:04Z

Digid702: /* Importing World Database */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>C++/C# Compiler: [http://www.microsoft.com/downloads/details.aspx?familyid=F3FBB04E-92C2-4701-B4BA-92E26E408569&displaylang=en#filelist Visual Studio 2008 Express] / [http://www.microsoft.com/express/Downloads/#2010-Visual-CPP Visual Studio 2010 Express] (Both free)
*'''Beware''', Express editions do not support 64-bit compilation by default and making them do so is arduous at best.
*You will need C++ for the Core and C# for the wow.exe patcher. (The patcher is now pre-compiled if you do not want to install C#)
*NOTE: Currently there is a bug with CMake & Some Versions of Visual Studio 2010. If you experience problems (errors) with CMake Configure using VS 2010, it might be better to use the 2008 OR 2012 version.
**For Visual Studios 2012 Express (Recommended for Beginners), download here [http://www.microsoft.com/visualstudio/eng/downloads Visual Studio 2012 Express].
**You will need to select the best option for your platform (most likely "Visual Studio 2012 Express for Windows Desktop").
**Once Installed, you will be required to register the software or the program will only work for 30 days.
**NOTE: Currently Visual Studios 2012 does NOT support C++ Compiling for Windows XP Environment. This means if you compile on your Windows 7 Machine, the server will NOT operate on your Windows XP Machine!.</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*'''Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]</li> 

<li>MySQL Server
*You can use [http://dev.mysql.com/downloads/mysql/ MySQL Community Server] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 5.5.9
*'''Do NOT download the Essentials package''' or compiling will NOT happen and you will have problems. ''As quoted on the MySQL page:''<pre>The Windows "msi-essential-*" installers do not include: Instance Manager tool, Documentation, Development headers etc.</pre>
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual C++ Redistributable Packages ===

*If you use different PCs for compile/run SkyFireEMU, install one of the following packages on your Server-PC to avoid missing dependencies (dependig on your Visual Studio Version and your Server-PC Operating System) Microsoft Visual C++ 2008 Redistributable Package SP1 MFC Security Update [[http://www.microsoft.com/downloads/en/details.aspx?familyid=05ce856d-8128-408b-96fa-5e1f57b097d8&displaylang=en x86 / x64 / ia64]] Microsoft Visual C++ 2010 Redistributable Package SP1 [[http://www.microsoft.com/downloads/details.aspx?familyid=C32F406A-F8FC-4164-B6EB-5328B8578F03&displaylang=en x86]] / [[http://www.microsoft.com/downloads/details.aspx?familyid=C68CCBB6-75EF-4C9D-A326-879EAB4FCDF8&displaylang=en x64]] / [[http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=647A8A36-A058-41A4-88B2-D4A05CC0B6B3 ia64]]
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFireEMU''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFireEMU\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFireEMU\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFireEMU\Core</pre>

Where to build the binaries:
<pre>C:\SkyFireEMU\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2008, your compiler would be "Visual Studio 9"
**If you are using Visual Studio 2010, your compiler would be "Visual Studio 10"
**If you are using Visual Studio 2012, your compiler would be "Visual Studio 11"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>https://codeberg.org/ProjectSkyfire/database.git</pre>

This will create a directory called Database that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''Database'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation Windows

2024-12-16T21:10:48Z

Digid702: /* PULLING AND COMPILING THE SOURCE */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>C++/C# Compiler: [http://www.microsoft.com/downloads/details.aspx?familyid=F3FBB04E-92C2-4701-B4BA-92E26E408569&displaylang=en#filelist Visual Studio 2008 Express] / [http://www.microsoft.com/express/Downloads/#2010-Visual-CPP Visual Studio 2010 Express] (Both free)
*'''Beware''', Express editions do not support 64-bit compilation by default and making them do so is arduous at best.
*You will need C++ for the Core and C# for the wow.exe patcher. (The patcher is now pre-compiled if you do not want to install C#)
*NOTE: Currently there is a bug with CMake & Some Versions of Visual Studio 2010. If you experience problems (errors) with CMake Configure using VS 2010, it might be better to use the 2008 OR 2012 version.
**For Visual Studios 2012 Express (Recommended for Beginners), download here [http://www.microsoft.com/visualstudio/eng/downloads Visual Studio 2012 Express].
**You will need to select the best option for your platform (most likely "Visual Studio 2012 Express for Windows Desktop").
**Once Installed, you will be required to register the software or the program will only work for 30 days.
**NOTE: Currently Visual Studios 2012 does NOT support C++ Compiling for Windows XP Environment. This means if you compile on your Windows 7 Machine, the server will NOT operate on your Windows XP Machine!.</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*'''Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]</li> 

<li>MySQL Server
*You can use [http://dev.mysql.com/downloads/mysql/ MySQL Community Server] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 5.5.9
*'''Do NOT download the Essentials package''' or compiling will NOT happen and you will have problems. ''As quoted on the MySQL page:''<pre>The Windows "msi-essential-*" installers do not include: Instance Manager tool, Documentation, Development headers etc.</pre>
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual C++ Redistributable Packages ===

*If you use different PCs for compile/run SkyFireEMU, install one of the following packages on your Server-PC to avoid missing dependencies (dependig on your Visual Studio Version and your Server-PC Operating System) Microsoft Visual C++ 2008 Redistributable Package SP1 MFC Security Update [[http://www.microsoft.com/downloads/en/details.aspx?familyid=05ce856d-8128-408b-96fa-5e1f57b097d8&displaylang=en x86 / x64 / ia64]] Microsoft Visual C++ 2010 Redistributable Package SP1 [[http://www.microsoft.com/downloads/details.aspx?familyid=C32F406A-F8FC-4164-B6EB-5328B8578F03&displaylang=en x86]] / [[http://www.microsoft.com/downloads/details.aspx?familyid=C68CCBB6-75EF-4C9D-A326-879EAB4FCDF8&displaylang=en x64]] / [[http://www.microsoft.com/downloads/details.aspx?displaylang=en&FamilyID=647A8A36-A058-41A4-88B2-D4A05CC0B6B3 ia64]]
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFireEMU''').</li>
<li>Right-click on the directory and click on '''Git GUI Here''' or open Git GUI from the Start menu</li>
<li>Then click '''Clone Existing Repository''' when the Git GUI dialog comes up.</li>
<li>Fill in the data as follows:</li> 

Source Location:
<pre>https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>

Target Directory:
<pre>C:\SkyFireEMU\Core</pre>
 

<li>Click on '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFireEMU\Core'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFireEMU\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFireEMU\Core</pre>

Where to build the binaries:
<pre>C:\SkyFireEMU\Build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2008, your compiler would be "Visual Studio 9"
**If you are using Visual Studio 2010, your compiler would be "Visual Studio 10"
**If you are using Visual Studio 2012, your compiler would be "Visual Studio 11"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''SkyFireEMU.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 
*Warning: Visual Studio 2008/2010 Express editions do not support the 64 bit platform. You will need to install the full Visual Studio, as well as additional components to enable 64 bit support. Refer to Microsoft's website and documentation for more details.</li> 
<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFireEMU\Build\bin\Release''' folder:
<pre>ace.dll
authserver.conf.dist
authserver.exe
libmysql.dll (If you did NOT update the header source.)
worldserver.conf.dist
worldserver.exe
</pre> 

<li>Cut and Paste these files from '''C:\SkyFireEMU\Build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFireEMU\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*''' Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 

<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB using Git Extensions or Git Gui:

<pre>git://github.com/ProjectSkyfire/SkyFireDB.git</pre>

This will create a directory called SkyFireDB that will contain the world database files that the server will need.
<li>Open '''Database_Installer_Updater.bat''' found in '''SkyFireDB'''</li>
<li>Follow the dialog and enter in your info.</li>

Example:<pre>
MySQL Server Address (e.g. localhost):localhost

MySQL Username: root
MySQL Password: pass

World Database: World
</pre></li>
<li>Press '''1''' to install the World Database and all current updates when asked.</li>
<li>Wait for the installer to do it's magic. After it is done, press any key to go back to the main menu.</li>
<li>Install locals if you want.</li>
<li>Press '''X''' to exit.</li>
</ol>
Done!

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li>
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>


==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''


=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "CT"''', NOT "LK".
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''
**If you still have problems delete your whole WTF folder and rerun launcher to generate both .wtf files again then redo the whole step above.</li> 

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''C:\SkyFireEMU\Build\bin\Release''' to your wow directory (C:\Program Files (x86)\World of Warcraft)</li> 

<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.


=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>



*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)


==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows 5xx)

2024-09-26T00:39:01Z

Digid702: /* INTRODUCTION */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*We supply OpenSSL 3.3.0 which is needed to build the core, it is within SkyFire_548\contrib\openssl folder. Extract and place the OpenSSL-Win64 in C:\OpenSSL-Win64
 
'''-- OLD CONTENT BELOW NOT NEEDED --'''
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows 5xx)

2024-09-26T00:36:16Z

Digid702: /* Software Required */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*We supply OpenSSL-Win64 within the contrib/openssl folder. Extract and place the OpenSSL-Win64 in C:\OpenSSL-Win64
 
'''-- OLD CONTENT BELOW --'''
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Windows 5xx)

2024-09-24T17:57:11Z

Digid702: /* DBC, MAPS, VMAPS, and MMAPS */

{| align="right"

|-

| __TOC__

|}

== INTRODUCTION ==
Before you get scared by this long guide, we assure you the procedure is quite simple. Most of the following steps are to be performed only the first time you install SkyFireEMU and only the SkyFireEMU updating procedures will need to be run from time to time.
After the first few times everyone gets used to the procedure and never needs to look at this guide ever again. 

=== Software Required ===
<ol>
<li>[http://git-scm.com/download Git] You can also use TortoiseGit that is more compatible with Windows (8). [http://code.google.com/p/tortoisegit/ TortoiseGIT]</li> 

<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].
</li> 

<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.
Note: If you have a 32-bit compiler, but a 64-bit OS and use the OpenSSL MSI installer for 32-bit, you will need to use the "?:\Program Files\OpenSSL" directory instead of the default "?:\Program Files (x86)\OpenSSL" setting in the installer.
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li> 

<li>[http://www.cmake.org/cmake/resources/software.html CMake]
CMake Version 3.16.3 or greater</li> 

<li>MySQL Server
*You can use [https://dev.mysql.com/downloads/mysql/ MySQL Community Server 8.0.X] or third party packages such as [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP]
*It's recommended that your MySQL server and the MySQL header source versions match.
*Current SkyFire core MySQL header version: 8.0.X
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.
*If you are just planning on updating the MySQL header source and plan on using another server or package like [http://www.wampserver.com WAMP] or [http://www.apachefriends.org/en/xampp.html XAMPP], all you need to install is '''Client C API library (shared)''' under '''Development Components''' when doing a '''Custom Setup'''.</li> 

<li>[http://www.microsoft.com/downloads/details.aspx?FamilyId=333325FD-AE52-4E35-B531-508D977D32A6&displaylang=en .NET Framework 3.5] (You should already have this via your Windows updates.)</li> 

<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]
*'''DO NOT USE NAVICAT: Due to NaviCat not being able to handle // style comments (standard SQL), we advice all users to stay VERY clear of the product - you have been warned.'''</li>
</ol>
 

=== Software Recommended ===
git command help:<ul>
<li>[http://code.google.com/p/gitextensions/ gitextensions]
*most popular with the community</li>
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]
*Makes pulling and cloning sources easier with right mouse clicks.
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.
*Note: You still need to install [http://git-scm.com/download Git] for this to work.
</li>
</ul>
 

=== Microsoft Visual Studio 2019 ===

Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].
 
Please note Visual Studio 2022 Preview is not supported.
 

== PULLING AND COMPILING THE SOURCE ==

*'''Before you start this phase you need to have installed Git, OpenSSL, CMake, Visual Studio, .NET Framework 3.5 (if needed) and MySQL (If you are updating the MySQL Header Source.)'''


=== Pulling the Source ===
<ol>
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li>
<li>Right-click on the directory and click on '''Git Bash Here'''</li>
<li>Fill in the data as follows:</li> 
<pre>git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre>


<li>Press Enter to '''Clone Existing Repository'''. Wait a few minutes (or less) and all the source files will be pulled in the directory '''C:\SkyFire_548'''.</li>
</ol>

=== Configuring and Generating Visual C++ solutions with CMake ===
<ol>
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".
<li>Open CMake. (cmake-gui)</li>
<li>Fill in the data as follows:</li> 

Where the the source code:
<pre>C:\SkyFire_548</pre>

Where to build the binaries:
<pre>C:\SkyFire_548\build</pre>
 

<li>Click '''Configure'''.</li>
<li>It should ask you if you want to create the directory, '''click yes'''.</li>
<li>A dialog should pop up asking you what compiler you will be using. Select the appropriate compiler and select '''Use default native compilers''' then click '''Finish'''.
*NOTE: You MUST select the appropriate compiler!
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li>
<li>When done, it will show you a list of options which it wants you to confirm (the top red part with the check boxes.) 
Make sure these are the ones selected:
<pre>
SCRIPTS
SERVERS
TOOLS
USE_COREPCH
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)
USE_SCRIPTPCH
</pre>

*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''
*'''(If you are updating MySQL header source):''' If you have installed MySQL version other than 5.5, be sure to UNCHECK the WITH_MYSQL_SOURCES option. This tells CMake to look for include files and libraries in your MySQL installation instead of using the MySQL source files provided with SkyFireEMU (which are 5.5.9). Remember, unchecking WITH_MYSQL_SOURCES requires that you have full MySQL package (not Essentials) and that your selected compiler is for the same architecture (32bit/64bit) as your MySQL. If you have 5.5.x, you need not worry - just leave WITH_MYSQL_SOURCES checked.</li>
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li>
<li>Click on '''Generate''' and it will start chugging away and creating the solutionfiles/projectfiles/makefiles it requires to build for that specific compiler.</li>
<li>When done, it'll state "Generating done"</li>
<li>Close CMake and continue below with '''Compiling the Source'''.
</ol>

=== Compiling the Source ===
<ol>
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li>
<li>Go on the top menu and click '''Build''' then click on '''Configuration Manager'''. Make sure you set the build to '''Release''' and to '''Win32''' or '''x64'''. 

<li>Now go back to the '''Build''' menu and click on '''Clean Solution'''. Unless you are just testing a compilation, it is always best to '''clean your build before compiling.''' Compilation length differs from machine to machine, you should expect it to take 15-30 minutes. </li>
*You will find the following message once the compilation has finished successfully:
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========
</pre>
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder:
<pre>
ace.dll
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.
libeay32.dll -> Needs to copy to the release folder.
libssl-1_1-x64.dll -> Needs to copy to the release folder.
ssleay32.dll -> Needs to copy to the release folder.
authserver.conf.dist
authserver.exe
libmysql.dll (From your MySQL 8 install bin folder.)*
worldserver.conf.dist
worldserver.exe
</pre>
 

<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from. For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now. </li>

<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf These are your config files. Go through and edit each one to match your prefered settings.</li> 

<li>You will also need '''libmysql.dll''' to run your server.
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib''' Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li> 
</ol>

=== Keeping the code up to date ===
SkyFireEMU Developers are always at work fixing and adding new features to the core so it's best you keep up to date with the code.

<ol>
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li>
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li>
<li>Then Click on the '''Merge>Local Merge...''' another window will popup, choose '''origin/master'''. When you see the green line with text '''success''' hit '''Close'''!</li>
</ol>

*Now you can repeat the compiling procedure above. 
*'''And remember to clean your build everytime!'''
 

== IMPORTING THE DATABASE ==

*'''Before you start this phase you need to have installed a SQL Client and you should also have installed and set up your MySQL server and made an user account for SkyFireEMU with proper permissions to access and write data.''' 

=== Creating Auth, Characters and World Databases ===
Using your chosen SQL Client, create the three Databases.
<ol>
<li>Auth</li>
<li>Characters</li>
<li>World</li>
</ol>
*Doing this may prevent importing problems later.


==== Importing Auth and Characters Databases ====
Using your chosen SQL Client,
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\sql\base''' to their respective places in your MySQL database.

==== Importing World Database ====
<ol>
----

Grab the latest version of SkyFireDB_5xx from our release repository:

<pre>https://github.com/ProjectSkyfire/database/releases</pre>

Import the DB into your world table. Will update this method shortly

==== Importing Important Database Structure Updates ====
<ol>
<li>Go into your '''C:\SkyFireEMU\core\sql\updates''' directory.</li> 
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li>
</ol>

==== Importing World Database Updates ====
<ol>
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li>
<li>Follow the dialog and enter in your info like you did before.</li>
<li>Press '''U''' to import the World Database updates when asked.</li>
<li>Select the correct changesets needed.</li>
</ol>
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''

=== Auth Database Accounts and Passwords ===
It is '''highly advised''' you change the passwords or delete these accounts.
*'''NOTE''': These may not exist.
<pre>User: Administrator
Pass: Administrator

User: Moderator
Pass: Moderator

User: Developer
Pass: Developer

User: Gamemaster
Pass: Gamemaster

User: Player
Pass: Player</pre>

==== Changing passwords ====
You can change a password to an account simply by going to your Worldserver console and type<pre>account set password <accountname> <newpassword> <newpassword></pre>

==== Deleting accounts ====
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre>

==== Making new accounts ====
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre>

==== Raising an account's access/GM level ====
You can raise an account level simply by going to your Worldserver console and type<pre>account set gmlevel <accountname> <gmlevel> <realmid></pre>Or you can go into your Auth database via your SQL Client, select '''account_access''' and add a new line.
*id=your account id found under '''accounts'''
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator
**You can only add Administrator (gmlevel 4) with your SQL client
*RealmID is usually 1 or -1 for all realms
 

== DBC, MAPS, VMAPS, and MMAPS ==

*'''Project Skyfire, for legal reasons, CANNOT and will NOT provide download links to already extracted DBCs, MAPS, VMAPS, or MMAPS... so please do NOT ask!'''
*We will, however, help you through the extraction process with step-by-step instructions
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''
<ol></li> 

<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 5.4.8 (build 18414)

<li>Copy and Paste '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from '''SkyFire_548\Build\bin\Release''' to your wow directory ex:(C:\Program Files (x86)\World of Warcraft)</li> 
<li>Locate your '''bin''' file in your '''MySQL installation directory''' (Example: C:\Program Files\MySQL\MySQL Server 5.5\lib\ OR C:\Program Files(x86)\MySQL\MySQL Server 5.5\lib\ if you have a 32 bit MySQL installed on an 64 bit system).
*Locate file named '''"libmysql.dll"'''.
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).
</ol>
 

=== Manual Extraction Method ===
<ol>
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li>
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li> 
Dbc and Maps:
<li>In your command prompt type '''extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li> 
VMaps:
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory named '''Buildings'''.</li>
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li>
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li>
<li>Wait until finished.</li>
<li>It should have made a new directory, '''vmaps'''.</li> 
MMaps:
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents ONLY'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li>
<li>You may now Delete the empty '''buildings''' folder.</li>
<li>Create a new folder named '''mmaps'''.</li>
<li>Now execute the '''mmaps_generator.exe'''.
*'''NOTE''': The generation of mmaps will take anywhere from 4 hours to 20 or MORE hours depending upon the speed of your machine. Please consider this before starting the mmaps generating!</li>
</ol>
 

=== Completion (For Both Methods) ===
<ol>
<li>Move folders named '''mmaps''', '''vmaps''', '''dbc''', '''maps''', as well as the '''"libmysql.dll"''' to your server directory (where your worldserver.exe will be ran from).</li>
<li>You may now delete files '''extractor.exe''', '''vmap3assembler.exe''', '''vmap3extractor.exe''', '''ace.dll''', '''Simple_Extractor.bat''', and '''mmaps_generator.exe''' from your WoW installation directory as you should no longer need them.</li>
</ol>
 

== SKYFIRE WOW.EXE PATCHER ==
Your Wow.exe client will be needed to be patched before you can properly connect to your server.

=== Patching ===
Pull the latest version of SkyFire-Community-Tools from
<pre>https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.
 

=== Pre-Patched Method (Easy Method)===
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.
 

=== Manuel Compile Method (Not really needed but will keep this for now)===

*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''
*You will not need CMake for this.
<ol>
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li>
<li>Select "Release"</li>
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li>
<li>Clean</li>
<li>Build. (This should take less than a minute.)</li>
</ol>

*Do not worry if you get an error like:<pre>..Sources\Patcher\SkyFirePatcher\Form1.cs(20,13): warning CS0414: The field 'SkyFirePatcher.Form1.exeLength' is assigned but its value is never used</pre>

*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder. (You can delete the rest if you like.)

==== Keeping the code up to date ====
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing. 

=== Moving and Patching ===
<ol>
<li>Move SkyFirePatcher.exe into your Wow directory. (Usually something like C:\Program Files (x86)\World of Warcraft)</li> 

<li>Now run SkyFirePatcher.exe and a dialog should pop up with:
<pre>Loading Wow.exe into memory...
Success!
Ready to patch Wow.exe.</pre>
And "Status: Ready!" at the bottom.</li> 

<li>Click "Patch" at the bottom to patch your Wow.exe 
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li> 
</ol>
=== Play! ===
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.
 
 
 

== References ==

http://www.trinitycore.org/w/How-to:Win

http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29

Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]

Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]

Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]

Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]

Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2024-09-23T04:35:37Z

Digid702:

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==
Now we will set up the database framework for which SkyFire will be installed into:
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''
Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://codeberg.org/ProjectSkyfire/database/tags
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2024-09-23T04:29:00Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://codeberg.org/ProjectSkyfire/database/tags
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2024-09-23T04:28:31Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://codeberg.org/ProjectSkyfire/database/tags
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Debian 10)

2024-09-23T04:27:42Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:

Debian based distributions use these commands:
<pre>
apt-get install build-essential autoconf libtool gcc g++ make cmake subversion git patch wget links zip unzip openssl libssl-dev libreadline-gplv2-dev zlib1g-dev libbz2-dev git-core libace-dev libncurses5-dev libace-dev -y
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.

For cases where you want to run an even newer release of OpenSSL than mentioned here, or your distribution not supplying a version that isn't of recent date, please check your distributions repositories or documentation. You can also retrieve it as sourcecode at http://openssl.org/source (feel free to use newer packages if you really feel like it). To build it from sourcecode, here's a primer :

<pre>
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz
tar -xvf openssl-1.1.1j.tar.gz
cd openssl-1.1.1j
mkdir build
cd build
</pre>

Alternative 1 : Local installation

<pre>
../config --prefix=/home/`echo $USER`/.sys shared
make
make install
</pre>

Alternative 2 : Systemwide installation

<pre>
../config shared
make
sudo make install
</pre>

Please note that any old revision of the OpenSSL package installed by the distribution may/will interfere with the new version. See your distribution documentation for information on how to remove it to be able to use the new one.

'''Installing MySQL'''
Start by downloading and dpkg the package.
<pre>
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb
dpkg -i mysql-apt-config_0.8.14-1_all.deb
</pre>
After following the configuration screen you want to apt-get update and install the libraries.
<pre>
apt-get update
apt-get install mysql-server mysql-client libmysqlclient-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build && cd build
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1
make -j(#cores+1)
make install
</pre>

Parameter explanations

<pre>
-DACE_LIBRARY=<path to ACE library> (full path to your libACE.so file INCLUDING the filename - do not use if you have ACE installed systemwide)
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)

-DSERVERS Build worldserver and authserver
-DSCRIPTS Build core with scripts included
-DTOOLS Build map/vmap extraction/assembler tools
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts
-DUSE_COREPCH Use precompiled headers when compiling servers
-DUSE_SFMT Use SFMT as random numbergenerator
-DWITH_WARNINGS Show all warnings during compile
-DWITH_COREDEBUG Include additional debug-code in core
-DWITH_SQL Copy SQL files during installation
-DCONF_DIR Set configuration directory
-DLIBSDIR Set library directory
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)

-DWITH_CXX_17_STD Use c++17 standard (advanced users only)
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre>

----

== Installing SkyFireDataBase (SFDB) ==

Now we will set up the database framework for which SkyFire will be installed into:

'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''

Replace the parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre>

----

Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre>

Edit both of these files to the correct Mysql user name, password, and your DataDir.
<pre>nano ~/skyfire/etc/(correctserver).conf</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

Before doing any of these commands, follow the guide at
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre>
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
~/skyfire/bin/extractor
~/skyfire/bin/vmap3extractor
mv dbc ~/skyfire/bin/dbc
mv maps ~/skyfire/bin/maps
mkdir vmaps
~/skyfire/bin/vmap3assembler
mv vmaps ~/skyfire/bin/
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2024-09-23T04:26:56Z

Digid702: /* Prerequisites */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2 libbz2-dev
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://codeberg.org/ProjectSkyfire/database/tags
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]

Installation (Ubuntu 24.04 LTS)

2024-09-23T04:26:02Z

Digid702: /* Compiling and Installing the SkyFire 5.4.8 */

== Introduction ==

This is a basic guide on how to install SkyFire_548 and SFDB from scratch. **Please note this is a work in progress and only contains enough information to get most people a viable server in Linux.

== Prerequisites ==

The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu 24.04 use the following command:
<pre>
sudo apt-get install g++ make cmake git wget libssl-dev libreadline-dev bzip2
</pre>

You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.

'''Installing MySQL'''
<pre>
sudo apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev
</pre>

'''Installing ACE'''
<pre>
sudo apt-get install libace-dev
</pre>

== Compiling and Installing the SkyFire 5.4.8 ==

Grab the latest version of SkyFire_548 using git:

<pre>
git clone -b master https://codeberg.org/ProjectSkyfire/SkyFire_548.git
</pre>

This should create a directory called SkyFire_548 that will contain all the files necessary to compile the server and it's tools. Change to the directory, configure, and build.

<pre>
cd SkyFire_548
mkdir build
cd build
cmake ../ -DTOOLS=1
make -j(#cores+1)
sudo make install
</pre>

parts in <> to the correct administrative username, and associated password.
Usually the administrative user is root, but you may have altered it.

'''In the terminal window:'''
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth_database.sql
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/characters_database.sql</pre>

----

Grab the latest version of SkyFireDB on. https://codeberg.org/ProjectSkyfire/database/tags
 
The DB download contains an installer for Linux and Windows. Also a single Sql file.

'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''

(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)
<pre>UPDATE auth.realmlist SET address = "YOUR IP HERE" WHERE id = 1;</pre>

== Configuration ==

Now move and edit the configuration files to run the server.

<pre>
sudo mv /usr/local/skyfire-server/etc/worldserver.conf.dist /usr/local/skyfire-server/etc/worldserver.conf
sudo mv /usr/local/skyfire-server/etc/authserver.conf.dist /usr/local/skyfire-server/etc/authserver.conf
</pre>

Edit worldserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/worldserver.conf
</pre>

Edit authserver to the correct Mysql user name, password, and your DataDir.
<pre>
sudo nano /usr/local/skyfire-server/etc/authserver.conf
</pre>

Move daemon service files to systemd.
<pre>
sudo mv /usr/local/skyfire-server/etc/worldserverd.service.dist /etc/systemd/system/worldserverd.service
sudo mv /usr/local/skyfire-server/etc/authserverd.service.dist /etc/systemd/system/authserverd.service
</pre>

== Extractor and VMAPs ==

If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP 
Extraction and assembly you can get a copy of them using your GIT client and download 
them from: https://codeberg.org/ProjectSkyfire/Community-Tools 

The last and final step of setting up SkyFire_548 is to obtain a proper set of maps for use in the server. Change to the WoW directory and run some commands:

<pre>
cd "Wow Directory"
/usr/local/skyfire-server/bin/extractor
/usr/local/skyfire-server/bin/vmap4extractor
sudo mv dbc /usr/local/skyfire-server/bin/dbc
sudo mv db2 /usr/local/skyfire-server/bin/db2
sudo mv cameras /usr/local/skyfire-server/bin/cameras
sudo mv maps /usr/local/skyfire-server/bin/maps
/usr/local/skyfire-server/bin/vmap4assembler
sudo mv vmaps /usr/local/skyfire-server/bin/
</pre>

== Starting and Stoping SkyFire Daemons==
Starting authserver daemon service
<pre>
systemctl start authserverd
</pre>
Starting worldserver daemon service
<pre>
systemctl start worldserverd
</pre>

Stoping authserver daemon service
<pre>
systemctl stop authserverd
</pre>
Stoping worldserver daemon service
<pre>
systemctl stop worldserverd
</pre>

To auto start daemons at startup you need to enable the services
<pre>
systemctl enable authserverd
systemctl enable worldserverd
</pre>

== SkyFire Patcher ==

The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.

<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre>

Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.

to install Mono simply, and correctly configured, please view:
<pre>http://wiki.winehq.org/winetricks</pre>
to obtain specific versions/running hackery in your Wine bottle.

== References ==

http://www.trinitycore.org/w/How-to:Linux

http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29

http://wiki.winehq.org/winetricks

http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549

[[Category:Installation]]