PX8

PX8 is an open source fantasy console (128x128 pixels) in Rust, where the cartridge code could be in Python or Lua.

It is still in development but the main features are:

• 128x128 pixels, 16 colours
• Python 3 / Lua 5.X support for the cartridge
• Controls with dpad + 2 buttons (gamecontroller/joystick support)
• No limit size in the code !
• Unlimited sprites (8x8)
• Map support (128x32)
• Edition of the cartridge data
• PX8 format to use your favorite code editor
• Screenshot (PNG) / Video recording (GIF)
• Pico-8 (P8/P8.PNG) cartridge format support
• Mainly run @60 FPS

It should work on all platform (Linux/OSX/Windows), and on tiny hardware like Raspberry Pi (with opengl enabled).

The console is inspired from Pico-8, so you can play Pico-8 cartridges (P8/P8.PNG).

• Youtube Video

[] (https://youtu.be/b-secxed-fk "PX8 SKI")

• Recorded GIF

The time for each frame is slow (10ms) in the GIF, and doesn't correspond to the speed of the game (see the previous videos on Youtube).

• PX8
  • Download
    • Binaries
  • Requirements
  • Build
  • Run a cartridge
  • Edit a cartridge
  • Keyboard Shortcut
  • Create a new cartridge
    • Python
    • Lua
  • Cartridge format
  • API documentation
  • PX8 Format documentation
  • Compatible API with Pico-8
    • Audio
    • Cart Data
    • Graphics
    • Input
    • Map
    • Math
    • Memory
    • Peek/Poke
  • Pico-8 compatibility
  • Screenshots and Records

Download

You can get directly the latest version via git:

git clone https://github.com/Gigoteur/PX8.git
cd PX8

Binaries

Or you can get binaries for multiples platforms directly on itch.io:

• Raspberry Pi (available)
• Windows (Work in progress)
• Linux (Work in progress)
• Mac (Work in progress)

Requirements

You will need multiple things:

• SDL2
• python3
• libreadline

Linux

Packages:

• libsdl2-dev
• libreadline-dev
• libpython3-dev

Raspberry Pi

Please enable the GL Driver (7 - Advanced Options -> Ac - GL Driver -> Yes) via:

sudo raspi-config

OSX

Build

You could build PX8 with cargo directly, in release mode for example, with the support of Python and Lua.

cargo build --features="cpython lua" --release 

Run a cartridge

You should be able to run it directly by providing the path of the cartridge:

./target/release/px8 -s 4 ./games/ski/ski.px8

The '-s' option is the scale, so you can increase it, or in fullscreen by using '-f' option.

Edit a cartridge

You can edit the cartridge by using the specific '-e' option:

./target/release/px8 -s 4 -e ./games/ski/ski.px8

Keyboard Shortcut

Player 1:

• cursors, Z,X / C,V / N,M

Player 2:

• ESDF, LSHIFT,A / TAB,Q,E

System shortcut:

• F2: FPS debug
• F3: Take a screenshot
• F4: Take a video
• F5: Save the current cartridge
• F6: Switch between editor/play mode

Game controller / Joystick

Change shortcuts

Add player

Create a new cartridge

PX8 could call 3 functions:

• _init : Called once on cartridge startup, mainly to initialize your variables
• _update: Called once per visible frame, mainly to get keyboard input for example
• _draw: Called once per visible frame, mainly to draw things on the screen :)

Python

def _init():
  print("INIT")
  
def _update():
  px8_print("UPDATE")
  
def _draw():
  px8_print("DRAW")

Lua

Cartridge format

Format	Read	Write
P8	✅	✅
P8.PNG	✅	🔴
PX8	✅	✅

API documentation

See API

PX8 Format documentation

Compatible API with Pico-8

Audio

API	Python	Lua
sfx	🔴	🔴
music	🔴	🔴

Cart Data

API	Python	Lua
cartdata	🔴	🔴
dget	🔴	🔴
dset	🔴	🔴

Graphics

API	Python	Lua
camera	✅	✅
circ	✅	✅
circfill	✅	✅
clip	🔴	🔴
cls	✅	✅
color	✅	✅
cursor	🔴	🔴
fget	🔴	🔴
flip	🔴	🔴
fset	🔴	🔴
line	✅	✅
print	✅ (px8_print)	✅
pal	✅	✅
palt	✅	✅
pget	✅	✅
print	✅	✅
pset	✅	✅
rect	✅	✅
rectfill	✅	✅
sget	✅	✅
spr	✅	✅
sspr	✅	✅

Input

API	Python	Lua
btn	✅	✅
btnp	✅	✅

Map

API	Python	Lua
map	✅ (spr_map)	✅
mget	🔴	✅
mset	🔴	✅

Math

API	Python	Lua
rnd	✅ (random.randint)	✅
flr	✅ (math.floor)	✅
ceil	✅ (math.ceil)	✅
cos	✅	✅
sin	✅	✅
atan2	🔴	✅
sqrt	✅ (math.sqrt)	✅
abs	✅ (math.abs)	✅
sgn	✅	✅
band	✅	✅
bor	✅	✅
bxor	✅	✅
bnot	✅	✅
shl	✅	✅
shr	✅	✅
sub	✅	✅

Memory

API	Python	Lua
cstore	🔴	🔴
memcpy	🔴	🔴
memset	🔴	🔴
reload	🔴	🔴

Peek Poke

API	Python	Lua
stat	🔴	✅
peek	🔴	🔴
poke	🔴	🔴

Specific Lua functions

API	Lua
add	✅
del	✅
min	✅
max	✅
mid	✅
foreach	✅
count	✅
all	✅

Pico-8 compatibility

The version of LUA in Pico-8 has some differences with the original one.

Lua features	Compatibility
Compound assignment operators	✅
Single line shorthand for if then else operator	🔴
Not Equal To	🔴

GFX: ✅

MUSIC: 🔴

Screenshots and Records

With a physical engine

PX8 + Python + Pymunk