PGE Engine: Installing preview Android version (2019)

From PGE Wiki
Jump to navigation Jump to search

It's the short manual how to install and prepare the experimental preview PGE Engine for Android made in the 2019'th year.

It's experimental!

Be sure, it's the same implementation of PGE Engine as for desktop which is WIP and incomplete yet. Means, it doesn't implement the complete functionality of SMBX Engine yet: a lot of in-game features will not work or will work buggy. Therefore almost all SMBX levels and episodes are unplayable.

Requirements

Minimal supported Android version is 4.1.

Download APK

At first, you need to visit the laboratory page and download PGE Engine's APK: http://wohlsoft.ru/docs/_laboratory/

Download config pack

Then, download any config pack you want: http://wohlsoft.ru/docs/_laboratory/config_packs/

Highly recommended to download "A2XT.zip" or "SMBX_13_compatible.zip". "Integration" config packs are totally useless for the mobile platform.

Download playable episode

For tests, you can use some SMBX episodes you have even they may become unplayable because of engine's incompleteness, or you can take the demo episode from here.

Prepare device

After installing of APK, you will need to create next directories in your "/sdcard/" location:

  • PGE Project
    • PGE Project/configs
    • PGE Project/worlds

Preparing game data

  • Unpack your config packs into the /sdcard/PGE Project/configs folder
  • Unpack your episodes into the /sdcard/PGE Project/worlds folder

Note for Android 6+

If you are using Android 6+, it's a temporary issue that wasn't fixed yet (need to implement the permission requester), and you will need to open your Settings, Applications, find "Moondust Engine" in your applications list, open "Permissions" and toggle on the access to the file storage. Without this permission, the game will not be able to see your episodes and config packs.

Trying to run a game

If everything is a success, you can simply start the "Moondust Engine" application and begin the game. Don't forget that the engine is experimental and incomplete, therefore any level or episode may become unplayable without hacks.

Troubleshooting

As it's the experimental preview, it may have even more some sudden bugs than it's well-known desktop variant. So, please, report to Wohlstand any bugs and troubles you will find by yourself.