PaintingReplacer
Swaps out paintings with custom image files
About this mod Author’s original text
Painting Replacer
This is a simple painting replacement mod for R.E.P.O that loads the image data after the level has loaded, rather than pre-loading the images during startup.
This mod is inspired by UnderratedJunk.CustomPaintings
Some code for the default map painting references and specific aspect ratios for image material targets was taken from this mod.
During initial game load, the image dimensions are taken from reading the header of the file, rather than using Unity's Texture2D. This makes initialisation much faster at the expense of image compatibility.
Multiplayer
Images are selected based on:
- Position of the painting
- Target Material Name
- AspectRatioType (Landscape, Portrait, Square)
This means that in multiplayer, all clients should pick the same images as long as the same image list is present on all clients.
Custom Map Compatibility
Custom maps can choose to provide their own ".paintings.json" file in a "PaintingsConfig" directory.
This file simply contains the material name and which aspect ratio to use:
For example, this mod includes a config file for the ApexBanking level by Nikki:
{
"PaintingTime": 2,
"PaintingHiccubz": 2,
"PaintingMystorra": 1,
"PaintingMoney": 2,
"PaintingInsym": 2
}
Landscape = 0, Portrait = 1, Square = 2
Install & use Install: BepInEx plugin
- The archive from playbuff is the mod itself — usually a BepInEx plugin (a .dll or a plugin folder once unzipped).
- Recommended: use a community mod manager (such as r2modman) — pick this game, import the mod, and the manager sets up BepInEx and its dependencies for you.
- Manual route: install the BepInEx loader in the game folder, then drop the unzipped .dll or plugin folder into BepInEx/plugins/.
- Launch the game — the BepInEx console logs every plugin it loads; seeing this mod in the log means it is installed.
Mods with listed dependencies need those installed too, or they will not load. Options are usually changed in-game or in the plugin's config file.
Install these first, or the mod will not work: