You are viewing a potentially older version of this package. View all versions.
WispForest-TextureSwapper-1.2.0 icon

TextureSwapper

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.

Date uploaded 4 months ago
Version 1.2.0
Download link WispForest-TextureSwapper-1.2.0.zip
Downloads 973
Dependency string WispForest-TextureSwapper-1.2.0

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2100 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2100
BULLETBOT-KeybindLib-1.0.3 icon
BULLETBOT-KeybindLib

A library that lets you add your own keybinds to the controls.

Preferred version: 1.0.3
WispForest-MediaHelper-1.0.0 icon
WispForest-MediaHelper

This mod acts as a way to have media utilities for the mod TextureSwapper

Preferred version: 1.0.0

README

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

  1. In the plugins folder where you placed the TextureSwapper-x.dll file, create a folder named texture_swapper_queries.
  2. 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

CHANGELOG

v1.1.7

  • Make Local rating optional in data format
  • Update method on getting extension information from URL if unable to query data though URL using head
  • Fix issues with internal image querys for Missing, Error, Loading and Censored being broken due to local rework in v1.1.3
  • Add log for if internal image querys were not found during loading to better indicate such issue if it occurs

v1.1.6

  • Fix issues with local image files being improperly handled for their identifier and adjust file name for user settings

v1.1.5

  • Fix issues related to local queries having duplicate names without unique taking into the folder/mod as namespace
  • Revamp global user settings access for tag mangement and users app credentials

v1.1.4

  • Refactor around Media Info to have more optional fields and add MediaFormat Endec
  • Add ability to toggle off global blacklist and whitelist tags

v1.1.3

  • Prevent duplicate caching of local media results
  • Fix issues with crashing due to off thread actions, refactor URI -> Identifier code for future plans
  • Fix local media file regex
  • Rework Web Queries to be loaded as separate plugin and patch reddit links to work
  • Fix issues with Web Media Query and add more checks for areas that cause possible exceptions

v1.1.2

  • Fix issues where blacklist is only applying in restrictiveQueries mode
  • Add more sanitization steps and prevent ability for path traversel

v1.1.1

  • Add ability for local queries to have media rating

v1.1.0

  • Initial Release