Table of Contents
When you download a mod manually, make sure it is compatible with the version you are using. If you download a mod via OSE's built-in downloader it should be compatible without problems.
There are three major versions:
- 1.0.x (2007-2008, Windows only)
- 1.1.x (2008-...), an update of 1.0.x a year after the initial release. This is the branch that OSE is based on.
- 1.2.x (2011-...), based on 1.1.1 prior to open-sourcing, with a rewritten engine and many other changes. This is the branch that became the iPad version and later the Android version.
1.0.x (2007-2008, Windows only)
Not much information is present about mods for this old version. Since the game and data files were packed with Molebox and not easily accessible, not much was known and no modding took place.
This version can be quickly identified during start-up as it has an ugly grey bar as loading screen.
Don't attempt to make mods for this version!
This is also the version that the official demo is based on.
If, for some reason, you still have this version, upgrade to 1.1.x as described in the update forum post. Direct link: update tool (windows only).
1.1.x (2008 - ...)
The 1.1.x versions are very compatible and functionally equal. There are a few differences to watch out for that are described below. Known versions:
- 1.1.0 (Mac: Humble Bundle, Ambrosia Software)
- 1.1.1 (Windows: Plimus, Humble Bundle, Humble Store, GOG.com)
- 1.1.2 (Windows version on Steam)
- 1.1.3 (All Linux versions)
Known bugs / problems / annoyances
- Level editor: Crashes when deleting custom entity
- Unknown problem that might cause a crash during some boss fights in Labyrinth mod
- No support for display aspect ratios longer than 5:4 and wider than 2:1
- No world map support for mods.
Known differences and gotchas by version:
1.1.0 (Mac)
- Some graphics files are missing:
gfx/drask/*.png
gfx/queen-statue/*.png
If you use those in mods they will show up as white squares. If you want to use them, your mods must include them.
- Template scripts must be included specially (see version note on that page).
1.1.1 (Windows, Plimus, Humble Bundle, Humble Store, GOG.com)
No special issues known.
1.1.2 (Steam+Windows)
- Possibly minor (unknown) bug fixes compared to 1.1.1
- Adds Steam achievements
1.1.3 (Linux versions)
- Fails to load custom particle effects and shots
- Has a custom replacement for Steam achievements, but it is not possible to create custom achievements.
OSE (formerly called 1.1.3+)
- Fixes all known bugs from previous versions as long as backwards compatibility is preserved.
- Updated but backwards-compatible save file structure
- Backwards-incompatible changes to the scripting interface that breaks mods for previous versions.
- This is the version that should be targeted for modding.
1.2.x (iPad, Android)
- Technically the most advanced version, ported for mobile by Andrew Church
- The iPad version does not support mods.
- Mod support for the Android version is unknown (TODO: needs clarification).
- Various incompatible script interface changes (similar to some degree to the OSE version but not 100% the same)
- Slightly different save file structure
- The source code has, as of 2018, not been published, and likely never will.
- Mods are not relevant for the mobile versions.