I made this tutorial on clean machine just after installing Windows 10 Pro (64bit) on 2020-02-16.
Installing everything took around 1 hour.
In this tutorial we will use Visual Studio 2019, not 2017 recommended for TFS compilation. It will work!
I used polish version of Windows and installed every possible application in polish.
I did this, to be sure, that it will work with any other language. One thing I found out is that you need English language pack in Visual Studio to install TFS libraries from vcpkg.
What do you need before start?
What will you have after completing this tutorial?
1. Install GIT for Windows with environment integration
Download it from site (version 64-bit Setup):Git - Downloading Package (https://git-scm.com/download/win)
‘Setup’ version will integrate Git with Windows explorer.
Download 64-bit Git for Windows Setup.
Unselect GUI option. It’s useless. You will have better Git GUI in IDEA.
Change line ending to ‘as is’. On GitHub most of code uses Unix-style endings.
2. Install Visual Studio 2019 Community with C++
Download it from site:Visual Studio 2019 | Download for free (https://visualstudio.microsoft.com/vs/)
Select “Community” version. It will start download. After download run installer.
Select packet “Programming classic applications in C++”.
Select packet “English language”. It’s required to install TFS compilation libraries.
After installation run Visual Studio for first time to make it configure itself.
You don’t need Microsoft Account to use it. Click ‘Not now, maybe later’.
3. Install vcpkg – C++ library manager for Windows
Open Git Bash (‘linux console’) in folder ‘C:\’
Type in console: git clone microsoft/vcpkg (https://github.com/Microsoft/vcpkg.git)
Type in console: cd vcpkg
Open website:microsoft/vcpkg (https://github.com/Microsoft/vcpkg) and find newest tagged version
Link: microsoft/vcpkg (https://github.com/Microsoft/vcpkg)
Newest tagged version should be stable. I tried master branch and it did not work with all libraries. You can always use old version, not newest. I used for this tutorial: 2020.01
Type in console: git checkout 2020.01
It will switch version of vcpkg to version from 2020.01
Type: ./bootstrap-vcpkg.bat
To build vcpkg. You must do it after downloading from GitHub and after every version change.
Run Windows PowerShell as Administrator (another black console..)
Change path in console to vcpkg path
Type: cd C:\vcpkg
In console type: .\vcpkg integrate install
This will integrate vcpkg C++ library manager with Visual Studio we installed before.
After integrating with Visual Studio close PowerShell. We don’t need administrator rights anymore.
If you closed Git Bash console we opened at start, open it again in vcpkg folder.
Copy current libraries list from official TFS wiki (for 64-bit):otland/forgottenserver (https://github.com/otland/forgottenserver/wiki/Compiling-on-Windows-%28vcpkg%29)
Libraries list at 2020-02-17:
Type in console: ./ and paste list
./ means ‘run’
We got all libraries for TFS!
4. Download TFS and compile engine
Create folder:
Open Git Bash in folder C:\ots
Download newest TFS. Type: git clone otland/forgottenserver (https://github.com/otland/forgottenserver.git)
It will open TFS project in Visual Studio.
Click ‘OK’ when VS ask you about changing target platform.
Change build type to Release and build target platform to x64.
Previously we installed C++ libraries for 64-bit platform – we can compile only 64-bit version.
If you plan to do many changes in sources and compile in often, you may try to use Debug build type.
It should link faster and reduce time of building solution.
Start compilation of TFS. It can take few minutes.
Open folder: C:\ots\forgottenserver\vc14\x64\Release
Copy all .dll files and .exe file to folder: C:\ots\forgottenserver\
TFS is ready. Now we need to install database server and import TFS database schema.
I was not able to post this as 1 thread.
It was keep saying that I cannot post more than 30 images in 1 post. Even when I split it into 2 posts. Probably because of auto-post-merge.
Can some moderator merge my 2 threads?
From Windows 10 to OTS development machine for dummies - part 2
Installing everything took around 1 hour.
In this tutorial we will use Visual Studio 2019, not 2017 recommended for TFS compilation. It will work!
I used polish version of Windows and installed every possible application in polish.
I did this, to be sure, that it will work with any other language. One thing I found out is that you need English language pack in Visual Studio to install TFS libraries from vcpkg.
What do you need before start?
- Windows 10
- Web Browser (tutorial created with Google Chrome)
What will you have after completing this tutorial?
- GIT client integrated with Windows 10
- ‘linux console’ integrated with Windows 10
- Visual Studio 2019 Community with C++ dev tools – IDE that let you compile TFS/OTClient easily (generate ‘.exe’ file)
- vcpkg – C++ Library Manager for Windows, it will let you compile TFS/OTClient without searching for C++ libraries for hours
- IDEA Community Edition with EmmyLUA plugin – free version of IDE that let you manage ‘data’ folder easily (XML and LUA files)
- MariaDB database, PHP 7.4 and Apache2 server – website for your OTS
- The Forgotten Server 1.2+ running on your PC
- Gesior2012 for TFS 1.2+ running on your PC
1. Install GIT for Windows with environment integration
Download it from site (version 64-bit Setup):Git - Downloading Package (https://git-scm.com/download/win)
‘Setup’ version will integrate Git with Windows explorer.
Download 64-bit Git for Windows Setup.
Unselect GUI option. It’s useless. You will have better Git GUI in IDEA.
Change line ending to ‘as is’. On GitHub most of code uses Unix-style endings.
2. Install Visual Studio 2019 Community with C++
Download it from site:Visual Studio 2019 | Download for free (https://visualstudio.microsoft.com/vs/)
Select “Community” version. It will start download. After download run installer.
Select packet “Programming classic applications in C++”.
Select packet “English language”. It’s required to install TFS compilation libraries.
After installation run Visual Studio for first time to make it configure itself.
You don’t need Microsoft Account to use it. Click ‘Not now, maybe later’.
3. Install vcpkg – C++ library manager for Windows
Open Git Bash (‘linux console’) in folder ‘C:\’
Type in console: git clone microsoft/vcpkg (https://github.com/Microsoft/vcpkg.git)
Code:
git clone https://github.com/Microsoft/vcpkg.git
Type in console: cd vcpkg
Code:
cd vcpkg
Open website:microsoft/vcpkg (https://github.com/Microsoft/vcpkg) and find newest tagged version
Link: microsoft/vcpkg (https://github.com/Microsoft/vcpkg)
Newest tagged version should be stable. I tried master branch and it did not work with all libraries. You can always use old version, not newest. I used for this tutorial: 2020.01
Type in console: git checkout 2020.01
Code:
git checkout 2020.01
It will switch version of vcpkg to version from 2020.01
Type: ./bootstrap-vcpkg.bat
Code:
./bootstrap-vcpkg.bat
To build vcpkg. You must do it after downloading from GitHub and after every version change.
Run Windows PowerShell as Administrator (another black console..)
Change path in console to vcpkg path
Type: cd C:\vcpkg
Code:
cd C:\vcpkg
In console type: .\vcpkg integrate install
Code:
.\vcpkg integrate install
This will integrate vcpkg C++ library manager with Visual Studio we installed before.
After integrating with Visual Studio close PowerShell. We don’t need administrator rights anymore.
If you closed Git Bash console we opened at start, open it again in vcpkg folder.
Copy current libraries list from official TFS wiki (for 64-bit):otland/forgottenserver (https://github.com/otland/forgottenserver/wiki/Compiling-on-Windows-%28vcpkg%29)
Libraries list at 2020-02-17:
Code:
vcpkg install boost-iostreams:x64-windows boost-asio:x64-windows boost-system:x64-windows boost-filesystem:x64-windows boost-variant:x64-windows boost-lockfree:x64-windows luajit:x64-windows libmariadb:x64-windows pugixml:x64-windows mpir:x64-windows cryptopp:x64-windows
Type in console: ./ and paste list
./ means ‘run’
We got all libraries for TFS!
4. Download TFS and compile engine
Create folder:
Code:
C:\ots
Open Git Bash in folder C:\ots
Download newest TFS. Type: git clone otland/forgottenserver (https://github.com/otland/forgottenserver.git)
Code:
git clone https://github.com/otland/forgottenserver.git
Code:
C:\ots\forgottenserver\vc14\theforgottenserver.sln
It will open TFS project in Visual Studio.
Click ‘OK’ when VS ask you about changing target platform.
Change build type to Release and build target platform to x64.
Previously we installed C++ libraries for 64-bit platform – we can compile only 64-bit version.
If you plan to do many changes in sources and compile in often, you may try to use Debug build type.
It should link faster and reduce time of building solution.
Start compilation of TFS. It can take few minutes.
Open folder: C:\ots\forgottenserver\vc14\x64\Release
Code:
C:\ots\forgottenserver\vc14\x64\Release
Copy all .dll files and .exe file to folder: C:\ots\forgottenserver\
Code:
C:\ots\forgottenserver\
TFS is ready. Now we need to install database server and import TFS database schema.
Post automatically merged:
I was not able to post this as 1 thread.
It was keep saying that I cannot post more than 30 images in 1 post. Even when I split it into 2 posts. Probably because of auto-post-merge.
Can some moderator merge my 2 threads?
From Windows 10 to OTS development machine for dummies - part 2
Last edited by a moderator: