A massive mod for the game GTFO, that adds a ton of Quality of Life and cosmetic features to the game without overstepping the games original design.
Not only compatible with the latest release on steam but also with many of the older GTFO builds, tested on all of the latest patches for each (old) rundown.
Additionally this mod is trying to preserve older versions by keeping them playable even once the servers are gone forever by handling all playfab requests locally and saving things like progression/level completions, boosters and vanity items onto your storage device of choice for old versions.
Improve the game via Quality of Life and cosmetic additions without disrupting the experience of other players.
All mechanics are still kept vanilla and in spirit of the games original design.
This does not give you access to the game or any of the old versions, you have to have bought the game on steam!
This does not give any player an unfair advantage or trivialize the game, you have to bring your own skill.
This project is in a Beta state at the moment, overall it's pretty stable but expect some bugs and unfinished features.
If you encounter any bugs while playing with mods installed make sure to remove your mods first and reproduce the issue without any installed before asking the games devs for support.
- Highlighted Features
- List of all Features
- How to Install
- Where are my saves?
- Building the project
- Contributing & License
An in-game mod settings menu for easy feature customization.
Most Features are toggleable mid game and some even have extra options to mess with!
Fully customizable Discord Rich Presence system to show others what you're up to.
(currently only configurable through the config file)
Game settings get saved to a different location for every Rundown so you only have to change them once*.
(*for each major version once, a version agnostic settings menu is on the TODO list)
Having to redo your settings whenever you switch to another Rundown is now a thing of the past.
All 4 of the old, pre rundown 6 melee weapons, are back:
Maul, Gavel, Mallet and Sledge can be enabled in the mod settings menu and will be added to the melee weapons menu on the loadout screen.
This allows you to save your progress (including boosters and vanity items) onto your computers hard drive instead of depending on the developers servers.
The implementation should be as close to the original game whenever a specific (rundown) version was live, to keep the experience genuine even after servers are down forever.
Lower or mute the game during the intro sequence and while dropping down with the elevator.
Also allows you to adjust what happens with audio whenever you tab outside of the game:
- Continue playing
- Lower Volume
- Mute
Open up players Steam profile or, if you're the host, kick them out of your lobby.
Big pickups (like CELL
s or FOG_TURBINE
s) get their own color as well as the item name above it.
Also shows a marker on whoever is carrying a big pickup.
Change the resolution of the system that renders the blood splatters and other liquids on your visor or disable it entirely.
Disabling the system entirely prevents/"fixes" the so called "Void Bug" from happening, where sometimes a blob of darkness, the big black blob consumes your entire screen, making you unable to see anything for a few seconds up to minutes at a time.
๐ท Glass Liquid Override Quality Settings Overview:
Adds a player colored marker on placed down sentry guns, with who placed it and the sentries type above it.
Displayes the weapons stats on the weapon select screen.
Damage, clip size, max ammo and more
Change the base color to any of the available ones (Green, Yellow, Orange or Red) which syncs to other players!
And/Or override the color locally (for yourself only) based on one fixed color or based on who threw the glowstick.
Displays a little indicator that shows if other players have finished loading yet.
Change your name in game, includes a color option.
Allows you to change the colors of you and your teammates.
Additionally allows you to colorize other players based on their nickname color.
Fixes the bug that leaves you with one bullet short in the mag even though enough ammo is available.
Use left and right mouse buttons to apply resource packs instead of E
Left mouse = yourself
Right mouse = other players (can be held down + hovered over a player to start the interaction)
Makes the in-game hud stay in place while running, jumping and looking around.
Removes the mirroring effect on UI elements.
Stops the movement of UI elements in menu screens (Loadout, Rundown, ...) whenever you move your cursor around.
(Some elements might get partially or fully cut off-screen!)
Fixes pings (red triangles, doritos) staying on dead enemies as a result of high ping.
Prevents all level-based voice events that have subtitles assigned from playing.
(Goodbye Schaefer & Co ๐ฅ)
Automatically skips the cutscene after initiating a cage drop.
This leads to faster load times as the game only starts building the level once the cutscene is over.
Customize your Bots appearance as host and change their names. (Syncs to other players!)
Automatically change the games process priority, potentially increasing performance by a tiny bit.
Check the List of all Features, that one should (hopefully) be somewhat up to date.
The mod is available for both MelonLoader and BepInEx (R2ModMan).
The BepInEx version is a little behind currently but will be updated in the future - not every feature is currently available on this version!
- Install MelonLoader into your game folder.
Make sure to install MelonLoader version0.5.7
, not anything older or newer (for now!) - Launch the game once to generate files & folders and once in the main menu close it again.
(This could take a little longer the first time around) - Download the latest mod version from here. (it's called
TheArchive.Core.dll
) - Put the dll into the
Mods
folder inside of your GTFO directory
(In Steam:[Right Click on GTFO]
>[Manage >]
>[Browse local files]
) - Launch the game again, you're done!
(Check if the mod is installed by navigating to the gamesSettings
menu, there should be a button labeledMod Settings
in the bottom left.)
- Create a Profile in R2MM and install the
GTFO BepInEx Pack
- Download the
EXPERIMENTAL_BepInEx_Ar_v?.?.??.zip
from the bottom of the releases page here. - In R2ModMan, go to the
Settings > Profile
tab - Click the
Import local mod
button - Open the downloaded zip file via the
Select file
button and following file picker. - You're done, it should now appear in the
Installed
tab.
By default, all mod files get saved to %appdata%/../LocalLow/GTFO_TheArchive/
.
Most things like progression, boosters and vanity get saved into the SaveData
folder inside of the previous mentioned one, neatly divided into rundown specific folders.
The location of this SaveData
folder can be customized by editing TheArchive_Settings.json
's "CustomFileSaveLocation"
property to point to any location of your choosing. (Cloud storage like GoogleDrive, Dropbox, etc ..., recommended)
(Make sure to escape backslashes (\
) in your path by doubling them (like this: \\
), else it won't work!)
In order to fully build the MelonLoader version of the mod, both latest AND Rundown 3 game files are required.
- Latest Game Version
- Install MelonLoader and run the game once
- Copy the
MelonLoader
folder from the game directory into_R_LATEST/
- R3 (steam manifest:
1993854016152145129
)- Obtain the last Rundown 3 build, install MelonLoader and run the game once.
- Copy the
MelonLoader
folder from the game directory into_R_RD003/
- Create a folder called
GTFO_Data
inside of_R_RD003/
- Copy the
Managed
folder from the game directoryGTFO/GTFO_Data/Managed/
into the_R_RD003/GTFO_Data/
folder
.
โโโ _R_LATEST/ # Latest Version Assemblies go here
โ โโโ MelonLoader/
โ โโโ Managed/
โ โ โโโ Accessibility.dll
โ โ โโโ Addons-ASM.dll
โ โ โโโ ...
โ โโโ MelonLoader.dll
โโโ _R_RD003/ # Rundown 3 Assemblies go here
โ โโโ GTFO_Data/
โ โ โโโ Managed/
โ โ โโโ Accessibility.dll
โ โ โโโ Addons-ASM.dll
โ โ โโโ ...
โ โโโ MelonLoader/
โ โโโ MelonLoader.dll
โโโ .../ # Other Project Folders / Files
The BepInEx release is only supported on the latest game version.
- Install BepInEx either manually or create a new profile in R2MM and install
GTFO BepInEx Pack
- Make sure to launch the game (or profile) once and let IL2CPPInterop generate the proxy assemblies
- Open the game (or profile) folder and copy the
BepInEx
folder into this projects_R_LATEST/
folder - After opening the solution make sure to switch from
R_ML
toR_BIE
in the menu bar to target BepInEx
.
โโโ _R_LATEST/ # Latest Version Assemblies go here
โ โโโ BepInEx/
โ โโโ interop/
โ โ โโโ Accessibility.dll
โ โ โโโ Addons-ASM.dll
โ โ โโโ ...
โ โโโ core/
โ โโโ BepInEx.Core.dll
โ โโโ ...
โโโ .../ # Other Project Folders / Files
- Open the solution
TheArchive.sln
in Visual Studio - Hit
CTRL + Shift + B
on your keyboard or alternatively use theBuild > Build Solution
menubar option - The project is now building and the final dll is going to be placed into the
out/
directory
Have fun, you'll figure it out.
Feel free to create issues and pull requests to help me improve this massive project.
โ By submitting a pull request you agree to add your code under the projects license. (see below)
Everything in this repository is licensed under the MIT License (unless stated otherwise inside of a given source file),
excluding TheArchive.Core/Resources/discord_game_sdk.dll
and all of the files inside of TheArchive.Core/Core/DiscordApi/*
, which are copyright Discord and only included for convenience.