Skip to content

Migration guide

If your game is still using an old Solarus version, you may want to migrate to a new one. This page explains how to upgrade a Solarus quest to the latest Solarus version.

Solarus version numbers

Since Solarus 1.0.0, versions of Solarus are numbered as follows: x.y.z, where

  • x is the major version,
  • y is the minor version,
  • z is the patch version.

Patch versions contain only 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.*, where * is any patch version number.

To make your quest compatible with the latest version of Solarus, there are two steps:

  1. Upgrading data files: when your quest is obsolete, the editor shows a dialog that lets you automatically convert it to the latest version.
  2. Upgrading scripts: Lua scripts are programs, so there is no way to convert them automatically when something changes in the Solarus Lua API. The goal of this migration guide is to help you doing the upgrade.

Each migration has its specificities. Be sure to not miss anything.

Last update: December 10, 2022