Skip to content

# Upgrade Your Quest from Solarus 1.5 to Solarus 1.6

Solarus 1.6 brings a lot new features and customization abilities, including shaders and custom hero states. Luckily, there is no incompatibility, so the upgrade process from a 1.5 quest to 1.6 is very straightforward. However, some Lua API functions become deprecated in Solarus 1.6.

## Upgrading Data Files

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

## Upgrading Lua Scripts

The Lua scripting API of Solarus 1.6 introduces no incompabilities. You have nothing to do!

### Deprecated Functions

The following functions are now deprecated. You can still use them in Solarus 1.6, but they will show a warning. They might be removed in a future version.

- `sol.video.get_mode()`, `sol.video.set_mode()`, `sol.video.switch_mode()`, `sol.video.get_modes()`, `sol.video.is_mode_supported()` and are now deprecated, you can use shaders instead. Shaders are faster, more powerful and customizable, making built-in video modes obsolete. We provide shaders that perform the same effects as deprecated built-in video modes.
- `sol.video.reset_window_size()` is now deprecated, use `sol.video.set_window_size()` instead.

April 1, 2025