Solarus Wiki

A wiki for the Solarus engine community

User Tools

Site Tools


Upgrade your quest from Solarus 1.2 to Solarus 1.3

The main improvements of Solarus 1.3 are in the quest editor: there is now a sprite editor, the quest tree gives more control over various files, and tile patterns are now identified by strings. There are also a few changes, like more customizable switches and bugfixes. Good news: there is no incompatible change in the Lua API. The only changes in the Lua API are bugfixes and new features, in particular with sprites and switches.

As always, you should make a backup before any upgrade.

In this page, we only focus on the incompatibilities. See the anouncement or the ChangeLog to know more about the new features.

Upgrading data files

Data files other than scripts can be upgraded automatically with the editor. Open your quest with Solarus Quest Editor 1.3 and a dialog will let you to perform the upgrade.

In case of trouble, please ask for help on the Solarus forums.

Note that the operation can also be done from the command line, by running the script update_quest.lua in the tools directory of the git repository. (Internally, the quest editor actually calls this script.)

The only changes in the data files are minor:

  • The id of tile patterns is now a string. This affects tilesets and maps. However, since integers are particular strings, this is actually not an incompatible change.
  • In maps, the subtype of switches is now a string.
  • In maps, switches have new properties sprite and sound.

Upgrading Lua scripts

The Lua scripting API of Solarus 1.3 introduces new functions, in particular on sprites and switches, but there is no incompatibility. Scripts that worked with Solarus 1.2 also work with Solarus 1.3. So you have nothing to do.

Get help

We can help you if you have any question or if you have problems to do the upgrade.

upgrade_from_1.2_to_1.3.txt · Last modified: 2018/12/22 14:14 (external edit)