This is an old revision of the document!
Pico-8
PICO-8 is a fantasy console created by Lexaloffle for playing tiny games inspired by the 8-bit consoles era. It has never been physically released, but runs as a software on computers like Windows / Mac / Linux and web browsers. Lexaloffle doesn't support all SBC, only the Raspberry Pi, and sells a commercial app for developing and running Pico-8 games and programs. If you like this piece of software, please support Lexaloffle and purchase it! It's well worth it.
Fantasy hardware constraints
- Display: 128×128 16 colors
- Cartridge: embedded as PNG images, max 32kB
- Sound: 4 channel chiptunes
- Code: Lua
- Sprites: 256 8×8 sprites
Batocera Linux doesn't embed the commercial program, but it can be added manually if purchased externally. Otherwise, the libretro/retro8 emulator can be used. It doesn't have 100% compatibility but runs most cartridges perfectly fine.
This system scrapes metadata for the “pico8” group(s) and loads the pico8 set from the currently selected theme, if available.
Quick reference
- Emulator: RetroArch
- Core: libretro/retro8
- Folder:
/userdata/roms/pico8 - Accepted ROM formats:
.p8,.png,.m3u
BIOS
No Pico-8 emulator included in Batocera requires BIOS to function.
ROMs
Place your Pico-8 ROMs in /userdata/roms/pico8.
"Cartridges" and games format
Pico-8 games are distributed as PNG images with the actual code, sprites and sounds embedded in them. Those are actual, real image files, that stands as the cartridge art too. You have to “load” the PNG to run the game. You can download hundreds of carts from the official page, the community is very active! Once you select a game, make sure you click on the “cart” link that downloads a .PNG file.
Support for official Pico-8 engine
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 the official Lexaloffle website
- Download the corresponding Linux (x86_64/64 bits) or Raspberry Pi binary (32bit ELF, not sure if our Rpi1/2/3 are still on 32bits systems, I could test only the PC x86_64 version at the moment and I put a message on their forum to ask for a ARM 64 bit build, like many others). Extract the files from the zip into the
/userdata/bios/pico-8/directory. The files in the archive are:lexaloffle-pico8.png license.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.dat pico8_dyn - Copy the following ES system addition into
/userdata/system/configs/emulationstation/es_systems_pico8.cfg:<?xml version="1.0" encoding="UTF-8"?> <systemList> <system> <name>pico8</name> <emulators> <emulator name="lexaloffle"> <cores> <core default="true">pico8_official</core> </cores> </emulator> <emulator name="libretro"> <cores> <core>retro8</core> </cores> </emulator> </emulators> </system> </systemList>
- Restart ES (or reboot). Then you can select LEXALOFFLE / PICO8 OFFICIAL as a core for Pico-8 games in ES.
- If you create a file
splore.p8orconsole.p8and 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 simpletouch /userdata/roms/pico8/splore.p8is sufficient to get access to splore).
Controls
Here are the default Pico-8's controls shown on a Batocera Retropad:
Keys inside the emulator: [START] or [HOTKEY] +
opens the Pico-8 menu.
Troubleshooting
Further troubleshooting
For further troubleshooting, refer to the generic support pages.
- systems/pico8.1637802179.txt.gz
- Last modified: 5 years ago
- by atari
