mirror of
https://github.com/EQEmu/Server.git
synced 2026-04-15 21:12:25 +00:00
Updated Ground Up Windows Install Rework (markdown)
Uleat
parent
c38e275ab7
commit
8c1b3a608e
@ -1,371 +1,276 @@
|
|||||||
<BODY LANG="en-US" BGCOLOR="#eeeeee" DIR="LTR">
|
**This guide provides instructions for compiling 32-bit Windows server binaries and setting up a local development server.**
|
||||||
|
|
||||||
<p><strong>This guide provides instructions for compiling 32-bit Windows server binaries and setting up a local development server.</strong></p>
|
**Read through this guide before starting to ensure an understanding of the process.**
|
||||||
|
|
||||||
<p><strong>Read through this guide before starting to ensure an understanding of the process.</strong></p>
|
**Please direct any questions to our server support channel in
|
||||||
|
[[discord](https://discord.gg/QHsm7CD)].**
|
||||||
|
|
||||||
<p><strong>Please direct any questions to our server support channel in [<a href="https://discord.gg/QHsm7CD">discord</a>].</strong></p>
|
---
|
||||||
|
|
||||||
<br>
|
## Compiler Setup
|
||||||
|
|
||||||
<hgroup>
|
The current c/c++ support standard of the EQEmulator server code base mandates the use of Visual Studio 2013 or later compilers.
|
||||||
|
|
||||||
<p><h2><strong>Compiler Setup</strong></h2></p>
|
Visual Studio 2017 is the current EQEmulator standard for binary compilation. Please ensure that your system meets the [[Visual Studio 2017 Minimum System Requirements](https://docs.microsoft.com/en-us/visualstudio/productinfo/vs2017-system-requirements-vs#visual-studio-2017-system-requirements)].
|
||||||
|
|
||||||
<p>The current c/c++ support standard of the EQEmulator server code base mandates the use of Visual Studio 2013 or later compilers.</p>
|
If your system does not meet the above requirements, or you are/would like to use an older version of Visual Studio, check the minimum system requirements for the version you plan to use. (It must still meet the Visual Studio 2013 or later requirement of the code base.)
|
||||||
|
|
||||||
<p>Visual Studio 2017 is the current EQEmulator standard for binary compilation. Please ensure that your system meets the <a href="https://docs.microsoft.com/en-us/visualstudio/productinfo/vs2017-system-requirements-vs#visual-studio-2017-system-requirements">Visual Studio 2017 Minimum System Requirements</a>.</p>
|
This setup assumes an install on a 64-bit Windows operating system with 32-bit target binaries.
|
||||||
|
|
||||||
<p>If your system does not meet the above requirements, or you are/would like to use an older version of Visual Studio, check the minimum system requirements for the version you plan to use. (It must still meet the Visual Studio 2013 or later requirement of the code base.)</p>
|
* ### Verify System Environment Variable %Path% Length
|
||||||
|
|
||||||
<p>This setup assumes an install on a 64-bit Windows operating system with 32-bit target binaries.</p>
|
Sometimes an automated server installation will fail due to the %Path% variable being full. This can happen with a manual installation as well.
|
||||||
|
|
||||||
<br>
|
Since this guide installs more programs than are required for server operation alone, verifying the length of %Path% is critical before we start.
|
||||||
|
|
||||||
<ul>
|
The easiest way to find it is to:
|
||||||
|
|
||||||
<li><p><h3>Verify System Environment Variable %Path% Length</h3></p></li>
|
* Click on your `Start` button
|
||||||
|
|
||||||
<p>Sometimes an automated server installation will fail due to the %Path% variable being full. This can happen with a manual installation as well.</p>
|
* Type "environment variable" into your search programs and files text box
|
||||||
|
|
||||||
<p>Since this guide installs more programs than are required for server operation, verifying the length of %Path% is critical before we start.</p>
|
* Click on `Edit system environment variables`
|
||||||
|
|
||||||
<br>
|
* Click the `Environment Variables` button on the window that pops up
|
||||||
|
|
||||||
<p>The easiest way to find it is to:</p>
|
* Ensure the variable `Path` is selected in the system variables section (bottom text box)
|
||||||
|
|
||||||
<ul>
|
* Click the `Edit` button
|
||||||
|
|
||||||
<li><p>Click on your start button</p></li>
|
You may check the length of your %Path% variable by copying the `Variable value` contents and pasting them into a text editor that supports "selection" count.
|
||||||
|
|
||||||
<li><p>Type 'environment variable' into your search programs and files text box</p></li>
|
|
||||||
|
|
||||||
<li><p>Click on 'Edit system environment variables'</p></li>
|
Registry values are only allocated 1024 bytes of storage. However, environmental variables may contain up to 2048 bytes through the use of an alias.
|
||||||
|
|
||||||
<li><p>Click the 'Environment Variables' button on the window that pops up</p></li>
|
If your selection count is greater than 768 characters, you may need to setup an alias to prevent corruption of the %Path% variable.
|
||||||
|
|
||||||
<li><p>Ensure the variable 'Path' is selected in the system variables section (bottom text box)</p></li>
|
* ### Required Programs
|
||||||
|
|
||||||
<li><p>Click the 'Edit' button</p></li>
|
Some of the pre-requisites for compiling binaries are the same as running a server.
|
||||||
|
|
||||||
</ul>
|
If you have already installed any of the following, the download and installation requirement should be omitted:
|
||||||
|
|
||||||
<br>
|
* Visual Studio 2017 Community Edition [[select Visual Studio 2017 Community Edition](https://visualstudio.microsoft.com/vs/older-downloads/)]
|
||||||
|
|
||||||
<p>You may check the length of your %Path% variable by copying the 'Variable value' contents and pasting them into a text editor that supports 'selection' count.</p>
|
_Note: Microsoft now requires a user account to download Visual Studio. Clicking the Visual Studio link above will take you to the "older versions" page. Clicking the_ `Download` _button on that page will prompt you to log in or create an account._
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60465078-3b56b180-9c1e-11e9-89c5-0137a6ed84ba.png">
|
* MariaDB (64-bit) [[download](https://downloads.mariadb.org/interstitial/mariadb-10.4.6/winx64-packages/mariadb-10.4.6-winx64.msi/from/http%3A//mirror.nodesdirect.com/mariadb/)]
|
||||||
|
|
||||||
<br><br>
|
* Perl v5.12.3.1204 (32-bit) [[download](https://github.com/EQEmu/eqemu.github.com/raw/master/downloads/ActivePerl-5.12.3.1204-MSWin32-x86-294330.msi)]
|
||||||
|
|
||||||
<p>Registry values are only allocated 1024 bytes of storage. However, environmental variables may contain up to 2048 bytes through the use of an alias.</p>
|
* CMake (64-bit) [[download](https://github.com/Kitware/CMake/releases/download/v3.14.5/cmake-3.14.5-win64-x64.msi)]
|
||||||
|
|
||||||
<p>If your selection count is greater than 768 characters, you may need to setup an alias to prevent corruption of the %Path% variable.</p>
|
<a name="back_git"></a>
|
||||||
|
|
||||||
<br>
|
* Git (64-bit - see [[note](Ground-Up-Windows-Install-Rework#note_git)] under install) [[download](https://git-scm.com/download/win)]
|
||||||
|
|
||||||
<li><p><h3>Required Programs</h3></p></li>
|
<a name="back_tgit"></a>
|
||||||
|
|
||||||
<p>Some of the pre-requisites for compiling binaries are the same as running a server.</p>
|
* TortoiseGit (64-bit - optional - see [[note](Ground-Up-Windows-Install-Rework#note_tgit)] under install) [[download](https://download.tortoisegit.org/tgit/2.8.0.0/TortoiseGit-2.8.0.0-64bit.msi)]
|
||||||
|
|
||||||
<br>
|
_Note: TortoiseGit is a menu-driven, add-on gui interface for Git. Though optional, this instructional provides for its use._
|
||||||
|
|
||||||
<p>If you have already installed any of the following, the download and installation requirement should be omitted:</p>
|
Some programs may be able to use newer versions, or even their lastest releases, without issue. But, this is not the case with Perl and (later) dependencies.
|
||||||
|
|
||||||
<ul>
|
The above list of programs is known to work for compiling working server binaries.
|
||||||
|
|
||||||
<li><p>Visual Studio 2017 Community Edition [<a href="https://visualstudio.microsoft.com/vs/older-downloads/">select Visual Studio 2017 Community Edition</a>]</p></li>
|
* ### Install Visual Studio
|
||||||
|
|
||||||
<li><p>MariaDB (64-bit) [<a href="https://downloads.mariadb.org/interstitial/mariadb-10.4.6/winx64-packages/mariadb-10.4.6-winx64.msi/from/http%3A//mirror.nodesdirect.com/mariadb/">download</a>]</p></li>
|
During the install process, ensure the option for `Desktop development with C++` is checked.
|
||||||
|
|
||||||
<li><p>Perl v5.12.3.1204 (32-bit) [<a href="https://github.com/EQEmu/eqemu.github.com/raw/master/downloads/ActivePerl-5.12.3.1204-MSWin32-x86-294330.msi">download</a>]</p></li>
|
This package is required by Visual Studio to compile c/c++ code and by CMake to determine available compiler options. It will cause CMake file generation to fail, if not enabled.
|
||||||
|
|
||||||
<li><p>CMake (64-bit) [<a href="https://github.com/Kitware/CMake/releases/download/v3.14.5/cmake-3.14.5-win64-x64.msi">download</a>]</p></li>
|
|
||||||
|
|
||||||
<a name="back_git"></a>
|
* ### Install MariaDB
|
||||||
|
|
||||||
<li><p>Git (64-bit - see <a href="Ground-Up-Windows-Install-Rework#note_git">note</a> under install) [<a href="https://git-scm.com/download/win">download</a>]</p></li>
|
This installation is self-explanatory.
|
||||||
|
|
||||||
<a name="back_tgit"></a>
|
_Note: You will need to keep track of your username and password. They will be needed anytime that you access the database as well as for setting up the server configuration files._
|
||||||
|
|
||||||
<li><p>TortoiseGit (64-bit - optional - see <a href="Ground-Up-Windows-Install-Rework#note_tgit">note</a> under install) [<a href="https://download.tortoisegit.org/tgit/2.8.0.0/TortoiseGit-2.8.0.0-64bit.msi">download</a>]</p></li>
|
At the end of the installation process, you will be prompted to install HeidiSQL. It is **HIGHLY** recommended that you install this program.
|
||||||
|
|
||||||
</ul>
|
* ### Install Perl 5.12.3 (32-bit)
|
||||||
|
|
||||||
<br>
|
This installation is self-explanatory.
|
||||||
|
|
||||||
<p>Note: Microsoft now requires a user account to download Visual Studio. Clicking the Visual Studio link above will take you to the 'older versions' page. Clicking the download button on this page will prompt you to log in or create an account. [<a href="Ground-Up-Windows-Install-Rework#back_msvs">back</a>]</p>
|
_Note: It is recommended that you install in the root directory (_`c:\`_) to avoid possible issues._
|
||||||
|
|
||||||
<p>Note: TortoiseGit is a menu-driven, add-on gui interface for Git. Though optional, this instructional provides for its use.</p>
|
* ### Install CMake
|
||||||
|
|
||||||
<br>
|
This installation is self-explanatory.
|
||||||
|
|
||||||
<p>Some programs may be able to use newer versions, or even the lastest releases, without issue. But, this is not the case with Perl and (later) dependencies.</p>
|
* ### Install Git
|
||||||
|
|
||||||
<p>The above list of programs is known to work for compiling working server binaries.</p>
|
This installation is self-explanatory.
|
||||||
|
|
||||||
<br>
|
<a name="note_git"></a>
|
||||||
|
|
||||||
<li><p><h3>Install Visual Studio</h3></p></li>
|
_Note: Should you wish to download the repository code with no further chance of updating or restoration, this requirement may be omitted._ [[back](Ground-Up-Windows-Install-Rework#back_git)]
|
||||||
|
|
||||||
<p>During the install process, ensure the option for 'Desktop development with C++' is checked.</p>
|
* ### Install TortoiseGit (optional)
|
||||||
|
|
||||||
<p>This package is required to compile c/c++ code and by CMake to determine available compiler options. It will cause CMake file generation to fail, if not enabled.</p>
|
This installation is self-explanatory.
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60468475-b40e3b80-9c27-11e9-8b2b-462bd0f22165.png">
|
<a name="note_tgit"></a>
|
||||||
|
|
||||||
<br><br>
|
_Note: If Git is not installed, this installation should be omitted._ [[back](Ground-Up-Windows-Install-Rework#back_tgit)]
|
||||||
|
|
||||||
<br>
|
* ### Restart Computer
|
||||||
|
|
||||||
<li><p><h3>Install MariaDB</h3><p></li>
|
You will need to restart your computer to ensure that all of the %Path% additions are loaded into memory.
|
||||||
|
|
||||||
<p>[need specifics on what settings to use]</p>
|
* ### Acquiring the Code
|
||||||
|
|
||||||
<p>At the end of the installation process, you will be prompted to install HeidiSQL. It is HIGHLY recommended that you install this program.</p>
|
At this point, you will need to make a decision on how you want to manage your code.
|
||||||
|
|
||||||
<br>
|
There are three options:
|
||||||
|
|
||||||
<li><p><h3>Install Perl 5.12.3 (32-bit)</h3></p></li>
|
* Option 1 - Retrieve the code as a one-time download (unmanaged - not recommended)
|
||||||
|
|
||||||
<p>This installation is self-explanatory.</p>
|
* Option 2 - Create a local repository from the parent EQEmulator project that can be updated, managed and maintained (recommended)
|
||||||
|
|
||||||
<br>
|
* Option 3 - Create a local repository from a fork of the EQEmulator project that you manage (optional - select only if you want to contribute back to the parent project)
|
||||||
|
|
||||||
<p>Note: It is recommended that you install in the root directory ("c:\") to avoid possible issues.</p>
|
_Note: If you choose to create a fork of the EQEmulator repository, you will need to create a_ [[github.com](https://github.com/)] _account._
|
||||||
|
|
||||||
<br>
|
If you chose options 1 or 2, create a sub-directory called `git-eqemulator` in the root directory of c: drive.
|
||||||
|
|
||||||
<li><p><h3>Install CMake</h3></p></li>
|
If you chose option 3, create a sub-directory called `git-<git-username>` in the root directory of c: drive. (example: git username is `Pavlov`, directory name would be `git-pavlov`)
|
||||||
|
|
||||||
<p>This installation is self-explanatory.</p>
|
The purpose of this directory is to facilitate code management. We'll refer to this as the `account` directory.
|
||||||
|
|
||||||
<br>
|
For option 1:
|
||||||
|
|
||||||
<li><p><h3>Install Git</h3></p></li>
|
* Download [[Server-master.zip](https://github.com/EQEmu/Server/archive/master.zip)]
|
||||||
|
|
||||||
<p>This installation is self-explanatory.</p>
|
* Place it inside of the `account` directory
|
||||||
|
|
||||||
<br>
|
* Unpack its contents
|
||||||
|
|
||||||
<a name="note_git"></a>
|
* Rename the local code directory from `Server-master` to `Server`
|
||||||
|
|
||||||
<p>Note: Should you wish to download the repository code with no further chance of updating or restoration, this requirement may be omitted. [<a href="Ground-Up-Windows-Install-Rework#back_git">back</a>]</p>
|
* Move on to [[Download Dependencies](Ground-Up-Windows-Install-Rework#step_dependencies)]
|
||||||
|
|
||||||
<br>
|
For options 2 & 3, go to the EQEmulator server code repository web page at [https://github.com/EQEmu/Server](https://github.com/EQEmu/Server)
|
||||||
|
|
||||||
<li><p><h3>Install TortoiseGit (optional)</h3></p></li>
|
If you chose option 3 and are creating a fork, click on the fork button to add the repository to your github account. You should be redirected to your fork's main repository page.
|
||||||
|
|
||||||
<p>This installation is self-explanatory.</p>
|
|
||||||
|
|
||||||
<br>
|
Finally, click the `Clone or download` button, then `Open in Desktop` button to create a local code repository on your computer. When prompted for where to create it, select the `account` directory created above.
|
||||||
|
|
||||||
<a name="note_tgit"></a>
|
|
||||||
|
|
||||||
<p>Note: If Git is not installed, this installation should be omitted. [<a href="Ground-Up-Windows-Install-Rework#back_tgit">back</a>]</p>
|
You should now have a managed local code repository on your computer.
|
||||||
|
|
||||||
<br>
|
_Note: It is helpful to create a shortcut to the_ `account` _directory and place it on your desktop._
|
||||||
|
|
||||||
<li><p><h3>Restart Computer</h3></p></li>
|
|
||||||
|
|
||||||
<p>You will need to restart your computer to ensure that all of the %Path% additions are loaded into memory.</p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<li><p><h3>Acquiring the Code</h3></p></li>
|
|
||||||
|
|
||||||
<p>At this point, you will need to make a decision on how you want to manage your code.</p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>There are three options:</p>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
|
|
||||||
<li><p>Option 1, Retrieve the code as a one-time download (unmanaged - not recommended)</p></li>
|
|
||||||
|
|
||||||
<li><p>Option 2, Create a local repository from the parent EQEmulator project that can be updated, managed and maintained (recommended)</p></li>
|
|
||||||
|
|
||||||
<li><p>Option 3, Create a local repository from a fork of the EQEmulator project that you manage (optional - only if you want to contribute back to the parent project)</p></li>
|
|
||||||
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>Note: If you choose to create a fork of the EQEmulator repository, you will need to create a [<a href="https://github.com/">github.com</a>] account.</p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>If you choose options 1 or 2, create a sub-directory called 'git-eqemulator' in the root directory of c: drive.</p>
|
|
||||||
|
|
||||||
<p>If you choose option 3, create a sub-directory called 'git-<git-username>' in the root directory of c: drive. (example: git username is 'Pavlov', directory name would be 'git-pavlov')</p>
|
|
||||||
|
|
||||||
<p>The purpose of this directory is to facilitate code management. We'll refer to this as the 'account' directory.</p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>For option 1:</p>
|
|
||||||
|
|
||||||
<ul>
|
|
||||||
|
|
||||||
<li><p>Download [<a href="https://github.com/EQEmu/Server/archive/master.zip">Server-master.zip</a>]</p></li>
|
|
||||||
|
|
||||||
<li><p>Place it inside of the account directory</p></li>
|
|
||||||
|
|
||||||
<li><p>Unpack its contents</p></li>
|
|
||||||
|
|
||||||
<li><p>Rename the local code directory from 'Server-master' to 'Server'</p></li>
|
|
||||||
|
|
||||||
<li><p>Move on to <a href="Ground-Up-Windows-Install-Rework#step_dependencies">Download Dependencies</a></p></li>
|
|
||||||
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>For options 2 & 3, go to the EQEmulator server code repository web page at <a href="https://github.com/EQEmu/Server">https://github.com/EQEmu/Server</a></p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>If you chose option 3 and are creating a fork, click on the fork button to add the repository to your github account. You should be redirected to your fork's main repository page.</p>
|
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60550151-0e290280-9cf5-11e9-966e-e8d1fec1c80e.png">
|
|
||||||
|
|
||||||
<br><br>
|
|
||||||
|
|
||||||
<p>Finally, click the 'Clone or download' button, then 'Open in Desktop' button to create a local code repository on your computer. When prompted for where to create it, select the account directory created above.</p>
|
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60550164-21d46900-9cf5-11e9-882b-439dea49c8e8.png">
|
|
||||||
|
|
||||||
<br><br>
|
|
||||||
|
|
||||||
<p>You should now have a managed local code repository on your computer.</p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>Note: It is helpful to create a shortcut to the account directory and place it on your desktop.</p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<a name="step_dependencies"></a>
|
<a name="step_dependencies"></a>
|
||||||
|
|
||||||
<li><p><h3>Download Dependencies</h3></p></li>
|
* ### Download Dependencies
|
||||||
|
|
||||||
<p>Library dependencies can be downloaded from [<a href="https://github.com/EQEmu/eqemu.github.com/raw/master/downloads/WindowsDependencies_x86.zip">here</a>].</p>
|
Library dependencies can be downloaded from [[here](https://github.com/EQEmu/eqemu.github.com/raw/master/downloads/WindowsDependencies_x86.zip)].
|
||||||
|
|
||||||
<p>Inside of your local code directory, you will find a sub-directory called 'dependencies`.</p>
|
Inside of your local code directory, you will find a sub-directory called `dependencies`.
|
||||||
|
|
||||||
<p>Just place this download inside of the 'dependencies' folder and unpack its contents.</p>
|
Just place this download inside of the `dependencies` folder and unpack its contents.
|
||||||
|
|
||||||
<br>
|
* ### Running CMake
|
||||||
|
|
||||||
<li><p><h3>Running CMake</h3></p></li>
|
CMake's default options are adequate to configure and generate the files needed for Visual Studio.
|
||||||
|
|
||||||
<p>CMake's default options are adequate to configure and generate the files needed for Visual Studio.</p>
|
There are two directory locations that you will need to provide:
|
||||||
|
|
||||||
<br>
|
* `Where is the source code:`
|
||||||
|
|
||||||
<p>There are two directory locations that you will need to provide:</p>
|
* `Where to build the binaries:`
|
||||||
|
|
||||||
<ul>
|
For the source code, type-in or navigate to your `c:/<account>/Server` directory.
|
||||||
|
|
||||||
<li><p>Where is the source code:</p></li>
|
The easiest way to define the build directory is to copy the source path and paste it in. Then, add `/build` to the end of the path so that you have `c:/<account>/Server/build`.
|
||||||
|
|
||||||
<li><p>Where to build the binaries:</p></li>
|
Once CMake knows where to look, click the `Configure` button. You will get a pop-up window stating that the `build` directory does not exist. Click `OK` to create it.
|
||||||
|
|
||||||
</ul>
|
The next window will be for compiler selection. Ensure that `Visual Studio 15 2017` is selected, then click `Finish` to proceed.
|
||||||
|
|
||||||
<p>For the source code, type-in or navigate to your 'c:/<account>/Server' directory.</p>
|
|
||||||
|
|
||||||
<p>The easiest way to define the build directory is to copy the source and paste it in. Then, add '/build' to the end of the path so that you have 'c:/<account>/Server/build'.</p>
|
You should now have a list of unconfigured options (in red) displayed in the main window of CMake:
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<p>Once CMake knows where to look, click the 'Configure' button. You will get a pop-up window stating that the 'build' directory does not exist. Click 'OK' to create it.</p>
|
The following list contains the most common options of interest to the majority of users:
|
||||||
|
|
||||||
<br>
|
* `EQEMU_BUILD_CLIENT_FILES` [_enabled_] Builds binaries used to import/export client support files
|
||||||
|
|
||||||
<p>The next window will be for the compiler selection. Ensure that 'Visual Studio 15 2017' is selected.</p>
|
* `EQEMU_BUILD_LOGIN` [_disabled_] Builds the login server (this guide makes use of the login server - change this option to _enabled_)
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60629799-3b44e600-9dc5-11e9-996a-df781b021d5c.png">
|
* `EQEMU_BUILD_LUA` [_enabled_] Compiles server code with Lua support
|
||||||
|
|
||||||
<br><br>
|
* `EQEMU_BUILD_PERL` [_enabled_] Compiles server code with Perl support
|
||||||
|
|
||||||
<p>You should now have a list of unconfigured options (in red) showing in the main window of CMake:</p>
|
* `EQEMU_DEBUG_LEVEL` [_5_] Determines what additional messaging and debugging code is enabled/disabled (_12_ is max)
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60629816-54e62d80-9dc5-11e9-89ab-8961e94c9491.png">
|
* `EQEMU_ENABLE_BOTS` [_disabled_] Compiles server code with Bot support (user choice)
|
||||||
|
|
||||||
<br><br>
|
_Note: Ensure that you set_ `EQEMU_BUILD_LOGIN` _to **enabled**_.
|
||||||
|
|
||||||
<p>The follow list contains pertinent options that most users will want to change:</p>
|
Once you have set the options that you would like for your server, click `Configure` again.
|
||||||
|
|
||||||
<ul>
|
Since we set an option (login server) that requires additional settings, more unconfigured options have appeared. In this case, the open ssl library:
|
||||||
|
|
||||||
<li></p>EQEMU_BUILD_CLIENT_FILES: [default: enabled] Builds binaries used to import/export client support files</p></li>
|
|
||||||
|
|
||||||
<li></p>EQEMU_BUILD_LOGIN: [default: disabled] Builds the login server (this guide makes use of the login server - change this option to enabled)</p></li>
|
These new options are only file path definitions. No additional changes need to be made. Click `Configure` one last time.
|
||||||
|
|
||||||
<li></p>EQEMU_BUILD_LUA: [default: enabled] Compiles server code with Lua support</p></li>
|
|
||||||
|
|
||||||
<li></p>EQEMU_BUILD_PERL: [default:enabled] Compiles server code with Perl support</p></li>
|
_Note: Regardless of option settings, anytime that you have red (unconfigured) entries in your options list, you will need to click_ `Configure` _to ensure that the settings are applied to the current CMake file generation template._
|
||||||
|
|
||||||
<li></p>EQEMU_DEBUG_LEVEL: [default: 5] Determines what additional messaging and debugging code is enabled/disabled (12 is max)</p></li>
|
You can now click the `Generate` button.
|
||||||
|
|
||||||
<li></p>EQEMU_ENABLE_BOTS: [default: disabled] Compiles server code with Bot support (user choice)</p></li>
|
If file generation was successful, you should see "Generating done" at the bottom of the CMake window.
|
||||||
|
|
||||||
</ul>
|
You are now ready to open Visual Studio and compile your code!
|
||||||
|
|
||||||
<br>
|
* ### Compiling Code
|
||||||
|
|
||||||
<p>Once you have set the options that you would like for your server, click 'Configure' again.</p>
|
navigate through desktop shortcut to `c:\<account>\Server\build`
|
||||||
|
|
||||||
<br>
|
right-click on `EQEmu.sln` and select `Open with` >> `Microsoft Visual Studio 2017`
|
||||||
|
|
||||||
<p>Since we set an option (login server) that requires additional settings, more unconfigured options have appeared. In this case, the open ssl library:</p>
|
upon loading, Intellisense will begin mapping out the entire project. allow a few seconds for this process to finish. the lower left-hand corner will display "Ready" when this process has completed.
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60629837-67606700-9dc5-11e9-8b8c-560e629eae27.png">
|
Visual Studio does not honor CMake's `CMAKE_BUILD_TYPE` variable. You will need to manually set this to the desired build type before compiling your code.
|
||||||
|
|
||||||
<br><br>
|
<!-- image of build type drop-down box -->
|
||||||
|
|
||||||
<p>Since these new options are only file path declarations, no changes need to be made. Click 'Configure' one last time.</p>
|
There are 4 options:
|
||||||
|
|
||||||
<img src="https://user-images.githubusercontent.com/3311166/60629846-76471980-9dc5-11e9-9b30-d7059103ed89.png">
|
* `Debug` - not recommended for production servers unless conditions warrant its use (i.e., load testing and trouble-shooting)
|
||||||
|
|
||||||
<br><br>
|
* `RelWithDebugInfo` - standard compile for production servers (provides debug symbols without the added overhead of extra code, memory buffers and stl assertions)
|
||||||
|
|
||||||
<p>Note: Regardless of option settings, anytime that you have red (unconfigured) entries in your options list, you will need to click 'Configure' to ensure that the settings are applied to the current CMake file generation template.</p>
|
* `Release` - similar to `RelWithDebugInfo`..but, without access to debug symbols (not recommended)
|
||||||
|
|
||||||
<br>
|
* `MinSizeRel` - probably not a good selection (due to over optimization?)
|
||||||
|
|
||||||
<p>You can now click the 'Generate' button.</p>
|
you may now click `compile`
|
||||||
|
|
||||||
<p>If file generation was successful, you should see 'Generating done' at the bottom of the CMake window.</p>
|
<!-- image of menu bar build option drop-down box -->
|
||||||
|
|
||||||
<br>
|
the compiled code will be located in the `c:\<account>\Server\build\bin\<build_type>` directory
|
||||||
|
|
||||||
<p>You are now ready to open Visual Studio and compile your code!</p>
|
[walk-through]
|
||||||
|
|
||||||
<br>
|
* ### Code Maintenance
|
||||||
|
|
||||||
<li><p><h3>Compiling Code</h3></p></li>
|
[final thoughts...]
|
||||||
|
|
||||||
<p>[walk-through]</p>
|
---
|
||||||
|
|
||||||
<br>
|
## Local Server Setup
|
||||||
|
|
||||||
<li><p><h3>Code Maintenance</h3></p></li>
|
|
||||||
|
|
||||||
<p>[final thoughts...]</p>
|
|
||||||
|
|
||||||
</ul>
|
|
||||||
|
|
||||||
</hgroup>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
<hgroup>
|
|
||||||
|
|
||||||
<p><h2><strong>Local Server Setup</strong></h2></p>
|
|
||||||
|
|
||||||
<br>
|
|
||||||
|
|
||||||
</hgroup>
|
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user