PaintingReplacer

版本 v0.0.2·更新於 2026-06-22

Swaps out paintings with custom image files

模組介紹 作者原文

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

安裝與使用 安裝:BepInEx 外掛

  1. 本站下載的壓縮包就是模組本體,通常是 BepInEx 外掛(解壓後得到 .dll 或外掛資料夾)。
  2. 建議流程:用社群模組管理器(如 r2modman)選中本遊戲後匯入該模組,管理器會自動裝好 BepInEx 前置並處理依賴。
  3. 手動流程:先在遊戲目錄裝好 BepInEx 載入器,再把解壓出的 .dll 或外掛資料夾放進 BepInEx/plugins/。
  4. 啟動遊戲,BepInEx 控制台會列印載入日誌;確認這個模組出現在日誌裡即為安裝成功。

帶「前置依賴」的模組需要一併安裝,否則不會載入。功能開關通常在遊戲內或外掛自帶的設定檔裡調整。

前置依賴

下面這些內容需要先安裝,否則該模組不會生效:

BepInEx-BepInExPack

檔案與校驗

檔案名稱
PaintingReplacer-0.0.2.zip
檔案大小
27.3 KiB