Skip to main content

Installing Mods

Steam Workshop#

If you are using the Steam version of Mannequin, you can utilize the Steam Workshop functionality for easy mod management. In the Welcome Screen, there is another tab beside Recent Files labeled Steam Workshop. Opening this tab will reveal additional controls.

You can click Browse Steam Workshop to open Mannequin's Steam Workshop page in your browser. There, you can find any workshop items that you like and Subscribe to them.

After subscribing for workshop items in your browser, you can go back to Mannequin and click Synchronize Subscriptions. Mannequin will fetch all of your subscribed items, download them and manage them in your local storage. All of your subscribed item will appear on the list, and you can Unsubscribe from each one individually.

itch.io#

If you're not using a custom installation location setting inside your itch.io desktop app, you can simply install any mods to the default installation location and Mannequin will automatically scan them. The default installation location is located in different places depending on your OS:

  • C:\Users\[yourUserName]\AppData\Roaming on Windows (Vista and up)
  • /home/user/.local/share on Linux
  • /Users/[yourUserName]/Library/Preferences on macOS

If you're using a custom installation location instead or prefer not using the itch.io desktop app, then you can download the mods' ZIP files and use the Manual Mod Installation below. Please note that unlike Steam Workshop, there is no way to filter Mannequin's mods among other items in itch.io storefront. At the moment we're tagging our mod examples in itch.io with the mannequin tag.

Manual Mod Installation#

To install mods from other places manually, first you must locate the mod files inside your local storage. If the downloaded mod files is packed inside an archive (.zip, .rar, .7z or others) then you must extract it first.

After locating the mod files, you can go to Mannequin's Preferences sidebar, and find the Custom Library Location section. Click Add and then browse for your downloaded mod files in the file browser window that shows up.

Choose the folder where mannequin-library.json is located, or one level above that. Doing the latter can benefit you if you are collecting multiple mods in a single place, like this:

myModCollectionFolder/
โ”‚
โ”œโ”€โ”€ myDownloadedMod1/
โ”‚ โ”œโ”€โ”€ components/
โ”‚ โ”œโ”€โ”€ configs/
โ”‚ โ”œโ”€โ”€ thumbnails/
โ”‚ โ””โ”€โ”€ mannequin-library.json
โ”‚
โ”œโ”€โ”€ myDownloadedMod2/
โ”‚ โ”œโ”€โ”€ components/
โ”‚ โ”œโ”€โ”€ configs/
โ”‚ โ”œโ”€โ”€ thumbnails/
โ”‚ โ””โ”€โ”€ mannequin-library.json
โ”‚
โ””โ”€โ”€ myDownloadedMod3/
โ”œโ”€โ”€ components/
โ”œโ”€โ”€ configs/
โ”œโ”€โ”€ thumbnails/
โ””โ”€โ”€ mannequin-library.json

In above example, you can just add myModCollectionFolder to the Custom Library Location, and myDownloadedMod1, myDownloadedMod2, myDownloadedMod3 will be automatically added to Mannequin.