Solarus Wiki

A wiki for the Solarus engine community

User Tools

Site Tools


Upgrade your quest from Solarus 1.3 to Solarus 1.4

Solarus 1.4 provides a brand new quest editor that was rewritten from scratch. There are almost no new features in the engine itself. The only change is that fonts are now a resource. This means they now appear in the tree of the quest editor, so they are now much easier to manage. But right now, this may require manual adjustement to your scripts.

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 what is new.

Upgrading data files

Data files other than scripts can be upgraded automatically with the editor. Open your quest with Solarus Quest Editor 1.4 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 resources/quest_converter directory of the git repository of Solarus Quest Editor. (Internally, the quest editor actually calls this script.)

For information, the changes in data files are:

  • The font list file text/fonts.dat no longer exists. Fonts are now listed as a resource (like maps, tilesets, musics, etc.) and there is no explicit default font anymore.
  • Fonts files are now in a fonts folder instead of text.
  • Shop treasures now have a font property.

Upgrading Lua scripts

The Lua scripting API of Solarus 1.3 introduces an incompatibility due to the new way fonts are handled. We explain below how to adjust your scripts to this change.


When you create a text surface, with sol.text_surface.create(), the font file and the font size are now set separately. Before, there was a font id that referred to both a font file and a size. Now, the font id is the name of a font file with extension. This is more consistent with all other resources: sounds, musics, maps, etc. If you don't set the font, it will be by default the first one in alphabetical order. If you don't set the font size, the default value is 11.

  • If your existing code calls sol.text_surface.create() or text_surface:set_font() with a font id that does not correspond to a font file without extension, then you need to fix this font id. For example, if you had like me a font called fixed referring to the font file minecraftia.ttf, the new font id to use is minecraftia.
  • If your existing code calls sol.text_surface.create() without setting an explicit font (therefore relying on the default font of fonts.dat), then you should set the font to use, because otherwise the default font would now be the first one in alphabetical order. You can do this in the table parameter of sol.text_surface.create() (the font field) or with text_surface:set_font().
  • If your existing code used any font with a size different from 11, you have to set that size whenever you use this font. You can do this in the table parameter of sol.text_surface.create() (the size field) or with text_surface:set_font_size().

Get help

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

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