psiberx/cp2077-archive-xl

ArchiveXL is a supporting mod for Cyberpunk 2077 mod authors rather than a player-facing add-on. Its value appears once you install several mods that want to extend the same game resource: instead of each mod replacing the original file, ArchiveXL lets them load additions alongside it, so the mods can coexist.

The problem

A modder who wants to add an item, localize a name or alter a clothing item's appearance normally has to alter the game's original resource files. Install two mods that touch the same resource and one overwrites the other, which is the familiar conflict that forces players into manual load-order fixes or abandoned mods. ArchiveXL changes the step where custom content is loaded: mods define additions or overrides that are merged at runtime, and the original resource stays untouched. The immediate result is that multiple expansions of the same item, entity or text resource can be installed together without the usual overwrite.

What's different

ArchiveXL is a runtime layer for mod-defined resources. It supports loading custom entity factories, which the README ties to item additions; adding localization text usable in scripts, resources and TweakDB; editing existing localization without replacing the original resource; overriding submesh visibility; adding visual tags to clothing; and spawning widgets from any library without registering dependencies (project instructions). These capabilities are exposed through the mod's own resource definitions rather than a general-purpose patching utility.

The trade-off is that it is a dependency with its own API surface. Mod authors have to learn the resource format and follow the Wiki conventions for dynamic appearances, body types, appearance suffixes, component overrides, visual tags and resource extension (documentation index, body types, visual tags, extending resources). It reduces mod-to-mod collisions only for mods built against it; it is not a universal conflict resolver for arbitrary Cyberpunk mods.

Who should try it

This is a good fit for someone authoring Cyberpunk 2077 mods who needs to add items or text and expects players to run other mods touching the same assets. It is also reasonable for a player assembling a mod collection, because many item and appearance mods list it as a requirement. It is a poor fit for a player who only wants a single standalone gameplay mod and does not want another framework in the dependency chain.

Requirements and limitations

ArchiveXL targets Cyberpunk 2077 2.5 and requires redscript 0.5.32+ and RED4ext 1.31.0+; installation means extracting the release into the game directory after setting up RED4ext. The pinned game version matters: a game update outside that target, or a newer RED4ext/redscript combination than the README accounts for, can break the mod's behavior. Ongoing upkeep is the real cost, since every framework in the chain and the game itself must stay compatible.

For authors, the available documentation covers specific extension features; it does not claim to cover every resource type or every conflict pattern. Treat the listed capabilities as the supported scope and test the particular resource extension against the mods you expect players to combine.

HotRepo's take

The only HotRepo observation is 137 stars and +5 on the daily board on 2026-10-25 (project page). That single dated snapshot says nothing about persistence, so trend evidence cannot yet be judged. The project has existed since 2021, which is a useful signal only for age, not for maintenance. Before building around it, verify that your game and redscript versions match the documented compatibility line and that the specific extension feature you need is documented in the Wiki.