TextureSwapper

版本 v1.2.0·更新於 2026-01-14

This mod is based on Custom Paintings and allows for the ability to replace Various Textured Items (Sellable or Static) either by end users or other plugins.

模組介紹 作者原文

Texture Swapper (R.E.P.O.)

Texture Swapper is an in-depth Texture and more swapper mod to the game R.E.P.O designed to be expandable and easy to use. Such was based on RandomPaintingSwap by GabziDev and credit to them for the orignal idea and code.

More Info

Recommend to check out Texture Swapper on GitHub for more up-to-date info about features and guides on using the mod.

Adding Custom Images

  • In the plugins folder where you placed the TextureSwapper-x.dll file, create a folder named texture_swapper_queries.
  • Place your images inside this folder. These images will be used to randomly replace the paintings in the game.

Do note that the texture_swapper_queries also looks into each plugin installed and into the config folder as well.

Supported Media Format

The following is the currently supported formats to swap textures and other assets with more to be added in the future:

Image Formats

-.png

-.jpg.jpeg

-.bmp

-.tiff

-.psd

-.webp (Converted to.png internally)

-.svg (Converted to.png internally)

-.gif (Note that all gifs are converted to webm's as such provides better performance with playback and file size

Video Formats

-.webm (Only VP8 Codec works due to issues with Unity)

-.mp4 (Check unity for supported codecs)

Data Format Information

Info about the data format to making queries will be documented within the future.

Future Plans

  • Add support for APNG
  • Check media format size to better match swapping of textures to texture loactions
  • Allow for swapping textures onto other textures i.e. replace the fridge images without needing asset replacement
  • Swap to using VLC or another media player to allow for more supported Codec and Media formats
  • Documentation about default queries provided, the format for making query files and info about creating addons for services
  • Add Support for Youtube and other Video Platforms

Known issues

  • DOSE NOT WORK IN SINGLEPLAYER
  • Random network incompatibilities
  • Some Image URL's are not valid due to how the URL pattern currently works
  • Local files are copied to cache instead of being used directly
  • Only a single instance of a VideoPlayer can occur
  • Some swapped textures are UV / Sprite Sheeted, leading to issues with the images swapped to being cropped

安裝與使用 安裝:BepInEx 外掛

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

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

前置依賴

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

BepInEx-BepInExPackBULLETBOT-KeybindLibWispForest-MediaHelper

檔案與校驗

檔案名稱
TextureSwapper-1.2.0.zip
檔案大小
1.5 MiB