Skip to main content
Each mod is one folder in Mods. This page covers the files that describe a mod, and Mods\mods.json. The files with content are on their own pages: see what a mod can hold.

Folder names

A mod’s folder name:
  • is 1 to 64 characters: ASCII letters, digits, spaces, _, - and .;
  • does not start with . (folders such as .reskate are ReSkate’s own);
  • has at least one file at its top, or a parks folder.
A folder that breaks these rules is not a mod, and is skipped without a message.

manifest.json

The Thunderstore manifest names the mod. ReSkate reads four fields and ignores the rest:
The file can be 32 KB. Without a manifest.json, ReSkate reads reskate-mod.json, an older name with the same fields (where version is used instead of version_number). Publishing on Thunderstore has the rules Thunderstore adds. A plugin’s message channel is named after the manifest’s name.

icon.png

The mod’s picture. ReSkate shows it:
  • on a map’s card in the map grid;
  • on the card of an item the mod adds, beside the mod’s title;
  • on the card asking a player to download a map in multiplayer.
Make it a 256 by 256 pixel PNG, as Thunderstore wants. A map’s picture can be at most 4 MB.

README.md

Shown on the mod’s page in the launcher, as plain text without pictures or HTML. The launcher reads up to 512 KB of it. For a mod from Thunderstore that is not installed yet, it shows the package’s README from Thunderstore.

The build stamp

A mod with game data (layout.toc) has to say which version of skate. it was built for. ReSkate Studio writes this into .reskate-studio-patch when it builds the mod. ReSkate compares it with the game it supports, and a mod built for another version does not load: the launcher marks it OUTDATED. A mod with layout.toc and no stamp counts as outdated too. Mods without game data (parks, plugins, reskate-music.json and the like) need no stamp. ReSkate Studio also writes reskate-build.json for maps: which Studio built it, and when. It is for your information only.

mods.json

Mods\mods.json holds the load order and which mods are on:
  • Mods are listed highest first: earlier rows win over later ones.
  • schema is 1, each row holds exactly name (the folder’s name) and enabled (true or false), and no folder is listed twice. No other fields are allowed.
  • Folders in Mods that the file does not list are on, and come after the listed ones, by name.
  • A row for a folder that is not there is noted in the log, and the launcher says so.
When mods.json cannot be read, no mod loads at all, plugins included. The game says Mods folder ignored, and the launcher says why and rewrites the file at your next change. Let the launcher and the in-game MODS tab write it.