denikson-H3VR_Sideloader icon

H3VR Sideloader

Swap textures, materials, meshes and prefabs effortlessly

Last updated 3 years ago
Total downloads 96503
Total rating 5 
Categories Tools
Dependency string denikson-H3VR_Sideloader-0.3.7
Dependants 360 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack_H3VR-5.4.1101 icon
BepInEx-BepInExPack_H3VR

BepInEx pack for H3VR. Preconfigured and ready to use.

Preferred version: 5.4.1101
bbepis-XUnity_ResourceRedirector-4.16.3 icon
bbepis-XUnity_ResourceRedirector

The resource director allows you to modify resources loaded through the Resources and AssetBundle API as they are being loaded by the game.

Preferred version: 4.16.3

README

H3VR.Sideloader

Swap textures, materials, meshes and prefabs effortlessly

What is this?

H3VR.Sideloader is a BepInEx plugin for Hot Dogs, Horseshoes & Hand Grenades that allows to

  • Swap weapon textures, meshes, materials and whole prefabs
  • Do all the swapping without editing any of game's files
  • Package swapped assets into single-file packages that a user can easily drop into a folder

How do I get it?

Automated (recommended)

This is the recommended way to install Sideloader.

  1. Download and install Thunderstore Mod Manager or r2modman
  2. Click Install with Mod Manager button on top of the page
  3. Run the game via the mod manager

Manual

  1. Download the requirements listed at the top of the page
  2. Move the contents of H3VR_Sideloader folder into <Steam Location>\steamapps\common\H3VR\BepInEx.
  3. Create Sideloader folder in BepInEx folder (optional, will get generated manually as well).
  4. Run the game once for sideloader to initialize

How does it work?

Sideloader makes mod installation easy: all mods are packaged into single .h3mod (or .hotmod) files that are simple to install.
Each h3mod contains a special manifest file that provides necessary information for sideloader for asset swapping and additional metadata that can be useful in future mod managers.

How do I install a mod?

Via Thunderstore

If a mod is on Thunderstore, it is recommended to use a mod manager. With it, installing mods happens automatically.
Download and install one of the mod managers: Thunderstore Mod Manager or r2modman.

Manual

If a mod is not on Thunderstore, you can still install it manually.

Simply take .h3mod or .hotmod that you obtained and place it into the BepInEx\Sideloader folder. Refer to Steam guide on how to find your H3VR game folder.

Launch the game and you should have your mods installed an available!

How do I create a mod?

Textures (weapon and item skins):

Download latest SkinPacker.
Run the tool, fill the required info and press Pack h3mod.

Tutorial video

Meshes, materials, prefabs: WIP, there is no tool yet to do this automatically.
Refer to the wiki for info on how to create these packages manually.

Custom objects (weapons, spawner IDs): WIP, there is no tool yet to do this automatically.
Refer to the wiki for WIP info about creating new weapons.