Selecting Structure Skins - Textures

Textures used by structures are loaded when the game starts. In order to change them, make sure you close RUMBLE first.

Textures are stored in the RUMBLE directory under RUMBLE\UserData\Skins\StructureType. To get started, you'll need to create this directory yourself. Navigate to RUMBLE\UserData\ and right click, then select 'New Folder'. Name it Skins. Enter this folder, and create another new folder for each of the structures you want to retexture. Valid names are Disc, Pillar, Ball, Cube, Wall, SmallRock and LargeRock.

From there, take the texture files from the skin you'd like to use and place them in the folder for the structure type you're targeting. Only files with the following names will be loaded appropriately:

Main.png - Base Colour, Albedo, ect. Determines the colour of the structure.

Normal.png - Normal map. Helps determine the way light interacts with the surface of the structure.

Mat.png - Additional effects map, unused by default. Used by shaders differently on an individual basis.

Grounded.png - A noise map used to offset the grounded effect on the standard structure.

When you're done, you should have a folder structure like this:

RUMBLE
| - UserData
|   | - Skins
|   |   | - StructureName
|   |   |   | - Mat.png
|   |   |   | - Main.png
|   |   |   | - Normal.png
|   |   |   | - Grounded.png

From there, launch the game, and the mod will automatically apply the textures in these folders to your structures.

Selecting Structure Skins - Shaders

Custom shaders can be built by mod developers using the SDK available on github. Visual effect and texture usage can vary between shaders, as it is up to the modder to define how they look. Shaders are stored in .bundle files, which can be found and shared on the RUMBLE Modding Discord.

To select a custom shader, place your bundle files in RUMBLE\UserData\Skins or any folder inside it. (eg. RUMBLE\UserData\Skins\Disc works for organization purposes)

Next, launch rumble and load into the Gym. From there, press F10 on your keyboard to bring up the ModUI settings menu.

Select AdvancedStructureSkins from the mod dropdown, then select a setting from the settings dropdown.

By default, all structures will use the same skin, defined in the setting Global Skin Path. To disable this function, turn off Use Global Skin.

To select a shader .bundle file, navigate to the StructureType Skin Path setting corresponding to the structure you'd like to modify. In the text box, type the path to the .bundle file relative to RUMBLE\UserData\Skins.

(This means if your .bundle is stored in RUMBLE\UserData\Skins\myShader.bundle, you would enter myShader or myShader.bundle to select it.)

Finally, press enter to confirm your selection, then click the save button to save it. The input box should say Current Value: myShader. The selected shader will be used when you spawn a new structure. Alternatively, you can press F5 to reload shaders on all objects in the scene.

If you cannot interact with ModUI or the UI freezes, take off your headset for a couple of seconds - I've found that usually solves it.