Modding in SimplePlanes

To use a mod, it must first be installed. Installing a mod consists of downloading the .spmod file (or .spmod-android on Android devices) and copying it in to the Mods folder for the game. The specifics of how this is done can vary by platform. The section below explains how to install a mod on each platform. Once a mod is installed, it must still be enabled in the game before it can be used (see the Managing Installed Mods section below for more info).

Windows

C:\Users\[Your User Name]\AppData\LocalLow\Jundroo\SimplePlanes\Mods\

To install mods on a Windows version of SimplePlanes, copy mods into the above directory. The "[Your User Name]" part of the path should be replaced with your windows user name. The AppData folder is hidden by default so you may need to turn on the showing of hidden files in order to find the directory.

To make the installation of mods easier, file associations should be set up such that you can open a mod directly (such as by double-clicking on it) and it should launch the game and automatically install the mod for you. If you want to uninstall a mod, you will still need to navigate to the Mods directory listed above and manually delete the file.

If the game doesn't appear to load any installed mods, check the Mods directory above and make sure there are no .temp files in the directory. If there are, delete those .temp files and verify that all .spmod files are not marked as read-only.

OSX

~/Library/Application Support/Jundroo/SimplePlanes/Mods/

To install mods on an OSX version of SimplePlanes, copy mods into the above directory. The library folder may be hidden by default, so if you have trouble finding it, check out the article here.

The Mac App Store version of the game does not support modding due to Apple's App Store policies. Sorry.

Android

/Android/data/com.jundroo.SimplePlanes/files/Mods/

To install mods on an Android device, copy mods into the above directory. Note that Android mods have the file extension of .spmod-android. Non-Android mods with a .spmod extension will not work. You may want to get a file browser app (such as ES File Explorer) for your Android device to help you navigate your device folders and copy mod files.

To make the installation of mods easier, file associations should be set up such that you can open a mod directly which should launch the game and automatically install the mod for you. If you want to uninstall a mod, you will still need to navigate to the Mods directory listed above and manually delete the file.

iOS

The iOS App Store version of the game does not support modding due to Apple's App Store policies. Sorry.

Steam Workshop

Some mods are hosted on the Steam Workshop. Using Steam, you can subscribe to these mods. Once subscribed, the mod will be automatically downloaded and installed. There might be a slight delay in the download process so a mod might not be available when jumping in to the game immediately after subscribing. If the mod was not fully downloaded before starting the game, you will need to exit the game and restart it before the mod becomes available.

Though mods are automatically installed, they are not automatically enabled. You will still need to enable the mod in game (see the Managing Installed Mods section below for more info). When a mod you have subscribed to in the Steam Workshop is udpated, Steam will automatically download the update for you. If this happens, you should receive a message about updated content upon entering the game. When a mod is updated, it is automatically disabled. You will need to manually re-enable the mod after it is updated.

When one or more mods are installed, a "Mod" button will show up in the main menu for the game. Clicking this button will take you to a menu with a list of installed mods. Mods that are currently enabled will have a green mark next to their name. Mods that have failed to load properly will have a red mark next to their name.

Clicking on a mod will show you some information about the mod in the panel on the right side of the screen. If the mod is not yet enabled, you can click the "Enable" button at the bottom of the screen to enable the mod. It should become enabled immediately and show a green mark next to its name if everything loaded successfully. To disable a mod, select a mod that is currently enabled and click on the "Disable" button at the bottom of the screen. A mod cannot be fully disabled until the game is restarted.

For information on how to create mods for SimplePlanes, check out Modding Wiki on our subreddit. Feel free to contribute to the wiki as well!