The Stay in Tarkov project was born due to Battlestate Games' (BSG) reluctance to create the pure PvE version of Escape from Tarkov. The project's aim is simple, create a Cooperation PvE experience that retains progression. If BSG decide to create the ability to do this on live, this project will be shut down immediately.
- You must buy the game to use this. You can obtain it here. https://www.escapefromtarkov.com.
- This is by no means designed for cheats (this project was made because cheats have destroyed the Live experience)
- This is by no means designed for illegally downloading the game (and has blocks for people that do!)
- This is purely for educational purposes (I am using this to learn Unity, Reverse Engineering & Networking)
- I am in no way affiliated with BSG or others (on Reddit or Discord) claiming to be working on a project
- Please be aware. The Ko-Fi link is buying me a coffee, nothing else!
- I do not have some special subset of code that makes it work beyond what is here on GitHub
- Please do not hand over money expecting help or a solution
- This is a hobby, for fun, project. Please don't treat it seriously.
- I do not BS the community. I know this is a semi-broken attempt but will attempt to fix as best I can.
- Pull Requests are encouraged!
- Stay in Tarkov works requires the latest AKI Server to run. You can learn about SPT-Aki here.
- DO NOT INSTALL THIS ON TO SPT-Aki CLIENT! ONLY INSTALL THE SERVER!
- HAMACHI SETUP-Hamachi.md Document by ppyLEK
- Standard (Port Forwarding) SETUP-Standard.md Document
- Extra Documentation HOSTING.md Document
BE AWARE
- Coop is in early stages of development.
- Most features work and it is "playable with likely bugs". "Playable" and perfect are two very different things. Expect lag (desync), issues and bugs.
- My tests have included all maps. The maps that work best are Factory and Labs. Performance is very dependant on the CPU / Internet on the Server and Clients and AI count on the Server
- More Information on HOSTING & COOP is in the HOSTING.md Document
You must have the SPT-Aki mod installed in your Server for this module to work. If you do not wish to use the Coop module, you must disable it in the BepInEx config file.
No. BSG server code is hidden from the client for obvious reasons. So BSG's implementation of Coop use the same online servers as PvPvE. We don't see this, so we cannot use this.
- After rigourous testing in SIT.Tarkov.Coop, I discovered that my UDP Web Socket implementation was much to unreliable and laggy.
- With point 1 in mind, I have reverted back to basic TCP JSON web calls back and forth to the SPT-Aki Server with a mod handling the data.
- The project uses multiple methods of BepInEx Harmony patches coupled with Unity Components to achieve its aims.
- Features/Methods that require constant polling between Client->Server->Client (Move, Rotate, Look, etc) use Components to send data (Harmony patches are too expensive, especially on AI!).
- Features/Methods that can easily be "replicated" use ModuleReplicationPatch abstract class to easily round trip the call.
- All server communication is via JSON TCP calls to the "Web Server" developed by SPT-Aki using a typescript mod to handle the "backend" work.
- CoopGameComponent is attached to the GameWorld object when a Coop ready game is started (any game that isn't Hideout). CoopGameComponent polls the Server for information and passes the data to the PlayerReplicatedComponent.
The following Aki Modules are supported.
- aki-core
- Aki.Common
- Aki.Reflection
- 50/50 on SPT-AKI Client mods. This is dependant on how well written the patches are. If they directly target GCLASSXXX or PUBLIC/PRIVATE then they will likely fail.
SPT-Aki DLLs are written specifically for their own Deobfuscation technique and my own technique is not working well with Aki Modules at this moment in time. So I ported many of SPT-Aki features into this module. My end-goal would be to rely on SPT-Aki and for this to be solely focused on SIT only features.
- Create Working Directory for all Tarkov Modding {EFT_WORK}
- Clone this {SIT_CORE} to a {SIT_CORE} directory inside {EFT_WORK}
- Copy your Live Tarkov Directory somewhere else {EFT_OFFLINE}
- Deobfuscate latest Assembly-CSharp in {EFT_OFFLINE} via SIT.Launcher. Ensure to close and restart Launcher after Deobfuscation.
- Copy all of {EFT_OFFLINE}\EscapeFromTarkov_Data\Managed assemblies to Tarkov.References {TARKOV.REF} in the parent folder of this project {EFT_WORK}
- You will need BepInEx Nuget Feed installed on your PC by running the following command in a terminal.
dotnet new -i BepInEx.Templates --nuget-source https://nuget.bepinex.dev/v3/index.json
- Open the .sln with Visual Studio 2022
- Rebuild Solution (This should download and install all nuget packages on compilation)
Version 5
https://docs.bepinex.dev/articles/user_guide/installation/index.html
BepInEx 5 must be installed and configured first (see How to install BepInEx) Place the built .dll in the BepInEx plugins folder
- Browse to where BepInEx is installed within your Tarkov folder
- Open config
- Open BepInEx.cfg
- Change the following setting [Logging.Console] Enabled to True
- Save the config file
- Run Tarkov through a launcher or bat file like this one (replacing the token with your ID)
start ./Clients/EmuTarkov/EscapeFromTarkov.exe -token=pmc062158106353313252 -config={"BackendUrl":"http://127.0.0.1:6969","Version":"live"}
- If BepInEx is working a console should open and display the module "plugin" as started
- SPT-Aki team
- MTGA team
- SPT-Aki Modding Community
- Props (AIBushPatch, AIAwakeOrSleepPatch - Currently unused)
- kmyuhkyuk (GamePanulHUD - Unused)
- 95% of the original core and single-player functionality completed by SPT-Aki teams. There may be licenses pertaining to them within this source.
- None of my own work is Licensed. This is solely a just for fun project. I don't care what you do with it.