For players
For quest makers
For translators
For artists
For Solarus developers
Useful links
For players
For quest makers
For translators
For artists
For Solarus developers
Useful links
This page explains how to upgrade a Solarus quest to the latest Solarus version.
Since Solarus 1.0.0, versions of Solarus are numbered as follows: x.y.z, where
The latest release is Solarus 1.5.3.
Patch versions only contain bug fixes. They never introduce incompatibilities, so when only the patch version changes, your quest continues to work.
Therefore, when we talk about compatibility, only the major and minor numbers are considered. In your quest properties file quest.dat
, the value solarus_version
indicates the format of your quest, with only the major and minor numbers. For example, if solarus_version
is 1.5
, your quest is compatible with Solarus 1.5.*.
To make your quest compatible with the latest version of Solarus, there are two steps:
Important improvements were made in Solarus 1.1. Some of them introduce incompatibilities that require manual changes of your Lua scripts. In particular, there is no built-in dialog box anymore and no built-in game-over menu anymore.
Solarus 1.2 introduces a lot of changes, including the port to SDL 2. Some changes introduce slight incompatibilities that require manual changes of your Lua scripts.
The main improvement of Solarus 1.3 is the addition of a graphical sprite editor in the quest editor. There is also slight changes in data files, but no incompatibility in Lua scripts. Therefore, no manual change is required.
Solarus 1.4 introduces a brand new quest editor. There are also slight changes in data files, and an incompatibility in Lua scripts due to the new way fonts are handled. Simple but manual changes of your Lua scripts are needed.
Solarus 1.5 introduces a new launcher GUI, better performance and a lot of new features like the camera as entity and maps with more than 3 layers. Some changes introduce slight incompatibilities that require manual changes of your Lua scripts. Additionally, for the launcher GUI it is best to provide an logo and an icon representing your quest.