AFTERLIFE

AFTERLIFE user guide

This guide covers everything in AFTERLIFE (AFTERLIFE.exe), from the first run to removing it again.

1. Before you start

Two editions

AFTERLIFE comes in two editions built from the same code:

In AFTERLIFE Offline the features of the full edition stay visible with a lock. A click on one opens WAITING FOR NEXUS MODS, which says what is waiting and what works now, with links to the pages of every core mod. In this guide, sections 11 and 12 and everything that mentions a Nexus key describe the full edition.

2. First run

  1. Unzip the whole folder AFTERLIFE from the zip to any place you like, for example C:\Tools\AFTERLIFE. Keep its files together and do not put it inside the game folder.
  2. Start AFTERLIFE.exe in that folder. Windows may show Windows protected your PC because the file is not code-signed yet: click More info → Run anyway.
  3. Game folder: AFTERLIFE suggests the usual Steam, GOG and Epic locations. If yours is elsewhere, BROWSE to the folder that contains bin\x64\Cyberpunk2077.exe.
  4. Library folder: where AFTERLIFE keeps its copy of every mod. Pick a drive with free space; the library holds every version you ever imported, so it grows. It must not be inside the game folder.
  5. Nexus Mods key (full edition only; optional, you can add it later): see section 11.
  6. START AFTERLIFE.

If the game already contains mods installed by hand, the Scan manual mods card shows how many it found. They keep working; AFTERLIFE does not touch them until you ask (see section 14).

3. The window

Area What it shows
Header, top right Game version and build, and the core mods table: version and source of each framework (AFTERLIFE, manual, in library, missing). GET › opens the Nexus page of a missing one.
Profiles (left) Your profiles. The one in the game is marked DEPLOYED; if it has changes you have not applied yet it shows PENDING.
Download history, Scan manual mods, Settings (left) Cards that open their own windows.
JACK IN (left, bottom) Starts the game. Above it, a line tells you whether the game matches the selected profile.
Filters (between the profiles and the list) Filter the list by state, by what needs attention, by block and by tag. Open, collapsed to a strip, or hidden.
Mod library (middle) Every mod in the library, in blocks: CORE MODS (yellow), each COLLECTION (cyan) and MODS (grey).
Mod details (right) The selected mod: picture and description from Nexus, status, and the tabs Overview, Files, Requirements, Conflicts.
Footer Progress of the current operation (Preparing, Applying, Verifying), contact and support links.

The mod list

Each block header has:

Each row has:

The search box above the list filters by name and tag; ✕ or Esc clears it. Select all (the checkbox above the list, Ctrl+A) selects exactly the mods the search shows, so you can, for example, move all found mods into a category at once.

Filters. The panel next to the list filters by state (on, off, not applied yet), by what needs attention (update available, conflict, missing requirement), by block (core mods, collections, your mods) and by tag; each line shows how many mods it matches. One click on a line means must match, a second click must not match, a third turns it off. MATCH ALL shows mods that fit every chosen line, MATCH ANY mods that fit at least one. « collapses the panel to a strip with the quick filters, ✕ hides it, and ⧩ FILTERS next to the search brings it back; AFTERLIFE remembers how you left it. Filtering never changes the load order, and Select all takes only what the filter shows.

Sorting for viewing. The SORT button next to FILTERS walks through LOAD ORDER, NAME, NEWEST, STATE and SIZE. Sorting stays inside each block and core mods keep their place. It changes only what you see: a line above the list says that the load order is unchanged, dragging mods is off while the list is sorted, and Back to load order returns.

When several mods are selected, the bar at the bottom offers MOVE TO CATEGORY, ACTIVATE, DEACTIVATE and DELETE EVERYWHERE for all of them.

The list is split into blocks, each with its own icon in its colour: CORE MODS (yellow chip with a lock, always on top), every COLLECTION (cyan layers) and MODS (light grey cube) for the rest. Drag a block by its icon or use the small arrows next to it. + CATEGORY in the MODS header adds your own category: a smaller violet divider with a bookmark icon inside MODS; double-click its name to rename it. Moved mods are unchecked afterwards; a click into the column header unchecks all mods. Drag mods onto a category (a row or its header) or select them and use MOVE TO CATEGORY; Rename and Remove are in the category header, and removing a category never deletes its mods. Collections, MODS and categories can be moved by their ⋮⋮ handle or the small arrows; see section 10 for what that does to the load order and how to load one mod before another. Inside MODS and every category you set the order yourself: drag a row up or down (local edits stay right below their mod), and A→Z in the header sorts that section by name once; collections keep the curator's order. Profiles are sorted by name, with Mods off first.

