https://wiki.projectskyfire.org/api.php?action=feedcontributions&feedformat=atom&user=AdminProject Skyfire - User contributions [en]2026-04-27T15:37:17ZUser contributionsMediaWiki 1.45.3https://wiki.projectskyfire.org/index.php?title=Installation_(Debian_10)&diff=972Installation (Debian 10)2024-02-29T02:28:28Z<p>Admin: /* Compiling and Installing the SkyFire 5.4.8 */</p>
<hr />
<div>== Introduction ==<br />
<br />
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.<br />
<br />
== Prerequisites ==<br />
<br />
The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:<br />
<br />
Debian based distributions use these commands:<br />
<pre><br />
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<br />
</pre><br />
<br />
You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.<br />
<br />
'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.<br />
<br />
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 : <br />
<br />
<pre><br />
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz<br />
tar -xvf openssl-1.1.1j.tar.gz<br />
cd openssl-1.1.1j<br />
mkdir build<br />
cd build<br />
</pre><br />
<br />
Alternative 1 : Local installation <br />
<br />
<pre><br />
../config --prefix=/home/`echo $USER`/.sys shared<br />
make<br />
make install<br />
</pre><br />
<br />
Alternative 2 : Systemwide installation <br />
<br />
<pre><br />
../config shared<br />
make<br />
sudo make install<br />
</pre><br />
<br />
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.<br />
<br />
'''Installing MySQL'''<br />
Start by downloading and dpkg the package.<br />
<pre><br />
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb<br />
dpkg -i mysql-apt-config_0.8.14-1_all.deb<br />
</pre><br />
After following the configuration screen you want to apt-get update and install the libraries.<br />
<pre><br />
apt-get update<br />
apt-get install mysql-server mysql-client libmysqlclient-dev<br />
</pre><br />
<br />
== Compiling and Installing the SkyFire 5.4.8 ==<br />
<br />
Grab the latest version of SkyFire_548 using git:<br />
<br />
<pre><br />
git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd SkyFire_548<br />
mkdir build && cd build<br />
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1<br />
make -j(#cores+1)<br />
make install<br />
</pre><br />
<br />
Parameter explanations <br />
<br />
<pre><br />
-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)<br />
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)<br />
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)<br />
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)<br />
<br />
-DSERVERS Build worldserver and authserver<br />
-DSCRIPTS Build core with scripts included<br />
-DTOOLS Build map/vmap extraction/assembler tools<br />
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts<br />
-DUSE_COREPCH Use precompiled headers when compiling servers<br />
-DUSE_SFMT Use SFMT as random numbergenerator<br />
-DWITH_WARNINGS Show all warnings during compile<br />
-DWITH_COREDEBUG Include additional debug-code in core<br />
-DWITH_SQL Copy SQL files during installation<br />
-DCONF_DIR Set configuration directory<br />
-DLIBSDIR Set library directory<br />
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)<br />
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)<br />
<br />
-DWITH_CXX_17_STD Use c++17 standard (advanced users only)<br />
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre><br />
<br />
----<br />
<br />
== Installing SkyFireDataBase (SFDB) ==<br />
<br />
Now we will set up the database framework for which SkyFire will be installed into:<br />
<br />
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''<br />
<br />
Replace the parts in <> to the correct administrative username, and associated password.<br />
Usually the administrative user is root, but you may have altered it.<br />
<br />
<br />
'''In the terminal window:'''<br />
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql<br />
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql <br />
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre><br />
<br />
----<br />
<br />
Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/<br />
<br><br />
The DB download contains an installer for Linux and Windows. Also a single Sql file.<br />
<br />
'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''<br />
<br />
(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)<br />
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre><br />
<br />
== Configuration ==<br />
<br />
Now move and edit the configuration files to run the server.<br />
<br />
<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf<br />
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre><br />
<br />
Edit both of these files to the correct Mysql user name, password, and your DataDir. <br />
<pre>nano ~/skyfire/etc/(correctserver).conf</pre><br />
<br />
== Extractor and VMAPs ==<br />
<br />
If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP<BR> <br />
Extraction and assembly you can get a copy of them using your GIT client and download<BR> <br />
them from: https://codeberg.org/ProjectSkyfire/Community-Tools<BR><BR><BR><br />
<br />
Before doing any of these commands, follow the guide at <br />
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre><br />
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:<br />
<br />
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:<br />
<br />
<pre><br />
cd "Wow Directory"<br />
~/skyfire/bin/extractor<br />
~/skyfire/bin/vmap3extractor<br />
mv dbc ~/skyfire/bin/dbc<br />
mv maps ~/skyfire/bin/maps<br />
mkdir vmaps <br />
~/skyfire/bin/vmap3assembler<br />
mv vmaps ~/skyfire/bin/<br />
</pre><br />
<br />
== SkyFire Patcher ==<br />
<br />
The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.<br />
<br />
<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre><br />
<br />
Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.<br />
<br />
to install Mono simply, and correctly configured, please view: <br />
<pre>http://wiki.winehq.org/winetricks</pre><br />
to obtain specific versions/running hackery in your Wine bottle.<br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Linux<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29<br />
<br />
http://wiki.winehq.org/winetricks<br />
<br />
http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Debian_10)&diff=971Installation (Debian 10)2024-02-29T02:27:55Z<p>Admin: /* Extractor and VMAPs */</p>
<hr />
<div>== Introduction ==<br />
<br />
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.<br />
<br />
== Prerequisites ==<br />
<br />
The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:<br />
<br />
Debian based distributions use these commands:<br />
<pre><br />
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<br />
</pre><br />
<br />
You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.<br />
<br />
'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.<br />
<br />
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 : <br />
<br />
<pre><br />
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz<br />
tar -xvf openssl-1.1.1j.tar.gz<br />
cd openssl-1.1.1j<br />
mkdir build<br />
cd build<br />
</pre><br />
<br />
Alternative 1 : Local installation <br />
<br />
<pre><br />
../config --prefix=/home/`echo $USER`/.sys shared<br />
make<br />
make install<br />
</pre><br />
<br />
Alternative 2 : Systemwide installation <br />
<br />
<pre><br />
../config shared<br />
make<br />
sudo make install<br />
</pre><br />
<br />
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.<br />
<br />
'''Installing MySQL'''<br />
Start by downloading and dpkg the package.<br />
<pre><br />
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb<br />
dpkg -i mysql-apt-config_0.8.14-1_all.deb<br />
</pre><br />
After following the configuration screen you want to apt-get update and install the libraries.<br />
<pre><br />
apt-get update<br />
apt-get install mysql-server mysql-client libmysqlclient-dev<br />
</pre><br />
<br />
== Compiling and Installing the SkyFire 5.4.8 ==<br />
<br />
Grab the latest version of SkyFire_548 using git:<br />
<br />
<pre><br />
git clone -b trunk https://github.com/ProjectSkyfire/SkyFire_548.git<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd SkyFire_548<br />
mkdir build && cd build<br />
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1<br />
make -j(#cores+1)<br />
make install<br />
</pre><br />
<br />
Parameter explanations <br />
<br />
<pre><br />
-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)<br />
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)<br />
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)<br />
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)<br />
<br />
-DSERVERS Build worldserver and authserver<br />
-DSCRIPTS Build core with scripts included<br />
-DTOOLS Build map/vmap extraction/assembler tools<br />
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts<br />
-DUSE_COREPCH Use precompiled headers when compiling servers<br />
-DUSE_SFMT Use SFMT as random numbergenerator<br />
-DWITH_WARNINGS Show all warnings during compile<br />
-DWITH_COREDEBUG Include additional debug-code in core<br />
-DWITH_SQL Copy SQL files during installation<br />
-DCONF_DIR Set configuration directory<br />
-DLIBSDIR Set library directory<br />
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)<br />
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)<br />
<br />
-DWITH_CXX_17_STD Use c++17 standard (advanced users only)<br />
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre><br />
<br />
----<br />
<br />
== Installing SkyFireDataBase (SFDB) ==<br />
<br />
Now we will set up the database framework for which SkyFire will be installed into:<br />
<br />
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''<br />
<br />
Replace the parts in <> to the correct administrative username, and associated password.<br />
Usually the administrative user is root, but you may have altered it.<br />
<br />
<br />
'''In the terminal window:'''<br />
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql<br />
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql <br />
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre><br />
<br />
----<br />
<br />
Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/<br />
<br><br />
The DB download contains an installer for Linux and Windows. Also a single Sql file.<br />
<br />
'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''<br />
<br />
(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)<br />
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre><br />
<br />
== Configuration ==<br />
<br />
Now move and edit the configuration files to run the server.<br />
<br />
<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf<br />
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre><br />
<br />
Edit both of these files to the correct Mysql user name, password, and your DataDir. <br />
<pre>nano ~/skyfire/etc/(correctserver).conf</pre><br />
<br />
== Extractor and VMAPs ==<br />
<br />
If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP<BR> <br />
Extraction and assembly you can get a copy of them using your GIT client and download<BR> <br />
them from: https://codeberg.org/ProjectSkyfire/Community-Tools<BR><BR><BR><br />
<br />
Before doing any of these commands, follow the guide at <br />
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre><br />
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:<br />
<br />
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:<br />
<br />
<pre><br />
cd "Wow Directory"<br />
~/skyfire/bin/extractor<br />
~/skyfire/bin/vmap3extractor<br />
mv dbc ~/skyfire/bin/dbc<br />
mv maps ~/skyfire/bin/maps<br />
mkdir vmaps <br />
~/skyfire/bin/vmap3assembler<br />
mv vmaps ~/skyfire/bin/<br />
</pre><br />
<br />
== SkyFire Patcher ==<br />
<br />
The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.<br />
<br />
<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre><br />
<br />
Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.<br />
<br />
to install Mono simply, and correctly configured, please view: <br />
<pre>http://wiki.winehq.org/winetricks</pre><br />
to obtain specific versions/running hackery in your Wine bottle.<br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Linux<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29<br />
<br />
http://wiki.winehq.org/winetricks<br />
<br />
http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Debian_10)&diff=970Installation (Debian 10)2024-02-29T02:27:20Z<p>Admin: /* SkyFire Patcher */</p>
<hr />
<div>== Introduction ==<br />
<br />
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.<br />
<br />
== Prerequisites ==<br />
<br />
The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:<br />
<br />
Debian based distributions use these commands:<br />
<pre><br />
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<br />
</pre><br />
<br />
You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.<br />
<br />
'''Installing OpenSSL''' - You should check if "1.1.1j" or newer is the latest version installed.<br />
<br />
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 : <br />
<br />
<pre><br />
wget https://www.openssl.org/source/openssl-1.1.1j.tar.gz<br />
tar -xvf openssl-1.1.1j.tar.gz<br />
cd openssl-1.1.1j<br />
mkdir build<br />
cd build<br />
</pre><br />
<br />
Alternative 1 : Local installation <br />
<br />
<pre><br />
../config --prefix=/home/`echo $USER`/.sys shared<br />
make<br />
make install<br />
</pre><br />
<br />
Alternative 2 : Systemwide installation <br />
<br />
<pre><br />
../config shared<br />
make<br />
sudo make install<br />
</pre><br />
<br />
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.<br />
<br />
'''Installing MySQL'''<br />
Start by downloading and dpkg the package.<br />
<pre><br />
wget https://dev.mysql.com/get/mysql-apt-config_0.8.14-1_all.deb<br />
dpkg -i mysql-apt-config_0.8.14-1_all.deb<br />
</pre><br />
After following the configuration screen you want to apt-get update and install the libraries.<br />
<pre><br />
apt-get update<br />
apt-get install mysql-server mysql-client libmysqlclient-dev<br />
</pre><br />
<br />
== Compiling and Installing the SkyFire 5.4.8 ==<br />
<br />
Grab the latest version of SkyFire_548 using git:<br />
<br />
<pre><br />
git clone -b trunk https://github.com/ProjectSkyfire/SkyFire_548.git<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd SkyFire_548<br />
mkdir build && cd build<br />
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1<br />
make -j(#cores+1)<br />
make install<br />
</pre><br />
<br />
Parameter explanations <br />
<br />
<pre><br />
-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)<br />
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)<br />
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)<br />
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)<br />
<br />
-DSERVERS Build worldserver and authserver<br />
-DSCRIPTS Build core with scripts included<br />
-DTOOLS Build map/vmap extraction/assembler tools<br />
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts<br />
-DUSE_COREPCH Use precompiled headers when compiling servers<br />
-DUSE_SFMT Use SFMT as random numbergenerator<br />
-DWITH_WARNINGS Show all warnings during compile<br />
-DWITH_COREDEBUG Include additional debug-code in core<br />
-DWITH_SQL Copy SQL files during installation<br />
-DCONF_DIR Set configuration directory<br />
-DLIBSDIR Set library directory<br />
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)<br />
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)<br />
<br />
-DWITH_CXX_17_STD Use c++17 standard (advanced users only)<br />
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre><br />
<br />
----<br />
<br />
== Installing SkyFireDataBase (SFDB) ==<br />
<br />
Now we will set up the database framework for which SkyFire will be installed into:<br />
<br />
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''<br />
<br />
Replace the parts in <> to the correct administrative username, and associated password.<br />
Usually the administrative user is root, but you may have altered it.<br />
<br />
<br />
'''In the terminal window:'''<br />
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql<br />
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql <br />
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre><br />
<br />
----<br />
<br />
Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/<br />
<br><br />
The DB download contains an installer for Linux and Windows. Also a single Sql file.<br />
<br />
'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''<br />
<br />
(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)<br />
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre><br />
<br />
== Configuration ==<br />
<br />
Now move and edit the configuration files to run the server.<br />
<br />
<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf<br />
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre><br />
<br />
Edit both of these files to the correct Mysql user name, password, and your DataDir. <br />
<pre>nano ~/skyfire/etc/(correctserver).conf</pre><br />
<br />
== Extractor and VMAPs ==<br />
<br />
If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP<BR> <br />
Extraction and assembly you can get a copy of them using your GIT client and download<BR> <br />
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools<BR><BR><BR><br />
<br />
Before doing any of these commands, follow the guide at <br />
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre><br />
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:<br />
<br />
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:<br />
<br />
<pre><br />
cd "Wow Directory"<br />
~/skyfire/bin/extractor<br />
~/skyfire/bin/vmap3extractor<br />
mv dbc ~/skyfire/bin/dbc<br />
mv maps ~/skyfire/bin/maps<br />
mkdir vmaps <br />
~/skyfire/bin/vmap3assembler<br />
mv vmaps ~/skyfire/bin/<br />
</pre><br />
<br />
== SkyFire Patcher ==<br />
<br />
The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.<br />
<br />
<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre><br />
<br />
Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.<br />
<br />
to install Mono simply, and correctly configured, please view: <br />
<pre>http://wiki.winehq.org/winetricks</pre><br />
to obtain specific versions/running hackery in your Wine bottle.<br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Linux<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29<br />
<br />
http://wiki.winehq.org/winetricks<br />
<br />
http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Ubuntu_22.04_LTS)&diff=969Installation (Ubuntu 22.04 LTS)2024-02-29T02:26:31Z<p>Admin: /* SkyFire Patcher */</p>
<hr />
<div>== Introduction ==<br />
<br />
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.<br />
<br />
== Prerequisites ==<br />
<br />
The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:<br />
<br />
Debian based distributions use these commands:<br />
<pre><br />
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<br />
</pre><br />
<br />
You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.<br />
<br />
'''Installing OpenSSL''' - You should check if "1.1.0K" or newer is the latest version installed.<br />
<br />
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 : <br />
<br />
<pre><br />
wget https://www.openssl.org/source/openssl-1.1.1k.tar.gz<br />
tar -xvf openssl-1.1.1k.tar.gz<br />
cd openssl-1.1.1k<br />
mkdir build<br />
cd build<br />
</pre><br />
<br />
Alternative 1 : Local installation <br />
<br />
<pre><br />
../config --prefix=/home/`echo $USER`/.sys shared<br />
make<br />
make install<br />
</pre><br />
<br />
Alternative 2 : Systemwide installation <br />
<br />
<pre><br />
../config shared<br />
make<br />
sudo make install<br />
</pre><br />
<br />
'''Installing ACE''' - You should check if "6.3.3" or newer is the latest version installed. <br />
<br />
For cases where you want to run an even newer release of ACE 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://download.dre.vanderbilt.edu (feel free to use newer packages if you really feel like it). To build it from sourcecode,<br />
start by downloading and unzipping the source:<br />
<br />
<pre><br />
wget http://github.com/DOCGroup/ACE_TAO/releases/download/ACE%2BTAO-6_5_6/ACE-6.5.6.tar.gz<br />
tar xvzf ACE-6.5.6.tar.gz<br />
cd ACE_wrappers/<br />
mkdir build<br />
cd build</pre><br />
<br />
Here is where we compile ACE <br />
<br />
<pre><br />
../configure --disable-ssl<br />
make<br />
make install<br />
</pre><br />
<br />
<pre>In the event one has a 4-core processor, you would use "make -j5", minus quotations.<br />
Note: There is NO SPACE inbetween j and 5. It's all a single stroke.</pre><br />
<br />
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.<br />
<br />
'''Installing MySQL'''<br />
Start by downloading and dpkg the package.<br />
<pre><br />
wget https://dev.mysql.com/get/mysql-apt-config_0.8.12-1_all.deb<br />
dpkg -i mysql-apt-config_0.8.12-1_all.deb<br />
</pre><br />
After following the configuration screen you want to apt-get update and install the libraries.<br />
<pre><br />
apt-get update<br />
apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev<br />
</pre><br />
<br />
'''Installing GCC 9'''<br />
Start by adding ppa:ubuntu-toolchain-r/test to your repository list (<span style="color:red">BIONIC ONLY !!!</span>)<br />
<pre><br />
add-apt-repository ppa:ubuntu-toolchain-r/test -y<br />
apt-get update<br />
</pre><br />
Now we can install gcc-9 and g++-9.<br />
<pre><br />
apt-get install gcc-9 g++-9<br />
</pre><br />
<br />
Symbolic links cc and c++ are installed by default.<br />
We will install symbol links for gcc and g++, then link cc and c++ to gcc and g++ respectively.<br />
<pre><br />
update-alternatives --remove-all gcc <br />
update-alternatives --remove-all g++<br />
<br />
update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 10<br />
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 10<br />
<br />
update-alternatives --install /usr/bin/cc cc /usr/bin/gcc 10<br />
update-alternatives --set cc /usr/bin/gcc<br />
update-alternatives --install /usr/bin/c++ c++ /usr/bin/g++ 10<br />
update-alternatives --set c++ /usr/bin/g++<br />
</pre><br />
<br />
The last step is configuring the default commands for gcc, g++.<br />
<pre><br />
update-alternatives --config gcc<br />
update-alternatives --config g++<br />
</pre><br />
<br />
== Compiling and Installing the SkyFire 5.4.8 ==<br />
<br />
Grab the latest version of SkyFire_548 using git:<br />
<br />
<pre><br />
git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd SkyFire_548<br />
mkdir build && cd build<br />
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1<br />
make -j(#cores+1)<br />
make install<br />
</pre><br />
<br />
Parameter explanations <br />
<br />
<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)<br />
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)<br />
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)<br />
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)<br />
<br />
-DSERVERS Build worldserver and authserver<br />
-DSCRIPTS Build core with scripts included<br />
-DTOOLS Build map/vmap extraction/assembler tools<br />
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts<br />
-DUSE_COREPCH Use precompiled headers when compiling servers<br />
-DUSE_SFMT Use SFMT as random numbergenerator<br />
-DWITH_WARNINGS Show all warnings during compile<br />
-DWITH_COREDEBUG Include additional debug-code in core<br />
-DWITH_SQL Copy SQL files during installation<br />
-DCONF_DIR Set configuration directory<br />
-DLIBSDIR Set library directory<br />
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)<br />
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)<br />
<br />
-DWITH_CXX_17_STD Use c++17 standard (advanced users only)<br />
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre><br />
<br />
<br />
----<br />
<br />
== Installing SkyFireDataBase (SFDB) ==<br />
<br />
Now we will set up the database framework for which SkyFire will be installed into:<br />
<br />
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''<br />
<br />
Replace the parts in <> to the correct administrative username, and associated password.<br />
Usually the administrative user is root, but you may have altered it.<br />
<br />
<br />
'''In the terminal window:'''<br />
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql<br />
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql <br />
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre><br />
<br />
----<br />
<br />
Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/<br />
<br><br />
The DB download contains an installer for Linux and Windows. Also a single Sql file.<br />
<br />
'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''<br />
<br />
(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)<br />
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre><br />
<br />
== Configuration ==<br />
<br />
Now move and edit the configuration files to run the server.<br />
<br />
<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf<br />
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre><br />
<br />
Edit both of these files to the correct Mysql user name, password, and your DataDir. <br />
<pre>nano ~/skyfire/etc/(correctserver).conf</pre><br />
<br />
== Extractor and VMAPs ==<br />
<br />
If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP<BR> <br />
Extraction and assembly you can get a copy of them using your GIT client and download<BR> <br />
them from: https://codeberg.org/ProjectSkyfire/Community-Tools<BR><BR><BR><br />
<br />
Before doing any of these commands, follow the guide at <br />
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre><br />
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:<br />
<br />
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:<br />
<br />
<pre>cd "Wow Directory"<br />
~/skyfire/bin/extractor<br />
~/skyfire/bin/vmap3extractor<br />
mv dbc ~/skyfire/bin/dbc<br />
mv maps ~/skyfire/bin/maps<br />
mkdir vmaps <br />
~/skyfire/bin/vmap3assembler<br />
mv vmaps ~/skyfire/bin/<br />
</pre><br />
<br />
== SkyFire Patcher ==<br />
<br />
The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.<br />
<br />
<pre>git clone https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre><br />
<br />
Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.<br />
<br />
to install Mono simply, and correctly configured, please view: <br />
<pre>http://wiki.winehq.org/winetricks</pre><br />
to obtain specific versions/running hackery in your Wine bottle.<br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Linux<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29<br />
<br />
http://wiki.winehq.org/winetricks<br />
<br />
http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Ubuntu_22.04_LTS)&diff=968Installation (Ubuntu 22.04 LTS)2024-02-29T02:25:56Z<p>Admin: /* Extractor and VMAPs */</p>
<hr />
<div>== Introduction ==<br />
<br />
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.<br />
<br />
== Prerequisites ==<br />
<br />
The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:<br />
<br />
Debian based distributions use these commands:<br />
<pre><br />
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<br />
</pre><br />
<br />
You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.<br />
<br />
'''Installing OpenSSL''' - You should check if "1.1.0K" or newer is the latest version installed.<br />
<br />
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 : <br />
<br />
<pre><br />
wget https://www.openssl.org/source/openssl-1.1.1k.tar.gz<br />
tar -xvf openssl-1.1.1k.tar.gz<br />
cd openssl-1.1.1k<br />
mkdir build<br />
cd build<br />
</pre><br />
<br />
Alternative 1 : Local installation <br />
<br />
<pre><br />
../config --prefix=/home/`echo $USER`/.sys shared<br />
make<br />
make install<br />
</pre><br />
<br />
Alternative 2 : Systemwide installation <br />
<br />
<pre><br />
../config shared<br />
make<br />
sudo make install<br />
</pre><br />
<br />
'''Installing ACE''' - You should check if "6.3.3" or newer is the latest version installed. <br />
<br />
For cases where you want to run an even newer release of ACE 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://download.dre.vanderbilt.edu (feel free to use newer packages if you really feel like it). To build it from sourcecode,<br />
start by downloading and unzipping the source:<br />
<br />
<pre><br />
wget http://github.com/DOCGroup/ACE_TAO/releases/download/ACE%2BTAO-6_5_6/ACE-6.5.6.tar.gz<br />
tar xvzf ACE-6.5.6.tar.gz<br />
cd ACE_wrappers/<br />
mkdir build<br />
cd build</pre><br />
<br />
Here is where we compile ACE <br />
<br />
<pre><br />
../configure --disable-ssl<br />
make<br />
make install<br />
</pre><br />
<br />
<pre>In the event one has a 4-core processor, you would use "make -j5", minus quotations.<br />
Note: There is NO SPACE inbetween j and 5. It's all a single stroke.</pre><br />
<br />
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.<br />
<br />
'''Installing MySQL'''<br />
Start by downloading and dpkg the package.<br />
<pre><br />
wget https://dev.mysql.com/get/mysql-apt-config_0.8.12-1_all.deb<br />
dpkg -i mysql-apt-config_0.8.12-1_all.deb<br />
</pre><br />
After following the configuration screen you want to apt-get update and install the libraries.<br />
<pre><br />
apt-get update<br />
apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev<br />
</pre><br />
<br />
'''Installing GCC 9'''<br />
Start by adding ppa:ubuntu-toolchain-r/test to your repository list (<span style="color:red">BIONIC ONLY !!!</span>)<br />
<pre><br />
add-apt-repository ppa:ubuntu-toolchain-r/test -y<br />
apt-get update<br />
</pre><br />
Now we can install gcc-9 and g++-9.<br />
<pre><br />
apt-get install gcc-9 g++-9<br />
</pre><br />
<br />
Symbolic links cc and c++ are installed by default.<br />
We will install symbol links for gcc and g++, then link cc and c++ to gcc and g++ respectively.<br />
<pre><br />
update-alternatives --remove-all gcc <br />
update-alternatives --remove-all g++<br />
<br />
update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 10<br />
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 10<br />
<br />
update-alternatives --install /usr/bin/cc cc /usr/bin/gcc 10<br />
update-alternatives --set cc /usr/bin/gcc<br />
update-alternatives --install /usr/bin/c++ c++ /usr/bin/g++ 10<br />
update-alternatives --set c++ /usr/bin/g++<br />
</pre><br />
<br />
The last step is configuring the default commands for gcc, g++.<br />
<pre><br />
update-alternatives --config gcc<br />
update-alternatives --config g++<br />
</pre><br />
<br />
== Compiling and Installing the SkyFire 5.4.8 ==<br />
<br />
Grab the latest version of SkyFire_548 using git:<br />
<br />
<pre><br />
git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd SkyFire_548<br />
mkdir build && cd build<br />
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1<br />
make -j(#cores+1)<br />
make install<br />
</pre><br />
<br />
Parameter explanations <br />
<br />
<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)<br />
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)<br />
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)<br />
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)<br />
<br />
-DSERVERS Build worldserver and authserver<br />
-DSCRIPTS Build core with scripts included<br />
-DTOOLS Build map/vmap extraction/assembler tools<br />
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts<br />
-DUSE_COREPCH Use precompiled headers when compiling servers<br />
-DUSE_SFMT Use SFMT as random numbergenerator<br />
-DWITH_WARNINGS Show all warnings during compile<br />
-DWITH_COREDEBUG Include additional debug-code in core<br />
-DWITH_SQL Copy SQL files during installation<br />
-DCONF_DIR Set configuration directory<br />
-DLIBSDIR Set library directory<br />
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)<br />
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)<br />
<br />
-DWITH_CXX_17_STD Use c++17 standard (advanced users only)<br />
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre><br />
<br />
<br />
----<br />
<br />
== Installing SkyFireDataBase (SFDB) ==<br />
<br />
Now we will set up the database framework for which SkyFire will be installed into:<br />
<br />
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''<br />
<br />
Replace the parts in <> to the correct administrative username, and associated password.<br />
Usually the administrative user is root, but you may have altered it.<br />
<br />
<br />
'''In the terminal window:'''<br />
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql<br />
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql <br />
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre><br />
<br />
----<br />
<br />
Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/<br />
<br><br />
The DB download contains an installer for Linux and Windows. Also a single Sql file.<br />
<br />
'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''<br />
<br />
(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)<br />
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre><br />
<br />
== Configuration ==<br />
<br />
Now move and edit the configuration files to run the server.<br />
<br />
<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf<br />
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre><br />
<br />
Edit both of these files to the correct Mysql user name, password, and your DataDir. <br />
<pre>nano ~/skyfire/etc/(correctserver).conf</pre><br />
<br />
== Extractor and VMAPs ==<br />
<br />
If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP<BR> <br />
Extraction and assembly you can get a copy of them using your GIT client and download<BR> <br />
them from: https://codeberg.org/ProjectSkyfire/Community-Tools<BR><BR><BR><br />
<br />
Before doing any of these commands, follow the guide at <br />
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre><br />
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:<br />
<br />
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:<br />
<br />
<pre>cd "Wow Directory"<br />
~/skyfire/bin/extractor<br />
~/skyfire/bin/vmap3extractor<br />
mv dbc ~/skyfire/bin/dbc<br />
mv maps ~/skyfire/bin/maps<br />
mkdir vmaps <br />
~/skyfire/bin/vmap3assembler<br />
mv vmaps ~/skyfire/bin/<br />
</pre><br />
<br />
== SkyFire Patcher ==<br />
<br />
The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.<br />
<br />
<pre>git clone git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre><br />
<br />
Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.<br />
<br />
to install Mono simply, and correctly configured, please view: <br />
<pre>http://wiki.winehq.org/winetricks</pre><br />
to obtain specific versions/running hackery in your Wine bottle.<br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Linux<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29<br />
<br />
http://wiki.winehq.org/winetricks<br />
<br />
http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Ubuntu_22.04_LTS)&diff=967Installation (Ubuntu 22.04 LTS)2024-02-29T02:25:08Z<p>Admin: /* Compiling and Installing the SkyFire 5.4.8 */</p>
<hr />
<div>== Introduction ==<br />
<br />
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.<br />
<br />
== Prerequisites ==<br />
<br />
The compilation of SkyFire_548 and the setup of SFDB will require certain packages to be installed. In Ubuntu use the following command:<br />
<br />
Debian based distributions use these commands:<br />
<pre><br />
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<br />
</pre><br />
<br />
You may also want to install phpmyadmin and/or Apache. Do not forget the user and password for the Mysql root user.<br />
<br />
'''Installing OpenSSL''' - You should check if "1.1.0K" or newer is the latest version installed.<br />
<br />
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 : <br />
<br />
<pre><br />
wget https://www.openssl.org/source/openssl-1.1.1k.tar.gz<br />
tar -xvf openssl-1.1.1k.tar.gz<br />
cd openssl-1.1.1k<br />
mkdir build<br />
cd build<br />
</pre><br />
<br />
Alternative 1 : Local installation <br />
<br />
<pre><br />
../config --prefix=/home/`echo $USER`/.sys shared<br />
make<br />
make install<br />
</pre><br />
<br />
Alternative 2 : Systemwide installation <br />
<br />
<pre><br />
../config shared<br />
make<br />
sudo make install<br />
</pre><br />
<br />
'''Installing ACE''' - You should check if "6.3.3" or newer is the latest version installed. <br />
<br />
For cases where you want to run an even newer release of ACE 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://download.dre.vanderbilt.edu (feel free to use newer packages if you really feel like it). To build it from sourcecode,<br />
start by downloading and unzipping the source:<br />
<br />
<pre><br />
wget http://github.com/DOCGroup/ACE_TAO/releases/download/ACE%2BTAO-6_5_6/ACE-6.5.6.tar.gz<br />
tar xvzf ACE-6.5.6.tar.gz<br />
cd ACE_wrappers/<br />
mkdir build<br />
cd build</pre><br />
<br />
Here is where we compile ACE <br />
<br />
<pre><br />
../configure --disable-ssl<br />
make<br />
make install<br />
</pre><br />
<br />
<pre>In the event one has a 4-core processor, you would use "make -j5", minus quotations.<br />
Note: There is NO SPACE inbetween j and 5. It's all a single stroke.</pre><br />
<br />
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.<br />
<br />
'''Installing MySQL'''<br />
Start by downloading and dpkg the package.<br />
<pre><br />
wget https://dev.mysql.com/get/mysql-apt-config_0.8.12-1_all.deb<br />
dpkg -i mysql-apt-config_0.8.12-1_all.deb<br />
</pre><br />
After following the configuration screen you want to apt-get update and install the libraries.<br />
<pre><br />
apt-get update<br />
apt-get install mysql-server mysql-client libmysqlclient-dev libmysql++-dev<br />
</pre><br />
<br />
'''Installing GCC 9'''<br />
Start by adding ppa:ubuntu-toolchain-r/test to your repository list (<span style="color:red">BIONIC ONLY !!!</span>)<br />
<pre><br />
add-apt-repository ppa:ubuntu-toolchain-r/test -y<br />
apt-get update<br />
</pre><br />
Now we can install gcc-9 and g++-9.<br />
<pre><br />
apt-get install gcc-9 g++-9<br />
</pre><br />
<br />
Symbolic links cc and c++ are installed by default.<br />
We will install symbol links for gcc and g++, then link cc and c++ to gcc and g++ respectively.<br />
<pre><br />
update-alternatives --remove-all gcc <br />
update-alternatives --remove-all g++<br />
<br />
update-alternatives --install /usr/bin/gcc gcc /usr/bin/gcc-9 10<br />
update-alternatives --install /usr/bin/g++ g++ /usr/bin/g++-9 10<br />
<br />
update-alternatives --install /usr/bin/cc cc /usr/bin/gcc 10<br />
update-alternatives --set cc /usr/bin/gcc<br />
update-alternatives --install /usr/bin/c++ c++ /usr/bin/g++ 10<br />
update-alternatives --set c++ /usr/bin/g++<br />
</pre><br />
<br />
The last step is configuring the default commands for gcc, g++.<br />
<pre><br />
update-alternatives --config gcc<br />
update-alternatives --config g++<br />
</pre><br />
<br />
== Compiling and Installing the SkyFire 5.4.8 ==<br />
<br />
Grab the latest version of SkyFire_548 using git:<br />
<br />
<pre><br />
git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git<br />
</pre><br />
<br />
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.<br />
<br />
<pre><br />
cd SkyFire_548<br />
mkdir build && cd build<br />
cmake ../ -DCMAKE_INSTALL_PREFIX=$HOME/skyfire-server/ -DTOOLS=1<br />
make -j(#cores+1)<br />
make install<br />
</pre><br />
<br />
Parameter explanations <br />
<br />
<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)<br />
-DACE_INCLUDE_DIR=<path to ACE includes/headers> (path to the libACE include directory - do not use if you have ACE installed systemwide)<br />
-DOPENSSL_LIBRARIES=<path to OpenSSL library> (path to your OpenSSL library - do not use if you have OpenSSL installed systemwide)<br />
-DOPENSSL_INCLUDE_DIR=<path to OpenSSL includes> (path to your OpenSSL includes directory - do not use if you have OpenSSL installed systemwide)<br />
<br />
-DSERVERS Build worldserver and authserver<br />
-DSCRIPTS Build core with scripts included<br />
-DTOOLS Build map/vmap extraction/assembler tools<br />
-DUSE_SCRIPTPCH Use precompiled headers when compiling scripts<br />
-DUSE_COREPCH Use precompiled headers when compiling servers<br />
-DUSE_SFMT Use SFMT as random numbergenerator<br />
-DWITH_WARNINGS Show all warnings during compile<br />
-DWITH_COREDEBUG Include additional debug-code in core<br />
-DWITH_SQL Copy SQL files during installation<br />
-DCONF_DIR Set configuration directory<br />
-DLIBSDIR Set library directory<br />
-DCMAKE_C_FLAGS Set C_FLAGS for compile (advanced users only)<br />
-DCMAKE_CXX_FLAGS Set CXX_FLAGS for compile (advanced users only)<br />
<br />
-DWITH_CXX_17_STD Use c++17 standard (advanced users only)<br />
-DWITH_CXX_DRAFT_STD Use c++ draft standard (advanced users only)</pre><br />
<br />
<br />
----<br />
<br />
== Installing SkyFireDataBase (SFDB) ==<br />
<br />
Now we will set up the database framework for which SkyFire will be installed into:<br />
<br />
'''It is assumed that you cloned SkyFire_548 into your home directory ~/'''<br />
<br />
Replace the parts in <> to the correct administrative username, and associated password.<br />
Usually the administrative user is root, but you may have altered it.<br />
<br />
<br />
'''In the terminal window:'''<br />
<pre>mysql -u <mysql_root> -p < ~/SkyFire_548/sql/create/create_mysql.sql<br />
mysql -u <mysql_root> -p auth < ~/SkyFire_548/sql/base/auth/auth.sql <br />
mysql -u <mysql_root> -p characters < ~/SkyFire_548/sql/base/character/character.sql</pre><br />
<br />
----<br />
<br />
Grab the latest version of SkyFireDB on our forum. http://www.projectskyfire.org/index.php?/files/<br />
<br><br />
The DB download contains an installer for Linux and Windows. Also a single Sql file.<br />
<br />
'''!!!You will also need to manually run any sql's found in the cores sql folder .../sql/updates/world and .../sql/updates/char!!!'''<br />
<br />
(If you are doing this for more than local use you will also need to change a database entry using this mysql command.)<br />
<pre>update auth.realmlist set adress = "YOUR IP HERE" where id = 1;</pre><br />
<br />
== Configuration ==<br />
<br />
Now move and edit the configuration files to run the server.<br />
<br />
<pre>mv ~/skyfire/etc/worldserver.conf.dist ~/skyfire/etc/worldserver.conf<br />
mv ~/skyfire/etc/authserver.conf.dist ~/skyfire/etc/authserver.conf</pre><br />
<br />
Edit both of these files to the correct Mysql user name, password, and your DataDir. <br />
<pre>nano ~/skyfire/etc/(correctserver).conf</pre><br />
<br />
== Extractor and VMAPs ==<br />
<br />
If you need a Windows compiled copy of the DBC Extractor and the tools for the VMAP<BR> <br />
Extraction and assembly you can get a copy of them using your GIT client and download<BR> <br />
them from: https://github.com/ProjectSkyfire/SkyFire-Community-Tools<BR><BR><BR><br />
<br />
Before doing any of these commands, follow the guide at <br />
<pre>http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549</pre><br />
to obtain a working installation of the latest WoW 5.4.8 client, then proceed:<br />
<br />
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:<br />
<br />
<pre>cd "Wow Directory"<br />
~/skyfire/bin/extractor<br />
~/skyfire/bin/vmap3extractor<br />
mv dbc ~/skyfire/bin/dbc<br />
mv maps ~/skyfire/bin/maps<br />
mkdir vmaps <br />
~/skyfire/bin/vmap3assembler<br />
mv vmaps ~/skyfire/bin/<br />
</pre><br />
<br />
== SkyFire Patcher ==<br />
<br />
The client will need to be patched before it can properly connect to the server. Acquire the patcher in the Community Tools repository.<br />
<br />
<pre>git clone git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre><br />
<br />
Install Mono in Wine or Crossover Office and run the patcher to modify your WoW.exe file.<br />
<br />
to install Mono simply, and correctly configured, please view: <br />
<pre>http://wiki.winehq.org/winetricks</pre><br />
to obtain specific versions/running hackery in your Wine bottle.<br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Linux<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Linux%29<br />
<br />
http://wiki.winehq.org/winetricks<br />
<br />
http://appdb.winehq.org/objectManager.php?sClass=version&iId=20549<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Windows_5xx)&diff=966Installation (Windows 5xx)2024-02-29T02:23:48Z<p>Admin: /* Patching */</p>
<hr />
<div>{| align="right"<br />
<br />
|-<br />
<br />
| __TOC__<br />
<br />
|}<br />
<br />
<br />
== INTRODUCTION ==<br />
<p>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.</p><br />
<p>After the first few times everyone gets used to the procedure and never needs to look at this guide ever again.</p><br><br />
<br />
=== Software Required ===<br />
<p><ol><br />
<li>[http://git-scm.com/download Git]<br>You can also use TortoiseGit that is more compatible with Windows (8).<br>[http://code.google.com/p/tortoisegit/ TortoiseGIT]</li><br><br />
<br />
<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].<br />
</li><br><br />
<br />
<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]<br />
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.<br />
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.<br />
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li><br><br />
<br />
<li>[http://www.cmake.org/cmake/resources/software.html CMake]<br />
CMake Version 3.16.3 or greater</li><br><br />
<br />
<li>MySQL Server<br />
*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]<br />
*It's recommended that your MySQL server and the MySQL header source versions match.<br />
*Current SkyFire core MySQL header version: 8.0.X<br />
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.<br />
*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><br><br />
<br />
<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><br><br />
<br />
<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]<br />
*'''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><br />
</ol><br />
<br></p><br />
<br />
=== Software Recommended ===<br />
<p>git command help:<ul><br />
<li>[http://code.google.com/p/gitextensions/ gitextensions]<br />
*most popular with the community</li><br />
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]<br />
*Makes pulling and cloning sources easier with right mouse clicks.<br />
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.<br />
*Note: You still need to install [http://git-scm.com/download Git] for this to work.<br />
</li><br />
</ul><br />
<br></p><br />
<br />
=== Microsoft Visual Studio 2019 ===<br />
<p><br />
Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].<br />
<br><br />
Please note Visual Studio 2022 Preview is not supported.<br />
<br></p><br />
<br />
== PULLING AND COMPILING THE SOURCE ==<br />
<p><br />
*'''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.)'''<br />
</p><br />
<br />
=== Pulling the Source ===<br />
<p><ol><br />
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li><br />
<li>Right-click on the directory and click on '''Git Bash Here'''</li><br />
<li>Fill in the data as follows:</li><br><br />
<pre>git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre><br />
</br><br />
<br />
<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><br />
</ol></p><br />
<br />
=== Configuring and Generating Visual C++ solutions with CMake ===<br />
<p><ol><br />
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".<br />
<li>Open CMake. (cmake-gui)</li><br />
<li>Fill in the data as follows:</li><br><br />
<br />
Where the the source code: <br />
<pre>C:\SkyFire_548</pre><br />
<br />
Where to build the binaries: <br />
<pre>C:\SkyFire_548\build</pre><br />
<br><br />
<br />
<li>Click '''Configure'''.</li><br />
<li>It should ask you if you want to create the directory, '''click yes'''.</li><br />
<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'''.<br />
*NOTE: You MUST select the appropriate compiler!<br />
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li><br />
<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.)<br><br />
Make sure these are the ones selected:<br />
<pre><br />
SCRIPTS<br />
SERVERS<br />
TOOLS<br />
USE_COREPCH<br />
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)<br />
USE_SCRIPTPCH<br />
</pre><br />
<br />
*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''<br />
*'''(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><br />
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li><br />
<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><br />
<li>When done, it'll state "Generating done"</li><br />
<li>Close CMake and continue below with '''Compiling the Source'''.<br />
</ol></p><br />
<br />
=== Compiling the Source ===<br />
<p><ol><br />
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li><br />
<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'''.<br><br />
<br />
<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><br />
*You will find the following message once the compilation has finished successfully: <br />
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========<br />
</pre><br />
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder: <br />
<pre><br />
ace.dll<br />
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.<br />
libeay32.dll -> Needs to copy to the release folder.<br />
libssl-1_1-x64.dll -> Needs to copy to the release folder.<br />
ssleay32.dll -> Needs to copy to the release folder.<br />
authserver.conf.dist<br />
authserver.exe<br />
libmysql.dll (From your MySQL 8 install bin folder.)*<br />
worldserver.conf.dist<br />
worldserver.exe<br />
</pre><br />
<br><br />
<br />
<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from.<br>For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now.<br></li><br />
<br />
<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf<br>These are your config files. Go through and edit each one to match your prefered settings.</li><br><br />
<br />
<li>You will also need '''libmysql.dll''' to run your server.<br />
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib'''<br>Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li><br><br />
</ol></p><br />
<br />
=== Keeping the code up to date ===<br />
<p>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.<br />
<br />
<ol><br />
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li><br />
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li><br />
<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><br />
</ol><br />
<br />
*Now you can repeat the compiling procedure above.<br><br />
*<u>'''And remember to clean your build everytime!'''</u><br />
<br></p><br />
<br />
== IMPORTING THE DATABASE ==<br />
<p><br />
*'''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.'''<br></p><br />
<br />
=== Creating Auth, Characters and World Databases ===<br />
<p>Using your chosen SQL Client, create the three Databases.<br />
<ol><br />
<li>Auth</li><br />
<li>Characters</li><br />
<li>World</li><br />
</ol><br />
*Doing this may prevent importing problems later.<br />
</p><br />
<br />
==== Importing Auth and Characters Databases ====<br />
<p>Using your chosen SQL Client,<br />
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\<u>sql\base</u>''' to their respective places in your MySQL database.</p><br />
<br />
<br />
==== Importing World Database ====<br />
<p><ol><br />
----<br />
<br />
Grab the latest version of SkyFireDB_5xx from our release repository:<br />
<br />
<pre>https://github.com/ProjectSkyfire/database/releases</pre><br />
<br />
Import the DB into your world table. Will update this method shortly</p><br />
<br />
==== Importing Important Database Structure Updates ====<br />
<ol><br />
<li>Go into your '''C:\SkyFireEMU\core\<u>sql\updates</u>''' directory.</li><br><br />
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li><br />
</ol><br />
<br />
==== Importing World Database Updates ====<br />
<ol><br />
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li><br />
<li>Follow the dialog and enter in your info like you did before.</li><br />
<li>Press '''U''' to import the World Database updates when asked.</li><br />
<li>Select the correct changesets needed.</li><br />
</ol><br />
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''<br />
<br />
=== Auth Database Accounts and Passwords ===<br />
It is '''highly advised''' you change the passwords or delete these accounts. <br />
*'''NOTE''': These may not exist.<br />
<pre>User: Administrator<br />
Pass: Administrator<br />
<br />
User: Moderator<br />
Pass: Moderator<br />
<br />
User: Developer<br />
Pass: Developer<br />
<br />
User: Gamemaster<br />
Pass: Gamemaster<br />
<br />
User: Player<br />
Pass: Player</pre><br />
<br />
==== Changing passwords ====<br />
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><br />
<br />
==== Deleting accounts ====<br />
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre><br />
<br />
==== Making new accounts ====<br />
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre><br />
<br />
==== Raising an account's access/GM level ====<br />
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.<br />
*id=your account id found under '''accounts'''<br />
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator<br />
**You can only add Administrator (gmlevel 4) with your SQL client<br />
*RealmID is usually 1 or -1 for all realms<br />
<br><br />
<br />
== DBC, MAPS, VMAPS, and MMAPS ==<br />
<br />
*'''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!'''<br />
*We will, however, help you through the extraction process with step-by-step instructions<br />
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''<br />
<ol></li><br><br />
<br />
<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)<br />
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:<br />
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "<u>CT</u>"''', NOT "<u>LK</u>".<br />
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''<br />
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''<br />
**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><br><br />
<br />
<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><br><br />
<br />
<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).<br />
*Locate file named '''"libmysql.dll"'''.<br />
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).<br />
</ol><br />
<br><br />
<br />
=== Manual Extraction Method ===<br />
<ol><br />
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li><br />
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li><br><br />
<u><b>Dbc and Maps:</b></u><br />
<li>In your command prompt type '''extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li><br><br />
<u><b>VMaps:</b></u><br />
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory named '''Buildings'''.</li><br />
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li><br />
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory, '''vmaps'''.</li><br><br />
<u><b>MMaps:</b></u><br />
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents <u>ONLY</u>'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li><br />
<li>You may now Delete the empty '''buildings''' folder.</li><br />
<li>Create a new folder named '''mmaps'''.</li><br />
<li>Now execute the '''mmaps_generator.exe'''.<br />
*'''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><br />
</ol><br />
<br><br />
<br />
=== Completion (For Both Methods) === <br />
<ol><br />
<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><br />
<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><br />
</ol><br />
<br><br />
<br />
== SKYFIRE WOW.EXE PATCHER ==<br />
Your Wow.exe client will be needed to be patched before you can properly connect to your server.<br />
<br />
<br />
=== Patching ===<br />
Pull the latest version of SkyFire-Community-Tools from<br />
<pre>https://codeberg.org/ProjectSkyfire/Community-Tools.git</pre><br />
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.<br />
<br><br />
<br />
=== Pre-Patched Method (Easy Method)===<br />
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.<br />
<br><br />
<br />
=== Manuel Compile Method (Not really needed but will keep this for now)===<br />
<br />
*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''<br />
*You will not need CMake for this.<br />
<ol><br />
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li><br />
<li>Select "Release"</li><br />
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li><br />
<li>Clean</li><br />
<li>Build. (This should take less than a minute.)</li><br />
</ol><br />
<br />
*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><br />
<br />
<br />
<br />
*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder.<br>(You can delete the rest if you like.)<br />
<br />
<br />
==== Keeping the code up to date ====<br />
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing.<br><br />
<br />
=== Moving and Patching ===<br />
<ol><br />
<li>Move SkyFirePatcher.exe into your Wow directory.<br>(Usually something like C:\Program Files (x86)\World of Warcraft)</li><br><br />
<br />
<li>Now run SkyFirePatcher.exe and a dialog should pop up with:<br />
<pre>Loading Wow.exe into memory...<br />
Success!<br />
Ready to patch Wow.exe.</pre><br />
And "Status: Ready!" at the bottom.</li><br><br />
<br />
<li>Click "Patch" at the bottom to patch your Wow.exe<br><br />
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li><br><br />
</ol><br />
=== Play! ===<br />
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.<br />
<br><br />
<br><br />
<br><br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Win<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]<br />
<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Windows_5xx)&diff=965Installation (Windows 5xx)2024-02-29T02:22:19Z<p>Admin: /* Pulling the Source */</p>
<hr />
<div>{| align="right"<br />
<br />
|-<br />
<br />
| __TOC__<br />
<br />
|}<br />
<br />
<br />
== INTRODUCTION ==<br />
<p>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.</p><br />
<p>After the first few times everyone gets used to the procedure and never needs to look at this guide ever again.</p><br><br />
<br />
=== Software Required ===<br />
<p><ol><br />
<li>[http://git-scm.com/download Git]<br>You can also use TortoiseGit that is more compatible with Windows (8).<br>[http://code.google.com/p/tortoisegit/ TortoiseGIT]</li><br><br />
<br />
<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].<br />
</li><br><br />
<br />
<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]<br />
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.<br />
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.<br />
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li><br><br />
<br />
<li>[http://www.cmake.org/cmake/resources/software.html CMake]<br />
CMake Version 3.16.3 or greater</li><br><br />
<br />
<li>MySQL Server<br />
*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]<br />
*It's recommended that your MySQL server and the MySQL header source versions match.<br />
*Current SkyFire core MySQL header version: 8.0.X<br />
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.<br />
*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><br><br />
<br />
<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><br><br />
<br />
<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]<br />
*'''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><br />
</ol><br />
<br></p><br />
<br />
=== Software Recommended ===<br />
<p>git command help:<ul><br />
<li>[http://code.google.com/p/gitextensions/ gitextensions]<br />
*most popular with the community</li><br />
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]<br />
*Makes pulling and cloning sources easier with right mouse clicks.<br />
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.<br />
*Note: You still need to install [http://git-scm.com/download Git] for this to work.<br />
</li><br />
</ul><br />
<br></p><br />
<br />
=== Microsoft Visual Studio 2019 ===<br />
<p><br />
Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].<br />
<br><br />
Please note Visual Studio 2022 Preview is not supported.<br />
<br></p><br />
<br />
== PULLING AND COMPILING THE SOURCE ==<br />
<p><br />
*'''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.)'''<br />
</p><br />
<br />
=== Pulling the Source ===<br />
<p><ol><br />
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li><br />
<li>Right-click on the directory and click on '''Git Bash Here'''</li><br />
<li>Fill in the data as follows:</li><br><br />
<pre>git clone -b trunk https://codeberg.org/ProjectSkyfire/SkyFire_548.git</pre><br />
</br><br />
<br />
<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><br />
</ol></p><br />
<br />
=== Configuring and Generating Visual C++ solutions with CMake ===<br />
<p><ol><br />
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".<br />
<li>Open CMake. (cmake-gui)</li><br />
<li>Fill in the data as follows:</li><br><br />
<br />
Where the the source code: <br />
<pre>C:\SkyFire_548</pre><br />
<br />
Where to build the binaries: <br />
<pre>C:\SkyFire_548\build</pre><br />
<br><br />
<br />
<li>Click '''Configure'''.</li><br />
<li>It should ask you if you want to create the directory, '''click yes'''.</li><br />
<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'''.<br />
*NOTE: You MUST select the appropriate compiler!<br />
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li><br />
<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.)<br><br />
Make sure these are the ones selected:<br />
<pre><br />
SCRIPTS<br />
SERVERS<br />
TOOLS<br />
USE_COREPCH<br />
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)<br />
USE_SCRIPTPCH<br />
</pre><br />
<br />
*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''<br />
*'''(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><br />
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li><br />
<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><br />
<li>When done, it'll state "Generating done"</li><br />
<li>Close CMake and continue below with '''Compiling the Source'''.<br />
</ol></p><br />
<br />
=== Compiling the Source ===<br />
<p><ol><br />
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li><br />
<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'''.<br><br />
<br />
<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><br />
*You will find the following message once the compilation has finished successfully: <br />
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========<br />
</pre><br />
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder: <br />
<pre><br />
ace.dll<br />
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.<br />
libeay32.dll -> Needs to copy to the release folder.<br />
libssl-1_1-x64.dll -> Needs to copy to the release folder.<br />
ssleay32.dll -> Needs to copy to the release folder.<br />
authserver.conf.dist<br />
authserver.exe<br />
libmysql.dll (From your MySQL 8 install bin folder.)*<br />
worldserver.conf.dist<br />
worldserver.exe<br />
</pre><br />
<br><br />
<br />
<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from.<br>For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now.<br></li><br />
<br />
<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf<br>These are your config files. Go through and edit each one to match your prefered settings.</li><br><br />
<br />
<li>You will also need '''libmysql.dll''' to run your server.<br />
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib'''<br>Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li><br><br />
</ol></p><br />
<br />
=== Keeping the code up to date ===<br />
<p>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.<br />
<br />
<ol><br />
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li><br />
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li><br />
<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><br />
</ol><br />
<br />
*Now you can repeat the compiling procedure above.<br><br />
*<u>'''And remember to clean your build everytime!'''</u><br />
<br></p><br />
<br />
== IMPORTING THE DATABASE ==<br />
<p><br />
*'''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.'''<br></p><br />
<br />
=== Creating Auth, Characters and World Databases ===<br />
<p>Using your chosen SQL Client, create the three Databases.<br />
<ol><br />
<li>Auth</li><br />
<li>Characters</li><br />
<li>World</li><br />
</ol><br />
*Doing this may prevent importing problems later.<br />
</p><br />
<br />
==== Importing Auth and Characters Databases ====<br />
<p>Using your chosen SQL Client,<br />
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\<u>sql\base</u>''' to their respective places in your MySQL database.</p><br />
<br />
<br />
==== Importing World Database ====<br />
<p><ol><br />
----<br />
<br />
Grab the latest version of SkyFireDB_5xx from our release repository:<br />
<br />
<pre>https://github.com/ProjectSkyfire/database/releases</pre><br />
<br />
Import the DB into your world table. Will update this method shortly</p><br />
<br />
==== Importing Important Database Structure Updates ====<br />
<ol><br />
<li>Go into your '''C:\SkyFireEMU\core\<u>sql\updates</u>''' directory.</li><br><br />
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li><br />
</ol><br />
<br />
==== Importing World Database Updates ====<br />
<ol><br />
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li><br />
<li>Follow the dialog and enter in your info like you did before.</li><br />
<li>Press '''U''' to import the World Database updates when asked.</li><br />
<li>Select the correct changesets needed.</li><br />
</ol><br />
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''<br />
<br />
=== Auth Database Accounts and Passwords ===<br />
It is '''highly advised''' you change the passwords or delete these accounts. <br />
*'''NOTE''': These may not exist.<br />
<pre>User: Administrator<br />
Pass: Administrator<br />
<br />
User: Moderator<br />
Pass: Moderator<br />
<br />
User: Developer<br />
Pass: Developer<br />
<br />
User: Gamemaster<br />
Pass: Gamemaster<br />
<br />
User: Player<br />
Pass: Player</pre><br />
<br />
==== Changing passwords ====<br />
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><br />
<br />
==== Deleting accounts ====<br />
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre><br />
<br />
==== Making new accounts ====<br />
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre><br />
<br />
==== Raising an account's access/GM level ====<br />
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.<br />
*id=your account id found under '''accounts'''<br />
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator<br />
**You can only add Administrator (gmlevel 4) with your SQL client<br />
*RealmID is usually 1 or -1 for all realms<br />
<br><br />
<br />
== DBC, MAPS, VMAPS, and MMAPS ==<br />
<br />
*'''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!'''<br />
*We will, however, help you through the extraction process with step-by-step instructions<br />
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''<br />
<ol></li><br><br />
<br />
<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)<br />
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:<br />
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "<u>CT</u>"''', NOT "<u>LK</u>".<br />
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''<br />
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''<br />
**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><br><br />
<br />
<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><br><br />
<br />
<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).<br />
*Locate file named '''"libmysql.dll"'''.<br />
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).<br />
</ol><br />
<br><br />
<br />
=== Manual Extraction Method ===<br />
<ol><br />
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li><br />
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li><br><br />
<u><b>Dbc and Maps:</b></u><br />
<li>In your command prompt type '''extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li><br><br />
<u><b>VMaps:</b></u><br />
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory named '''Buildings'''.</li><br />
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li><br />
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory, '''vmaps'''.</li><br><br />
<u><b>MMaps:</b></u><br />
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents <u>ONLY</u>'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li><br />
<li>You may now Delete the empty '''buildings''' folder.</li><br />
<li>Create a new folder named '''mmaps'''.</li><br />
<li>Now execute the '''mmaps_generator.exe'''.<br />
*'''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><br />
</ol><br />
<br><br />
<br />
=== Completion (For Both Methods) === <br />
<ol><br />
<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><br />
<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><br />
</ol><br />
<br><br />
<br />
== SKYFIRE WOW.EXE PATCHER ==<br />
Your Wow.exe client will be needed to be patched before you can properly connect to your server.<br />
<br />
<br />
=== Patching ===<br />
Pull the latest version of SkyFire-Community-Tools from<br />
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre><br />
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.<br />
<br><br />
<br />
=== Pre-Patched Method (Easy Method)===<br />
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.<br />
<br><br />
<br />
=== Manuel Compile Method (Not really needed but will keep this for now)===<br />
<br />
*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''<br />
*You will not need CMake for this.<br />
<ol><br />
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li><br />
<li>Select "Release"</li><br />
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li><br />
<li>Clean</li><br />
<li>Build. (This should take less than a minute.)</li><br />
</ol><br />
<br />
*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><br />
<br />
<br />
<br />
*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder.<br>(You can delete the rest if you like.)<br />
<br />
<br />
==== Keeping the code up to date ====<br />
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing.<br><br />
<br />
=== Moving and Patching ===<br />
<ol><br />
<li>Move SkyFirePatcher.exe into your Wow directory.<br>(Usually something like C:\Program Files (x86)\World of Warcraft)</li><br><br />
<br />
<li>Now run SkyFirePatcher.exe and a dialog should pop up with:<br />
<pre>Loading Wow.exe into memory...<br />
Success!<br />
Ready to patch Wow.exe.</pre><br />
And "Status: Ready!" at the bottom.</li><br><br />
<br />
<li>Click "Patch" at the bottom to patch your Wow.exe<br><br />
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li><br><br />
</ol><br />
=== Play! ===<br />
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.<br />
<br><br />
<br><br />
<br><br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Win<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]<br />
<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Windows_5xx)&diff=964Installation (Windows 5xx)2023-12-08T20:54:52Z<p>Admin: /* INTRODUCTION */</p>
<hr />
<div>{| align="right"<br />
<br />
|-<br />
<br />
| __TOC__<br />
<br />
|}<br />
<br />
<br />
== INTRODUCTION ==<br />
<p>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.</p><br />
<p>After the first few times everyone gets used to the procedure and never needs to look at this guide ever again.</p><br><br />
<br />
=== Software Required ===<br />
<p><ol><br />
<li>[http://git-scm.com/download Git]<br>You can also use TortoiseGit that is more compatible with Windows (8).<br>[http://code.google.com/p/tortoisegit/ TortoiseGIT]</li><br><br />
<br />
<li>Install the compiler Visual C++ 2022 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].<br />
</li><br><br />
<br />
<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]<br />
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.<br />
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.<br />
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li><br><br />
<br />
<li>[http://www.cmake.org/cmake/resources/software.html CMake]<br />
CMake Version 3.16.3 or greater</li><br><br />
<br />
<li>MySQL Server<br />
*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]<br />
*It's recommended that your MySQL server and the MySQL header source versions match.<br />
*Current SkyFire core MySQL header version: 8.0.X<br />
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.<br />
*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><br><br />
<br />
<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><br><br />
<br />
<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]<br />
*'''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><br />
</ol><br />
<br></p><br />
<br />
=== Software Recommended ===<br />
<p>git command help:<ul><br />
<li>[http://code.google.com/p/gitextensions/ gitextensions]<br />
*most popular with the community</li><br />
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]<br />
*Makes pulling and cloning sources easier with right mouse clicks.<br />
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.<br />
*Note: You still need to install [http://git-scm.com/download Git] for this to work.<br />
</li><br />
</ul><br />
<br></p><br />
<br />
=== Microsoft Visual Studio 2019 ===<br />
<p><br />
Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].<br />
<br><br />
Please note Visual Studio 2022 Preview is not supported.<br />
<br></p><br />
<br />
== PULLING AND COMPILING THE SOURCE ==<br />
<p><br />
*'''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.)'''<br />
</p><br />
<br />
=== Pulling the Source ===<br />
<p><ol><br />
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li><br />
<li>Right-click on the directory and click on '''Git Bash Here'''</li><br />
<li>Fill in the data as follows:</li><br><br />
<pre>git clone -b trunk https://github.com/ProjectSkyfire/SkyFire_548.git</pre><br />
</br><br />
<br />
<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><br />
</ol></p><br />
<br />
=== Configuring and Generating Visual C++ solutions with CMake ===<br />
<p><ol><br />
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".<br />
<li>Open CMake. (cmake-gui)</li><br />
<li>Fill in the data as follows:</li><br><br />
<br />
Where the the source code: <br />
<pre>C:\SkyFire_548</pre><br />
<br />
Where to build the binaries: <br />
<pre>C:\SkyFire_548\build</pre><br />
<br><br />
<br />
<li>Click '''Configure'''.</li><br />
<li>It should ask you if you want to create the directory, '''click yes'''.</li><br />
<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'''.<br />
*NOTE: You MUST select the appropriate compiler!<br />
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li><br />
<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.)<br><br />
Make sure these are the ones selected:<br />
<pre><br />
SCRIPTS<br />
SERVERS<br />
TOOLS<br />
USE_COREPCH<br />
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)<br />
USE_SCRIPTPCH<br />
</pre><br />
<br />
*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''<br />
*'''(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><br />
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li><br />
<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><br />
<li>When done, it'll state "Generating done"</li><br />
<li>Close CMake and continue below with '''Compiling the Source'''.<br />
</ol></p><br />
<br />
=== Compiling the Source ===<br />
<p><ol><br />
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li><br />
<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'''.<br><br />
<br />
<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><br />
*You will find the following message once the compilation has finished successfully: <br />
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========<br />
</pre><br />
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder: <br />
<pre><br />
ace.dll<br />
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.<br />
libeay32.dll -> Needs to copy to the release folder.<br />
libssl-1_1-x64.dll -> Needs to copy to the release folder.<br />
ssleay32.dll -> Needs to copy to the release folder.<br />
authserver.conf.dist<br />
authserver.exe<br />
libmysql.dll (From your MySQL 8 install bin folder.)*<br />
worldserver.conf.dist<br />
worldserver.exe<br />
</pre><br />
<br><br />
<br />
<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from.<br>For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now.<br></li><br />
<br />
<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf<br>These are your config files. Go through and edit each one to match your prefered settings.</li><br><br />
<br />
<li>You will also need '''libmysql.dll''' to run your server.<br />
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib'''<br>Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li><br><br />
</ol></p><br />
<br />
=== Keeping the code up to date ===<br />
<p>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.<br />
<br />
<ol><br />
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li><br />
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li><br />
<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><br />
</ol><br />
<br />
*Now you can repeat the compiling procedure above.<br><br />
*<u>'''And remember to clean your build everytime!'''</u><br />
<br></p><br />
<br />
== IMPORTING THE DATABASE ==<br />
<p><br />
*'''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.'''<br></p><br />
<br />
=== Creating Auth, Characters and World Databases ===<br />
<p>Using your chosen SQL Client, create the three Databases.<br />
<ol><br />
<li>Auth</li><br />
<li>Characters</li><br />
<li>World</li><br />
</ol><br />
*Doing this may prevent importing problems later.<br />
</p><br />
<br />
==== Importing Auth and Characters Databases ====<br />
<p>Using your chosen SQL Client,<br />
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\<u>sql\base</u>''' to their respective places in your MySQL database.</p><br />
<br />
<br />
==== Importing World Database ====<br />
<p><ol><br />
----<br />
<br />
Grab the latest version of SkyFireDB_5xx from our release repository:<br />
<br />
<pre>https://github.com/ProjectSkyfire/database/releases</pre><br />
<br />
Import the DB into your world table. Will update this method shortly</p><br />
<br />
==== Importing Important Database Structure Updates ====<br />
<ol><br />
<li>Go into your '''C:\SkyFireEMU\core\<u>sql\updates</u>''' directory.</li><br><br />
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li><br />
</ol><br />
<br />
==== Importing World Database Updates ====<br />
<ol><br />
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li><br />
<li>Follow the dialog and enter in your info like you did before.</li><br />
<li>Press '''U''' to import the World Database updates when asked.</li><br />
<li>Select the correct changesets needed.</li><br />
</ol><br />
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''<br />
<br />
=== Auth Database Accounts and Passwords ===<br />
It is '''highly advised''' you change the passwords or delete these accounts. <br />
*'''NOTE''': These may not exist.<br />
<pre>User: Administrator<br />
Pass: Administrator<br />
<br />
User: Moderator<br />
Pass: Moderator<br />
<br />
User: Developer<br />
Pass: Developer<br />
<br />
User: Gamemaster<br />
Pass: Gamemaster<br />
<br />
User: Player<br />
Pass: Player</pre><br />
<br />
==== Changing passwords ====<br />
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><br />
<br />
==== Deleting accounts ====<br />
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre><br />
<br />
==== Making new accounts ====<br />
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre><br />
<br />
==== Raising an account's access/GM level ====<br />
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.<br />
*id=your account id found under '''accounts'''<br />
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator<br />
**You can only add Administrator (gmlevel 4) with your SQL client<br />
*RealmID is usually 1 or -1 for all realms<br />
<br><br />
<br />
== DBC, MAPS, VMAPS, and MMAPS ==<br />
<br />
*'''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!'''<br />
*We will, however, help you through the extraction process with step-by-step instructions<br />
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''<br />
<ol></li><br><br />
<br />
<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)<br />
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:<br />
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "<u>CT</u>"''', NOT "<u>LK</u>".<br />
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''<br />
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''<br />
**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><br><br />
<br />
<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><br><br />
<br />
<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).<br />
*Locate file named '''"libmysql.dll"'''.<br />
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).<br />
</ol><br />
<br><br />
<br />
=== Manual Extraction Method ===<br />
<ol><br />
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li><br />
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li><br><br />
<u><b>Dbc and Maps:</b></u><br />
<li>In your command prompt type '''extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li><br><br />
<u><b>VMaps:</b></u><br />
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory named '''Buildings'''.</li><br />
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li><br />
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory, '''vmaps'''.</li><br><br />
<u><b>MMaps:</b></u><br />
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents <u>ONLY</u>'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li><br />
<li>You may now Delete the empty '''buildings''' folder.</li><br />
<li>Create a new folder named '''mmaps'''.</li><br />
<li>Now execute the '''mmaps_generator.exe'''.<br />
*'''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><br />
</ol><br />
<br><br />
<br />
=== Completion (For Both Methods) === <br />
<ol><br />
<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><br />
<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><br />
</ol><br />
<br><br />
<br />
== SKYFIRE WOW.EXE PATCHER ==<br />
Your Wow.exe client will be needed to be patched before you can properly connect to your server.<br />
<br />
<br />
=== Patching ===<br />
Pull the latest version of SkyFire-Community-Tools from<br />
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre><br />
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.<br />
<br><br />
<br />
=== Pre-Patched Method (Easy Method)===<br />
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.<br />
<br><br />
<br />
=== Manuel Compile Method (Not really needed but will keep this for now)===<br />
<br />
*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''<br />
*You will not need CMake for this.<br />
<ol><br />
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li><br />
<li>Select "Release"</li><br />
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li><br />
<li>Clean</li><br />
<li>Build. (This should take less than a minute.)</li><br />
</ol><br />
<br />
*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><br />
<br />
<br />
<br />
*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder.<br>(You can delete the rest if you like.)<br />
<br />
<br />
==== Keeping the code up to date ====<br />
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing.<br><br />
<br />
=== Moving and Patching ===<br />
<ol><br />
<li>Move SkyFirePatcher.exe into your Wow directory.<br>(Usually something like C:\Program Files (x86)\World of Warcraft)</li><br><br />
<br />
<li>Now run SkyFirePatcher.exe and a dialog should pop up with:<br />
<pre>Loading Wow.exe into memory...<br />
Success!<br />
Ready to patch Wow.exe.</pre><br />
And "Status: Ready!" at the bottom.</li><br><br />
<br />
<li>Click "Patch" at the bottom to patch your Wow.exe<br><br />
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li><br><br />
</ol><br />
=== Play! ===<br />
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.<br />
<br><br />
<br><br />
<br><br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Win<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]<br />
<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Windows_5xx)&diff=963Installation (Windows 5xx)2023-10-29T12:24:05Z<p>Admin: /* Importing World Database */</p>
<hr />
<div>{| align="right"<br />
<br />
|-<br />
<br />
| __TOC__<br />
<br />
|}<br />
<br />
<br />
== INTRODUCTION ==<br />
<p>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.</p><br />
<p>After the first few times everyone gets used to the procedure and never needs to look at this guide ever again.</p><br><br />
<br />
=== Software Required ===<br />
<p><ol><br />
<li>[http://git-scm.com/download Git]<br>You can also use TortoiseGit that is more compatible with Windows (8).<br>[http://code.google.com/p/tortoisegit/ TortoiseGIT]</li><br><br />
<br />
<li>Install the compiler Visual C++ 2019 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].<br />
</li><br><br />
<br />
<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]<br />
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.<br />
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.<br />
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li><br><br />
<br />
<li>[http://www.cmake.org/cmake/resources/software.html CMake]<br />
CMake Version 3.16.3 or greater</li><br><br />
<br />
<li>MySQL Server<br />
*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]<br />
*It's recommended that your MySQL server and the MySQL header source versions match.<br />
*Current SkyFire core MySQL header version: 8.0.X<br />
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.<br />
*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><br><br />
<br />
<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><br><br />
<br />
<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]<br />
*'''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><br />
</ol><br />
<br></p><br />
<br />
=== Software Recommended ===<br />
<p>git command help:<ul><br />
<li>[http://code.google.com/p/gitextensions/ gitextensions]<br />
*most popular with the community</li><br />
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]<br />
*Makes pulling and cloning sources easier with right mouse clicks.<br />
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.<br />
*Note: You still need to install [http://git-scm.com/download Git] for this to work.<br />
</li><br />
</ul><br />
<br></p><br />
<br />
=== Microsoft Visual Studio 2019 ===<br />
<p><br />
Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].<br />
<br><br />
Please note Visual Studio 2022 Preview is not supported.<br />
<br></p><br />
<br />
== PULLING AND COMPILING THE SOURCE ==<br />
<p><br />
*'''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.)'''<br />
</p><br />
<br />
=== Pulling the Source ===<br />
<p><ol><br />
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li><br />
<li>Right-click on the directory and click on '''Git Bash Here'''</li><br />
<li>Fill in the data as follows:</li><br><br />
<pre>git clone -b trunk https://github.com/ProjectSkyfire/SkyFire_548.git</pre><br />
</br><br />
<br />
<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><br />
</ol></p><br />
<br />
=== Configuring and Generating Visual C++ solutions with CMake ===<br />
<p><ol><br />
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".<br />
<li>Open CMake. (cmake-gui)</li><br />
<li>Fill in the data as follows:</li><br><br />
<br />
Where the the source code: <br />
<pre>C:\SkyFire_548</pre><br />
<br />
Where to build the binaries: <br />
<pre>C:\SkyFire_548\build</pre><br />
<br><br />
<br />
<li>Click '''Configure'''.</li><br />
<li>It should ask you if you want to create the directory, '''click yes'''.</li><br />
<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'''.<br />
*NOTE: You MUST select the appropriate compiler!<br />
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li><br />
<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.)<br><br />
Make sure these are the ones selected:<br />
<pre><br />
SCRIPTS<br />
SERVERS<br />
TOOLS<br />
USE_COREPCH<br />
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)<br />
USE_SCRIPTPCH<br />
</pre><br />
<br />
*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''<br />
*'''(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><br />
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li><br />
<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><br />
<li>When done, it'll state "Generating done"</li><br />
<li>Close CMake and continue below with '''Compiling the Source'''.<br />
</ol></p><br />
<br />
=== Compiling the Source ===<br />
<p><ol><br />
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li><br />
<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'''.<br><br />
<br />
<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><br />
*You will find the following message once the compilation has finished successfully: <br />
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========<br />
</pre><br />
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder: <br />
<pre><br />
ace.dll<br />
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.<br />
libeay32.dll -> Needs to copy to the release folder.<br />
libssl-1_1-x64.dll -> Needs to copy to the release folder.<br />
ssleay32.dll -> Needs to copy to the release folder.<br />
authserver.conf.dist<br />
authserver.exe<br />
libmysql.dll (From your MySQL 8 install bin folder.)*<br />
worldserver.conf.dist<br />
worldserver.exe<br />
</pre><br />
<br><br />
<br />
<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from.<br>For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now.<br></li><br />
<br />
<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf<br>These are your config files. Go through and edit each one to match your prefered settings.</li><br><br />
<br />
<li>You will also need '''libmysql.dll''' to run your server.<br />
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib'''<br>Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li><br><br />
</ol></p><br />
<br />
=== Keeping the code up to date ===<br />
<p>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.<br />
<br />
<ol><br />
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li><br />
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li><br />
<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><br />
</ol><br />
<br />
*Now you can repeat the compiling procedure above.<br><br />
*<u>'''And remember to clean your build everytime!'''</u><br />
<br></p><br />
<br />
== IMPORTING THE DATABASE ==<br />
<p><br />
*'''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.'''<br></p><br />
<br />
=== Creating Auth, Characters and World Databases ===<br />
<p>Using your chosen SQL Client, create the three Databases.<br />
<ol><br />
<li>Auth</li><br />
<li>Characters</li><br />
<li>World</li><br />
</ol><br />
*Doing this may prevent importing problems later.<br />
</p><br />
<br />
==== Importing Auth and Characters Databases ====<br />
<p>Using your chosen SQL Client,<br />
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\<u>sql\base</u>''' to their respective places in your MySQL database.</p><br />
<br />
<br />
==== Importing World Database ====<br />
<p><ol><br />
----<br />
<br />
Grab the latest version of SkyFireDB_5xx from our release repository:<br />
<br />
<pre>https://github.com/ProjectSkyfire/database/releases</pre><br />
<br />
Import the DB into your world table. Will update this method shortly</p><br />
<br />
==== Importing Important Database Structure Updates ====<br />
<ol><br />
<li>Go into your '''C:\SkyFireEMU\core\<u>sql\updates</u>''' directory.</li><br><br />
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li><br />
</ol><br />
<br />
==== Importing World Database Updates ====<br />
<ol><br />
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li><br />
<li>Follow the dialog and enter in your info like you did before.</li><br />
<li>Press '''U''' to import the World Database updates when asked.</li><br />
<li>Select the correct changesets needed.</li><br />
</ol><br />
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''<br />
<br />
=== Auth Database Accounts and Passwords ===<br />
It is '''highly advised''' you change the passwords or delete these accounts. <br />
*'''NOTE''': These may not exist.<br />
<pre>User: Administrator<br />
Pass: Administrator<br />
<br />
User: Moderator<br />
Pass: Moderator<br />
<br />
User: Developer<br />
Pass: Developer<br />
<br />
User: Gamemaster<br />
Pass: Gamemaster<br />
<br />
User: Player<br />
Pass: Player</pre><br />
<br />
==== Changing passwords ====<br />
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><br />
<br />
==== Deleting accounts ====<br />
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre><br />
<br />
==== Making new accounts ====<br />
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre><br />
<br />
==== Raising an account's access/GM level ====<br />
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.<br />
*id=your account id found under '''accounts'''<br />
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator<br />
**You can only add Administrator (gmlevel 4) with your SQL client<br />
*RealmID is usually 1 or -1 for all realms<br />
<br><br />
<br />
== DBC, MAPS, VMAPS, and MMAPS ==<br />
<br />
*'''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!'''<br />
*We will, however, help you through the extraction process with step-by-step instructions<br />
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''<br />
<ol></li><br><br />
<br />
<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)<br />
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:<br />
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "<u>CT</u>"''', NOT "<u>LK</u>".<br />
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''<br />
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''<br />
**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><br><br />
<br />
<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><br><br />
<br />
<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).<br />
*Locate file named '''"libmysql.dll"'''.<br />
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).<br />
</ol><br />
<br><br />
<br />
=== Manual Extraction Method ===<br />
<ol><br />
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li><br />
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li><br><br />
<u><b>Dbc and Maps:</b></u><br />
<li>In your command prompt type '''extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li><br><br />
<u><b>VMaps:</b></u><br />
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory named '''Buildings'''.</li><br />
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li><br />
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory, '''vmaps'''.</li><br><br />
<u><b>MMaps:</b></u><br />
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents <u>ONLY</u>'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li><br />
<li>You may now Delete the empty '''buildings''' folder.</li><br />
<li>Create a new folder named '''mmaps'''.</li><br />
<li>Now execute the '''mmaps_generator.exe'''.<br />
*'''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><br />
</ol><br />
<br><br />
<br />
=== Completion (For Both Methods) === <br />
<ol><br />
<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><br />
<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><br />
</ol><br />
<br><br />
<br />
== SKYFIRE WOW.EXE PATCHER ==<br />
Your Wow.exe client will be needed to be patched before you can properly connect to your server.<br />
<br />
<br />
=== Patching ===<br />
Pull the latest version of SkyFire-Community-Tools from<br />
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre><br />
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.<br />
<br><br />
<br />
=== Pre-Patched Method (Easy Method)===<br />
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.<br />
<br><br />
<br />
=== Manuel Compile Method (Not really needed but will keep this for now)===<br />
<br />
*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''<br />
*You will not need CMake for this.<br />
<ol><br />
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li><br />
<li>Select "Release"</li><br />
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li><br />
<li>Clean</li><br />
<li>Build. (This should take less than a minute.)</li><br />
</ol><br />
<br />
*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><br />
<br />
<br />
<br />
*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder.<br>(You can delete the rest if you like.)<br />
<br />
<br />
==== Keeping the code up to date ====<br />
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing.<br><br />
<br />
=== Moving and Patching ===<br />
<ol><br />
<li>Move SkyFirePatcher.exe into your Wow directory.<br>(Usually something like C:\Program Files (x86)\World of Warcraft)</li><br><br />
<br />
<li>Now run SkyFirePatcher.exe and a dialog should pop up with:<br />
<pre>Loading Wow.exe into memory...<br />
Success!<br />
Ready to patch Wow.exe.</pre><br />
And "Status: Ready!" at the bottom.</li><br><br />
<br />
<li>Click "Patch" at the bottom to patch your Wow.exe<br><br />
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li><br><br />
</ol><br />
=== Play! ===<br />
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.<br />
<br><br />
<br><br />
<br><br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Win<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]<br />
<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Ip_banned_548&diff=962Ip banned 5482023-08-03T02:41:57Z<p>Admin: </p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `ip_banned` table'''</big><br />
<br />
This table contains all of the banned IPs and the date when (or if) the ban will expire.<br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#ip|ip]]<br />
|varchar(15)<br />
|<br />
|<br />
|NO<br />
|<nowiki>127.0.0.1</nowiki><br />
|<br />
|<br />
|-<br />
|[[#bandate|bandate]]<br />
|int<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#unbandate|unbandate]]<br />
|int<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#bannedby|bannedby]]<br />
|varchar(50)<br />
|unsigned<br />
|<br />
|NO<br />
|<nowiki>[Console]</nowiki><br />
|<br />
|<br />
|-<br />
|[[#banreason|banreason]]<br />
|varchar(255)<br />
|unsigned<br />
|<br />
|NO<br />
|<nowiki>no reason</nowiki><br />
|<br />
|<br />
|-<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `ip_banned` (<br />
`ip` varchar(15) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '127.0.0.1',<br />
`bandate` int UNSIGNED NOT NULL,<br />
`unbandate` int UNSIGNED NOT NULL,<br />
`bannedby` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '[Console]',<br />
`banreason` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT 'no reason',<br />
PRIMARY KEY (`ip`, `bandate`) USING BTREE<br />
) ENGINE = InnoDB CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = 'Banned IPs' ROW_FORMAT = Dynamic;<br />
;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== ip ====<br />
<br />
The ip address.<br />
<br />
==== bandate====<br />
<br />
The date when the ip was banned, in Unix time.<br />
<br />
==== unbandate====<br />
<br />
The date when the ip will be automatically unbanned, in Unix time. A value less than the current date means, in effect, a permanent ban.<br />
<br />
==== bannedby ====<br />
<br />
The GM character's name who banned that ip. If banned from the console, then it will be empty (until improved).<br />
<br />
==== banreason ====<br />
<br />
The reason for the ban.</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Ip_banned_548&diff=961Ip banned 5482023-08-03T02:40:43Z<p>Admin: Final</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `ip_banned` table'''</big><br />
<br />
This table contains all of the banned IPs and the date when (or if) the ban will expire.<br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#ip|ip]]<br />
|varchar(15)<br />
|<br />
|<br />
|NO<br />
|<nowiki>127.0.0.1</nowiki><br />
|<br />
|<br />
|-<br />
|[[#bandate|bandate]]<br />
|int<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#unbandate|unbandate]]<br />
|int<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#bannedby|bannedby]]<br />
|varchar(50)<br />
|unsigned<br />
|<br />
|NO<br />
|<nowiki>[Console]</nowiki><br />
|<br />
|<br />
|-<br />
|[[#banreason|banreason]]<br />
|varchar(255)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `ip_banned` (<br />
`ip` varchar(15) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '127.0.0.1',<br />
`bandate` int UNSIGNED NOT NULL,<br />
`unbandate` int UNSIGNED NOT NULL,<br />
`bannedby` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '[Console]',<br />
`banreason` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT 'no reason',<br />
PRIMARY KEY (`ip`, `bandate`) USING BTREE<br />
) ENGINE = InnoDB CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = 'Banned IPs' ROW_FORMAT = Dynamic;<br />
;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== ip ====<br />
<br />
The ip address.<br />
<br />
==== bandate====<br />
<br />
The date when the ip was banned, in Unix time.<br />
<br />
==== unbandate====<br />
<br />
The date when the ip will be automatically unbanned, in Unix time. A value less than the current date means, in effect, a permanent ban.<br />
<br />
==== bannedby ====<br />
<br />
The GM character's name who banned that ip. If banned from the console, then it will be empty (until improved).<br />
<br />
==== banreason ====<br />
<br />
The reason for the ban.</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Ip2nationcountries_548&diff=960Ip2nationcountries 5482023-08-03T02:32:26Z<p>Admin: Unfinished</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `ip2nationcountries` table'''</big><br />
<br />
These tables allow to see approximately which country a player might be from when doing .pinfo <player> command.<br />
<br />
They are not mantained by the ProjectSkyfire development team and they require external data to perform their function, which can be found at http://www.ip2nation.com/ip2nation/Download<br />
<br />
NOTE IF YOU EXPORT THIS DATABASE FROM WINDOWS ENVIROMENT AND IMPORT IT ON LINUX YOU WILL HAVE STARTUP ERROR BECAUSE ip2nationCountries WILL BE RENAMED TO ip2nationcountries IMPORT IT AGAIN FROM IP2NATION WEBPAGE TO FIX IT.<br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#code|code]]<br />
|int<br />
|<br />
|<br />
|NO<br />
|<nowiki>0</nowiki><br />
|<br />
|<br />
|-<br />
|[[#iso_code_2|iso_code_2]]<br />
|char(2)<br />
|<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#iso_code_3|iso_code_3]]<br />
|char(2)<br />
|<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#iso_country|iso_country]]<br />
|char(2)<br />
|<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#country|country]]<br />
|char(2)<br />
|<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#lat|lat]]<br />
|char(2)<br />
|<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#lon|lon]]<br />
|char(2)<br />
|<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `ip2nationcountries` (<br />
`code` varchar(4) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '',<br />
`iso_code_2` varchar(2) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '',<br />
`iso_code_3` varchar(3) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT '',<br />
`iso_country` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '',<br />
`country` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '',<br />
`lat` float NOT NULL DEFAULT 0,<br />
`lon` float NOT NULL DEFAULT 0,<br />
PRIMARY KEY (`code`) USING BTREE,<br />
INDEX `code`(`code` ASC) USING BTREE<br />
) ENGINE = InnoDB CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== code ====<br />
Please Define<br />
<br />
==== so_code_2 ====<br />
<br />
Please Define<br />
==== iso_code_3 ====<br />
<br />
Please Define<br />
==== iso_country ====<br />
<br />
Please Define<br />
==== country ====<br />
<br />
Please Define<br />
==== lat ====<br />
<br />
Please Define<br />
==== lon ====<br />
<br />
Please Define</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Ip2nation_548&diff=959Ip2nation 5482023-08-03T02:25:10Z<p>Admin: </p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `ip2nation` table'''</big><br />
<br />
These tables allow to see approximately which country a player might be from when doing .pinfo <player> command.<br />
<br />
They are not mantained by the ProjectSkyfire development team and they require external data to perform their function, which can be found at http://www.ip2nation.com/ip2nation/Download<br />
<br />
NOTE IF YOU EXPORT THIS DATABASE FROM WINDOWS ENVIROMENT AND IMPORT IT ON LINUX YOU WILL HAVE STARTUP ERROR BECAUSE ip2nationCountries WILL BE RENAMED TO ip2nationcountries IMPORT IT AGAIN FROM IP2NATION WEBPAGE TO FIX IT.<br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#ip|ip]]<br />
|int<br />
|<br />
|<br />
|NO<br />
|<nowiki>0</nowiki><br />
|<br />
|<br />
|-<br />
|[[#country|country]]<br />
|char(2)<br />
|<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `ip2nation` (<br />
`ip` int UNSIGNED NOT NULL DEFAULT 0,<br />
`country` char(2) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL DEFAULT '',<br />
INDEX `ip`(`ip` ASC) USING BTREE<br />
) ENGINE = InnoDB CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== ip ====<br />
ip Range<br />
<br />
==== country ====<br />
<br />
Country Code</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Autobroadcast_548&diff=958Autobroadcast 5482023-08-03T02:14:53Z<p>Admin: Final</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `autobroadcast` table'''</big><br />
<br />
This table contains the autobroadcast entries for your realms. Values like it's activity, position and Timer (*.On, *.Center, *.Timer) are defined within the worldserver.conf. They are chosen randomly, based on their weight.<br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#realmid|realmid]]<br />
|int<br />
|<br />
|<br />
|NO<br />
|<nowiki>-1</nowiki><br />
|<br />
|<br />
|-<br />
|[[#id|id]]<br />
|tinyint<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|AUTO_INCREMENT<br />
|<br />
|-<br />
|[[#weight|weight]]<br />
|tinyint<br />
|unsigned<br />
|<br />
|<br />
| 1<br />
|<br />
|<br />
|-<br />
|[[#text|text]]<br />
|longtext<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `sf_auth`.`Untitled` (<br />
`realmid` int NOT NULL DEFAULT -1,<br />
`id` tinyint UNSIGNED NOT NULL AUTO_INCREMENT,<br />
`weight` tinyint UNSIGNED NULL DEFAULT 1,<br />
`text` longtext CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,<br />
PRIMARY KEY (`id`, `realmid`) USING BTREE<br />
) ENGINE = InnoDB AUTO_INCREMENT = 1 CHARACTER SET = utf8 COLLATE = utf8_general_ci ROW_FORMAT = Dynamic;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== realmid ====<br />
<br />
The realmlist.id. Defines which realm this entry belongs to. Use -1 for all realms to load this entry.<br />
<br />
==== id ====<br />
<br />
Unique identifier key per realm. Entries with same id will override each other without warnings - this can be used to replace -1 realmid entry on a specific realm.<br />
<br />
==== weight ====<br />
<br />
A non-negative integer. Entries with higher weight have more chance to get picked.<br />
<br />
==== text ====<br />
<br />
The text to broadcast. Color and item/spell/quest link formating codes can be used.</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_banned_548&diff=957Account banned 5482023-08-03T02:00:00Z<p>Admin: Final</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `account_banned` table'''</big><br />
<br />
This table lists all of the accounts that have been banned along with the date when (or if) the ban will expire.<br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#id|id]]<br />
|int(10)<br />
|unsigned<br />
|PRI<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#bandate|bandate]]<br />
|int(10)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#unbandate|unbandate]]<br />
|int(10)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#bannedby|bannedby]]<br />
|varchar(50)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#banreason|banreason]]<br />
|varchar(255)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#active|active]]<br />
|tinyint(5)<br />
|unsigned<br />
|<br />
|NO<br />
|<nowiki>-1</nowiki><br />
|<br />
|<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `sf_auth`.`Untitled` (<br />
`id` int UNSIGNED NOT NULL DEFAULT 0 COMMENT 'Account id',<br />
`bandate` int UNSIGNED NOT NULL DEFAULT 0,<br />
`unbandate` int UNSIGNED NOT NULL DEFAULT 0,<br />
`bannedby` varchar(50) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,<br />
`banreason` varchar(255) CHARACTER SET utf8 COLLATE utf8_general_ci NOT NULL,<br />
`active` tinyint UNSIGNED NOT NULL DEFAULT 1,<br />
PRIMARY KEY (`id`, `bandate`) USING BTREE<br />
) ENGINE = InnoDB CHARACTER SET = utf8 COLLATE = utf8_general_ci COMMENT = 'Ban List' ROW_FORMAT = Dynamic;<br />
;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== id ====<br />
<br />
The account ID.<br />
<br />
==== bandate====<br />
<br />
The date when the account was banned, in Unix time.<br />
<br />
==== unbandate====<br />
<br />
The date when the account will be automatically unbanned, in Unix time. A value less than the current date means, in effect, a permanent ban.<br />
<br />
==== bannedby ====<br />
<br />
The GM character's name who banned that account. If banned from the console, then it will be empty (until improved).<br />
<br />
==== banreason ====<br />
<br />
The reason for the ban.<br />
<br />
==== active ====<br />
<br />
Boolean 0 or 1 controlling if the ban is currently active or not.</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_banned_548&diff=956Account banned 5482023-08-03T01:54:15Z<p>Admin: </p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `account_banned` table'''</big><br />
<br />
This table holds banned users<br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#id|id]]<br />
|int(10)<br />
|unsigned<br />
|PRI<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#bandate|bandate]]<br />
|int(10)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#unbandate|unbandate]]<br />
|int(10)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#bannedby|bannedby]]<br />
|varchar(50)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#banreason|banreason]]<br />
|varchar(255)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#active|active]]<br />
|tinyint(5)<br />
|unsigned<br />
|<br />
|NO<br />
|<nowiki>-1</nowiki><br />
|<br />
|<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `account_banned` (<br />
`id` INT NOT NULL,<br />
`gmlevel` TINYINT NOT NULL,<br />
`RealmID` INT NOT NULL DEFAULT -1,<br />
PRIMARY KEY (`id`, `RealmID`) USING BTREE<br />
)<br />
COLLATE='utf8_general_ci'<br />
ENGINE=InnoDB<br />
;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== id ====<br />
The account ID.<br />
<br />
==== gmlevel ====<br />
The account security level. Different levels have access to different commands. The individual level required for a command is defined in the command table in each realm.<br />
<br />
==== RealmID ====<br />
The Realm ID.</div>Adminhttps://wiki.projectskyfire.org/index.php?title=DB:Auth_18414&diff=955DB:Auth 184142023-08-02T23:45:27Z<p>Admin: </p>
<hr />
<div><big>'''This is the list of tables in the 'auth' database 5.4.8 Build 18414'''</big> <br />
<br />
*[[DB:Auth:account_548|account*]]<br />
<br />
*[[DB:Auth:account_access_548|account_access*]]<br />
<br />
*[[DB:Auth:account_banned_548|account_banned]]<br />
<br />
*[[DB:Auth:autobroadcast_548|autobroadcast]]<br />
<br />
*[[DB:Auth:ip2nation_548|ip2nation]]<br />
<br />
*[[DB:Auth:1p2nationcountries_548|1p2nationcountries]]<br />
<br />
*[[DB:Auth:ip_banned_548|ip_banned]]<br />
<br />
*[[DB:Auth:logs_548|logs]]<br />
<br />
*[[DB:Auth:rbac_account_permissions_548|rbac_account_permissions]]<br />
<br />
*[[DB:Auth:rbac_default_permissions_548|rbac_default_permissions]]<br />
<br />
*[[DB:Auth:rbac_linked_permissions_548|rbac_linked_permissions]]<br />
<br />
*[[DB:Auth:rbac_permissions_548|rbac_permissions]]<br />
<br />
*[[DB:Auth:realmcharacters_548|realmcharacters]]<br />
<br />
*[[DB:Auth:realmlist_548|realmlist]]<br />
<br />
*[[DB:Auth:realm_classes_548|realm_classes]]<br />
<br />
*[[DB:Auth:realm_races_548|realm_races]]<br />
<br />
*[[DB:Auth:uptime_548|uptime]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Uptime_548&diff=954Uptime 5482023-08-02T23:44:38Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=DB:Auth:realm_races_548&diff=953DB:Auth:realm races 5482023-08-02T23:44:29Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=DB:Auth:realm_classes_548&diff=952DB:Auth:realm classes 5482023-08-02T23:44:19Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Realmlist_548&diff=951Realmlist 5482023-08-02T23:44:07Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Realmcharacters_548&diff=950Realmcharacters 5482023-08-02T23:43:56Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Rbac_permissions_548&diff=949Rbac permissions 5482023-08-02T23:43:45Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Rbac_linked_permissions_548&diff=948Rbac linked permissions 5482023-08-02T23:43:36Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Rbac_default_permissions_548&diff=947Rbac default permissions 5482023-08-02T23:43:26Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Rbac_account_permissions_548&diff=946Rbac account permissions 5482023-08-02T23:43:17Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Logs_548&diff=945Logs 5482023-08-02T23:43:06Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Ip_banned_548&diff=944Ip banned 5482023-08-02T23:42:54Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Ip2nationcountries_548&diff=943Ip2nationcountries 5482023-08-02T23:42:43Z<p>Admin: placeholder</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Ip2nation_548&diff=942Ip2nation 5482023-08-02T23:42:30Z<p>Admin: Created page with "placeholder"</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Autobroadcast_548&diff=941Autobroadcast 5482023-08-02T23:42:17Z<p>Admin: Created page with "placeholder"</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_banned_548&diff=940Account banned 5482023-08-02T23:41:28Z<p>Admin: Created page with "placeholder"</p>
<hr />
<div>placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Main_Page&diff=939Main Page2023-08-02T21:02:11Z<p>Admin: Removed protection from "Main Page"</p>
<hr />
<div>{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to [[Project Skyfire]] wiki!</div><br />
<div style="top:+0.2em; font-size:95%;">We have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles. [[Special:UserLogin|Join]] and feel free to improve us.</div><br />
|}<br />
|}<br />
<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Getting started : Install the server 5.x.x SUPPORTED</h3><br />
----<br />
<br />
* Windows:<br />
** [[Installation (Windows_5xx)]] -- UPDATED<br />
* Linux:<br />
** [[Installation (Ubuntu 18.04_LTS)]] -- UPDATED<br />
** [[Installation (Debian 10)]] -- NEW<br />
** [[Installation (CentOS 7/8)]]<br />
</div><br />
<br />
<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;"><br />
<h3>SkyFire Database Structure 5.4.8 Build 18414</h3><br />
----<br />
<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_18414|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters_18414|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth_18414|Description of the SkyFire `'''auth'''` database structure]]<br />
</div><br />
<br />
<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;"><br />
<h3>AI Scripting</h3><br />
----<br />
<br />
* [[Smart AI (DB Scripting) reference]]<br />
* [[Guide on ScriptDev2's Event AI DB script]]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Development</h3><br />
----<br />
<br />
*[[Linux GDB Debugging]]<br />
*[[Mmaps Information]]<br />
*[[Opcode list]] -- Not Updated<br />
*[[DBC list]] -- Not Updated<br />
*[[SkyFire DB|Database Changelog]] -- Not Updated<br />
*[[Reporting Bugs|Reporting Bugs]]<br />
*[[DBC Files|DBC Files]] -- Not Updated<br />
*[[DBC Files 542|DBC Files (542)]] -- Not Updated<br />
*[[IRC Rules|IRC Rules]]<br />
</div><br />
<br />
<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;"><br />
<h3>Advanced Features</h3><br />
----<br />
<br />
*[[How-to:Advanced|Advanced Guides]] <br />
*[[How-to:MySQLStoredProcedures|How to use MySQL Stored Procedures]]<br />
*[[How-to:Advanced:Xampp|How to use Xampp with MySQL 8.0]]<br />
<br />
{{Pp-vandalism}}<br />
</div><br />
<br />
<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;"><br />
<h3>Scripting Assets</h3><br />
----<br />
<br />
This is a placeholder.<br />
</div><br />
<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;"><br />
<h3>Unsupported Legacy Information</h3><br />
----<br />
Install the server 4.0.6 a Archived<br />
----<br />
<br />
* [[Installation (Windows)]]<br />
* [[Installation (Linux)]]<br />
----<br />
Install the server 2.4.3 Archived<br />
----<br />
<br />
* [[Installation (Windows_243)]] -- Work In Progress<br />
* [[Installation Debian 9 (Linux_243 (General))]] -- Work In Progress<br />
** Ubuntu:<br />
*** [[Installation (Ubuntu 18.04LTS)]] -- Work In Progress<br />
<br />
----<br />
SkyFire Database Structure Legacy 4.0.6a<br />
----<br />
<br />
'''{{revision-number}}''' <br />
<br />
*[[DB:World|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth|Description of the SkyFire `'''auth'''` database structure]]<br />
<br />
----<br />
SkyFire Database Structure 2.4.3 Build 8606<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_243|Description of the SkyFire One `'''world'''` database structure]]<br />
*[[DB:Characters_243|Description of the SkyFire One `'''characters'''` database structure]]<br />
*[[DB:Auth_243|Description of the SkyFire One `'''auth'''` database structure]]<br />
----<br />
<br />
</div><br />
</div><br />
|}<br />
<br />
<br />
{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;" class="plainlinks"><br />
<ul> {{NUMBEROFARTICLES}} Articles</ul><br />
<ul> {{NUMBEROFPAGES}} Pages</ul><br />
<ul> {{NUMBEROFUSERS}} Registered Users</ul><br />
</div><br />
|}<br />
|}</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Main_Page&diff=938Main Page2023-08-02T21:01:30Z<p>Admin: Protected "Main Page" ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite))</p>
<hr />
<div>{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to [[Project Skyfire]] wiki!</div><br />
<div style="top:+0.2em; font-size:95%;">We have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles. [[Special:UserLogin|Join]] and feel free to improve us.</div><br />
|}<br />
|}<br />
<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Getting started : Install the server 5.x.x SUPPORTED</h3><br />
----<br />
<br />
* Windows:<br />
** [[Installation (Windows_5xx)]] -- UPDATED<br />
* Linux:<br />
** [[Installation (Ubuntu 18.04_LTS)]] -- UPDATED<br />
** [[Installation (Debian 10)]] -- NEW<br />
** [[Installation (CentOS 7/8)]]<br />
</div><br />
<br />
<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;"><br />
<h3>SkyFire Database Structure 5.4.8 Build 18414</h3><br />
----<br />
<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_18414|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters_18414|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth_18414|Description of the SkyFire `'''auth'''` database structure]]<br />
</div><br />
<br />
<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;"><br />
<h3>AI Scripting</h3><br />
----<br />
<br />
* [[Smart AI (DB Scripting) reference]]<br />
* [[Guide on ScriptDev2's Event AI DB script]]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Development</h3><br />
----<br />
<br />
*[[Linux GDB Debugging]]<br />
*[[Mmaps Information]]<br />
*[[Opcode list]] -- Not Updated<br />
*[[DBC list]] -- Not Updated<br />
*[[SkyFire DB|Database Changelog]] -- Not Updated<br />
*[[Reporting Bugs|Reporting Bugs]]<br />
*[[DBC Files|DBC Files]] -- Not Updated<br />
*[[DBC Files 542|DBC Files (542)]] -- Not Updated<br />
*[[IRC Rules|IRC Rules]]<br />
</div><br />
<br />
<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;"><br />
<h3>Advanced Features</h3><br />
----<br />
<br />
*[[How-to:Advanced|Advanced Guides]] <br />
*[[How-to:MySQLStoredProcedures|How to use MySQL Stored Procedures]]<br />
*[[How-to:Advanced:Xampp|How to use Xampp with MySQL 8.0]]<br />
<br />
{{Pp-vandalism}}<br />
</div><br />
<br />
<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;"><br />
<h3>Scripting Assets</h3><br />
----<br />
<br />
This is a placeholder.<br />
</div><br />
<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;"><br />
<h3>Unsupported Legacy Information</h3><br />
----<br />
Install the server 4.0.6 a Archived<br />
----<br />
<br />
* [[Installation (Windows)]]<br />
* [[Installation (Linux)]]<br />
----<br />
Install the server 2.4.3 Archived<br />
----<br />
<br />
* [[Installation (Windows_243)]] -- Work In Progress<br />
* [[Installation Debian 9 (Linux_243 (General))]] -- Work In Progress<br />
** Ubuntu:<br />
*** [[Installation (Ubuntu 18.04LTS)]] -- Work In Progress<br />
<br />
----<br />
SkyFire Database Structure Legacy 4.0.6a<br />
----<br />
<br />
'''{{revision-number}}''' <br />
<br />
*[[DB:World|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth|Description of the SkyFire `'''auth'''` database structure]]<br />
<br />
----<br />
SkyFire Database Structure 2.4.3 Build 8606<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_243|Description of the SkyFire One `'''world'''` database structure]]<br />
*[[DB:Characters_243|Description of the SkyFire One `'''characters'''` database structure]]<br />
*[[DB:Auth_243|Description of the SkyFire One `'''auth'''` database structure]]<br />
----<br />
<br />
</div><br />
</div><br />
|}<br />
<br />
<br />
{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;" class="plainlinks"><br />
<ul> {{NUMBEROFARTICLES}} Articles</ul><br />
<ul> {{NUMBEROFPAGES}} Pages</ul><br />
<ul> {{NUMBEROFUSERS}} Registered Users</ul><br />
</div><br />
|}<br />
|}</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Windows_5xx)&diff=937Installation (Windows 5xx)2021-09-14T23:18:24Z<p>Admin: /* Compiling the Source */</p>
<hr />
<div>{| align="right"<br />
<br />
|-<br />
<br />
| __TOC__<br />
<br />
|}<br />
<br />
<br />
== INTRODUCTION ==<br />
<p>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.</p><br />
<p>After the first few times everyone gets used to the procedure and never needs to look at this guide ever again.</p><br><br />
<br />
=== Software Required ===<br />
<p><ol><br />
<li>[http://git-scm.com/download Git]<br>You can also use TortoiseGit that is more compatible with Windows (8).<br>[http://code.google.com/p/tortoisegit/ TortoiseGIT]</li><br><br />
<br />
<li>Install the compiler Visual C++ 2019 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].<br />
</li><br><br />
<br />
<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]<br />
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.<br />
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.<br />
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li><br><br />
<br />
<li>[http://www.cmake.org/cmake/resources/software.html CMake]<br />
CMake Version 3.16.3 or greater</li><br><br />
<br />
<li>MySQL Server<br />
*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]<br />
*It's recommended that your MySQL server and the MySQL header source versions match.<br />
*Current SkyFire core MySQL header version: 8.0.X<br />
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.<br />
*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><br><br />
<br />
<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><br><br />
<br />
<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]<br />
*'''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><br />
</ol><br />
<br></p><br />
<br />
=== Software Recommended ===<br />
<p>git command help:<ul><br />
<li>[http://code.google.com/p/gitextensions/ gitextensions]<br />
*most popular with the community</li><br />
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]<br />
*Makes pulling and cloning sources easier with right mouse clicks.<br />
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.<br />
*Note: You still need to install [http://git-scm.com/download Git] for this to work.<br />
</li><br />
</ul><br />
<br></p><br />
<br />
=== Microsoft Visual Studio 2019 ===<br />
<p><br />
Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].<br />
<br><br />
Please note Visual Studio 2022 Preview is not supported.<br />
<br></p><br />
<br />
== PULLING AND COMPILING THE SOURCE ==<br />
<p><br />
*'''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.)'''<br />
</p><br />
<br />
=== Pulling the Source ===<br />
<p><ol><br />
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li><br />
<li>Right-click on the directory and click on '''Git Bash Here'''</li><br />
<li>Fill in the data as follows:</li><br><br />
<pre>git clone -b trunk https://github.com/ProjectSkyfire/SkyFire_548.git</pre><br />
</br><br />
<br />
<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><br />
</ol></p><br />
<br />
=== Configuring and Generating Visual C++ solutions with CMake ===<br />
<p><ol><br />
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".<br />
<li>Open CMake. (cmake-gui)</li><br />
<li>Fill in the data as follows:</li><br><br />
<br />
Where the the source code: <br />
<pre>C:\SkyFire_548</pre><br />
<br />
Where to build the binaries: <br />
<pre>C:\SkyFire_548\build</pre><br />
<br><br />
<br />
<li>Click '''Configure'''.</li><br />
<li>It should ask you if you want to create the directory, '''click yes'''.</li><br />
<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'''.<br />
*NOTE: You MUST select the appropriate compiler!<br />
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li><br />
<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.)<br><br />
Make sure these are the ones selected:<br />
<pre><br />
SCRIPTS<br />
SERVERS<br />
TOOLS<br />
USE_COREPCH<br />
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)<br />
USE_SCRIPTPCH<br />
</pre><br />
<br />
*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''<br />
*'''(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><br />
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li><br />
<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><br />
<li>When done, it'll state "Generating done"</li><br />
<li>Close CMake and continue below with '''Compiling the Source'''.<br />
</ol></p><br />
<br />
=== Compiling the Source ===<br />
<p><ol><br />
<li>Open '''Project_Skyfire.sln''' located in your '''build''' folder with your chosen compiler.</li><br />
<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'''.<br><br />
<br />
<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><br />
*You will find the following message once the compilation has finished successfully: <br />
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========<br />
</pre><br />
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder: <br />
<pre><br />
ace.dll<br />
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.<br />
libeay32.dll -> Needs to copy to the release folder.<br />
libssl-1_1-x64.dll -> Needs to copy to the release folder.<br />
ssleay32.dll -> Needs to copy to the release folder.<br />
authserver.conf.dist<br />
authserver.exe<br />
libmysql.dll (From your MySQL 8 install bin folder.)*<br />
worldserver.conf.dist<br />
worldserver.exe<br />
</pre><br />
<br><br />
<br />
<li>Copy and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from.<br>For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now.<br></li><br />
<br />
<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf<br>These are your config files. Go through and edit each one to match your prefered settings.</li><br><br />
<br />
<li>You will also need '''libmysql.dll''' to run your server.<br />
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib'''<br>Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li><br><br />
</ol></p><br />
<br />
=== Keeping the code up to date ===<br />
<p>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.<br />
<br />
<ol><br />
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li><br />
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li><br />
<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><br />
</ol><br />
<br />
*Now you can repeat the compiling procedure above.<br><br />
*<u>'''And remember to clean your build everytime!'''</u><br />
<br></p><br />
<br />
== IMPORTING THE DATABASE ==<br />
<p><br />
*'''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.'''<br></p><br />
<br />
=== Creating Auth, Characters and World Databases ===<br />
<p>Using your chosen SQL Client, create the three Databases.<br />
<ol><br />
<li>Auth</li><br />
<li>Characters</li><br />
<li>World</li><br />
</ol><br />
*Doing this may prevent importing problems later.<br />
</p><br />
<br />
==== Importing Auth and Characters Databases ====<br />
<p>Using your chosen SQL Client,<br />
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\<u>sql\base</u>''' to their respective places in your MySQL database.</p><br />
<br />
<br />
==== Importing World Database ====<br />
<p><ol><br />
----<br />
<br />
Grab the latest version of SkyFireDB_5xx from our forum:<br />
<br />
<pre>http://www.projectskyfire.org/index.php?/files/</pre><br />
<br />
Import the DB into your world table. Will update this method shortly</p><br />
<br />
==== Importing Important Database Structure Updates ====<br />
<ol><br />
<li>Go into your '''C:\SkyFireEMU\core\<u>sql\updates</u>''' directory.</li><br><br />
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li><br />
</ol><br />
<br />
==== Importing World Database Updates ====<br />
<ol><br />
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li><br />
<li>Follow the dialog and enter in your info like you did before.</li><br />
<li>Press '''U''' to import the World Database updates when asked.</li><br />
<li>Select the correct changesets needed.</li><br />
</ol><br />
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''<br />
<br />
=== Auth Database Accounts and Passwords ===<br />
It is '''highly advised''' you change the passwords or delete these accounts. <br />
*'''NOTE''': These may not exist.<br />
<pre>User: Administrator<br />
Pass: Administrator<br />
<br />
User: Moderator<br />
Pass: Moderator<br />
<br />
User: Developer<br />
Pass: Developer<br />
<br />
User: Gamemaster<br />
Pass: Gamemaster<br />
<br />
User: Player<br />
Pass: Player</pre><br />
<br />
==== Changing passwords ====<br />
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><br />
<br />
==== Deleting accounts ====<br />
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre><br />
<br />
==== Making new accounts ====<br />
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre><br />
<br />
==== Raising an account's access/GM level ====<br />
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.<br />
*id=your account id found under '''accounts'''<br />
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator<br />
**You can only add Administrator (gmlevel 4) with your SQL client<br />
*RealmID is usually 1 or -1 for all realms<br />
<br><br />
<br />
== DBC, MAPS, VMAPS, and MMAPS ==<br />
<br />
*'''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!'''<br />
*We will, however, help you through the extraction process with step-by-step instructions<br />
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''<br />
<ol></li><br><br />
<br />
<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)<br />
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:<br />
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "<u>CT</u>"''', NOT "<u>LK</u>".<br />
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''<br />
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''<br />
**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><br><br />
<br />
<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><br><br />
<br />
<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).<br />
*Locate file named '''"libmysql.dll"'''.<br />
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).<br />
</ol><br />
<br><br />
<br />
=== Manual Extraction Method ===<br />
<ol><br />
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li><br />
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li><br><br />
<u><b>Dbc and Maps:</b></u><br />
<li>In your command prompt type '''extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li><br><br />
<u><b>VMaps:</b></u><br />
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory named '''Buildings'''.</li><br />
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li><br />
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory, '''vmaps'''.</li><br><br />
<u><b>MMaps:</b></u><br />
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents <u>ONLY</u>'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li><br />
<li>You may now Delete the empty '''buildings''' folder.</li><br />
<li>Create a new folder named '''mmaps'''.</li><br />
<li>Now execute the '''mmaps_generator.exe'''.<br />
*'''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><br />
</ol><br />
<br><br />
<br />
=== Completion (For Both Methods) === <br />
<ol><br />
<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><br />
<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><br />
</ol><br />
<br><br />
<br />
== SKYFIRE WOW.EXE PATCHER ==<br />
Your Wow.exe client will be needed to be patched before you can properly connect to your server.<br />
<br />
<br />
=== Patching ===<br />
Pull the latest version of SkyFire-Community-Tools from<br />
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre><br />
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.<br />
<br><br />
<br />
=== Pre-Patched Method (Easy Method)===<br />
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.<br />
<br><br />
<br />
=== Manuel Compile Method (Not really needed but will keep this for now)===<br />
<br />
*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''<br />
*You will not need CMake for this.<br />
<ol><br />
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li><br />
<li>Select "Release"</li><br />
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li><br />
<li>Clean</li><br />
<li>Build. (This should take less than a minute.)</li><br />
</ol><br />
<br />
*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><br />
<br />
<br />
<br />
*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder.<br>(You can delete the rest if you like.)<br />
<br />
<br />
==== Keeping the code up to date ====<br />
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing.<br><br />
<br />
=== Moving and Patching ===<br />
<ol><br />
<li>Move SkyFirePatcher.exe into your Wow directory.<br>(Usually something like C:\Program Files (x86)\World of Warcraft)</li><br><br />
<br />
<li>Now run SkyFirePatcher.exe and a dialog should pop up with:<br />
<pre>Loading Wow.exe into memory...<br />
Success!<br />
Ready to patch Wow.exe.</pre><br />
And "Status: Ready!" at the bottom.</li><br><br />
<br />
<li>Click "Patch" at the bottom to patch your Wow.exe<br><br />
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li><br><br />
</ol><br />
=== Play! ===<br />
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.<br />
<br><br />
<br><br />
<br><br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Win<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]<br />
<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(Windows_5xx)&diff=936Installation (Windows 5xx)2021-09-14T23:08:00Z<p>Admin: /* Software Required */</p>
<hr />
<div>{| align="right"<br />
<br />
|-<br />
<br />
| __TOC__<br />
<br />
|}<br />
<br />
<br />
== INTRODUCTION ==<br />
<p>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.</p><br />
<p>After the first few times everyone gets used to the procedure and never needs to look at this guide ever again.</p><br><br />
<br />
=== Software Required ===<br />
<p><ol><br />
<li>[http://git-scm.com/download Git]<br>You can also use TortoiseGit that is more compatible with Windows (8).<br>[http://code.google.com/p/tortoisegit/ TortoiseGIT]</li><br><br />
<br />
<li>Install the compiler Visual C++ 2019 Community [http://www.visualstudio.com/en-us/downloads/download-visual-studio-vs#DownloadFamilies_2 Here].<br />
</li><br><br />
<br />
<li>[http://www.slproweb.com/products/Win32OpenSSL.html OpenSSL]<br />
*'''Current minimum supported version is OpenSSL v1.1.1c - Do NOT use the light version!'''<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit bit version if you have a 64bit compiler.<br />
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.<br />
*You may have to download and install one of the Microsoft Visual C++ Redistributable Packages for OpenSSL to work.</li><br><br />
<br />
<li>[http://www.cmake.org/cmake/resources/software.html CMake]<br />
CMake Version 3.16.3 or greater</li><br><br />
<br />
<li>MySQL Server<br />
*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]<br />
*It's recommended that your MySQL server and the MySQL header source versions match.<br />
*Current SkyFire core MySQL header version: 8.0.X<br />
*'''[https://dev.mysql.com/downloads/mysql/ Download MySQL Installer. ] ''' Be sure to install the development libraries else your core will not compile.<br />
*Download the 32bit version if you have a 32bit compiler or the 64bit version if you have a 64bit compiler.<br />
*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><br><br />
<br />
<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><br><br />
<br />
<li>SQL Client: [http://www.heidisql.com/download.php HeidiSQL] [http://dev.mysql.com/downloads/gui-tools/5.0.html MySQL GUI Tools]<br />
*'''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><br />
</ol><br />
<br></p><br />
<br />
=== Software Recommended ===<br />
<p>git command help:<ul><br />
<li>[http://code.google.com/p/gitextensions/ gitextensions]<br />
*most popular with the community</li><br />
<li>[http://code.google.com/p/tortoisegit/ tortoisegit]<br />
*Makes pulling and cloning sources easier with right mouse clicks.<br />
*Also adds symbols over your folder and file icons to indicate if your source is inaccurate.<br />
*Note: You still need to install [http://git-scm.com/download Git] for this to work.<br />
</li><br />
</ul><br />
<br></p><br />
<br />
=== Microsoft Visual Studio 2019 ===<br />
<p><br />
Microsoft Visual Studio 2019 Community Edition [https://visualstudio.microsoft.com/downloads/ Download].<br />
<br><br />
Please note Visual Studio 2022 Preview is not supported.<br />
<br></p><br />
<br />
== PULLING AND COMPILING THE SOURCE ==<br />
<p><br />
*'''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.)'''<br />
</p><br />
<br />
=== Pulling the Source ===<br />
<p><ol><br />
<li>Create a directory in which Core files will be pulled (for example: '''C:\SkyFire_548''').</li><br />
<li>Right-click on the directory and click on '''Git Bash Here'''</li><br />
<li>Fill in the data as follows:</li><br><br />
<pre>git clone -b trunk https://github.com/ProjectSkyfire/SkyFire_548.git</pre><br />
</br><br />
<br />
<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><br />
</ol></p><br />
<br />
=== Configuring and Generating Visual C++ solutions with CMake ===<br />
<p><ol><br />
<li>Create a new directory in your '''C:\SkyFire_548\''' called "Build".<br />
<li>Open CMake. (cmake-gui)</li><br />
<li>Fill in the data as follows:</li><br><br />
<br />
Where the the source code: <br />
<pre>C:\SkyFire_548</pre><br />
<br />
Where to build the binaries: <br />
<pre>C:\SkyFire_548\build</pre><br />
<br><br />
<br />
<li>Click '''Configure'''.</li><br />
<li>It should ask you if you want to create the directory, '''click yes'''.</li><br />
<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'''.<br />
*NOTE: You MUST select the appropriate compiler!<br />
**If you are using Visual Studio 2019, your compiler would be "Visual Studio 16"</li><br />
<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.)<br><br />
Make sure these are the ones selected:<br />
<pre><br />
SCRIPTS<br />
SERVERS<br />
TOOLS<br />
USE_COREPCH<br />
USE_MYSQL_SOURCES (If you are NOT updating the MySQL header sources.)<br />
USE_SCRIPTPCH<br />
</pre><br />
<br />
*'''Do not worry about setting CMAKE_INTALL_PREFIX it's not used. Just keep it at it's default value (C:/Program Files/SkyFire)'''<br />
*'''(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><br />
<li>Click on '''Configure''' again to verify your selection. (Most of the red should now go away.)</li><br />
<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><br />
<li>When done, it'll state "Generating done"</li><br />
<li>Close CMake and continue below with '''Compiling the Source'''.<br />
</ol></p><br />
<br />
=== Compiling the Source ===<br />
<p><ol><br />
<li>Open '''SkyFire_548.sln''' located in your '''build''' folder with your chosen compiler.</li><br />
<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'''.<br><br />
<br />
<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><br />
*You will find the following message once the compilation has finished successfully: <br />
<pre>========== Build: 22 completed, 0 failed, 0 up-to-date, 1 skipped ==========<br />
</pre><br />
*You will find your freshly compiled binaries in your '''C:\SkyFire_548\build\bin\Release''' folder: <br />
<pre><br />
ace.dll<br />
libcrypto-1_1-x64.dll -> Needs to copy to the release folder.<br />
libeay32.dll -> Needs to copy to the release folder.<br />
libssl-1_1-x64.dll -> Needs to copy to the release folder.<br />
ssleay32.dll -> Needs to copy to the release folder.<br />
authserver.conf.dist<br />
authserver.exe<br />
libmysql.dll (If you did NOT update the header source.)*<br />
worldserver.conf.dist<br />
worldserver.exe<br />
</pre><br />
<br><br />
<br />
<li>Cut and Paste these files from '''C:\SkyFire_548\build\bin\Release''' to where ever your server will be runned from.<br>For demonstration\instruction purposes, we will move them to '''C:\SkyFire_548\Server\'''. Leave the rest there for now.<br></li><br />
<br />
<li>Rename authserver.conf.dist to authserver.conf and worldserver.conf.dist to worldserver.conf<br>These are your config files. Go through and edit each one to match your prefered settings.</li><br><br />
<br />
<li>You will also need '''libeay32.dll''' & '''ssleay32.dll''' to run your server.<br />
This file is found in your '''OpenSSL folder''' which is usually located '''C:\OpenSSL-Win*'''<br>Just copy and paste '''libeay32.dll''' & '''ssleay32.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li><br><br />
<br />
<li>'''(If you are updating MySQL header source):''' You will also need '''libmysql.dll''' to run your server.<br />
This file is found in your '''MySQL folder''' which is usually located '''C:\Program Files*\MySQL\MySQL Server *\lib'''<br>Just copy and paste '''libmysql.dll''' along with your other files in your '''C:\SkyFireEMU_5xx\Server''' folder.</li><br><br />
</ol></p><br />
<br />
=== Keeping the code up to date ===<br />
<p>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.<br />
<br />
<ol><br />
<li>Simply right-click on your '''C:\SkyFireEMU_5xx\Core''' folder and click on '''Git GUI Here'''.</li><br />
<li>Click on the '''Remote>Fetch from>origin''' when you see green line with text '''success''' hit '''Close'''.</li><br />
<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><br />
</ol><br />
<br />
*Now you can repeat the compiling procedure above.<br><br />
*<u>'''And remember to clean your build everytime!'''</u><br />
<br></p><br />
<br />
== IMPORTING THE DATABASE ==<br />
<p><br />
*'''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.'''<br></p><br />
<br />
=== Creating Auth, Characters and World Databases ===<br />
<p>Using your chosen SQL Client, create the three Databases.<br />
<ol><br />
<li>Auth</li><br />
<li>Characters</li><br />
<li>World</li><br />
</ol><br />
*Doing this may prevent importing problems later.<br />
</p><br />
<br />
==== Importing Auth and Characters Databases ====<br />
<p>Using your chosen SQL Client,<br />
import both the '''auth_database.sql''' and '''characters_database.sql''' files located in '''C:\SkyFireEMU\Core\<u>sql\base</u>''' to their respective places in your MySQL database.</p><br />
<br />
<br />
==== Importing World Database ====<br />
<p><ol><br />
----<br />
<br />
Grab the latest version of SkyFireDB_5xx from our forum:<br />
<br />
<pre>http://www.projectskyfire.org/index.php?/files/</pre><br />
<br />
Import the DB into your world table. Will update this method shortly</p><br />
<br />
==== Importing Important Database Structure Updates ====<br />
<ol><br />
<li>Go into your '''C:\SkyFireEMU\core\<u>sql\updates</u>''' directory.</li><br><br />
<li>Apply updates to their appropriate corresponding databases using your chosen SQL client.</li><br />
</ol><br />
<br />
==== Importing World Database Updates ====<br />
<ol><br />
<li>Open '''Database_Installer_Updater.bat''' found in '''C:\SkyFireEMU\Core\database'''</li><br />
<li>Follow the dialog and enter in your info like you did before.</li><br />
<li>Press '''U''' to import the World Database updates when asked.</li><br />
<li>Select the correct changesets needed.</li><br />
</ol><br />
*Or.. if you are a "pro" use your SQL client and import needed changes from '''C:\SkyFireEMU\Core\database\updates'''<br />
<br />
=== Auth Database Accounts and Passwords ===<br />
It is '''highly advised''' you change the passwords or delete these accounts. <br />
*'''NOTE''': These may not exist.<br />
<pre>User: Administrator<br />
Pass: Administrator<br />
<br />
User: Moderator<br />
Pass: Moderator<br />
<br />
User: Developer<br />
Pass: Developer<br />
<br />
User: Gamemaster<br />
Pass: Gamemaster<br />
<br />
User: Player<br />
Pass: Player</pre><br />
<br />
==== Changing passwords ====<br />
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><br />
<br />
==== Deleting accounts ====<br />
You can delete an account simply by going to your Worldserver console and type<pre>account delete <accountname></pre><br />
<br />
==== Making new accounts ====<br />
You can make a new account simply by going to your Worldserver console and type<pre>account create <accountname> <password></pre><br />
<br />
==== Raising an account's access/GM level ====<br />
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.<br />
*id=your account id found under '''accounts'''<br />
*GM/Access Levels: 0=Regular player, 1=Gamemaster, 2=Developer, 3=Moderator, 4=Administrator<br />
**You can only add Administrator (gmlevel 4) with your SQL client<br />
*RealmID is usually 1 or -1 for all realms<br />
<br><br />
<br />
== DBC, MAPS, VMAPS, and MMAPS ==<br />
<br />
*'''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!'''<br />
*We will, however, help you through the extraction process with step-by-step instructions<br />
*'''NOTE: Contrary to popular belief, your client does NOT have to have been on the live server to extract DBCs, MAPS, VMAPS, or MMAPS.'''<br />
<ol></li><br><br />
<br />
<li>The '''VERY FIRST THING''' you need is a WoW client fully patched to version 4.0.6a (build 13623)<br />
*'''NOTE:''' Your client has NOT been fully patched unless you have completed the following steps:<br />
**Ensure your '''config.wtf''' AND '''launcher.wtf''' are set at '''SET accounttype "<u>CT</u>"''', NOT "<u>LK</u>".<br />
**'''Then run launcher.exe and allow it to update your data files to the Cataclysm expansion, must download fully.'''<br />
**'''DO NOT ALLOW THE LAUNCHER TO BEGIN DOWNLOADING THE NEXT PATCH... CLOSE IMMEDIATELY AFTER DOWNLOADING TOOLS!'''<br />
**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><br><br />
<br />
<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><br><br />
<br />
<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).<br />
*Locate file named '''"libmysql.dll"'''.<br />
*Copy this file and Paste it into your wow directory (ONLY COPY, do NOT move this file!).<br />
</ol><br />
<br><br />
<br />
=== Manual Extraction Method ===<br />
<ol><br />
<li>Open a command prompt to your wow directory (cd C:\Program Files (x86)\World of Warcraft).</li><br />
*To open a command prompt hold down shift and right-click inside the folder and then select: Open command window here. </li><br><br />
<u><b>Dbc and Maps:</b></u><br />
<li>In your command prompt type '''extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made two new directories, '''dbc''' and '''maps'''.</li><br><br />
<u><b>VMaps:</b></u><br />
<li>In your command prompt type '''vmap3extractor.exe''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory named '''Buildings'''.</li><br />
<li>In your command prompt type '''mkdir vmaps''' (or simply make a '''new folder''' and rename it to '''vmaps''').</li><br />
<li>Then in your command prompt again, type '''vmap3assembler.exe Buildings vmaps''' and hit enter.</li><br />
<li>Wait until finished.</li><br />
<li>It should have made a new directory, '''vmaps'''.</li><br><br />
<u><b>MMaps:</b></u><br />
<li>Move the entire contents of your '''buildings''' folder into your '''vmaps''' folder ('''The contents <u>ONLY</u>'''. You do NOT want the folder named '''buildings''' inside your '''vmaps''' folder).</li><br />
<li>You may now Delete the empty '''buildings''' folder.</li><br />
<li>Create a new folder named '''mmaps'''.</li><br />
<li>Now execute the '''mmaps_generator.exe'''.<br />
*'''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><br />
</ol><br />
<br><br />
<br />
=== Completion (For Both Methods) === <br />
<ol><br />
<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><br />
<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><br />
</ol><br />
<br><br />
<br />
== SKYFIRE WOW.EXE PATCHER ==<br />
Your Wow.exe client will be needed to be patched before you can properly connect to your server.<br />
<br />
<br />
=== Patching ===<br />
Pull the latest version of SkyFire-Community-Tools from<br />
<pre>git://github.com/ProjectSkyfire/SkyFire-Community-Tools.git</pre><br />
You now have what you need to patch your wow. Choose one of the methods below to patch your wow.<br />
<br><br />
<br />
=== Pre-Patched Method (Easy Method)===<br />
Open SkyFire-Community-Tools\SkyFire Patcher\ and skip to '''Moving and Patching'''.<br />
<br><br />
<br />
=== Manuel Compile Method (Not really needed but will keep this for now)===<br />
<br />
*'''Note: The patcher is made in C# and not C++. You need a C# compiler to compile it.'''<br />
*You will not need CMake for this.<br />
<ol><br />
<li>Open SkyFirePatcher.sln (located in '''..Sources\Patcher''') with C#.</li><br />
<li>Select "Release"</li><br />
<li>The platform should be "Any" (No separate 32/64 bit versions.)</li><br />
<li>Clean</li><br />
<li>Build. (This should take less than a minute.)</li><br />
</ol><br />
<br />
*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><br />
<br />
<br />
<br />
*After you compiled it, you should have SkyFirePatcher.exe in your '''..Sources\Patcher\SkyFirePatcher\bin\Release''' folder.<br>(You can delete the rest if you like.)<br />
<br />
<br />
==== Keeping the code up to date ====<br />
Again, you should be an expert by now with this pulling the source stuff. It's basically the same thing.<br><br />
<br />
=== Moving and Patching ===<br />
<ol><br />
<li>Move SkyFirePatcher.exe into your Wow directory.<br>(Usually something like C:\Program Files (x86)\World of Warcraft)</li><br><br />
<br />
<li>Now run SkyFirePatcher.exe and a dialog should pop up with:<br />
<pre>Loading Wow.exe into memory...<br />
Success!<br />
Ready to patch Wow.exe.</pre><br />
And "Status: Ready!" at the bottom.</li><br><br />
<br />
<li>Click "Patch" at the bottom to patch your Wow.exe<br><br />
It will make a backup of your original Wow.exe as well. (Something like wow-original.exe)</li><br><br />
</ol><br />
=== Play! ===<br />
*Use your new patched Wow.exe file to play on your server and the backed up original Wow.exe to play on retail.<br />
<br><br />
<br><br />
<br><br />
<br />
== References ==<br />
<br />
http://www.trinitycore.org/w/How-to:Win<br />
<br />
http://wiki.cactusemu.com/index.php?title=Installation_%28Windows%29<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=sitxeaONV5A Pulling core repository with TortoiseGit]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=ec3zxCmaVq4 CMake x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=TdPwKUy9gkE Compiling x64]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=uqbbpgJSUF0 Importing the databases and structure updates]<br />
<br />
Video tutorial: [http://www.youtube.com/watch?v=JoA5tSeTWn4 dbc, map and vmaps]<br />
<br />
<br />
<br />
[[Category:Installation]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_548&diff=869Account 5482021-08-09T23:59:53Z<p>Admin: Format</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br> <big>'''The `account` table'''</big> <br />
<br />
This table holds information on all available accounts. <br />
<br />
<br> <big>'''Structure'''</big> <br />
<br />
{| border="1"<br />
|-<br />
| '''Field''' <br />
| '''Type''' <br />
| '''Attributes''' <br />
| '''Key''' <br />
| '''Null''' <br />
| '''Default''' <br />
| '''Extra''' <br />
| '''Comment'''<br />
|-<br />
| [[#id|id]] <br />
| int(10) <br />
| unsigned <br />
| PRI <br />
| NO <br />
| <br />
| Auto increment <br />
| Identifier<br />
|-<br />
| [[#username|username]] <br />
| varchar(32) <br />
| signed <br />
| UNI <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sha_pass_hash|sha_pass_hash]] <br />
| varchar(40) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sessionkey|sessionkey]] <br />
| varchar(80) <br />
| signed <br />
| <br />
| NO <br />
| " <br />
| <br />
| <br />
|-<br />
| [[#v|v]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#s|s]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#token_key|token_key]] <br />
| varchar(100)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#email|email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#reg_email|reg_email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#joindate|joindate]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| CURRENT_TIMESTAMP <br />
| <br />
| <br />
|-<br />
| [[#last_ip|last_ip]] <br />
| varchar(15) <br />
| signed <br />
| <br />
| NO <br />
| 127.0.0.1 <br />
| <br />
| <br />
|-<br />
| [[#failed_logins|failed_logins]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locked|locked]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#lock_country|lock_country]] <br />
| varchar(2) <br />
| unsigned <br />
| <br />
| NO <br />
| 00 <br />
| <br />
| <br />
|-<br />
| [[#last_login|last_login]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| 0000-00-00 00:00:00 <br />
| <br />
| <br />
|-<br />
| [[#online|online]] <br />
| tinyint(3) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#expansion|expansion]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 2 <br />
| <br />
| <br />
|-<br />
| [[#mutetime|mutetime]] <br />
| bigint(20) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#mutereason|mutereason]] <br />
| varchar(255) <br />
| signed <br />
| <br />
| NO <br />
| <br />
| <br />
| <br />
|-<br />
| [[#muteby|muteby]] <br />
| varchar(50) <br />
| signed <br />
| <br />
| NO <br />
| <br />
| <br />
| <br />
|-<br />
| [[#locale|locale]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#os|os]] <br />
| varchar(3) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#recruiter|recruiter]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
|-<br />
| [[#hasBoost|hasBoost]] <br />
| tinyint <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
|<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `account` (<br />
`id` INT NOT NULL AUTO_INCREMENT COMMENT 'Identifier',<br />
`username` VARCHAR(32) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sha_pass_hash` VARCHAR(40) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sessionkey` VARCHAR(80) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`v` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`s` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`token_key` VARCHAR(100) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`email` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`reg_mail` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`joindate` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,<br />
`last_ip` VARCHAR(15) NOT NULL DEFAULT '127.0.0.1' COLLATE 'utf8_general_ci',<br />
`failed_logins` INT NOT NULL DEFAULT '0',<br />
`locked` TINYINT NOT NULL DEFAULT '0',<br />
`lock_country` VARCHAR(2) NOT NULL DEFAULT '00' COLLATE 'utf8_general_ci',<br />
`last_login` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00:00',<br />
`online` TINYINT NOT NULL DEFAULT '0',<br />
`expansion` TINYINT NOT NULL DEFAULT '4',<br />
`mutetime` BIGINT NOT NULL DEFAULT '0',<br />
`mutereason` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`muteby` VARCHAR(50) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`locale` TINYINT NOT NULL DEFAULT '0',<br />
`os` VARCHAR(3) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`recruiter` INT NOT NULL DEFAULT '0',<br />
`hasBoost` TINYINT NOT NULL DEFAULT '0',<br />
PRIMARY KEY (`id`) USING BTREE,<br />
UNIQUE INDEX `idx_username` (`username`) USING BTREE<br />
)<br />
COMMENT='Account System'<br />
COLLATE='utf8_general_ci'<br />
ENGINE=InnoDB<br />
;<br />
</pre><br />
<br />
<br> <big>'''Description of the fields'''</big> <br />
<br />
==== id ====<br />
The unique account ID. <br />
<br />
==== username ====<br />
The account user name. <br />
<br />
==== sha_pass_hash ====<br />
This field contains the encrypted password. The encryption is SHA1 and is in the following format: username:password. The SQL to create the password (or to compare with the current hash) is: <br />
<pre>SELECT SHA1(CONCAT(UPPER(`username`), ':', UPPER(&lt;pass&gt;)));</pre> <br />
<br />
==== sessionkey ====<br />
{{field-no-description|4}} <br />
<br />
==== v ====<br />
v is derived from salt, as well as the user's username (all uppercase) and their password (all uppercase).<br />
<br />
To obtain the verifier you need to calculate:<br />
<br />
Calculate h1 = SHA1("USERNAME:PASSWORD"), substituting the user's username and password converted to uppercase.<br />
<br />
Calculate h2 = SHA1(salt || h1), where || is concatenation (the . operator in PHP).<br />
<br />
NOTE: Both salt and h1 are binary, not hexadecimal strings!<br />
<br />
Treat h2 as an integer in little-endian order (the first byte is the least significant).<br />
<br />
Calculate (g ^ h2) % N.<br />
<br />
NOTE: g and N are parameters, which are fixed in the WoW implementation.<br />
<br />
g = 7<br />
<br />
N = 0x894B645E89E1535BBDAD5B8B290650530801B18EBFBF5E8FAB3C82872A3E9BB7<br />
<br />
Convert the result back to a byte array in little-endian order.<br />
<br />
<br />
==== s ====<br />
s is a cryptographically random 32-byte value. <br />
<br />
==== token_key ====<br />
{{field-no-description|7}} <br />
<br />
==== email ====<br />
The e-mail address associated with this account. <br />
<br />
==== reg_email ====<br />
The registration e-mail address associated with this account. <br />
<br />
==== joindate ====<br />
The date when the account was created. <br />
<br />
==== last_ip ====<br />
The last IP used by the person who logged in the account. <br />
<br />
==== failed_logins ====<br />
The number of failed logins attempted on the account. <br />
<br />
==== locked ====<br />
Boolean 0 or 1 controlling if the account has been locked or not. This can be controlled with the ".account lock" GM command. If locked (1), the user can only log in with their [[DB:Auth:account#last_ip|last_ip]]. If unlocked (0), a user can log in from any IP, and their last_ip will be updated if it is different. ".Ban account" does not lock it.<br />
<br />
==== lock_country ====<br />
{{field-no-description|14}} <br />
<br />
==== last_login ====<br />
The date when the account was last logged into. <br />
<br />
==== online ====<br />
Boolean 0 or 1 controlling if the account is currently logged in and online. <br />
<br />
==== expansion ====<br />
Boolean 0 or 1 controlling if the client logged in on the account has any expansions. (for example if client is TBC, but expansion is set to 0, it will not be able to enter outlands and etc.) <br />
<br />
==== mutetime ====<br />
The time, in Unix time, when the account will be unmuted. To see when mute will be expired you can use this query: <br />
<pre>SELECT FROM_UNIXTIME(`mutetime`);</pre> <br />
<br />
==== mutereason ====<br />
The reason for the mute.<br />
<br />
==== muteby ====<br />
The character name with the rights to the .mute command that give the mute.<br />
<br />
==== locale ====<br />
The locale used by the client logged into this account. If multiple locale data has been configured and added to the world servers, the world servers will return the proper locale strings to the client. See [[Localization lang|localization IDs]] <br />
<br />
==== os ====<br />
Stores information about client's OS. Used by Warden system.<br />
* Win<br />
* Mac<br />
<br />
==== recruiter ====<br />
The account ID of another account. Used for recuit-a-friend system. See [[DB:Auth:account#id|account.id]]<br />
<br />
==== hasBoost ==== <br />
{{field-no-description|24}}</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_548&diff=868Account 5482021-08-09T23:49:40Z<p>Admin: Format</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br> <big>'''The `account` table'''</big> <br />
<br />
This table holds information on all available accounts. <br />
<br />
<br> <big>'''Structure'''</big> <br />
<br />
{| border="1"<br />
|-<br />
| '''Field''' <br />
| '''Type''' <br />
| '''Attributes''' <br />
| '''Key''' <br />
| '''Null''' <br />
| '''Default''' <br />
| '''Extra''' <br />
| '''Comment'''<br />
|-<br />
| [[#id|id]] <br />
| int(10) <br />
| unsigned <br />
| PRI <br />
| NO <br />
| <br />
| Auto increment <br />
| Identifier<br />
|-<br />
| [[#username|username]] <br />
| varchar(32) <br />
| signed <br />
| UNI <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sha_pass_hash|sha_pass_hash]] <br />
| varchar(40) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sessionkey|sessionkey]] <br />
| varchar(80) <br />
| signed <br />
| <br />
| NO <br />
| " <br />
| <br />
| <br />
|-<br />
| [[#v|v]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#s|s]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#token_key|token_key]] <br />
| varchar(100)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#email|email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#reg_email|reg_email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#joindate|joindate]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| CURRENT_TIMESTAMP <br />
| <br />
| <br />
|-<br />
| [[#last_ip|last_ip]] <br />
| varchar(15) <br />
| signed <br />
| <br />
| NO <br />
| 127.0.0.1 <br />
| <br />
| <br />
|-<br />
| [[#failed_logins|failed_logins]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locked|locked]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#lock_country|lock_country]] <br />
| varchar(2) <br />
| unsigned <br />
| <br />
| NO <br />
| 00 <br />
| <br />
| <br />
|-<br />
| [[#last_login|last_login]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| 0000-00-00 00:00:00 <br />
| <br />
| <br />
|-<br />
| [[#online|online]] <br />
| tinyint(3) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#expansion|expansion]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 2 <br />
| <br />
| <br />
|-<br />
| [[#mutetime|mutetime]] <br />
| bigint(20) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locale|locale]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#os|os]] <br />
| varchar(3) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#recruiter|recruiter]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `account` (<br />
`id` INT NOT NULL AUTO_INCREMENT COMMENT 'Identifier',<br />
`username` VARCHAR(32) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sha_pass_hash` VARCHAR(40) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sessionkey` VARCHAR(80) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`v` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`s` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`token_key` VARCHAR(100) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`email` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`reg_mail` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`joindate` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,<br />
`last_ip` VARCHAR(15) NOT NULL DEFAULT '127.0.0.1' COLLATE 'utf8_general_ci',<br />
`failed_logins` INT NOT NULL DEFAULT '0',<br />
`locked` TINYINT NOT NULL DEFAULT '0',<br />
`lock_country` VARCHAR(2) NOT NULL DEFAULT '00' COLLATE 'utf8_general_ci',<br />
`last_login` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00:00',<br />
`online` TINYINT NOT NULL DEFAULT '0',<br />
`expansion` TINYINT NOT NULL DEFAULT '4',<br />
`mutetime` BIGINT NOT NULL DEFAULT '0',<br />
`mutereason` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`muteby` VARCHAR(50) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`locale` TINYINT NOT NULL DEFAULT '0',<br />
`os` VARCHAR(3) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`recruiter` INT NOT NULL DEFAULT '0',<br />
`hasBoost` TINYINT NOT NULL DEFAULT '0',<br />
PRIMARY KEY (`id`) USING BTREE,<br />
UNIQUE INDEX `idx_username` (`username`) USING BTREE<br />
)<br />
COMMENT='Account System'<br />
COLLATE='utf8_general_ci'<br />
ENGINE=InnoDB<br />
;<br />
</pre><br />
<br />
<br> <big>'''Description of the fields'''</big> <br />
<br />
==== id ====<br />
The unique account ID. <br />
<br />
==== username ====<br />
The account user name. <br />
<br />
==== sha_pass_hash ====<br />
This field contains the encrypted password. The encryption is SHA1 and is in the following format: username:password. The SQL to create the password (or to compare with the current hash) is: <br />
<pre>SELECT SHA1(CONCAT(UPPER(`username`), ':', UPPER(&lt;pass&gt;)));</pre> <br />
<br />
==== sessionkey ====<br />
{{field-no-description|4}} <br />
<br />
==== v ====<br />
v is derived from salt, as well as the user's username (all uppercase) and their password (all uppercase).<br />
<br />
To obtain the verifier you need to calculate:<br />
<br />
Calculate h1 = SHA1("USERNAME:PASSWORD"), substituting the user's username and password converted to uppercase.<br />
<br />
Calculate h2 = SHA1(salt || h1), where || is concatenation (the . operator in PHP).<br />
<br />
NOTE: Both salt and h1 are binary, not hexadecimal strings!<br />
<br />
Treat h2 as an integer in little-endian order (the first byte is the least significant).<br />
<br />
Calculate (g ^ h2) % N.<br />
<br />
NOTE: g and N are parameters, which are fixed in the WoW implementation.<br />
<br />
g = 7<br />
<br />
N = 0x894B645E89E1535BBDAD5B8B290650530801B18EBFBF5E8FAB3C82872A3E9BB7<br />
<br />
Convert the result back to a byte array in little-endian order.<br />
<br />
<br />
==== s ====<br />
s is a cryptographically random 32-byte value. <br />
<br />
==== token_key ====<br />
{{field-no-description|7}} <br />
<br />
==== email ====<br />
The e-mail address associated with this account. <br />
<br />
==== reg_email ====<br />
The registration e-mail address associated with this account. <br />
<br />
==== joindate ====<br />
The date when the account was created. <br />
<br />
==== last_ip ====<br />
The last IP used by the person who logged in the account. <br />
<br />
==== failed_logins ====<br />
The number of failed logins attempted on the account. <br />
<br />
==== locked ====<br />
Boolean 0 or 1 controlling if the account has been locked or not. This can be controlled with the ".account lock" GM command. If locked (1), the user can only log in with their [[DB:Auth:account#last_ip|last_ip]]. If unlocked (0), a user can log in from any IP, and their last_ip will be updated if it is different. ".Ban account" does not lock it.<br />
<br />
==== lock_country ====<br />
{{field-no-description|13}} <br />
<br />
==== last_login ====<br />
The date when the account was last logged into. <br />
<br />
==== online ====<br />
Boolean 0 or 1 controlling if the account is currently logged in and online. <br />
<br />
==== expansion ====<br />
Boolean 0 or 1 controlling if the client logged in on the account has any expansions. (for example if client is TBC, but expansion is set to 0, it will not be able to enter outlands and etc.) <br />
<br />
==== mutetime ====<br />
The time, in Unix time, when the account will be unmuted. To see when mute will be expired you can use this query: <br />
<pre>SELECT FROM_UNIXTIME(`mutetime`);</pre> <br />
<br />
==== locale ====<br />
The locale used by the client logged into this account. If multiple locale data has been configured and added to the world servers, the world servers will return the proper locale strings to the client. See [[Localization lang|localization IDs]] <br />
<br />
==== os ====<br />
Stores information about client's OS. Used by Warden system.<br />
* Win<br />
* Mac<br />
<br />
==== recruiter ====<br />
The account ID of another account. Used for recuit-a-friend system. See [[DB:Auth:account#id|account.id]]<br />
<br />
<br />
[[Category: SkyFire Auth database tables]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_548&diff=867Account 5482021-08-09T23:47:56Z<p>Admin: Format</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br> <big>'''The `account` table'''</big> <br />
<br />
This table holds information on all available accounts. <br />
<br />
<br> <big>'''Structure'''</big> <br />
<br />
{| border="1"<br />
|-<br />
| '''Field''' <br />
| '''Type''' <br />
| '''Attributes''' <br />
| '''Key''' <br />
| '''Null''' <br />
| '''Default''' <br />
| '''Extra''' <br />
| '''Comment'''<br />
|-<br />
| [[#id|id]] <br />
| int(10) <br />
| unsigned <br />
| PRI <br />
| NO <br />
| <br />
| Auto increment <br />
| Identifier<br />
|-<br />
| [[#username|username]] <br />
| varchar(32) <br />
| signed <br />
| UNI <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sha_pass_hash|sha_pass_hash]] <br />
| varchar(40) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sessionkey|sessionkey]] <br />
| varchar(80) <br />
| signed <br />
| <br />
| NO <br />
| " <br />
| <br />
| <br />
|-<br />
| [[#v|v]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#s|s]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#token_key|token_key]] <br />
| varchar(100)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#email|email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#reg_email|reg_email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#joindate|joindate]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| CURRENT_TIMESTAMP <br />
| <br />
| <br />
|-<br />
| [[#last_ip|last_ip]] <br />
| varchar(15) <br />
| signed <br />
| <br />
| NO <br />
| 127.0.0.1 <br />
| <br />
| <br />
|-<br />
| [[#failed_logins|failed_logins]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locked|locked]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#lock_country|lock_country]] <br />
| varchar(2) <br />
| unsigned <br />
| <br />
| NO <br />
| 00 <br />
| <br />
| <br />
|-<br />
| [[#last_login|last_login]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| 0000-00-00 00:00:00 <br />
| <br />
| <br />
|-<br />
| [[#online|online]] <br />
| tinyint(3) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#expansion|expansion]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 2 <br />
| <br />
| <br />
|-<br />
| [[#mutetime|mutetime]] <br />
| bigint(20) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locale|locale]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#os|os]] <br />
| varchar(3) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#recruiter|recruiter]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `account` (<br />
`id` INT NOT NULL AUTO_INCREMENT COMMENT 'Identifier',<br />
`username` VARCHAR(32) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sha_pass_hash` VARCHAR(40) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sessionkey` VARCHAR(80) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`v` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`s` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`token_key` VARCHAR(100) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`email` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`reg_mail` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`joindate` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,<br />
`last_ip` VARCHAR(15) NOT NULL DEFAULT '127.0.0.1' COLLATE 'utf8_general_ci',<br />
`failed_logins` INT NOT NULL DEFAULT '0',<br />
`locked` TINYINT NOT NULL DEFAULT '0',<br />
`lock_country` VARCHAR(2) NOT NULL DEFAULT '00' COLLATE 'utf8_general_ci',<br />
`last_login` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00:00',<br />
`online` TINYINT NOT NULL DEFAULT '0',<br />
`expansion` TINYINT NOT NULL DEFAULT '4',<br />
`mutetime` BIGINT NOT NULL DEFAULT '0',<br />
`mutereason` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`muteby` VARCHAR(50) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`locale` TINYINT NOT NULL DEFAULT '0',<br />
`os` VARCHAR(3) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`recruiter` INT NOT NULL DEFAULT '0',<br />
`hasBoost` TINYINT NOT NULL DEFAULT '0',<br />
PRIMARY KEY (`id`) USING BTREE,<br />
UNIQUE INDEX `idx_username` (`username`) USING BTREE<br />
)<br />
COMMENT='Account System'<br />
COLLATE='utf8_general_ci'<br />
ENGINE=InnoDB<br />
;<br />
</pre><br />
<br />
<br> <big>'''Description of the fields'''</big> <br />
<br />
==== id ====<br />
The unique account ID. <br />
<br />
==== username ====<br />
The account user name. <br />
<br />
==== sha_pass_hash ====<br />
This field contains the encrypted password. The encryption is SHA1 and is in the following format: username:password. The SQL to create the password (or to compare with the current hash) is: <br />
<pre>SELECT SHA1(CONCAT(UPPER(`username`), ':', UPPER(&lt;pass&gt;)));</pre> <br />
<br />
==== sessionkey ====<br />
{{field-no-description|6}} <br />
<br />
==== v ====<br />
v is derived from salt, as well as the user's username (all uppercase) and their password (all uppercase).<br />
<br />
To obtain the verifier you need to calculate:<br />
<br />
Calculate h1 = SHA1("USERNAME:PASSWORD"), substituting the user's username and password converted to uppercase.<br />
<br />
Calculate h2 = SHA1(salt || h1), where || is concatenation (the . operator in PHP).<br />
<br />
NOTE: Both salt and h1 are binary, not hexadecimal strings!<br />
<br />
Treat h2 as an integer in little-endian order (the first byte is the least significant).<br />
<br />
Calculate (g ^ h2) % N.<br />
<br />
NOTE: g and N are parameters, which are fixed in the WoW implementation.<br />
<br />
g = 7<br />
<br />
N = 0x894B645E89E1535BBDAD5B8B290650530801B18EBFBF5E8FAB3C82872A3E9BB7<br />
<br />
Convert the result back to a byte array in little-endian order.<br />
<br />
<br />
==== s ====<br />
s is a cryptographically random 32-byte value. <br />
<br />
==== token_key ====<br />
{{field-no-description|7}} <br />
<br />
==== email ====<br />
The e-mail address associated with this account. <br />
<br />
==== reg_email ====<br />
The registration e-mail address associated with this account. <br />
<br />
==== joindate ====<br />
The date when the account was created. <br />
<br />
==== last_ip ====<br />
The last IP used by the person who logged in the account. <br />
<br />
==== failed_logins ====<br />
The number of failed logins attempted on the account. <br />
<br />
==== locked ====<br />
Boolean 0 or 1 controlling if the account has been locked or not. This can be controlled with the ".account lock" GM command. If locked (1), the user can only log in with their [[DB:Auth:account#last_ip|last_ip]]. If unlocked (0), a user can log in from any IP, and their last_ip will be updated if it is different. ".Ban account" does not lock it.<br />
<br />
==== lock_country ====<br />
{{field-no-description|13}} <br />
<br />
==== last_login ====<br />
The date when the account was last logged into. <br />
<br />
==== online ====<br />
Boolean 0 or 1 controlling if the account is currently logged in and online. <br />
<br />
==== expansion ====<br />
Boolean 0 or 1 controlling if the client logged in on the account has any expansions. (for example if client is TBC, but expansion is set to 0, it will not be able to enter outlands and etc.) <br />
<br />
==== mutetime ====<br />
The time, in Unix time, when the account will be unmuted. To see when mute will be expired you can use this query: <br />
<pre>SELECT FROM_UNIXTIME(`mutetime`);</pre> <br />
<br />
==== locale ====<br />
The locale used by the client logged into this account. If multiple locale data has been configured and added to the world servers, the world servers will return the proper locale strings to the client. See [[Localization lang|localization IDs]] <br />
<br />
==== os ====<br />
Stores information about client's OS. Used by Warden system.<br />
* Win<br />
* Mac<br />
<br />
==== recruiter ====<br />
The account ID of another account. Used for recuit-a-friend system. See [[DB:Auth:account#id|account.id]]<br />
<br />
<br />
[[Category: SkyFire Auth database tables]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_548&diff=866Account 5482021-08-09T23:47:01Z<p>Admin: Format</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br> <big>'''The `account` table'''</big> <br />
<br />
This table holds information on all available accounts. <br />
<br />
<br> <big>'''Structure'''</big> <br />
<br />
{| border="1"<br />
|-<br />
| '''Field''' <br />
| '''Type''' <br />
| '''Attributes''' <br />
| '''Key''' <br />
| '''Null''' <br />
| '''Default''' <br />
| '''Extra''' <br />
| '''Comment'''<br />
|-<br />
| [[#id|id]] <br />
| int(10) <br />
| unsigned <br />
| PRI <br />
| NO <br />
| <br />
| Auto increment <br />
| Identifier<br />
|-<br />
| [[#username|username]] <br />
| varchar(32) <br />
| signed <br />
| UNI <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sha_pass_hash|sha_pass_hash]] <br />
| varchar(40) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sessionkey|sessionkey]] <br />
| varchar(80) <br />
| signed <br />
| <br />
| NO <br />
| " <br />
| <br />
| <br />
|-<br />
| [[#v|v]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#s|s]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#token_key|token_key]] <br />
| varchar(100)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#email|email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#reg_email|reg_email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#joindate|joindate]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| CURRENT_TIMESTAMP <br />
| <br />
| <br />
|-<br />
| [[#last_ip|last_ip]] <br />
| varchar(15) <br />
| signed <br />
| <br />
| NO <br />
| 127.0.0.1 <br />
| <br />
| <br />
|-<br />
| [[#failed_logins|failed_logins]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locked|locked]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#lock_country|lock_country]] <br />
| varchar(2) <br />
| unsigned <br />
| <br />
| NO <br />
| 00 <br />
| <br />
| <br />
|-<br />
| [[#last_login|last_login]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| 0000-00-00 00:00:00 <br />
| <br />
| <br />
|-<br />
| [[#online|online]] <br />
| tinyint(3) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#expansion|expansion]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 2 <br />
| <br />
| <br />
|-<br />
| [[#mutetime|mutetime]] <br />
| bigint(20) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locale|locale]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#os|os]] <br />
| varchar(3) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#recruiter|recruiter]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `account` (<br />
`id` INT NOT NULL AUTO_INCREMENT COMMENT 'Identifier',<br />
`username` VARCHAR(32) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sha_pass_hash` VARCHAR(40) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sessionkey` VARCHAR(80) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`v` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`s` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`token_key` VARCHAR(100) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`email` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`reg_mail` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`joindate` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,<br />
`last_ip` VARCHAR(15) NOT NULL DEFAULT '127.0.0.1' COLLATE 'utf8_general_ci',<br />
`failed_logins` INT NOT NULL DEFAULT '0',<br />
`locked` TINYINT NOT NULL DEFAULT '0',<br />
`lock_country` VARCHAR(2) NOT NULL DEFAULT '00' COLLATE 'utf8_general_ci',<br />
`last_login` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00:00',<br />
`online` TINYINT NOT NULL DEFAULT '0',<br />
`expansion` TINYINT NOT NULL DEFAULT '4',<br />
`mutetime` BIGINT NOT NULL DEFAULT '0',<br />
`mutereason` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`muteby` VARCHAR(50) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`locale` TINYINT NOT NULL DEFAULT '0',<br />
`os` VARCHAR(3) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`recruiter` INT NOT NULL DEFAULT '0',<br />
`hasBoost` TINYINT NOT NULL DEFAULT '0',<br />
PRIMARY KEY (`id`) USING BTREE,<br />
UNIQUE INDEX `idx_username` (`username`) USING BTREE<br />
)<br />
COMMENT='Account System'<br />
COLLATE='utf8_general_ci'<br />
ENGINE=InnoDB<br />
;<br />
</pre><br />
<br />
<br> <big>'''Description of the fields'''</big> <br />
<br />
==== id ====<br />
The unique account ID. <br />
<br />
==== username ====<br />
The account user name. <br />
<br />
==== sha_pass_hash ====<br />
This field contains the encrypted password. The encryption is SHA1 and is in the following format: username:password. The SQL to create the password (or to compare with the current hash) is: <br />
<pre>SELECT SHA1(CONCAT(UPPER(`username`), ':', UPPER(&lt;pass&gt;)));</pre> <br />
<br />
==== sessionkey ====<br />
{{field-no-description|5}} <br />
<br />
==== v ====<br />
v is derived from salt, as well as the user's username (all uppercase) and their password (all uppercase).<br />
<br />
To obtain the verifier you need to calculate:<br />
<br />
Calculate h1 = SHA1("USERNAME:PASSWORD"), substituting the user's username and password converted to uppercase.<br />
<br />
Calculate h2 = SHA1(salt || h1), where || is concatenation (the . operator in PHP).<br />
<br />
NOTE: Both salt and h1 are binary, not hexadecimal strings!<br />
<br />
Treat h2 as an integer in little-endian order (the first byte is the least significant).<br />
<br />
Calculate (g ^ h2) % N.<br />
<br />
NOTE: g and N are parameters, which are fixed in the WoW implementation.<br />
<br />
g = 7<br />
<br />
N = 0x894B645E89E1535BBDAD5B8B290650530801B18EBFBF5E8FAB3C82872A3E9BB7<br />
<br />
Convert the result back to a byte array in little-endian order.<br />
<br />
<br />
==== s ====<br />
s is a cryptographically random 32-byte value. <br />
<br />
==== token_key ====<br />
{{field-no-description|6}} <br />
<br />
==== email ====<br />
The e-mail address associated with this account. <br />
<br />
==== reg_email ====<br />
The registration e-mail address associated with this account. <br />
<br />
==== joindate ====<br />
The date when the account was created. <br />
<br />
==== last_ip ====<br />
The last IP used by the person who logged in the account. <br />
<br />
==== failed_logins ====<br />
The number of failed logins attempted on the account. <br />
<br />
==== locked ====<br />
Boolean 0 or 1 controlling if the account has been locked or not. This can be controlled with the ".account lock" GM command. If locked (1), the user can only log in with their [[DB:Auth:account#last_ip|last_ip]]. If unlocked (0), a user can log in from any IP, and their last_ip will be updated if it is different. ".Ban account" does not lock it.<br />
<br />
==== lock_country ====<br />
{{field-no-description|13}} <br />
<br />
==== last_login ====<br />
The date when the account was last logged into. <br />
<br />
==== online ====<br />
Boolean 0 or 1 controlling if the account is currently logged in and online. <br />
<br />
==== expansion ====<br />
Boolean 0 or 1 controlling if the client logged in on the account has any expansions. (for example if client is TBC, but expansion is set to 0, it will not be able to enter outlands and etc.) <br />
<br />
==== mutetime ====<br />
The time, in Unix time, when the account will be unmuted. To see when mute will be expired you can use this query: <br />
<pre>SELECT FROM_UNIXTIME(`mutetime`);</pre> <br />
<br />
==== locale ====<br />
The locale used by the client logged into this account. If multiple locale data has been configured and added to the world servers, the world servers will return the proper locale strings to the client. See [[Localization lang|localization IDs]] <br />
<br />
==== os ====<br />
Stores information about client's OS. Used by Warden system.<br />
* Win<br />
* Mac<br />
<br />
==== recruiter ====<br />
The account ID of another account. Used for recuit-a-friend system. See [[DB:Auth:account#id|account.id]]<br />
<br />
<br />
[[Category: SkyFire Auth database tables]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_548&diff=865Account 5482021-08-09T23:25:42Z<p>Admin: Update structure and add DB structure.</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br> <big>'''The `account` table'''</big> <br />
<br />
This table holds information on all available accounts. <br />
<br />
<br> <big>'''Structure'''</big> <br />
<br />
{| border="1"<br />
|-<br />
| '''Field''' <br />
| '''Type''' <br />
| '''Attributes''' <br />
| '''Key''' <br />
| '''Null''' <br />
| '''Default''' <br />
| '''Extra''' <br />
| '''Comment'''<br />
|-<br />
| [[#id|id]] <br />
| int(10) <br />
| unsigned <br />
| PRI <br />
| NO <br />
| <br />
| Auto increment <br />
| Identifier<br />
|-<br />
| [[#username|username]] <br />
| varchar(32) <br />
| signed <br />
| UNI <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sha_pass_hash|sha_pass_hash]] <br />
| varchar(40) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#sessionkey|sessionkey]] <br />
| varchar(80) <br />
| signed <br />
| <br />
| NO <br />
| " <br />
| <br />
| <br />
|-<br />
| [[#v|v]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#s|s]] <br />
| varchar(64) <br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#email|email]] <br />
| varchar(254)<br />
| signed <br />
| <br />
| NO<br />
| "<br />
| <br />
| <br />
|-<br />
| [[#joindate|joindate]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| CURRENT_TIMESTAMP <br />
| <br />
| <br />
|-<br />
| [[#last_ip|last_ip]] <br />
| varchar(15) <br />
| signed <br />
| <br />
| NO <br />
| 127.0.0.1 <br />
| <br />
| <br />
|-<br />
| [[#failed_logins|failed_logins]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locked|locked]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#last_login|last_login]] <br />
| timestamp <br />
| signed <br />
| <br />
| NO <br />
| 0000-00-00 00:00:00 <br />
| <br />
| <br />
|-<br />
| [[#online|online]] <br />
| tinyint(3) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#expansion|expansion]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 2 <br />
| <br />
| <br />
|-<br />
| [[#mutetime|mutetime]] <br />
| bigint(20) <br />
| signed <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#locale|locale]] <br />
| tinyint(3) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|-<br />
| [[#os|os]] <br />
| varchar(3) <br />
| signed <br />
| <br />
| NO <br />
| "<br />
| <br />
| <br />
|-<br />
| [[#recruiter|recruiter]] <br />
| int(10) <br />
| unsigned <br />
| <br />
| NO <br />
| 0 <br />
| <br />
| <br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `account` (<br />
`id` INT NOT NULL AUTO_INCREMENT COMMENT 'Identifier',<br />
`username` VARCHAR(32) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sha_pass_hash` VARCHAR(40) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`sessionkey` VARCHAR(80) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`v` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`s` VARCHAR(64) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`token_key` VARCHAR(100) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`email` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`reg_mail` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`joindate` TIMESTAMP NOT NULL DEFAULT CURRENT_TIMESTAMP,<br />
`last_ip` VARCHAR(15) NOT NULL DEFAULT '127.0.0.1' COLLATE 'utf8_general_ci',<br />
`failed_logins` INT NOT NULL DEFAULT '0',<br />
`locked` TINYINT NOT NULL DEFAULT '0',<br />
`lock_country` VARCHAR(2) NOT NULL DEFAULT '00' COLLATE 'utf8_general_ci',<br />
`last_login` TIMESTAMP NOT NULL DEFAULT '0000-00-00 00:00:00',<br />
`online` TINYINT NOT NULL DEFAULT '0',<br />
`expansion` TINYINT NOT NULL DEFAULT '4',<br />
`mutetime` BIGINT NOT NULL DEFAULT '0',<br />
`mutereason` VARCHAR(255) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`muteby` VARCHAR(50) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`locale` TINYINT NOT NULL DEFAULT '0',<br />
`os` VARCHAR(3) NOT NULL DEFAULT '' COLLATE 'utf8_general_ci',<br />
`recruiter` INT NOT NULL DEFAULT '0',<br />
`hasBoost` TINYINT NOT NULL DEFAULT '0',<br />
PRIMARY KEY (`id`) USING BTREE,<br />
UNIQUE INDEX `idx_username` (`username`) USING BTREE<br />
)<br />
COMMENT='Account System'<br />
COLLATE='utf8_general_ci'<br />
ENGINE=InnoDB<br />
;<br />
</pre><br />
<br />
<br> <big>'''Description of the fields'''</big> <br />
<br />
==== id ====<br />
The unique account ID. <br />
<br />
==== username ====<br />
The account user name. <br />
<br />
==== sha_pass_hash ====<br />
This field contains the encrypted password. The encryption is SHA1 and is in the following format: username:password. The SQL to create the password (or to compare with the current hash) is: <br />
<pre>SELECT SHA1(CONCAT(UPPER(`username`), ':', UPPER(&lt;pass&gt;)));</pre> <br />
<br />
==== sessionkey ====<br />
{{field-no-description|5}} <br />
<br />
==== v ====<br />
{{field-no-description|6}} <br />
<br />
==== s ====<br />
{{field-no-description|7}} <br />
<br />
==== email ====<br />
The e-mail address associated with this account. <br />
<br />
==== joindate ====<br />
The date when the account was created. <br />
<br />
==== last_ip ====<br />
The last IP used by the person who logged in the account. <br />
<br />
==== failed_logins ====<br />
The number of failed logins attempted on the account. <br />
<br />
==== locked ====<br />
Boolean 0 or 1 controlling if the account has been locked or not. This can be controlled with the ".account lock" GM command. If locked (1), the user can only log in with their [[DB:Auth:account#last_ip|last_ip]]. If unlocked (0), a user can log in from any IP, and their last_ip will be updated if it is different. ".Ban account" does not lock it.<br />
<br />
==== last_login ====<br />
The date when the account was last logged into. <br />
<br />
==== online ====<br />
Boolean 0 or 1 controlling if the account is currently logged in and online. <br />
<br />
==== expansion ====<br />
Boolean 0 or 1 controlling if the client logged in on the account has any expansions. (for example if client is TBC, but expansion is set to 0, it will not be able to enter outlands and etc.) <br />
<br />
==== mutetime ====<br />
The time, in Unix time, when the account will be unmuted. To see when mute will be expired you can use this query: <br />
<pre>SELECT FROM_UNIXTIME(`mutetime`);</pre> <br />
<br />
==== locale ====<br />
The locale used by the client logged into this account. If multiple locale data has been configured and added to the world servers, the world servers will return the proper locale strings to the client. See [[Localization lang|localization IDs]] <br />
<br />
==== os ====<br />
Stores information about client's OS. Used by Warden system.<br />
* Win<br />
* Mac<br />
<br />
==== recruiter ====<br />
The account ID of another account. Used for recuit-a-friend system. See [[DB:Auth:account#id|account.id]]<br />
<br />
<br />
[[Category: SkyFire Auth database tables]]</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Account_access_548&diff=864Account access 5482021-08-09T23:24:12Z<p>Admin: Add content and update</p>
<hr />
<div>{| align="right"<br />
|-<br />
| __TOC__<br />
|}<br />
{{Back-to:Auth_18414}} <br />
<br />
<br />
<big>'''The `account_access` table'''</big><br />
<br />
This table holds security access level for any realm in [[DB:Auth:realmlist|realmlist]] table. <br />
<br />
<br />
<big>'''Structure'''</big><br />
{| border="1"<br />
|'''Field'''<br />
|'''Type'''<br />
|'''Attributes'''<br />
|'''Key'''<br />
|'''Null'''<br />
|'''Default'''<br />
|'''Extra'''<br />
|'''Comment'''<br />
|-<br />
|[[#id|id]]<br />
|int(10)<br />
|unsigned<br />
|PRI<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#gmlevel|gmlevel]]<br />
|tinyint(3)<br />
|unsigned<br />
|<br />
|NO<br />
|<br />
|<br />
|<br />
|-<br />
|[[#RealmID|RealmID]]<br />
|int(11)<br />
|signed<br />
|PRI<br />
|NO<br />
|<nowiki>-1</nowiki><br />
|<br />
|<br />
|}<br />
<br> <big>'''DB Structure'''</big> <br />
<br><br />
{| border="1"<br><br />
<pre style="color: red"><br />
CREATE TABLE `account_access` (<br />
`id` INT NOT NULL,<br />
`gmlevel` TINYINT NOT NULL,<br />
`RealmID` INT NOT NULL DEFAULT -1,<br />
PRIMARY KEY (`id`, `RealmID`) USING BTREE<br />
)<br />
COLLATE='utf8_general_ci'<br />
ENGINE=InnoDB<br />
;<br />
</pre><br />
<br />
<big>'''Description of the fields'''</big><br />
<br />
==== id ====<br />
The account ID.<br />
<br />
==== gmlevel ====<br />
The account security level. Different levels have access to different commands. The individual level required for a command is defined in the command table in each realm.<br />
<br />
==== RealmID ====<br />
The Realm ID.</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Template:Back-to:Auth_18414&diff=863Template:Back-to:Auth 184142021-08-09T23:17:59Z<p>Admin: Fix link</p>
<hr />
<div>Back to [[DB:Auth_18414|auth database]] list of tables.</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Template:Back-to:Auth_18414&diff=862Template:Back-to:Auth 184142021-08-09T23:14:24Z<p>Admin: Created page with "{{Back-to:Auth_18414}}"</p>
<hr />
<div>{{Back-to:Auth_18414}}</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Project_Skyfire:Copyrights&diff=861Project Skyfire:Copyrights2021-08-09T22:59:30Z<p>Admin: GNU General Public License</p>
<hr />
<div> <big>Copyright (C) 2011-2021 Project SkyFire https://www.projectskyfire.org/<br />
Copyright (C) 2008-2021 TrinityCore <http://www.trinitycore.org/<br />
Copyright (C) 2005-2021 MaNGOS <https://www.getmangos.eu/><br><br />
This program is free software; you can redistribute it and/or modify it<br />
under the terms of the GNU General Public License as published by the<br />
Free Software Foundation; either version 3 of the License, or (at your<br />
option) any later version.<br><br />
This program is distributed in the hope that it will be useful, but WITHOUT<br />
ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or<br />
FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for<br />
more details.<br> <br />
You should have received a copy of the GNU General Public License along<br />
with this program. If not, see http://www.gnu.org/licenses/.</big></div>Adminhttps://wiki.projectskyfire.org/index.php?title=Main_Page&diff=860Main Page2021-08-09T22:54:56Z<p>Admin: Format. Cleanup</p>
<hr />
<div>{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to [[Project Skyfire]] wiki!</div><br />
<div style="top:+0.2em; font-size:95%;">We have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles. [[Special:UserLogin|Join]] and feel free to improve us.</div><br />
|}<br />
|}<br />
<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Getting started : Install the server 5.x.x SUPPORTED</h3><br />
----<br />
<br />
* Windows:<br />
** [[Installation (Windows_5xx)]] -- UPDATED<br />
* Linux:<br />
** [[Installation (Ubuntu 18.04_LTS)]] -- UPDATED<br />
** [[Installation (Debian 10)]] -- NEW<br />
** [[Installation (CentOS 7/8)]]<br />
</div><br />
<br />
<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;"><br />
<h3>SkyFire Database Structure 5.4.8 Build 18414</h3><br />
----<br />
<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_18414|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters_18414|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth_18414|Description of the SkyFire `'''auth'''` database structure]]<br />
</div><br />
<br />
<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;"><br />
<h3>AI Scripting</h3><br />
----<br />
<br />
* [[Smart AI (DB Scripting) reference]]<br />
* [[Guide on ScriptDev2's Event AI DB script]]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Development</h3><br />
----<br />
<br />
*[[Linux GDB Debugging]]<br />
*[[Mmaps Information]]<br />
*[[Opcode list]] -- Not Updated<br />
*[[DBC list]] -- Not Updated<br />
*[[SkyFire DB|Database Changelog]] -- Not Updated<br />
*[[Reporting Bugs|Reporting Bugs]]<br />
*[[DBC Files|DBC Files]] -- Not Updated<br />
*[[DBC Files 542|DBC Files (542)]] -- Not Updated<br />
*[[IRC Rules|IRC Rules]]<br />
</div><br />
<br />
<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;"><br />
<h3>Advanced Features</h3><br />
----<br />
<br />
*[[How-to:Advanced|Advanced Guides]] <br />
*[[How-to:MySQLStoredProcedures|How to use MySQL Stored Procedures]]<br />
*[[How-to:Advanced:Xampp|How to use Xampp with MySQL 8.0]]<br />
<br />
{{Pp-vandalism}}<br />
</div><br />
<br />
<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;"><br />
<h3>Scripting Assets</h3><br />
----<br />
<br />
This is a placeholder.<br />
</div><br />
<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;"><br />
<h3>Unsupported Legacy Information</h3><br />
----<br />
Install the server 4.0.6 a Archived<br />
----<br />
<br />
* [[Installation (Windows)]]<br />
* [[Installation (Linux)]]<br />
----<br />
Install the server 2.4.3 Archived<br />
----<br />
<br />
* [[Installation (Windows_243)]] -- Work In Progress<br />
* [[Installation Debian 9 (Linux_243 (General))]] -- Work In Progress<br />
** Ubuntu:<br />
*** [[Installation (Ubuntu 18.04LTS)]] -- Work In Progress<br />
<br />
----<br />
SkyFire Database Structure Legacy 4.0.6a<br />
----<br />
<br />
'''{{revision-number}}''' <br />
<br />
*[[DB:World|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth|Description of the SkyFire `'''auth'''` database structure]]<br />
<br />
----<br />
SkyFire Database Structure 2.4.3 Build 8606<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_243|Description of the SkyFire One `'''world'''` database structure]]<br />
*[[DB:Characters_243|Description of the SkyFire One `'''characters'''` database structure]]<br />
*[[DB:Auth_243|Description of the SkyFire One `'''auth'''` database structure]]<br />
----<br />
<br />
</div><br />
</div><br />
|}<br />
<br />
<br />
{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;" class="plainlinks"><br />
<ul> {{NUMBEROFARTICLES}} Articles</ul><br />
<ul> {{NUMBEROFPAGES}} Pages</ul><br />
<ul> {{NUMBEROFUSERS}} Registered Users</ul><br />
</div><br />
|}<br />
|}</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Main_Page&diff=859Main Page2021-08-09T22:12:00Z<p>Admin: Format</p>
<hr />
<div>{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to [[Project Skyfire]] wiki!</div><br />
<div style="top:+0.2em; font-size:95%;">We have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles. [[Special:UserLogin|Join]] and feel free to improve us.</div><br />
|}<br />
|}<br />
<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Getting started : Install the server 5.x.x SUPPORTED</h3><br />
----<br />
<br />
* Windows:<br />
** [[Installation (Windows_5xx)]] -- UPDATED<br />
* Linux:<br />
** [[Installation (Ubuntu 18.04_LTS)]] -- UPDATED<br />
** [[Installation (Debian 10)]] -- NEW<br />
** [[Installation (CentOS 7/8)]]<br />
</div><br />
<br />
<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;"><br />
<h3>SkyFire Database Structure 5.4.8 Build 18414</h3><br />
----<br />
<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_18414|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters_18414|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth_18414|Description of the SkyFire `'''auth'''` database structure]]<br />
</div><br />
<br />
<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;"><br />
<h3>AI Scripting</h3><br />
----<br />
<br />
* [[Smart AI (DB Scripting) reference]]<br />
* [[Guide on ScriptDev2's Event AI DB script]]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Development</h3><br />
----<br />
<br />
*[[Linux GDB Debugging]]<br />
*[[Mmaps Information]]<br />
*[[Opcode list]]<br />
*[[DBC list]]<br />
*[[Todo-list]]<br />
*[[SkyFire DB|Database Changelog]]<br />
*[[Reporting Bugs|Reporting Bugs]]<br />
*[[DBC Files|DBC Files]]<br />
*[[DBC Files 542|DBC Files (542)]]<br />
*[[IRC Rules|IRC Rules]]<br />
</div><br />
<br />
<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;"><br />
<h3>Advanced Features</h3><br />
----<br />
<br />
*[[How-to:Advanced|Advanced Guides]] <br />
*[[How-to:MySQLStoredProcedures|How to use MySQL Stored Procedures]]<br />
*[[How-to:Advanced:Xampp|How to use Xampp with MySQL 8.0]]<br />
<br />
{{Pp-vandalism}}<br />
</div><br />
<br />
<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;"><br />
<h3>Scripting Assets</h3><br />
----<br />
<br />
This is a placeholder.<br />
</div><br />
<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;"><br />
<h3>Unsupported Legacy Information</h3><br />
----<br />
Install the server 4.0.6 a Archived<br />
----<br />
<br />
* [[Installation (Windows)]]<br />
* [[Installation (Linux)]]<br />
----<br />
Install the server 2.4.3 Archived<br />
----<br />
<br />
* [[Installation (Windows_243)]] -- Work In Progress<br />
* [[Installation Debian 9 (Linux_243 (General))]] -- Work In Progress<br />
** Ubuntu:<br />
*** [[Installation (Ubuntu 18.04LTS)]] -- Work In Progress<br />
<br />
----<br />
SkyFire Database Structure Legacy 4.0.6a<br />
----<br />
<br />
'''{{revision-number}}''' <br />
<br />
*[[DB:World|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth|Description of the SkyFire `'''auth'''` database structure]]<br />
<br />
----<br />
SkyFire Database Structure 2.4.3 Build 8606<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_243|Description of the SkyFire One `'''world'''` database structure]]<br />
*[[DB:Characters_243|Description of the SkyFire One `'''characters'''` database structure]]<br />
*[[DB:Auth_243|Description of the SkyFire One `'''auth'''` database structure]]<br />
----<br />
<br />
</div><br />
</div><br />
|}<br />
<br />
<br />
{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;" class="plainlinks"><br />
<ul> {{NUMBEROFARTICLES}} Articles</ul><br />
<ul> {{NUMBEROFPAGES}} Pages</ul><br />
<ul> {{NUMBEROFUSERS}} Registered Users</ul><br />
</div><br />
|}<br />
|}</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Installation_(CentOS_7/8)&diff=858Installation (CentOS 7/8)2021-08-09T22:09:58Z<p>Admin: Placeholder</p>
<hr />
<div>CentOS<br />
<br />
Placeholder</div>Adminhttps://wiki.projectskyfire.org/index.php?title=Main_Page&diff=857Main Page2021-08-09T22:09:18Z<p>Admin: Format</p>
<hr />
<div>{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;">Welcome to [[Project Skyfire]] wiki!</div><br />
<div style="top:+0.2em; font-size:95%;">We have [[Special:Statistics|{{NUMBEROFARTICLES}}]] articles. [[Special:UserLogin|Join]] and feel free to improve us.</div><br />
|}<br />
|}<br />
<br />
{| width="100%" cellspacing="0" cellpadding="0"<br />
| colspan="2" |<br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Getting started : Install the server 5.x.x SUPPORTED</h3><br />
----<br />
<br />
** Windows:<br />
*** [[Installation (Windows_5xx)]] -- UPDATED<br />
** Linux:<br />
*** [[Installation (Ubuntu 18.04_LTS)]] -- UPDATED<br />
*** [[Installation (Debian 10)]] -- NEW<br />
*** [[Installation (CentOS 7/8)]]<br />
</div><br />
<br />
<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;"><br />
<h3>SkyFire Database Structure 5.4.8 Build 18414</h3><br />
----<br />
<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_18414|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters_18414|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth_18414|Description of the SkyFire `'''auth'''` database structure]]<br />
</div><br />
<br />
<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;"><br />
<h3>AI Scripting</h3><br />
----<br />
<br />
* [[Smart AI (DB Scripting) reference]]<br />
* [[Guide on ScriptDev2's Event AI DB script]]<br />
</div><br />
<br />
| width="50%" style="vertical-align:top;" |<br />
<br />
<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;"><br />
<h3>Development</h3><br />
----<br />
<br />
*[[Linux GDB Debugging]]<br />
*[[Mmaps Information]]<br />
*[[Opcode list]]<br />
*[[DBC list]]<br />
*[[Todo-list]]<br />
*[[SkyFire DB|Database Changelog]]<br />
*[[Reporting Bugs|Reporting Bugs]]<br />
*[[DBC Files|DBC Files]]<br />
*[[DBC Files 542|DBC Files (542)]]<br />
*[[IRC Rules|IRC Rules]]<br />
</div><br />
<br />
<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;"><br />
<h3>Advanced Features</h3><br />
----<br />
<br />
*[[How-to:Advanced|Advanced Guides]] <br />
*[[How-to:MySQLStoredProcedures|How to use MySQL Stored Procedures]]<br />
*[[How-to:Advanced:Xampp|How to use Xampp with MySQL 8.0]]<br />
<br />
{{Pp-vandalism}}<br />
</div><br />
<br />
<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;"><br />
<h3>Scripting Assets</h3><br />
----<br />
<br />
This is a placeholder.<br />
</div><br />
<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;"><br />
<h3>Unsupported Legacy Information</h3><br />
----<br />
Install the server 4.0.6 a Archived<br />
----<br />
<br />
* [[Installation (Windows)]]<br />
* [[Installation (Linux)]]<br />
----<br />
Install the server 2.4.3 Archived<br />
----<br />
<br />
* [[Installation (Windows_243)]] -- Work In Progress<br />
* [[Installation Debian 9 (Linux_243 (General))]] -- Work In Progress<br />
** Ubuntu:<br />
*** [[Installation (Ubuntu 18.04LTS)]] -- Work In Progress<br />
<br />
----<br />
SkyFire Database Structure Legacy 4.0.6a<br />
----<br />
<br />
'''{{revision-number}}''' <br />
<br />
*[[DB:World|Description of the SkyFire `'''world'''` database structure]]<br />
*[[DB:Characters|Description of the SkyFire `'''characters'''` database structure]]<br />
*[[DB:Auth|Description of the SkyFire `'''auth'''` database structure]]<br />
<br />
----<br />
SkyFire Database Structure 2.4.3 Build 8606<br />
You can always help us developing our wiki and improving our community.<br />
<br />
*[[DB:World_243|Description of the SkyFire One `'''world'''` database structure]]<br />
*[[DB:Characters_243|Description of the SkyFire One `'''characters'''` database structure]]<br />
*[[DB:Auth_243|Description of the SkyFire One `'''auth'''` database structure]]<br />
----<br />
<br />
</div><br />
</div><br />
|}<br />
<br />
<br />
{| id="mp-topbanner" style="width:100%; background:#f9f9f9; margin:1.2em 0 6px 0; border:1px solid #ddd;"<br />
| style="width:61%; color:#000;" |<br />
{| style="width:100%; border:none; background:none;"<br />
| style="width:280px; text-align:center; white-space:nowrap; color:#000;" |<br />
<div style="font-size:162%; border:none; margin:0; padding:.1em; color:#000;" class="plainlinks"><br />
<ul> {{NUMBEROFARTICLES}} Articles</ul><br />
<ul> {{NUMBEROFPAGES}} Pages</ul><br />
<ul> {{NUMBEROFUSERS}} Registered Users</ul><br />
</div><br />
|}<br />
|}</div>Admin