91 lines
3.0 KiB
Markdown
Raw Normal View History

2020-11-20 02:26:41 +01:00
# Setup
By Senko-san, 20/11/2020
## Preface
2020-11-20 08:51:18 +01:00
This is for setting up the development environment, as well the projects and building them.\
This guide is by no means meant for beginners or those unfamilliar with the project.\
It is hightly recommended to read the guide at least once before executing it.
2020-11-20 02:26:41 +01:00
2020-11-20 08:51:18 +01:00
## Legend
2020-11-20 02:26:41 +01:00
2020-11-20 03:39:12 +01:00
**Path** | **What** | **Example**
2020-11-20 02:26:41 +01:00
------------ | ----------------------------- | ----------------------
`%gamedir%` | Escape From Tarkov (Live) | `C:/games/EFT (Live)`
`%akidir%` | Where AKI needs to be located | `C:/games/aki`
`%server%` | server project | `C:/projects/server`
`%launcher%` | launcher project | `C:/projects/launcher`
`%modules%` | modules project | `C:/projects/modules`
## Requirements
- Escape From Tarkov (Live)
- [Node 12.18.2](https://nodejs.org/download/release/v12.18.2/node-v12.18.2-x64.msi)
- [Visual Studio Build Tools](https://visualstudio.microsoft.com/thank-you-downloading-visual-studio/?sku=BuildTools&rel=16)
- [VSCodium](https://github.com/VSCodium/vscodium/releases/download/1.51.1/VSCodiumSetup-x64-1.49.1.exe)
- [Git](https://github.com/git-for-windows/git/releases/download/v2.29.2.windows.2/Git-2.29.2.2-64-bit.exe)
## 1. Development environment
2020-11-20 03:39:12 +01:00
### 1.1. Node
2020-11-20 02:26:41 +01:00
1. Install `npm package manager`
2. Uncheck `install chocolaty`
2020-11-20 03:39:12 +01:00
### 1.2. Visual Studio Build Tools
2020-11-20 02:26:41 +01:00
- Check `.NET desktop development`
- Select `Download all, then install`
2020-11-20 03:39:12 +01:00
### 1.3. VSCodium
2020-11-20 02:26:41 +01:00
- Check `Register VSCodium as an editor for supported file types`
- Check `Add to PATH`
2020-11-20 03:39:12 +01:00
### 1.4. Git
2020-11-20 02:26:41 +01:00
1. Check only `Associate .git* configuration with the default text editor`
2020-11-20 03:36:25 +01:00
2. Select `Use VSCodium`
3. Select `Git from the command line`
4. Select `Checkout windows-style`
5. Select `Use Windows' default console window`
6. Select `Default (fast-forward or merge)`
7. Select `Git Credential Manager`
2020-11-20 02:26:41 +01:00
8. Check only `Enable file system caching`
9. Leave unchecked `Enable experimental support`
## 2. Server
1. Open VSCodium
2. Clone Repository > `https://dev.offline-tarkov.com/SPT-AKI/Server.git`
3. Open `%server%/Server.code-workspace`
4. Terminal > Run Task... > NPM > install
5. Terminal > Run Build Task...
## 3. Launcher
1. Open VSCodium
2. Clone Repository > `https://dev.offline-tarkov.com/SPT-AKI/Launcher.git`
3. Open `%launcher%/Launcher.code-workspace`
4. Terminal > Run Build Task...
## 4. Modules
1. Open VSCodium
2. Clone Repository > `https://dev.offline-tarkov.com/SPT-AKI/Modules.git`
3. Open `%modules%/Modules.code-workspace`
4. Terminal > Run Build Task...
## 5. Game files
1. Copy-paste `%gamedir%` to `%akidir%`
2. Copy-paste `%server%/project/Server.exe` and `%server%/project/packages/` to `%akidir%`
3. Copy-paste `%launcher%/project/Build/Launcher.exe` and `%launcher%/project/Buiild/Launcher_data/` to `%akidir%`
4. Copy-paste `%modules%/project/Build/EscapeFromTarov_Data/` to `%akidir%`
## Conclusion
2020-11-20 08:51:18 +01:00
Well done, you've succesfully setup and build the development build.
Now you can get started with contributing to the project.