Please do not post a support request without first reading and following the advice in

Updated Solarus Engine

  • Hello,
    I've modified the script to install the updated 1.5.3 version of the Solarus engine. I've also added the updated versions of the games that came with the original script, and the Book of Mudora game that couldn't be played with the 1.4.5 version of the engine.

    #!/usr/bin/env bash
    # This file is part of The RetroPie Project
    # The RetroPie Project is the legal property of its developers, whose names are
    # too numerous to list here. Please refer to the file distributed with this source.
    # See the file at the top-level directory of this distribution and
    # at
    rp_module_desc="solarus - An Open Source Zelda LttP Engine"
    rp_module_flags="noinstclean !aarch64"
    function depends_solarus() {
        getDepends cmake libsdl2-dev libsdl2-image-dev libsdl2-ttf-dev libluajit-5.1-dev libphysfs-dev libopenal-dev libmodplug-dev libvorbis-dev zip unzip qttools5-dev-tools qtbase5-dev
    function sources_solarus() {
        downloadAndExtract "" "$md_build" --strip-components 1
        downloadAndExtract "" "$md_build"
        downloadAndExtract "" "$md_build"
        downloadAndExtract "" "$md_build"
    function build_solarus() {
        mkdir build
        cd build
        cmake .. -DCMAKE_INSTALL_PREFIX="$md_inst"
        cd ../zsdx-1.11.0
        cmake . -DCMAKE_INSTALL_PREFIX="$md_inst"
        cd ../zsxd-1.11.0
        cmake . -DCMAKE_INSTALL_PREFIX="$md_inst"
        cd ../zelda-roth-se-1.1.0
        cmake . -DCMAKE_INSTALL_PREFIX="$md_inst"
        cd ..
        git clone --recursive
        cd zbom
        cmake . -DCMAKE_INSTALL_PREFIX="$md_inst"
    function install_solarus() {
        cd build
        make install
        cd ../zsdx-1.11.0/
        make install
        cd ../zsxd-1.11.0/
        make install
        cd ../zelda-roth-se-1.1.0/
        make install
        cd ../zbom/
        make install
    function configure_solarus() {
        addPort "$md_id" "zsdx" "Solarus Engine - Zelda Mystery of Solarus DX" "LD_LIBRARY_PATH=$md_inst/lib $md_inst/bin/solarus-run $md_inst/share/solarus/zsdx/"
        addPort "$md_id" "zsxd" "Solarus Engine - Zelda Mystery of Solarus XD" "LD_LIBRARY_PATH=$md_inst/lib $md_inst/bin/solarus-run $md_inst/share/solarus/zsxd/"
        addPort "$md_id" "zelda_roth_se" "Solarus Engine - Zelda Return of the Hylian SE" "LD_LIBRARY_PATH=$md_inst/lib $md_inst/bin/solarus-run $md_inst/share/solarus/zelda_roth_se/"
        addPort "$md_id" "zbom" "Solarus Engine - Zelda Book of Mudora" "LD_LIBRARY_PATH=$md_inst/lib $md_inst/bin/solarus-run $md_inst/share/solarus/zbom/"
        # symlink the library so it can be found on all platforms
        ln -sf "$md_inst"/lib/*/ "$md_inst/lib"
        ln -sf "$md_inst"/lib/*/ "$md_inst/lib"
        moveConfigDir "$home/.solarus" "$md_conf_root/solarus"
        chown -R $user:$user "$md_inst"/share/solarus/*/data.solarus

    You can replace this script with the standard one located in /home/pi/RetroPie-Setup/scriptmodules/ports and use it with Of course, to update the engine and install the new versions of the games you have to select the "update from source" option.

  • It appears the site no longer uses .tar.gz for its packages, so this script is out of date. Any chance you will be updating it with 1.6.0 and the new locations?

  • @Mootikins I've been working on this nowadays, however recently I got a bit busy so haven't been able to finish. Hopefully is done this weekend.

    See a post I made describing it a bit:

  • @hhromic I'm back home so I can work on it. Should I update my script or just wait for yours?

  • @saccublenda I'm working on the scriptmodule in current RetroPie. I'm more than updating it because I'm also changing how it behaves. So I would wait for mine. I currently have relatives visiting so I've been having a hard time finding spare time :( But they are leaving soon.

    In particular the important changes I'm implementing are:

    • Solarus now uses single .solarus files for the quests in addition to folders, therefore we can use Solarus as a system with its own rom directory that runs these files directly from EmulationStation.
    • For the above, the Solarus team designer already created art assets for two included EmulationStation themes: Carbon and Simple.
    • The scriptmodule will offer a simple menu to install these assets until (and if) we merge them into the official theme repositories.
    • Because of the above, the scriptmodule will no longer install quests but the user is responsible for downloading them from the Website and place them in the new solarus rom folder. This is a very easy and legal operation anyway. Also, this is easier to maintain and more importantly, does not force RetroPie to install copyrighted material from the scriptmodule.
    • Solarus 1.6 now supports GLES accelerated rendering on RPI, the scriptmodule properly configures the source build to take advantage for this.
    • Also the scriptmodule generates a helper launcher script to automatically set fullscreen and disable the mouse cursor.
    • Also an option to set a joypad buttons combo to quit the engine at any moment will be available (similar to HOTKEY+START in RetroArch)

    The branch in my fork where I'm working on this is here (not fully updated as of this writing):

    Once I have the fully completed new scriptmodule I will open a forum thread with instructions to test it and provide feedback before submitting to RetroPie.

    Thanks for your patience guys!

  • @hhromic Great news, looking forward to see your script.

  • @hhromic any more news on this? Eagerly anticipating your finished work!

  • @PiDad The updated installer by @hhromic is available through the retropie_setup script:

  • @saccublenda @hhromic installed, and working like a dream. My son's own quests working perfectly. Amazing

  • @PiDad sorry I'm too late, but glad @saccublenda updated you already!

    I'm also glad that it's working fine for you!
    If your son is making Solarus Quests, I strongly recommend him to join the Solarus Discord server. The people there is very knowledgeable about game design and Solarus quests in general. I'm sure he will have fun discussing his game there.

    Simply go to the Solarus website and on the top select "Community" -> "Discord Chat". Good Luck!

  • @hhromic thank you, I will tell him. He is currently trying to make an "earthbound" theme resource pack for solarus, then wants to do 2 player co-op. Hopefully someone on Discord can help him out!

Contributions to the project are always appreciated, so if you would like to support us with a donation you can do so here.

Hosting provided by Mythic-Beasts. See the Hosting Information page for more information.