325 lines
15 KiB
HTML
325 lines
15 KiB
HTML
<h1 id="awesome-pico-8-awesome">Awesome PICO-8 <a
|
||
href="https://awesome.re"><img src="https://awesome.re/badge.svg"
|
||
alt="Awesome" /></a></h1>
|
||
<p><img src="https://www.lexaloffle.com/gfx/p8_jelpi.gif"
|
||
alt="PICO-8" /> <img src="https://www.lexaloffle.com/gfx/p8_tracker.gif"
|
||
alt="tools" /> <img src="https://www.lexaloffle.com/gfx/p8_cast.gif"
|
||
alt="code" /></p>
|
||
<p>A curated list of PICO-8 resources, tutorials, tools and more.
|
||
Inspired by the <a
|
||
href="https://github.com/sindresorhus/awesome">awesome</a> list thing.
|
||
You might also like <a
|
||
href="https://github.com/LewisJEllis/awesome-lua">awesome-lua</a> and <a
|
||
href="https://github.com/JanWerder/awesome-love2d">awesome-love2d</a>.</p>
|
||
<p>PICO-8 is a fantasy console for making, sharing and playing tiny
|
||
games and other computer programs. When you turn it on, the machine
|
||
greets you with a shell for typing in a subset of <a
|
||
href="https://www.lua.org/">Lua</a> commands and provides simple
|
||
built-in tools for creating your own cartridges.</p>
|
||
<h2 id="contents">Contents</h2>
|
||
<ul>
|
||
<li><a href="#community">Community</a></li>
|
||
<li><a href="#demoscene">Demoscene</a></li>
|
||
<li><a href="#resources">Resources</a></li>
|
||
<li><a href="#tutorials">Tutorials</a></li>
|
||
<li><a href="#tools">Tools</a></li>
|
||
<li><a href="#assets">Assets</a></li>
|
||
<li><a href="#text-editors-language-support">Text Editors Language
|
||
Support</a></li>
|
||
<li><a href="#hacks---undocumented-pico-8-features">Hacks</a></li>
|
||
<li><a href="#hardware">Hardware</a></li>
|
||
<li><a href="#articles--posts">Articles & Posts</a></li>
|
||
<li><a href="#talks">Talks</a></li>
|
||
<li><a href="#clones">Clones</a></li>
|
||
<li><a href="#i-want-to-contribute">Contributing</a></li>
|
||
<li><a href="#license">License</a></li>
|
||
</ul>
|
||
<h3 id="community">Community</h3>
|
||
<ul>
|
||
<li><a href="https://www.lexaloffle.com">Lexaloffle</a>
|
||
<ul>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?uid=1">Blog</a></li>
|
||
<li><a href="https://www.lexaloffle.com/pico-8.php">PICO-8</a></li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?cat=7">Forum/BBS</a></li>
|
||
<li><a href="https://twitter.com/lexaloffle">Twitter</a></li>
|
||
<li><a href="https://www.facebook.com/lexaloffle/">Facebook</a></li>
|
||
<li><a href="https://www.youtube.com/user/lexaloffletv">Youtube</a></li>
|
||
</ul></li>
|
||
<li><a href="https://www.reddit.com/r/pico8/">Subreddit</a></li>
|
||
<li><a href="https://twitter.com/hashtag/pico8">#pico8 on
|
||
Twitter</a></li>
|
||
<li><a
|
||
href="https://webchat.freenode.net/?randomnick=1&channels=#pico8&prompt=1">#pico8
|
||
on Freenode</a></li>
|
||
<li><a href="https://twitter.com/pico8console">Pico-8 Console
|
||
News</a></li>
|
||
<li><a href="https://pico-8.wikia.com/wiki/Pico-8_Wikia">Pico-8
|
||
Wiki</a></li>
|
||
<li><a href="https://slofile.com/slack/pico-8">Slack Team</a> - PICO-8
|
||
Slack chat.</li>
|
||
<li><a href="https://discord.gg/EwQ86eq">Discord Server</a> - PICO-8
|
||
Discord chat.</li>
|
||
</ul>
|
||
<h3 id="demoscene">DemoScene</h3>
|
||
<ul>
|
||
<li><a href="https://demozoo.org/platforms/81/">Pico-8 demos on
|
||
Demozoo</a></li>
|
||
<li><a
|
||
href="https://www.pouet.net/prodlist.php?platform%5B%5D=PICO-8">Pico-8
|
||
demos on Pouet</a></li>
|
||
<li><a
|
||
href="https://medium.com/swlh/creativity-through-limitation-pico-8-fantasy-console-175294e13332">Article
|
||
with demoscene effects code</a></li>
|
||
<li><a
|
||
href="https://www.youtube.com/results?search_query=pico+8+demoscene">Pico-8
|
||
demos on Youtube</a></li>
|
||
</ul>
|
||
<h3 id="resources">Resources</h3>
|
||
<ul>
|
||
<li><a href="https://www.lexaloffle.com/pico-8.php?page=manual">Official
|
||
Manual</a> - Placeholder dump of pico-8.txt! (Proper manual coming
|
||
soon).</li>
|
||
<li><a href="https://sectordub.itch.io/pico-8-fanzine-1">PicoZine
|
||
#1</a>, <a href="https://sectordub.itch.io/pico-8-fanzine-2">#2</a>, <a
|
||
href="https://sectordub.itch.io/pico-8-fanzine-3">#3</a> and <a
|
||
href="https://sectordub.itch.io/-pico-8-zine-4">#4</a> - PICO-8 Zine is
|
||
a 48-page fanzine made by and for PICO-8 users.</li>
|
||
<li><a
|
||
href="https://gist.github.com/josefnpat/bfe4aaa5bbb44f572cd0">Going from
|
||
Lua 5.2 to PICO-8’s Lua</a> - This document is here to help folks with a
|
||
proficiency in Lua understand the limitations and discrepencies between
|
||
Lua and PICO-8’s Lua.</li>
|
||
<li><a href="https://ztiromoritz.github.io/pico-8-spick/">Cheat Sheet
|
||
(printable)</a> - A reduced cheat sheet in a printable format. German
|
||
and English version available.</li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?tid=28207">Cheat Sheet
|
||
(wallpaper)</a> - An enhancement of the printable cheat sheet for use as
|
||
a desktop wallpaper.</li>
|
||
</ul>
|
||
<h3 id="tutorials">Tutorials</h3>
|
||
<ul>
|
||
<li><a
|
||
href="https://www.youtube.com/playlist?list=PLjZAika8vyZkyOjoCp0EbHeIFZ8MLlhvg">Music
|
||
Tracker Tutorial Series</a> - Making audio with PICO-8.</li>
|
||
<li><a href="https://youtu.be/ZuaLuMhwcc8">Tron Lightcycle game from
|
||
scratch</a> - A quick introduction to PICO-8 writing a game from
|
||
scratch.</li>
|
||
<li><a href="https://ztiromoritz.github.io/pico-8-shooter/">A PICO-8
|
||
Spaceshooter in 16 GIFs</a> - Screencaptures of writing a Spaceshooter
|
||
game step by step.</li>
|
||
<li><a href="https://github.com/seleb/PICO-8-Token-Optimizations">Token
|
||
optimization</a> - tips&tricks for saving tokens.</li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?tid=3726">Tweetjam, BBS
|
||
thread</a> - cards which code fits in a tweet (really useful to learn
|
||
some fun techniques).</li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?search=sample+code">Sample
|
||
code on the BBS</a> - the search is not 100% accurate, but some of those
|
||
cards features some nice tricks you can re-use in your future code.</li>
|
||
<li><a
|
||
href="https://github.com/Bigaston/pico-8-newgrounds-tutorial">Newgrounds
|
||
Medals Tutorial</a> - a little tutorial to add Newgrounds Medals to
|
||
PICO-8 games.</li>
|
||
<li><a
|
||
href="https://ultiman3rd.wordpress.com/2018/02/01/pico-8-binary-save-system/">Binary
|
||
save system</a> - Custom game save system that supports various data
|
||
types</li>
|
||
</ul>
|
||
<h3 id="tools">Tools</h3>
|
||
<ul>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?tid=51270">Sprite
|
||
Editor</a> - Keyboard only 8x8 pixel art tool.</li>
|
||
<li><a href="https://github.com/briacp/pico2png">pico2png</a> -
|
||
Spritesheet extraction written in perl.</li>
|
||
<li><a
|
||
href="https://www.reddit.com/r/pico8/comments/3jhmni/spritesheets_and_tools_for_the_pico8_palette/">Spritesheets
|
||
and tools for the PICO-8 Palette</a> - Compilation of works assest and
|
||
tools using the PICO-8 palette.</li>
|
||
<li><a href="https://github.com/josefnpat/pico8utils">Pico8Utils</a> -
|
||
Compilation of lua scripts based on the unix philosophy for working with
|
||
.p8 files.</li>
|
||
<li><a href="https://github.com/dansanderson/picotool">picotool</a> -
|
||
Tools and Python libraries for manipulating Pico-8 game files.</li>
|
||
<li><a href="https://github.com/franciscod/p8dl">p8dl - Carts Downloader
|
||
- Python</a> - Downloads cartridges into the correct folder (looks at
|
||
your config.txt).</li>
|
||
<li><a
|
||
href="https://github.com/kikookoubis/pico-8-carts-bash-downloader">Pico-8
|
||
Carts Downloader - Bash</a> - Downloads cartridge from the BBS (single
|
||
cart, whole index or dump your favourited entries) & rename them
|
||
according to their metadata.</li>
|
||
<li><a
|
||
href="https://github.com/benwiley4000/pico8-responsive-webplayer-transform">p8
|
||
responsive webplayer transform</a> - Python script that makes your HTML
|
||
export page responsive.</li>
|
||
<li><a href="https://www.romanzolotarev.com/pico-8-color-palette/">Color
|
||
Palette</a> - Hex and RGB colors codes for web.</li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?tid=3760">PICO-8 font</a> -
|
||
by <a
|
||
href="https://www.lexaloffle.com/bbs/?uid=11704">RhythmLynx</a>.</li>
|
||
<li><a href="https://github.com/jozanza/pico-test">pico-test</a> -
|
||
PICO-8 testing framework.</li>
|
||
<li><a href="https://github.com/clowerweb/Lib-Pico8">Lib-Pico8</a> - A
|
||
Pico-8 library of useful common functions.</li>
|
||
<li><a
|
||
href="https://github.com/adamscott/pico8-missing-builtins">pico8-missing-builtins</a>
|
||
- Provides Lua built-in functions to pico8.</li>
|
||
<li><a href="https://github.com/movAX13h/P8Coder">P8Coder</a> - A
|
||
programming tool that replaces the lua code in pico-8 cartridges (p8)
|
||
with the code you write in P8Coder.</li>
|
||
<li><a href="https://github.com/outkine/pico-kit">Pico-Kit</a> - An
|
||
opinionated collection of Pico-8 helpers that make it easier to get
|
||
going. Adds OOP, better debugging, and physics.</li>
|
||
<li><a href="https://github.com/torch2424/picoDeploy">picoDeploy</a> -
|
||
Deploy Pico-8 carts as standalone applications on desktop (Electron) and
|
||
mobile (Ionic).</li>
|
||
<li><a
|
||
href="https://github.com/TeamNoComplyGames/pico8Grunt">pico8Grunt</a> -
|
||
A build system for pico8 games, using gruntjs.</li>
|
||
<li><a href="https://github.com/JoebRogers/PICO-EC">PICO-EC</a> - A tiny
|
||
scene-entity-component library created for the PICO-8 fantasty
|
||
console.</li>
|
||
<li><a href="https://github.com/JoebRogers/PICO-Tween">PICO-Tween</a> -
|
||
A small library of tweening/easing functions for use in the PICO-8
|
||
fantasy console, inspired by Robert Penner’s easing functions.</li>
|
||
<li><a href="https://github.com/jozanza/p8">p8</a> - A dependency
|
||
manager and build tool. Lets you share code/sprites,
|
||
<code>require()</code> dependencies, and auto-reload carts on save.
|
||
Works with any external code editor and supports <a
|
||
href="https://moonscript.org/">MoonScript</a>.</li>
|
||
<li><a href="https://github.com/andmatand/midi-to-pico8">MIDI to
|
||
PICO-8</a> - A tool to convert MIDI files to PICO-8 music.</li>
|
||
<li><a href="https://github.com/gamax92/midi2pico">midi2pico</a> - A
|
||
MIDI to PICO-8 converter.</li>
|
||
<li><a href="https://bikibird.itch.io/denote">Denote</a> - Converts MIDI
|
||
files into SFX data– interactive and web based.</li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?tid=31000">Custom
|
||
template</a> - A simple and clean template, that fixes issues with
|
||
fullscreen, mouse and just looks nice.</li>
|
||
<li><a href="https://seansleblanc.itch.io/pico-8-fillp-tool">Fillp
|
||
Tool</a> - A simple helper tool for generating fillp patterns.</li>
|
||
<li><a href="https://bikibird.itch.io/depict">Depict</a> - Converts
|
||
image into a dithered image using PICO-8 colors and reduces it to a
|
||
maximum size of 128 x 128.</li>
|
||
<li><a href="https://johanpeitz.itch.io/picocad">picoCAD</a> - A PICO-8
|
||
program to build and texture lowpoly 3D models.</li>
|
||
<li><a href="https://github.com/tducasse/pico8-deploy">pico8-deploy</a>
|
||
- An easy way to export and deploy PICO-8 projects to itch.io</li>
|
||
<li><a href="https://github.com/Enerccio/yap8b">yap8b</a> - Build tool
|
||
for creating pico carts from multiple source files.</li>
|
||
<li><a
|
||
href="https://github.com/tmountain/pico-8-typescript">TS-PICO-8</a> -
|
||
Create PICO-8 games using TypeScript.</li>
|
||
<li><a href="https://github.com/thisismypassport/shrinko8">Shrinko8</a>
|
||
- A minifier that aggressively shrinks Pico-8 code size. Also includes a
|
||
linter and other tools.</li>
|
||
<li><a href="https://github.com/Siapran/parens-8">parens-8</a> - Bypass
|
||
the Lua token limit with a tiny lisp interpreter/compiler.</li>
|
||
</ul>
|
||
<h3 id="assets">Assets</h3>
|
||
<ul>
|
||
<li><a
|
||
href="https://www.lexaloffle.com/bbs/?cat=7#tag=midilib">midilib</a> -
|
||
Custom SFX instruments</li>
|
||
</ul>
|
||
<h3 id="text-editors-language-support">Text Editors Language
|
||
Support</h3>
|
||
<ul>
|
||
<li>Visual Studio Code: <a
|
||
href="https://github.com/japhib/pico8-ls">pico8-ls</a> - PICO-8 Language
|
||
Server, providing full language support for the PICO-8 dialect of
|
||
Lua.</li>
|
||
<li>Atom: <a
|
||
href="https://atom.io/packages/language-pico8">language-pico8</a></li>
|
||
<li>Sublime: <a href="https://packagecontrol.io/packages/PICO-8">Sublime
|
||
PICO-8</a> - PICO-8 plugin for the Sublime Text editor (color scheme,
|
||
font, build system, code completion, snippets…).</li>
|
||
<li>Vim: <a
|
||
href="https://github.com/justinj/vim-pico8-syntax">vim-pico8-syntax</a></li>
|
||
<li>Emacs: <a
|
||
href="https://github.com/Kaali/pico8-mode">pico8-mode</a></li>
|
||
</ul>
|
||
<h3 id="programming-fonts">Programming Fonts</h3>
|
||
<p>You might be interested to install <a
|
||
href="https://github.com/juanitogan/p8-programming-fonts">pico-8
|
||
programming fonts</a> they support the pico-8 custom characters as well
|
||
as various fonts (bitmap and regular anti-aliased fonts). Check the <a
|
||
href="https://www.lexaloffle.com/bbs/?tid=28975">BBS thread
|
||
here</a>.</p>
|
||
<p>How to install the font(s):</p>
|
||
<ul>
|
||
<li><strong>Linux:</strong> copy the files on ~/.fonts and
|
||
<code>sudo fc-cache -f -v</code></li>
|
||
<li><strong>Windows:</strong> copy the files on c:/windows/fonts/</li>
|
||
</ul>
|
||
<h3 id="hacks---undocumented-pico-8-features">Hacks - undocumented
|
||
PICO-8 features</h3>
|
||
<ul>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?tid=3549">Mouse</a> - How
|
||
to retrieve mouse coordinates (with demo).</li>
|
||
<li><a href="https://github.com/dppc/p8keyboard.js">p8keyboard.js</a> -
|
||
Javascript “keyboard adapter” for the Pico-8. Send ASCII characters to a
|
||
Pico-8 program running in a browser.</li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?tid=3561">SFX
|
||
Modifications</a> - Four effects that can only be applied by modifying
|
||
memory (with demo).</li>
|
||
<li><a href="https://www.lexaloffle.com/bbs/?pid=10719#p10719">Tracker
|
||
State/Audio Memory Locations</a> - How to access and modify audio data
|
||
as it is playing.</li>
|
||
</ul>
|
||
<h3 id="hardware">Hardware</h3>
|
||
<ul>
|
||
<li><a href="https://www.clockworkpi.com/">GameShell</a> - A modular
|
||
handheld game console that allows you to play & modify retro games
|
||
and DIY new devices. Check the <a
|
||
href="https://github.com/clockworkpi/GameShellDocs/wiki/Running-PICO-8-on-the-GameShell">GameShell
|
||
Docs</a> for how to run PICO-8 on the GameShell.</li>
|
||
<li><a href="https://shop.pocketchip.co/">PocketChip</a> - A handheld
|
||
designed for playing and coding anywhere. Officially supported by
|
||
pico-8. <a href="https://www.lexaloffle.com/bbs/?tid=34009">PoketChip
|
||
version of pico-8</a></li>
|
||
</ul>
|
||
<h3 id="articles-posts">Articles & Posts</h3>
|
||
<ul>
|
||
<li><a
|
||
href="https://www.indieretronews.com/2015/10/pico-8-8-bit-fantasy-console-from.html">Indie
|
||
Retro News</a> - A great introduction to PICO-8 by <a
|
||
href="https://twitter.com/ABrugsch"><span class="citation"
|
||
data-cites="ABrugsch">@ABrugsch</span></a>.</li>
|
||
</ul>
|
||
<h3 id="talks">Talks</h3>
|
||
<ul>
|
||
<li><a href="https://www.youtube.com/watch?v=AmMYWD2Zbso">Sharing the
|
||
love</a> - Making games with PICO-8. linux conf au 2017 - Hobart,
|
||
Australia</li>
|
||
</ul>
|
||
<h3 id="clones">Clones</h3>
|
||
<ul>
|
||
<li><a href="https://nesbox.itch.io/tic">TIC-80 by Nesbox</a> - Tiny
|
||
Computer, available on HTML 5, Windows, Linux 32/64bit, Android &
|
||
MacOSX</li>
|
||
<li><a href="https://github.com/picolove/picolove">PicoLove</a> - Pico-8
|
||
Reimplementation in LÖVE.</li>
|
||
<li><a href="https://github.com/RamiLego4Game/LIKO-12">LIKO-12</a> - An
|
||
open source fantasy computer made using LÖVE with 96kb RAM.</li>
|
||
<li><a href="https://github.com/PikuseruConsole/pikuseru">Pikuseru</a> -
|
||
Open Source Fantasy Console in pure Rust [Core].</li>
|
||
<li><a href="https://0xcafed00d.itch.io/tac08-rg350">tac08</a> - tac08
|
||
is an emulation of the runtime part of the Pico-8 fantasy console,
|
||
running on RG350 handheld game console.</li>
|
||
<li><a href="https://lowresnx.inutilis.com/">LowRes NX</a> - Fantasy
|
||
Console available on IOS, MacOS, Windows, Linux, and GameShell (BASIC
|
||
code support)</li>
|
||
</ul>
|
||
<h3 id="i-want-to-contribute">I Want to Contribute!</h3>
|
||
<p>Great! :smiley:</p>
|
||
<p>Please, read the <a href="CONTRIBUTING.md">contribution
|
||
guidelines</a> first.</p>
|
||
<h3 id="license">License</h3>
|
||
<p><a href="https://creativecommons.org/publicdomain/zero/1.0/"><img
|
||
src="https://i.creativecommons.org/p/zero/1.0/88x31.png"
|
||
alt="CC0" /></a></p>
|
||
<p>To the extent possible under law, <a
|
||
href="https://twitter.com/felipebueno">Felipe Bueno</a> has waived all
|
||
copyright and related or neighboring rights to this work.</p>
|
||
<p>See <a href="LICENSE">LICENSE</a> for more information.</p>
|