Below the list: REFRESH (F5) reads the game folder and the library again, CHECK UPDATES asks Nexus now, UPDATE ALL (see section 11), EXPORT LIST (section 16), RESET ORDER, PREVIEW and APPLY CHANGES. The GUIDE tab next to CORE MODS explains columns, colours and marks; SHOW EVERYTHING opens the rest.

4. Adding mods

Three ways, all ending up in the library:

  1. Drag and drop .zip, .7z, .rar or .archive files into the window, or use + ADD MOD (Ctrl+O).
  2. Mod Manager Download on a Nexus Mods page, once AFTERLIFE handles those links (Settings → Nexus Mods). The file is downloaded and imported; you see it in Download history.
  3. + ADD COLLECTION for a whole Nexus collection (section 12).

Every archive is checked before it is accepted: paths are validated, the layout is recognised (archives, CET, RED4ext, redscript, TweakXL, REDmod, bin/x64 plugins and so on) and the files are stored with their hashes. AFTERLIFE never runs .exe, .bat or script files from an archive.

What you may see after an import:

Mods added from files find their Nexus page (full edition, needs a key). A mod you add from an archive on disk is linked to its page on Nexus Mods when Nexus confirms it, first by the checksum of the archive, then by its file name. From then on it shows its description, picture, requirements and updates like a mod that came through Mod Manager Download. A mod Nexus does not confirm is left as it is; AFTERLIFE never guesses from the name. Link all unlinked mods… in the mod details and in Settings → Nexus Mods does the same for every mod already in the library: one list of what Nexus confirmed, one question.

5. Profiles

A profile is a list of which mods are on, which mod wins each conflict and the archive load order.

6. Apply changes: load to the deck

APPLY CHANGES (or Preview changes to just look) shows what will happen: how many mods go in and out, mods held back because a core mod they need is off, the load order, and files that need a decision. LOAD TO DECK writes it.

Preview changes lists the changes by mod (how many files each mod adds, replaces or removes, and why: switched off, held back because ArchiveXL or another core mod is off, new content); BY FILE › shows every file. When something blocks the apply, the reason is shown above APPLY CHANGES and SHOW MOD › jumps to the mod it concerns.

How the write works:

  1. every file is written to a temporary name next to its target,
  2. its hash is checked against the library,
  3. the intent is recorded in a journal,
  4. the file is renamed into place,
  5. at the end every file is verified.

Files that AFTERLIFE did not put there are never overwritten or deleted. If a step fails, nothing is left half done: the game stays in the previous state, and a crash or power cut in the middle is offered as FINISH or RETURN TO PREVIOUS the next time you start AFTERLIFE.

When an apply takes a core mod out of the game, the files that mod created itself (logs, settings) are moved into the library as Leftovers of …, so they can be restored.

7. Jack in: starting the game

JACK IN starts Cyberpunk 2077 with --launcher-skip. If the profile contains REDmods, AFTERLIFE first runs the game's redMod.exe deploy (only when the REDmod list changed) and starts the game with -modded. If the REDmod DLC is missing, the game starts without the REDmods and AFTERLIFE tells you how to add it.

JACK IN asks you to apply first when the game does not match the selected profile.

8. Mod details

9. Requirements and core mods

AFTERLIFE combines two sources:

Each requirement shows its state: deployed (green), in library · not deployed, installed by hand, not in library. For a missing one, Open page ↗ opens its Nexus page (or Search on Nexus ↗ by name), and Copy name copies it for searching. Requirements the author marked as optional or recommended do not raise warnings.

Switching a mod on offers to also switch on what it needs (if it is in the library). Switching a mod off opens the dialog SWITCH OFF ‹mod›? (or SWITCH OFF 5 MODS?) with up to three parts, each explained by a sentence under its title: WILL STOP WORKING lists the switched-on mods that need it (ticked: they go off with it), NOT NEEDED ANY MORE lists the mods nothing else switched on needs once it is off (their own checkbox, unticked) and STAYS ON, to read only, lists what it needs that another switched-on mod still uses. The last two parts follow the first checkbox: untick it and the mods that need it stay on, so what they use moves from NOT NEEDED ANY MORE to STAYS ON. Core mods are never offered. A mod without such links goes off without a question. The same dialog appears for a selection, a category and whole blocks. Switching a collection off asks next SWITCH OFF UNUSED MODS? about the mods outside it that only it needed (unticked); Cancel there leaves the collection on.

