lorsanta / ps4-p8

PS4-P8

An emulator to run pico-8 cartridges on a PS4.

Project based on OpenOrbis PS4 Toolchain

Pico-8 is a Fantasy Programmable Console made by Lexaloffle Games. This emulator is compatible with built pico-8 cartridges in PNG format, to build your own games you will need the original Pico-8 console

Status

Not finished - Compatibility is still limited, but there are many cartridges it can run already.

Features

• Modified lua interpreter compatible with pico8's lua.
• 16-bit fixed point decimal arithemtic just like pico8.
• Save states (at the moment simplistic, one save state per cartridge).
• The most used predefined pico8 functions are implemented: 90 functions implemented out of 105

It comes with a set of bundled games which have been used to improve the compatibility.

More .p8.png cartridges can be bundled with the .pkg file by adding them into /assets/misc folder, or they will be loaded in runtime from PS4's /data/p8-cartridges folder.

• print: It prints text on the screen, but it's missing some P8SCII control codes, non-ascii characters.
• Sprites: Done
• Sfx: Playable. Room of improvement for sound quality, and sound filters are missing (damp, buzz, reverb, etc.)
• Music: Playable.
• Menu: WIP.
• Memory manipulation: Almost complete.
• Maps: Done
• Custom P8-Lua: Done

A list of some playable cartridges can be found here

Building

The project is cross-platform for Windows + MacOS + PS4.

You'll need OpenOrbis PS4 Toolchain installed with its dependencies (.NET Core) and clang++.

You'll need to add the external libraries in ${SolutionDir}/lib:

• lib/include/stb/stb_image.h: Grab this file from https://github.com/nothings/stb

Additionally, to run it on windows, you will need:

• lib/include/SDL2: SDL2 headers
• lib/include/dirent.h: Dirent port for windows, grab from https://github.com/tronkko/dirent
• lib/lib/SDL2.lib: SDL2 lib
• libcurl: Install via vcpkg

Windows

Run with visual studio. First build ${SolutionDir}/lua project, then ${SolutionDir}/pico8_ps4.

PS4

Run ./build.bat - First of ${SolutionDir}/lua project, then ${SolutionDir}/pico8_ps4.

License

External code used

Special thanks to:

• Bucanero - The code under http.cpp is based from code on apolo-ps4 GPL v3

External tools and dependencies used

• OpenOrbis PS4 Toolchain GPL v3
• Lua MIT
• Eris MIT
• libfixmath MIT
• plusequals powerpatch
• STB MIT
• EFLA
• dirent MIT
• SDL2 ZLib
• Pico-8 Font + Palette CC-0
• ConcurrentQueue

Bundled cartridges

• Mine Walker CC4-BY-NC-SA by voliva
• Celeste by noel+maddy
• To a Starling CC4-BY-NC-SA by Peteksi+Gruber
• Flip Knight CC4-BY-NC-SA by st33d
• Harold's Bad Day CC4-BY-NC-SA by biovoid
• PakPok CC4-BY-NC-SA by st33d
• Phoenix CC4-BY-NC-SA by pahammond
• Tiny golf puzzles by beepyeah

PS4-P8

MIT

Copyright 2021 Victor Oliva

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.