| Both sides previous revision Previous revision | |
| systems:pico8 [2022/01/19 04:06] – [Support for official Pico-8 engine] added note about how to edit pico-8 atari | systems:pico8 [2023/01/27 03:46] (current) – [Support for official Pico-8 engine] make instructions clearer atari |
|---|
| Starting with Batocera **v32**, you can add the official commercial Lexaloffle Pico-8 engine to run all Pico-8 games and explore the Splore universe! In order to do so, you need to do a few manual steps: | Starting with Batocera **v32**, you can add the official commercial Lexaloffle Pico-8 engine to run all Pico-8 games and explore the Splore universe! In order to do so, you need to do a few manual steps: |
| |
| * Buy it from [[https://www.lexaloffle.com/games.php?page=updates|the official Lexaloffle website]] | - Buy it from [[https://www.lexaloffle.com/games.php?page=updates|the official Lexaloffle website]]. |
| * Download the corresponding Linux (x86_64/64 bits) for PC, or the Raspberry Pi .zip file. The Raspberry Pi version will work for **all Batocera SBC** (i.e. Odroid N2, Odroid Go Advance/Super, RockPro64 and so on). With version 0.2.4, Lexaloffle started to ship a 64-bit compiled version. | - Download the corresponding binary (it's the ZIP file) appropriate to your platform: |
| * Extract the files from the zip into the ''/userdata/bios/pico-8/'' directory on your Batocera machine. | * **For PC/any x86_64 board:** The Linux (x86_64/64 bits) ZIP file. |
| * For PC x86_64, the files in the archive are:<code> | * **For any ARM-based board, such as RPi, Odroid N2/Go/Super, RockPro64, RK3326, etc.:** the Raspberry Pi ZIP file. |
| | - Extract the files from the zip into the ''/userdata/bios/pico-8/'' directory on your Batocera machine. |
| | * **For PC x86_64**, the files in the archive are:<code> |
| lexaloffle-pico8.png | lexaloffle-pico8.png |
| license.txt | license.txt |
| pico-8.txt | pico-8.txt |
| pico8 (make sure this one is executable via "chmod +x", I assume nobody uses a filesystem for /userdata/ that would be incompatible with this...) | pico8 (make sure this one is executable via "chmod +x", the filesystem itself must support the executable bit) |
| pico8.dat | pico8.dat |
| pico8_dyn | pico8_dyn |
| </code> | </code> |
| * For ARM SBC and handhelds (Raspberry Pi, Odroid, RockPro...), the files are:<code> | * For ARM SBC and handhelds (Raspberry Pi, Odroid, RockPro...), the files are:<code> |
| lexaloffle-pico8.png | lexaloffle-pico8.png |
| license.txt | license.txt |
| pico-8_manual.txt | pico-8_manual.txt |
| pico8 (make sure this one is executable via "chmod +x") | pico8 (make sure this one is executable via "chmod +x", the filesystem itself must support the executable bit) |
| pico8.dat | pico8.dat |
| pico8_64 | pico8_64 (make sure this one is executable via "chmod +x", the filesystem itself must support the executable bit) |
| pico8_dyn | pico8_dyn |
| pico8_gpio | pico8_gpio |
| readme_raspi.txt | readme_raspi.txt |
| </code> | </code> <WRAP center round important> |
| * There is an **additional step** for ARM64-based boards (i.e. all SBC except Raspberry Pi0/1/2, which are still with a 32-bit Batocera). You need to delete the original ''pico8'' file (this one is the 32-bit version), and rename ''pico8_64'' as ''pico8'' and make sure it is executable with ''chmod +x pico8''. | **For ARM64-based boards**, by default the 32-bit executable is named ''pico8''. 64-bit users will want to delete the 32-bit executable and rename ''pico8_64'' as ''pico8''. Make sure it's marked as executable with ''chmod +x pico8''. |
| * Copy the following ES system addition into ''/userdata/system/configs/emulationstation/es_systems_pico8.cfg'':<code xml> | </WRAP> |
| | - Copy the following ES system addition into ''/userdata/system/configs/emulationstation/es_systems_pico8.cfg'':<code xml> |
| <?xml version="1.0" encoding="UTF-8"?> | <?xml version="1.0" encoding="UTF-8"?> |
| <systemList> | <systemList> |
| </systemList> | </systemList> |
| </code> | </code> |
| * Restart ES (or reboot). Then you can select **LEXALOFFLE / PICO8 OFFICIAL** as a core for Pico-8 games in ES. | - Restart ES (or reboot). While in the pico8 gamelist, press ''[SELECT]'', go to **ADVANCED SYSTEM OPTIONS** -> **EMULATOR** and then select "LEXALOFFLE: PICO8 OFFICIAL". |
| * If you create a file ''splore.p8'' or ''console.p8'' and launch it from Batocera-ES, you'll get access to Pico-8 splore universe with all the games to play and download from inside Pico-8 (a simple ''touch /userdata/roms/pico8/splore.p8'' is sufficient to get access to splore). | |
| |
| <WRAP center round tip> | <WRAP center round tip> |
| | If you create a file ''splore.p8'' or ''console.p8'' and launch it from Batocera-ES, you'll get access to Pico-8 splore universe with all the games to play and download from inside Pico-8 (a simple ''touch /userdata/roms/pico8/splore.p8'' is sufficient to get access to splore). |
| | |
| Press ''[START]'' to open Pico 8's menu, which can be used to exit the emulator and return to Batocera. | Press ''[START]'' to open Pico 8's menu, which can be used to exit the emulator and return to Batocera. |
| </WRAP> | </WRAP> |
| |
| |
| ===== Controls ===== | ===== Controls ===== |