File Structure

The files for workshop items can be found in two different locations. One location contains the files for all mods that you've subscribed to and downloaded via the Steam Workshop. The other location contains local content – in other words, files in this location while NOT be synced via the Steam Workshop. This location is generally used to store workshop items that you create/modify.

Downloaded Content

When you subscribe to an item through the Steam Workshop, its files are downloaded and placed in your Steam Library folders. For many users, the file path for this location will be:

C:\Program Files (x86)\Steam\steamapps\workshop\content\383980

💡

If your steam library is installed in an area that’s not the default, you can also do a search for the Rivals app ID (383980) to find your Steam Workshop content.

Within this folder, you will be able to access the files of any character, stage, skin, or buddy that you have subscribed to. They will each be packed into their own folder labeled with the mod's 10-digit unique ID. This ID should match the number found at the end of the item's URL on the Steam Workshop. For example, Sandbert (located at https://steamcommunity.com/workshop/filedetails/?id=1865940669) will have all its files located in the folder named 1865940669. This number will also be used in the item's config.ini to point Steam towards the correct workshop item when uploading your local version of the workshop item as an update to an already existing mod.

⚠️

These files will be automatically updated when you subscribe/unsubscribe from a mod or when the item is updated by its authors. For this reason, it is not recommended that you modify files in this directory. If you would like to modify an item that you have subscribed to, you should copy the item's folder to the directory where you can find your local content and modify the copy only.

Local Content

Workshop items that you are working on should have their files placed in the Rivals of Aether folder found in your %localappdata% folder. For most users, the file path for this location will look something like:

C:\Users\{Your Account}\AppData\Local\RivalsofAether

From here, you should create folders named workshop and stages if they do not already exist. Files for each workshop item that you are creating should be packed into their own individual folders within the workshop and stages folders.

The workshop folder is where you will place the files for any characters, buddies, or skins you are working on. The stages folder is where you will place the files for any stages you are working on.

For character and skin mods, each mod's folder should contain the following:

• Folders:
  • fonts – folder containing all custom font properties in .ini format
  • scripts – folder containing all custom scripts in .gml format
    • attacks – sub-folder containing all attack scripts in .gml format
  • sounds – folder containing all custom sounds in .ogg format
  • sprites – folder containing all custom sprites in .png format
• Files:
  • config.ini – a file with all general info about your item
  • charselect.png [102 x 72px] – a preview for the in-game character select menu, usually with the character facing right
  • hud.png [48 x 32px] – used in the bottom HUD during gameplay
  • hurt.png [48 x 32px] – used in the bottom HUD while being launched
  • icon.png [15 x 15px] – used for the in-game workshop items list and various HUDs
  • offscreen.png [34 x 34px] – used when the player is offscreen. Use this template to make it fit inside the offscreen indicator
  • portrait.png [350 x 350px] – large portrait showed on Steam workshop page and on the after-match results screen
  • preview.png [any size, but 16:9 aspect ratio, 960 × 540px recommended] – used as the preview image for the item when browsing the Steam Workshop
  • result_small.png [79 x 31px] – used in the results screen (usually a cropped, mirrored version of charselect.png)

ℹ️

For the .png files listed above, aside from preview.png, the image's dimensions must match exactly the dimensions listed here.

Stage and buddy mods will have slightly different contents. More information can be found on their respective pages in this manual.