AdvancedStructureSkins

Advanced Structure Skins

Advanced Structure Skins allows users to create custom shaders for structures, providing creators with extreme flexibility, albeit also introducing additional complexity and potential incompatibilities.

This mod may remove game functionality, including but not limited to visible grounded effects, grounded vertex offsets and on-collision structure shaking, depending which shaders are used (as these features are implemented in the shader and must be rebuilt by skin creators.)

Don't forget to install AdvancedStructureSkins.Shared.dll in /RUMBLE/UserLibs!

You can watch a video tutorial for User setup and for getting started as a developer here:

NOTE: This video is slightly outdated! Advanced Structure Skins now uses a UIFramework implementation, so press F9 instead of F10 when selecting your skins!

For Users

Installing Skins

To find skins, head to the Rumble Modding Discord's #skin-share forum. Find a.bundle (v1.0.0 - v1.3.3) or.asb (v2.0.0+) file for a skin you like the look of and place it in /RUMBLE/UserData/Skins. You may have to create this folder. Once you launch the game, your skin will be available to select in the UIFramework menu for Advanced Structure Skins.

There are two types of skins:

• Shaders, which have their visuals generated by code
• Textures, which are images placed on your structures

Some Shaders can sample Textures, allowing you to use a texture skin with a unique shader..bundle files will only ever contain Shaders, but.asb files may contain either a Shader, a Texture Set, or both. In fact,.asb files can contain as many different Texture Sets as a developer wants.

Shaders are selectable in the Shaders tab in Advanced Structure Skins' UIFramework menu. Likewise, Textures are selectable in the Textures tab.

Manually Installing Texture Sets

Texture Sets may also be installed without using.asb files. Each Texture Set supports 4 images, Main.png, Normal.png, Mat.png and Grounded.png. Main images are typically a fairly normal looking image, a flat colour which contributes the majority of the texture's appearance. Normal, despite the name, is not a normal map any more due to changes in RUMBLE's art pipeline. Instead, it is typically a red and yellow image, which applies highlights and shadows to a structure's surface.

Installing Texture Sets manually is fairly straightforward.

Here's the folder structure you'll want to create:

RUMBLE

| - UserData

| | - Skins

| | | - StructureName

| | | | - Mat.png

| | | | - Main.png

| | | | - Normal.png

| | | | - Grounded.png

Valid structure names are Disc, Pillar, Ball, Cube, Wall, SmallRock and LargeRock.

If you want to use multiple textures, add your textures to a subfolder under the StructureName, and the game will automatically load the textures on launch. Textures can then be selected from the Textures tab.

If you want to prevent a skin from loading without deleting the skin permanently, just add an Underscore (_) to the beginning of the folder name and the game will ignore it.

Example folder structure:

RUMBLE

| - UserData

| | - Skins

| | | - StructureName

| | | | - SkinName (can be anything)

| | | | | - Main.png

| | | | | - Normal.png

| | | | | - Mat.png

| | | | | - Grounded.png

| | | | - SkinName2

| | | | | - Main.png

| | | | | - Normal.png

| | | | | - Mat.png

| | | | | - Grounded.png

If you want to use multiple textures of the same type for a single skin (like if you wanted a playing card which changed the Main texture randomly, but kept the same Normal, simply add a folder for that type of texture to your SkinName folder.

Example:

RUMBLE

| - UserData

| | - Skins

| | | - StructureName

| | | | - Main

| | | | | - tex1.png (can be anything)

| | | | | - tex2.png (can be anything)

| | | | | - tex3.png (can be anything)

| | | | - Normal.png

| | | | - Mat.png

| | | | - Grounded.png

You can combine this with the previous example too - placing the skin files in a SkinName folder will load multiple skins