picolove/README.md

PICOLOVE

A fork of the original PICOLOVE, an implementation of PICO-8's API in LÖVE
Original is on github at: https://github.com/picolove/picolove
Requires LÖVE 11.x

PICO-8: http://www.lexaloffle.com/pico-8.php
LÖVE: https://love2d.org/

What it is:

• An implementation of PICO-8's api in LÖVE

Why:

• For a fun challenge!
• Allow standalone publishing of PICO-8 games on other platforms
• Should work on mobile devices *
• Configurable controls
• Extendable
• No arbitrary cpu or memory limitations
• No arbitrary code size limitations
• Better debugging tools available
• Open source

What it isn't:

• A replacement for PICO-8
• A perfect replica
• No dev tools, no image editor, map editor, sfx editor, music editor
• No modifying or saving carts
• Not memory compatible with PICO-8

Differences:

• Uses floating point numbers not fixed point
• Uses LuaJIT not lua 5.2
• Memory layout is not complete

Extra features:

• ipairs(), pairs() standard lua functions
• assert(expr,message) if expr is not true then errors with message
• error(message) bluescreens with an error message
• warning(message) prints warning and stacktrace to console
• setfps(fps) changes the consoles framerate
• _keyup, _keydown, _textinput allow using direct keyboard input

Android Packaging:

Replace nocart.p8 with your game, since this is the default cartridge on boot. Text P8 or PNG P8.PNG is supported.
Follow the steps at Android Game Packaging
An additional step when editing AndroidManifest.xml is to remove android:screenOrientation="landscape" if you would like your game to support orientation rotation (Portrait and Landscape)