Core mods are the frameworks other mods build on: Cyber Engine Tweaks, RED4ext, redscript, ArchiveXL, TweakXL, Codeware, Input Loader and, optional, Mod Settings, Native Settings UI, RedFileSystem, Audioware and Virtual Atelier. They have their own yellow block and are never changed by collections. Turning all core mods off asks about every mod that depends on them, because most mods will not run without them.

10. Conflicts and load order

Two mods can bring the same file. AFTERLIFE shows ! CONFLICT · DECIDE and the Conflicts tab lists the files with the mod that wins each one.

Load order

Where it matters. Only archive mods (.archive files in archive/pc/mod) have a load order. When two of them change the same game asset, the one that loads first wins. The order (written to modlist.txt) does not affect scripts, CET, RED4ext, TweakXL and other mods; for them only the file conflicts above count.

How the list maps to the order. The top of the list loads first and wins:

  1. CORE MODS (always first, cannot be moved),
  2. then the blocks from top to bottom (every COLLECTION and MODS),
  3. inside MODS: the mods without a category first, then each category from top to bottom,
  4. inside MODS and inside every category the mods load in the order you give them; inside a collection they keep the curator's order.

The number at the start of a row (#1, #2 …) is its place in that order, counted after CORE MODS; it is shown only while the list is in load order (not while it is sorted with SORT). A number shown dimmer belongs to a mod without any .archive file in archive/pc/mod: the load order does not affect it (its tooltip says so).

To load one mod before another (for example a texture fix that must win over a bigger texture pack):

  1. Drag the mod by its ⋮⋮ handle above the other one, inside MODS, inside a category or from one into another. A line shows where it lands. Several checked mods move together and keep their order.
  2. APPLY CHANGES. The preview shows the new order before anything is written.

From the keyboard (only in the load order view, not while sorted with SORT): Ctrl+Up / Ctrl+Down move the checked mods (or the selected row) by one row inside their section (MODS, one category or an unlocked collection), Ctrl+Home / Ctrl+End to its start or end. They never cross into another section.

A mod's local edits (└ name) always stay right below the mod and move with it. Categories still group mods, and a whole category moves by its handle or the small arrows. A→Z in the header of MODS or a category sorts that section by name once, after a question; nothing changes in the game before you apply. New mods go to the end of MODS, without a category; an updated mod keeps the place of the old version. The order belongs to the profile: another profile can order the same mods differently (categories are shared by all profiles).

Inside an unlocked collection you can drag rows the same way (section 12). Moving a mod, a block or a category changes the load order; AFTERLIFE tells you when a conflicting file gets another winner, and nothing changes in the game before you apply. AFTERLIFE writes the order to modlist.txt when you apply. Until you change the order of a profile, the game uses its default (alphabetical by archive name) and the list shows the mods of MODS by name. Reset order returns to that default. Sorting the list (SORT) changes only the view, never the order.

Save and load the order (EXPORT ORDER, IMPORT ORDER)

EXPORT ORDER (above the list, next to EXPORT LIST) saves the load order of the selected profile to a text file, afterlife-order-<profile>-<date>.txt: a backup, a way to move the order to another PC, to share it, or to edit it in Notepad. Every mod of the list is written, switched on or off, with CORE MODS, every collection, MODS and every category in load order. A mod's local edits are written as notes only: they exist just in the library they were made in.

The file is plain text. The first line is AFTERLIFE LOAD LIST 1; lines starting with # are notes. @core, @collection <name>, @mods and @category <name> start a section, + <name> is a mod switched on and - <name> one switched off. After the name a line can have the version and fields separated by | (nexus=, file=, md5=); a hand-written + Better Lighting is enough. Top loads first and wins, as in the window. You can move lines, change + and - and add @category lines.

IMPORT ORDER loads such a file into the selected profile. First a preview shows what changes: mods that change place, switched on and off, new categories, other versions, mods missing in the library, and every mod found only by its name on its own line (two different mods can share a name, so check those). A mod is found by its Nexus file, then the checksum or name of its archive, then its name and version, then its name alone. Options in the preview:

Good to know:

11. Nexus Mods: key, downloads, updates

Your key

AFTERLIFE uses your personal Nexus Mods API key. Get it on nexusmods.com → Site preferences → API Keys (Personal API Key), paste it in Settings → Nexus Mods and SAVE KEY. AFTERLIFE checks it and shows your account type. The key is stored encrypted for your Windows user; Remove key deletes it.

Log in with Nexus Mods (single sign-on) will replace the copy-paste once Nexus Mods has registered AFTERLIFE as an application.

Mod Manager Download

Turn on Open Mod Manager Download links in AFTERLIFE in Settings. AFTERLIFE registers itself for nxm:// links for your Windows user (the previous handler, for example Vortex, is remembered and given back when you turn it off). Then Mod Manager Download on any Cyberpunk 2077 mod page downloads the file straight into the library.

GET NEW MODS opens the Cyberpunk 2077 section on Nexus Mods. Download history lists everything downloaded through AFTERLIFE, with search; your full history is on the Nexus website.

Updates

With a key, AFTERLIFE looks for newer versions when it starts and then every hour. It asks Nexus which mods changed and reads only those, core mods and the mods of the selected profile first. As a safety net every mod is also read in full once in a while (every 7 days by default), the mods taking turns so about the same number is read each day. CHECK UPDATES asks right away.

Settings → Updates has the switches: the check at start and the check every hour (separately; core mods are always checked), check only the mods switched on in the selected profile, the number of days between full reads (0 = never) and Check every mod now….

The request limit of Nexus Mods. Nexus allows every key 20,000 requests a day and 500 an hour, for all programs that use the key together. AFTERLIFE knows the limit, stops a check a little before it so downloads still work, rests until the quota is back and then goes on by itself. Settings show what your choice of days costs for your library and warn when it is too often.

A mod with a newer version shows UPDATE vX in the list and an UPDATE line in its details.

With Nexus Mods Premium

AFTERLIFE works with a free Nexus Mods account, and it is at its best with Premium, because Nexus allows direct downloads through its API only for Premium members:

Premium Free account
UPDATE downloads the new file directly opens the download page; one click on Slow download
UPDATE ALL one question, then every update downloads and installs by itself opens the pages one after another; one click for each mod
Collections the whole collection downloads by itself one click on Mod Manager Download for each mod
Download speed uncapped capped by Nexus

With a few hundred mods the difference is one click instead of a few hundred. Premium also supports the mod authors and the site that hosts their work. You can get it on nexusmods.com; AFTERLIFE itself stays free either way and locks nothing behind it.

What an update does

An update replaces the old version completely: the new one takes its place in every profile (same position, on or off as before), in its collections and category and as the winner of its file conflicts. When the profile is the one in the game, AFTERLIFE applies right away, then deletes the old version from the library. UPDATE ALL and REPLACE ALL apply once at the end. If the game cannot be changed at that moment (for example it is running), the old version is kept until you apply.

12. Collections

+ ADD COLLECTION accepts a collection link (https://next.nexusmods.com/…/collections/… or nxm://…/collections/…). The preview shows:

ADD COLLECTION then downloads what is missing:

The collection window stays open while it downloads: one progress bar for the whole collection, the mod in progress, the state of every mod, PAUSE (stops after the current file) and RESUME (continues and retries failed ones). Closing the window does not stop the download.

In the library a collection is its own cyan block, with Manage ›, a count of mods on and a switch for the whole collection:

Mods you add later stay outside the collection; the collection always matches the curator's version on Nexus.

Manage collection:

Core mods are never changed by a collection: if the collection lists a core mod you already have, your version is used.

13. FOMOD installers and REDmods

FOMOD: archives with fomod/ModuleConfig.xml open a wizard with the author's steps, groups, descriptions and pictures. Your choices are saved with the mod and reused when you import a newer version. AFTERLIFE reads the XML only; it never runs C# scripts.

REDmod: archives with a mods/<name>/info.json layout are recognised. They are deployed with the game's own tools\redmod\bin\redMod.exe before the game starts (section 7). The REDmod DLC must be installed (free on every store).

14. Scan manual mods

The card on the left shows how many files in the mod folders AFTERLIFE does not manage, by folder (archive, redscript, tweaks, CET, RED4ext, REDmod, other). Scan manual mods opens the list:

Files that mods in the library create on their own (logs, settings, caches, lock files in their own folder, red4ext/config.ini) are not reported, also while the mod is switched off, and identical leftovers from an earlier manual install of the same mod are ignored. A core-mod group that holds only such files says so instead of installed manually. The Address Library database (bin/x64/plugins/address_library/version-….bin), which native plugins write when the game starts, belongs to the game: it is never reported and never moved. A mod folder that holds nothing its loader would load (no init.lua, .reds, .dll, tweak, archive or REDmod info.json), only files a removed mod left behind (lock files, logs, saved settings), is not a mod and is not listed either.

15. Files changed outside AFTERLIFE

Mods often change their own files after you play: settings, databases (AMM's db.sqlite3), caches. AFTERLIFE tells the two cases apart by where the file is:

Files a core mod rewrites by design every time the game runs (Input Loader's r6/cache/inputContexts.xml, inputUserMappings.xml and input_loader.ini, Mod Settings' user.ini) are treated like files in the mod's own folder.

16. Export the mod list

Export list (above the list) gives the active mods with their versions and Nexus links:

Attach it to bug reports, or use it to find the mod that breaks something (switch half of them off, test, repeat).

EXPORT LIST is a report and cannot be loaded back. To save the load order and load it again (a backup, another PC), use EXPORT ORDER and IMPORT ORDER (section 10).

17. Settings

The settings have tabs on the left and the chosen tab on the right. They open on the tab you used last. Under the tabs are the version and Remove AFTERLIFE from this PC… (section 21).

Tab
01 · Game & library The game folder: CHANGE… moves AFTERLIFE to another install (it asks to take the mods out of the old one first). Where the library is, with Open in Explorer.
02 · Nexus Mods Account: your key and account type (a green dot on the tab means the key works). Link mods: Link all unlinked mods… (section 4). Download links: open nxm:// links in AFTERLIFE. Locked in AFTERLIFE Offline.
03 · Updates When AFTERLIFE looks for newer versions and what it reads, and the cost in requests to Nexus Mods (section 11). Visible with a lock in AFTERLIFE Offline.
04 · Display Reduce motion stops the background, glitches, scans and the breach animation. Draw only the visible rows (experimental, off by default) makes a list of hundreds of mods open and scroll faster; switch it off again if the list jumps while scrolling or dragging.
05 · Kept files Copies AFTERLIFE keeps so you can undo: Removed files, downloaded archives and temporary files. Each line shows its size and has Show (opens the folder, so you can look first) and Delete; DELETE ALL KEPT FILES clears all three. The tab shows the total. Deleted kept files can no longer be restored; the game, the mods in the library and the profiles stay.
06 · Diagnostics Log what AFTERLIFE does (off by default) writes switches, imports, every planned file change with its reason, blockers and results into activity-YYYYMMDD.log, one file per day; Open log folder shows %LOCALAPPDATA%\AFTERLIFE\logs. Copy diagnostics copies the mod list, versions and the last errors to the clipboard for a bug report, without your key or paths. Nothing is sent anywhere.
07 · FIXER Off by default. FIXER is not released yet, so for now this switch has nothing to receive. For FIXER, a quest editor for Cyberpunk 2077: while this is on, AFTERLIFE takes the quests FIXER leaves in the fixer\inbox folder of the library. They arrive in the category FIXER, switched on in the selected profile, and go into the game with APPLY CHANGES like any other mod. A new build of a quest takes the place of the previous one; a quest FIXER withdraws is switched off in every profile.

18. After a game update

When the game version or build changes, AFTERLIFE shows a game updated banner. Nothing is switched off, but JACK IN asks before a modded launch (Launch anyway or Switch to Mods off). Many mods, especially RED4ext plugins and CET, need their own update after a game patch:

  1. check the core mods table and the authors' pages for versions that support the new build,
  2. update them (section 11),
  3. click REVIEW on the banner and apply.

19. If something goes wrong

More in the FAQ.

20. Where AFTERLIFE keeps its data

What Where
Settings %APPDATA%\AFTERLIFE
Library (default) %LOCALAPPDATA%\AFTERLIFE\Library, or the folder you chose. A folder named AFTERLIFE Library next to AFTERLIFE.exe is used automatically (portable use).
Inside the library afterlife.db (database), packages (mods), downloads, removed, staging, backups, locks, cache/images, exports (the order saved before each IMPORT ORDER), and fixer once the FIXER drop box was switched on
Logs %LOCALAPPDATA%\AFTERLIFE\logs
Nexus key encrypted with Windows DPAPI for your user, in the settings folder

21. Removing AFTERLIFE

  1. Apply Mods off if you want the game without AFTERLIFE's mods.
  2. Settings → Remove AFTERLIFE from this PC…: gives nxm:// links back to the previous app, deletes the saved key and the settings, and the library too if you tick it.
  3. Delete the folder AFTERLIFE.

22. Keyboard and mouse

Ctrl+O Add mod
F5 Refresh
Ctrl+A Select all mods the search and the filters show
Esc Clear the search
Double-click a mod, profile or category name Rename
Shift+click, Ctrl+click Select several mods
Ctrl+Up, Ctrl+Down Move the checked mods (or the selected row) one row up or down in the load order, inside their section
Ctrl+Home, Ctrl+End Move them to the start or end of their section
Drag ⋮⋮ Move a mod up or down inside MODS, a category or an unlocked collection, or into another category; move a block or category (load order)