{"id":19902564,"url":"https://github.com/aurirex/gtfo_thearchive","last_synced_at":"2025-05-02T23:32:26.435Z","repository":{"id":64215725,"uuid":"433233608","full_name":"AuriRex/GTFO_TheArchive","owner":"AuriRex","description":"GTFO Quality of Life mod for almost* any version of the game","archived":false,"fork":false,"pushed_at":"2025-03-22T19:50:18.000Z","size":11727,"stargazers_count":33,"open_issues_count":27,"forks_count":10,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-04-07T08:37:28.745Z","etag":null,"topics":["game-mod","gtfo-game","gtfo-modding","melonloader-mod","unity3d"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AuriRex.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-11-29T23:54:11.000Z","updated_at":"2025-03-16T00:52:35.000Z","dependencies_parsed_at":"2023-10-13T13:46:34.944Z","dependency_job_id":"b3b9a8ff-99a0-4cab-a3bb-03def0ec86f5","html_url":"https://github.com/AuriRex/GTFO_TheArchive","commit_stats":null,"previous_names":[],"tags_count":12,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AuriRex%2FGTFO_TheArchive","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AuriRex%2FGTFO_TheArchive/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AuriRex%2FGTFO_TheArchive/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AuriRex%2FGTFO_TheArchive/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AuriRex","download_url":"https://codeload.github.com/AuriRex/GTFO_TheArchive/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252122404,"owners_count":21698307,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["game-mod","gtfo-game","gtfo-modding","melonloader-mod","unity3d"],"created_at":"2024-11-12T20:18:30.588Z","updated_at":"2025-05-02T23:32:22.883Z","avatar_url":"https://github.com/AuriRex.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# TheArchive\n\nA massive mod for the game [GTFO](https://gtfothegame.com/), that adds a ton of Quality of Life and cosmetic features to the game without overstepping the games original design.\n\nNot 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.  \nAdditionally 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.\n\n## What this does\nImprove the game via Quality of Life and cosmetic additions without disrupting the experience of other players.  \nAll mechanics are still kept vanilla and in spirit of the games original design.\n\n## What this **doesn't** do\nThis ***does not*** give you access to the game or any of the old versions, you have to have bought the game on steam!  \nThis ***does not*** give any player an unfair advantage or trivialize the game, you have to bring your own skill.\n\n## Status\nThis project is in a Beta state at the moment, overall it's pretty stable but expect some bugs and unfinished features.  \n\nIf 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.\n\n### Quick Links\n * [Highlighted Features](#features)\n * [List of all Features](Features.md)\n * [How to Install](#installation)\n * [Where are my saves?](#where-are-my-saves)\n * [Building the project](#technical-stuffs)\n * [Contributing \u0026 License](#contributing)\n\n# Features\n\n## In Game Mod Settings\n\nAn in-game mod settings menu for easy feature customization.  \nMost Features are toggleable mid game and some even have extra options to mess with!\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/37329066/190881761-1c0550c3-2d2e-4e74-9904-d0f439b96f24.png\" alt=\"Mod Settings\"/\u003e\n\u003c/p\u003e\n\n## Discord Rich presence\n\nFully customizable Discord Rich Presence system to show others what you're up to.  \n(currently only configurable through the config file)\n\n![Rich Presence](https://user-images.githubusercontent.com/37329066/190882400-4be7c531-f863-4c3b-a703-34020f579aad.png)\n\n## Settings Redirect\n\nGame settings get saved to a different location for every Rundown so you only have to change them once*.  \n(*for each major version once, a version agnostic settings menu is on the TODO list)\n\nHaving to redo your settings whenever you switch to another Rundown is now a thing of the past.\n\n## Re-Added Old Hammers - `[R6 - RL]`\n\nAll 4 of the old, pre rundown 6 melee weapons, are back:  \nMaul, 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.\n\n## Local Rundown Progression\nThis allows you to save your progress (including boosters and vanity items) onto your computers hard drive instead of depending on the developers servers.  \nThe 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.\n\n## [List of all Features](Features.md)\n\n---\n\n### Loud Volume Override\n\nLower or mute the game during the intro sequence and while dropping down with the elevator.  \nAlso allows you to adjust what happens with audio whenever you tab outside of the game:\n* Continue playing\n* Lower Volume\n* Mute\n\n### Player Lobby Management\n\nOpen up players Steam profile or, if you're the host, kick them out of your lobby.\n\n![PlayerLobbyManagement](https://user-images.githubusercontent.com/37329066/227807583-03305c00-323c-446c-94df-43f9aa7595cd.png)\n\n### Carry Item Marker\n\nBig pickups (like `CELL`s or `FOG_TURBINE`s) get their own color as well as the item name above it.  \nAlso shows a marker on whoever is carrying a big pickup.\n\n\u003cdetails\u003e\n\u003csummary\u003e📷 Example of someone carrying a CELL:\u003c/summary\u003e\n\n![CarryMarker](https://user-images.githubusercontent.com/37329066/227804434-22e8de81-6884-4830-9ff6-a5a8c4616cc2.png)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003e📷 All the different color variations: (Big Pickup spoilers!!)\u003c/summary\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/37329066/227804227-207d47a7-54cb-49f7-936f-76e4d0c5068d.png\" alt=\"CarryItemMarker\"/\u003e\n\u003c/p\u003e\n\u003c/details\u003e\n\n### Glass Liquid System Override\n\nChange the resolution of the system that renders the blood splatters and other liquids on your visor or disable it entirely.  \nDisabling 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.\n\n\u003cdetails\u003e\n\u003csummary\u003e📷 Glass Liquid Override Quality Settings Overview:\u003c/summary\u003e\n\n### Default Quality:\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/37329066/227805471-00d214a2-7f56-4409-86f1-39ba147f909b.png\" alt=\"GLSQualityDefault\"/\u003e\n\u003c/p\u003e\n\n### Worst Quality: (`VeryBad`)\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/37329066/227805489-12613b41-8d98-4f2f-9d68-fe1298fe66ad.png\" alt=\"GLSQualityVeryBad\"/\u003e\n\u003c/p\u003e\n\n### Best Quality: (`Extraordinary`)\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/37329066/227805447-95aff551-2e71-4dc6-a414-f4b316cbb750.png\" alt=\"GLSQualityExtraordinary\"/\u003e\n\u003c/p\u003e\n\u003c/details\u003e\n\n### Sentry Markers\n\nAdds a player colored marker on placed down sentry guns, with who placed it and the sentries type above it.\n\n\u003cdetails\u003e\n\u003csummary\u003e📷 Example:\u003c/summary\u003e\n\n![SentryMarkers](https://user-images.githubusercontent.com/37329066/227806849-933e2a23-7bb3-4352-b028-8c35974b4e26.png)\n\u003c/details\u003e\n\n### Show Weapon Stats\n\nDisplayes the weapons stats on the weapon select screen.  \nDamage, clip size, max ammo and more\n\n![GTFO_ShowWeaponStats](https://github.com/AuriRex/GTFO_TheArchive/assets/37329066/d771eaf2-0d57-4978-ac32-8f44e34e5800)\n\n### Glowsticks! - `[A1 - RL]`\n\nChange the base color to any of the available ones (Green, Yellow, Orange or Red) which syncs to other players!  \nAnd/Or override the color locally (for yourself only) based on one fixed color or based on who threw the glowstick.\n\n### Loading Indicator\n\nDisplays a little indicator that shows if other players have finished loading yet.\n\n### Nickname\n\nChange your name in game, includes a color option.\n\n### Player Color Override\n\nAllows you to change the colors of you and your teammates.  \nAdditionally allows you to colorize other players based on their nickname color.\n\n### 99% Reload Fix\n\nFixes the bug that leaves you with one bullet short in the mag even though enough ammo is available.\n\n### L4D Style Resource Packs\n\nUse left and right mouse buttons to apply resource packs instead of `E`  \nLeft mouse = yourself  \nRight mouse = other players (can be held down + hovered over a player to start the interaction)\n\n### Disable Hud Sway\n\nMakes the in-game hud stay in place while running, jumping and looking around.\n\n### Disable UI Mirroring\n\nRemoves the mirroring effect on UI elements.\n\n### Disable UI Paralax\n\nStops the movement of UI elements in menu screens (Loadout, Rundown, ...) whenever you move your cursor around.  \n(Some elements might get partially or fully cut off-screen!)\n\n### No Dead Pings\n\nFixes pings (red triangles, doritos) staying on dead enemies as a result of high ping.\n\n### Remove Story Dialog\n\nPrevents all level-based voice events that have subtitles assigned from playing.  \n(Goodbye Schaefer \u0026 Co 😥)\n\n### Skip Elevator Animation\n\nAutomatically skips the cutscene after initiating a cage drop.  \nThis leads to faster load times as the game only starts building the level once the cutscene is over.  \n\n### Bot Customization - `[R6 - RL]`\n\nCustomize your Bots appearance as host and change their names. (Syncs to other players!)\n\n### Process Priority\n\nAutomatically change the games process priority, potentially increasing performance by a tiny bit.\n\n### Other things not mentioned here\n\nCheck the [List of all Features](Features.md), that one should (hopefully) be somewhat up to date.\n\n---\n\n# Installation\n\nThe mod is available for both MelonLoader and BepInEx (R2ModMan).  \nThe BepInEx version is a little behind currently but will be updated in the future - not every feature is currently available on this version!\n\n## Using MelonLoader\n\n1. Install [MelonLoader](https://github.com/LavaGang/MelonLoader#how-to-use-the-installer) into your game folder.  \n   Make sure to install **MelonLoader version `0.5.7`**, not anything older or newer (for now!)\n2. **Launch the game once to generate files \u0026 folders** and once in the main menu close it again.  \n   (This could take a little longer the first time around)\n3. Download the latest mod version from [here](https://github.com/AuriRex/GTFO_TheArchive/releases/latest). (it's called `TheArchive.Core.dll`)\n4. Put the dll into the `Mods` folder inside of your GTFO directory  \n   (In Steam: `[Right Click on GTFO]` \u003e `[Manage \u003e]` \u003e `[Browse local files]`)\n5. Launch the game again, you're done!  \n   (Check if the mod is installed by navigating to the games `Settings` menu, there should be a button labeled `Mod Settings` in the bottom left.)\n\n## Using BepInEx / R2MM\n\n1. Create a Profile in R2MM and install the `GTFO BepInEx Pack`\n2. Download the `EXPERIMENTAL_BepInEx_Ar_v?.?.??.zip` from the bottom of the [releases page here](https://github.com/AuriRex/GTFO_TheArchive/releases/latest).\n3. In R2ModMan, go to the `Settings \u003e Profile` tab\n4. Click the `Import local mod` button  \n5. Open the downloaded zip file via the `Select file` button and following file picker.\n6. You're done, it should now appear in the `Installed` tab.\n\n---\n\n# Where are my saves?\n\nBy default, all mod files get saved to `%appdata%/../LocalLow/GTFO_TheArchive/`.  \nMost things like progression, boosters and vanity get saved into the `SaveData` folder inside of the previous mentioned one, neatly divided into rundown specific folders.  \nThe 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)  \n(*Make sure to escape backslashes (`\\`) in your path by doubling them (like this: `\\\\`), else it won't work!*)\n\n---\n\n# Technical stuffs\n\n## Building the project (On Windows)\n\n### Step 1 (using MelonLoader)\nIn order to fully build the MelonLoader version of the mod, both latest **AND** Rundown 3 game files are required.\n* Latest Game Version\n    * Install [MelonLoader](https://github.com/LavaGang/MelonLoader) and run the game once\n    * Copy the `MelonLoader` folder from the game directory into `_R_LATEST/`\n* R3 (steam manifest: `1993854016152145129`)\n    * Obtain the last Rundown 3 build, install [MelonLoader](https://github.com/LavaGang/MelonLoader) and run the game once.\n    * Copy the `MelonLoader` folder from the game directory into `_R_RD003/`\n    * Create a folder called `GTFO_Data` inside of `_R_RD003/`\n    * Copy the `Managed` folder from the game directory `GTFO/GTFO_Data/Managed/` into the `_R_RD003/GTFO_Data/` folder\n\n#### Folder structure (MelonLoader)\n```\n.\n├── _R_LATEST/                              # Latest Version Assemblies go here\n│   └── MelonLoader/\n│       ├── Managed/\n│       │   ├── Accessibility.dll\n│       │   ├── Addons-ASM.dll\n│       │   └── ...\n│       └── MelonLoader.dll\n├── _R_RD003/                               # Rundown 3 Assemblies go here\n│   ├── GTFO_Data/\n│   │   └── Managed/\n│   │       ├── Accessibility.dll\n│   │       ├── Addons-ASM.dll\n│   │       └── ...\n│   └── MelonLoader/\n│       └── MelonLoader.dll\n└── .../                                    # Other Project Folders / Files\n```\n\n### Step 1 (using BepInEx)\nThe BepInEx release is only supported on the latest game version.\n* Install BepInEx either manually or create a new profile in R2MM and install `GTFO BepInEx Pack`\n* Make sure to launch the game (or profile) once and let IL2CPPInterop generate the proxy assemblies\n* Open the game (or profile) folder and copy the `BepInEx` folder into this projects `_R_LATEST/` folder\n* After opening the solution make sure to switch from `R_ML` to `R_BIE` in the menu bar to target BepInEx\n\n#### Folder structure (BepInEx)\n```\n.\n├── _R_LATEST/                              # Latest Version Assemblies go here\n│   └── BepInEx/\n│       ├── interop/\n│       │   ├── Accessibility.dll\n│       │   ├── Addons-ASM.dll\n│       │   └── ...\n│       └── core/\n│           ├── BepInEx.Core.dll\n│           └── ...\n└── .../                                    # Other Project Folders / Files\n```\n\n### Step 2: Building\n1. Open the solution `TheArchive.sln` in Visual Studio\n2. Hit `CTRL + Shift + B` on your keyboard or alternatively use the `Build \u003e Build Solution` menubar option\n3. The project is now building and the final dll is going to be placed into the `out/` directory\n\n## Building the project (On Linux)\n\nHave fun, you'll figure it out.\n\n# Contributing\n\nFeel free to create issues and pull requests to help me improve this massive project.  \n⚠ **By submitting a pull request you agree to add your code under the projects license.** (see [below](#License))\n\n# License\n\nEverything in [this repository](https://github.com/AuriRex/GTFO_TheArchive) is licensed under the MIT License (unless stated otherwise inside of a given source file),\n**excluding** `TheArchive.Core/Resources/discord_game_sdk.dll` and all of the files inside of `TheArchive.Core/Core/DiscordApi/*`, which are copyright [Discord](https://discord.com/developers/docs/legal) and only included for convenience.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faurirex%2Fgtfo_thearchive","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faurirex%2Fgtfo_thearchive","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faurirex%2Fgtfo_thearchive/lists"}