Skip to content

Custom Assets Support

Christian Semmler edited this page Aug 11, 2025 · 3 revisions

isle-portable supports custom asset packs via its built-in SI loader, making it possible to add or change backgrounds, music, animations and more.

How to Use a custom asset pack

Currently, isle-portable provides a pre-built set of assets. It is possible to create your own, however tooling for this is limited in functionality at this time and there's no documentation yet.

  1. Obtain asset packs (e.g., isle-assets.zip) and place the SI files in a destination of your choice.

  2. Enable the SI loader by adding the following to your isle.ini file:

[extensions]
si loader = "true"

[si loader]
files = /path/to/asset.si

Multiple SI files may be specified by separating the paths with a comma. Each path must be relative to either diskpath or cdpath.

Clone this wiki locally