The PICO-8 is a fantasy console with limited space for programs and data, programmed in a flavor of Lua with a very small standard library. This repository is meant to serve as a collection of useful functions and tables built, curated, and optimized by the pico8 developer community.
The focus of this repository is on game-agnostic code and functions. Most of the code you will find here is applicable to any type of game or game engine, and represents code you might generally expect to find in the lua standard library (string, table, math, etc) or in a more comprehensive console I/O library (drawing, memory access, etc).
What you will not find here is code related to gameplay implementation, such as actor and component frameworks, rendering engines, or game rule logic. I would like to add this sort of content in the future, but it will require significant additional organization and documentation efforts above and beyond those requires for the current contents of the repo.
strings- Manipulating and creating stringstables- Manipulating and creating tablesfunctions- Manipulating and creating functionsmath- Mathematical operations, mostly on numbersnumber- Non-mathematical maniuplation of numbersjson- JSON(ish) parsergraphics- Drawing and sprite manipulationphysics- Collision functions, etcmemory- Reading, writing, manipulating memory
snippets- inline snippets to mix with your own codeboilerplate- mostly empty pico8 cart with profiling and comments
Code is not minified for character count; that is a job for a minifier if desired or necessary. I try to aim for 3-5 character identifiers in moderate to complex functions, 1-3 characters in simple functions.
Functions and variables are local where possible, for performance reasons. Thanks to zep for giving it to us as a free token!
Some functions are provided in multiple variations, optimized for tokens, size, speed, and/or functionality. Every function should have at least a token-optimized version. Some functions have lines or blocks commented with variations.
-- inline[t,c] marks code that could be inlined to save t tokens and c characters, usually at the cost of cpu or memory.
-- remove[t,c] marks code that can be removed, usually at the cost of reduced functionality or code safety.
PRs are welcome! I am looking to collect a variety of best-of-breed examples of common library functions. Additional (or any) tests would also be helpful.
The best place to chat with other PICO-8 developers is on the PICO-8 Discord.