jelos.org/docs/systems/pico-8.md
2023-10-18 07:21:48 -04:00

3.5 KiB

Pico-8

Overview

Path(s) Supported Extensions
storage/roms/pico-8 ++".png"++ ++".p8"++

Emulator(s)

Name Documentation
Pico-8   default https://www.lexaloffle.com/pico-8.php
Fake-08 https://github.com/jtothebell/fake-08

Instructions

Option 1: Running Pico-8 through the native engine

Pico-8 games are best played with the default emulator as it supports all native features without any limitations. You need to purchase it from Lexaloffle and we do recommend that you buy a copy if you can. Its an awesome piece of software and it also comes with the tools to make your own games.

Setup

Once you have purchased a license; the files you need will depend on the deivce you are using. These instructions will walk through how to set things up to work on all of our supported devices.

  • Go to Lexaloffle's download page
  • From that page download the Linux 64-bit zip file and the Raspberry Pi zip file
  • From the Linux 64-bit zip file...
    • Create a directory in roms/pico-8 called x86_64
    • Upload the pico8_dyn and pico8.dat from the Linux 64-bit zip to this directory (you do not need any other files)
  • From the Raspberry Pi zip file...
    • Create a directory in roms/pico-8 called aarch64
    • Upload the pico8_dyn and pico8.dat from the Raspberry Pi to this directory (you do not need any other files)
/storage/roms/pico-8/
    ├─ x86_64/
    │   ├─ pico8_dyn
    │   ├─ pico8.dat
    ├─ aarch64/
    │   ├─ pico8_dyn
    │   ├─ pico8.dat
    ├─ Splore.png
    └─ (your Pico-8 game files)

Playing a game

Once the above is set up is you have 2 options for playing games through Pico-8's native engine:

  1. Using Splore
    • Splore is awesome as it allows you to browse and play the entire library of user creaed games with an internet connection.
    • To use this method simply launch Splore.png from the gamelist.
    • Note that you will need an internet connection to browse the pico-8 BBS (If you don't have an internet connection you can still use it to launch games you have downlaoded previously)
  2. Through .png or .p8 files added directly roms/pico-8
    • Browse the list of games (aka. "Carts") on Lexaloffle's website
    • Download the .png file for any game you are interested in playing and upload it to roms/pico-8
    • Refresh EmulationStation by pressing ++"START"++ to open the Main Menu then select Game Settings > Update Gamelists.
    • You should now be able to launch the game by selecting it from the gamelist.

Option 2: Running through RetroArch Fake-08

!!! warning "Fake-08 does not support all the native features of Pico-8 so its not guaranteed that every game will work with it."

  • Set the default emulator for Pico-8 to Fake-08
  • Browse the list of games (aka. "Carts") on Lexaloffle's website
  • Download the .png file for any game you are interested in playing and upload it to roms/pico-8
  • Refresh EmulationStation by pressing ++"START"++ to open the Main Menu then select Game Settings > Update Gamelists.
  • You should now be able to launch the game by selecting it from the gamelist.