Log In  
[back to top]

A couple of devs are investing into multicart games (like 5 or more data carts).
We are all put back by the artificial loading times (eg minutes)

Would it be possible for the fat client to either ignore load time throttling, or only activat throttling for the published version?
I want the multicart multiverse, not loading screens ;)

P#66040 2019-07-23 06:44 ( Edited 2019-07-23 06:46)

Using the cough undocumented cough stat(102) from a game hosted on itch.io, I got back:


This is indeed the url of the iframe (which doesn't help).
A more correct behavior would be to report the parent page url, with the benefits of:

  • having a predictable outcome
  • actually preventing rogue hosting (somehow...)

Note: Looking at the HTML, I see that url is retrieved from:

var str = window.location.hostname;

Using that alternate code would fix the bug:

var str = (parent !== window) ? document.referrer : document.location;
P#65996 2019-07-21 08:37

Ce post est la version française de: PICO-8 Giveaway

Initié par @Liquidream, plusieurs developpeurs offrent des licences pico8 à des jeunes (et moins jeunes) qui n'auraient pas les moyens mais pleins d'idées!


Pour avoir une chance de gagner, repondez à la discussion officielle avec un petit message:

  • pourquoi vous voulez une licence?
  • quel jeu(x) comptez-vous créer?

Les Règles

  • Ouvert à tous (sauf ceux qui peuvent se payer une licence ET un sandwich!)
  • Une seule entrée par personne
  • Date de cloture (ouch!) Samedi 6 Juillet @ 11:00 (heure Paris)
  • Les gagnants seront choisis au hasard
  • Il y aura autant de gagnants que de licences offertes
  • La licence sera attribuées via un compte mail (message privé)

Bonne chance 😁🤞

P#65558 2019-07-04 19:16 ( Edited 2019-07-05 06:12)

Ghost Rally

Cart #grally-0 | 2019-06-02 | Code ▽ | Embed ▽ | License: CC4-BY-NC-SA


The game is a race-against-yourself rally game. It features accurate rigid body physics and car handling.
Goal is to beat yourself every lap!

Enjoy racing as in the 80's, whith over powered cars very close to the public!
tip hitting any of the lil' dudes:
incurs a +5s time penalty :]

warning the game is complete yet the car handling is really picky - I am releasing it as is, as I can't tweak the gameplay without breaking the physic engine :/


  • left/right: turn
  • up/down: accelerate/brake
  • c: recover (when flipping over!)

Dev Log

Source code & tools: ghost-rally


Sound effect code: taken from @tiagosr rally game
Trifill: @p01

Physic Engine

Physic engine was started from scratch following Barraf's 'classic' paper.
I quickly dropped this version as it relied too much on numeric convergence !

The current version uses part of Randy Gaul C++ physic library and underlying principles.
The key aspect to get stable collision is to resolve impacts only for the incident face, e.g. the plane most facing the ground:

This is obviously an heavily simplified version, limited to dynamic-to-static resolution.
Randy's engine architecture relies on very few magic constants and is extremely stable (well, as long as pico numbers don't get in the way!!).

The physic engine is designed as an extension a generic 3d actor class and can easily be taken out for other games.

Car Physic

The car is modeled using a front and rear tire. Each tire has lateral and longitudinal forces, as detailed in this article: The Racing Line - Combined Tyre Forces.
Other good readings:
Car Physics for Games
Box2d Top Down Racing Game

The gif above shows forces applied to the car and their application point:

  • G force (down)
  • read tyre pushing car (with a lateral component to counter slide)
  • front tyre and turning forces (again with a lateral component)

Slip angle and slip ratio curves are defined using SFX 4 and 5 - tweak them to see effect in game!


The game started as a terrain renderer using marching squares.
Terrain height map is 64x64, displayed as a 128x128 grid to display marching square "diamond tiles":

Textured Car

The car is textured mapped, using a custom version of @p01 trifill.
The Blender model directly references an export of the cart spritesheet.


The game uses my usual Blender/Python export toolchain.
A custom terrain editor is available as a pico-8 cart (contact me if needed)

P#64950 2019-06-02 14:33 ( Edited 2019-06-04 20:11)

I am writing data to a p8 file from a Python program - format for 0x0-0x3200 ROM range is ok.
Issue is sfx section - each sfx (68 bytes) is actually written as 84 bytes (??) with empty bits left and right.
I have no clue what is the masking/bitshifting/... logic between my input value and the resulting p8 string.






P#64268 2019-05-09 18:44 ( Edited 2019-05-09 18:49)

Case solved: issue was triggered by one of my USB sticks constantly sending inputs

When exporting Tiny Sim, some keys are stuck:

P#64164 2019-05-03 14:25 ( Edited 2019-05-04 09:17)

Cart #numakunawa-0 | 2019-04-08 | Code ▽ | Embed ▽ | No License

FPS demo cart as an answer to @MBoffin April 1st Twitter joke.
Stay tuned for technical details.

P#63343 2019-04-08 21:27

Cart #doyusuyepo-0 | 2019-05-04 | Code ▽ | Embed ▽ | No License

Project started following a question on 3d clipping on this forum and quickly spiraled into a full blown 3d renderer with support for real-time shadows and camera space clipping :/

Shadows are calculated in real-time by extruding a shadow volume from each lit face.
Resulting polygons are added to the face and rendered/sorted with the face.

The shadows are globals e.g. self-shadowing is supported, see torus scene.

Performance-wise this is bordering what pico can support, as many clipping operations are required to generate shadow polygons. There is room for optimization (vertex cache, smart selection of clipping planes) left to the reader!


Project (including how to add custom 3d models) is available here: github


  • 3d papers from the 70s/80s are pure gold!
  • trifill function from @p01

Update 1.1

  • fixed polygon gaps (using correct middle screen position + ceil)
P#60772 2019-01-12 14:38 ( Edited 2019-05-04 12:54)

How to reproduce:

  • go to a game page
  • launch game
  • go to comment section
  • type some text

Bug: nothing appears (input is captured by pico)

Workaround: refresh the page / don't launch game before posting comments.

P#59908 2018-12-11 21:38 ( Edited 2018-12-11 21:38)

Since forum updates, new gif uploads are rendered as broken links.
See: https://www.lexaloffle.com/bbs/?pid=59400#p

P#59537 2018-12-01 15:11

Be a X-Wing pilot!

Take a seat in the most advanced fighter of the galaxy. Fight against the evil empire!
Use proton torpedo to quickly dismiss enemy forces or your 4 blasters (aiming skill required).
Go through 4 epic missions, from space to Deathstar and back.

Flight Manual

Copyright Notice

Starwars logo/music/... credits to their respective owners. Don't sue me :/

Dev Log

This is a demake of the X68000 Attack of the Deathstar game, (kind of) complete with space/ground/trench missions.
This version departs from the original with a less arcade/grinding gameplay.

The un-minified version can be found (as usual) on my Github page (includes all 3d assets).

Tie Fighters

All flying NPCs are following boids behavior (seek, avoid, follow) and are really a blast to watch in pack (imho)!
Baddies will try to get on your six to fry good old r2d2 :/

Proton Torpedo

Proton flight path is following Proportional Navigation rules. Gives a nice interception path (and the math is cool :)

3d Engine

Engine is a edge renderer (wireframe only as you certainly noticed!). It supports faces with an arbitrary number of edges to reduce visual cluter and achieve good performance.

Face culling is using object-space culling, the normal.point constant is pre-calculated when model is loaded.

Quaternions functions ported from ThreeJS.

3d Sound

(sort of...) Sound volume is changed at runtime according to sound emitter location, using the PICO-8 "feature" that sfx can be modified without impacting currently playing sound.
Note: sfx 63 is reserved for that use.

Software Pipeline

3d assets are modeled in Blender, exported in sprite/map format using a Python exporter .

Models are unpacked from spritesheet/map memory at startup and made available in a global table.

All game data are expressed as JSON strings, supporting references to global functions. Ex:

local player=json_parse('{"x":0,"y":0,"update":"update_player"}')
-- works!

Mini json parser from Tyler Neylon: lua JSON parser

Code is minified using picotool.
Music lifted from "public" MIDI files, simplified and converted with midi2pico.



  • Initial public version
  • Bug: not able to restart after gameover (will be fixed soon)


  • change: redone control scheme (flat turn, optional roll)
  • change: removed boost
  • change: laser auto lock
  • change: difficulty curve
  • fixed: NPC flight AI
  • fixed: torpedo aiming


  • added: menu to switch view
  • changed: turret & tie fire lead (+ random chance to miss)
  • changed: tie fighter difficulty ramp up
  • fixed: random hit on NPC (distance function overflow)
  • fixed: reworked trench to keep 60 fps
  • removed: in-game help


  • changed: reduced tie hit points
  • changed: increased tie damage
P#53727 2018-06-23 09:45 ( Edited 2020-02-21 11:22)

Coroutines are an essential part of my game engines.
However, I don't get how I can do both:

  • raise an error when something bad happens
  • silently handle proper coroutine termination

coresume returns a pair (is running,exception).
Thing is exception is set even during normal termination!!
note: costatus doesn't help as it immediately flips to "dead" when the coroutine crashes.

Something like that doesn't work, e.g. I get an assert even after genuine termination:

local co
function _init()
        for i=1,10 do
               -- syntax error test
           -- i=k/10

function _update()
    if co then
     local r,e=coresume(co)
     if not r then
        if(e) assert(r,e)
        -- never reached
P#53201 2018-06-02 04:48 ( Edited 2018-06-02 15:26)

Cart #52460 | 2018-05-06 | Code ▽ | Embed ▽ | License: CC4-BY-NC-SA

As a temporary side project, I hastily ported Randy Gaul ImpulseEngine to pico-8/LUA.


Requires a mouse

  • left mouse button: create a random shape at mouse cursor or drag shapes
  • right mouse button: show/hide world or body options
  • button c: show/hide debug information

Dev Log

The physic engine is a direct port from Randy Gaul's work, detailled in a series of articles:
How to Create a Custom 2D Physics Engine

My contribution is mostly on a clean 2d vector and 2x2 matrix object oriented library.
It makes vector/matrix math very concise to work (and easy to port from C++ code!):

local v1,v2=vec(3,4),vec(5,6)
local v3=v1+v2
-- rotation matrix
local m=mat:make_r(0.4)
local r=m*v3

Note: I don't plan to expand the library beyond this demo, feel free to make a game out of it!

The cart now include a context menu that could be fairly easily reused for other carts.

Missing Features:

  • Optimisation pass (currently supports ~4/5 objects max)

Change Log


  • initial revision


  • added: support for circles


  • fixed: force reset
  • changed: left click now creates a new body
  • added: right click menu to control world or object settings
P#52222 2018-05-01 08:32 ( Edited 2018-05-06 16:44)

Cart #50248 | 2018-03-11 | Code ▽ | Embed ▽ | License: CC4-BY-NC-SA

Anti-Aliased Asteroids

Hastily crafted Asteroids clone complementary of the anti-aliased line thead:



  • Added: Teleport ('c' button)! Up to 3 chances (sort of...) to get out of trouble
  • Changed: inertia cranked up, use your thrusters!
  • Changed: safe time is now 2s
  • Changed: thrust is now 'up' only
  • Fixed: Saucer Invasion!


  • Fixed: incorrect font rendering
  • Fixed: incorrect high score message on game over
  • Changed: reduced number of rocks to 4


  • Fixed: crash with dead player
  • Changed: multiple rocks types
  • Added: saucer!
  • Added: highscore (saved in cart data)
  • Added: multiple CRT effects (enjoy @Felice!)
  • Bug: couple of chars incorrectly rendered

1.0f: temp. fix by @Felice (tks!)

1.0: initial release (did not work)

Tech. Details

Not much really - using bits of my Pico 8 "game toolkit":

  • anti-aliased circle fill (using mid-point error for the shading)
  • multiple "CRT" shaders (find out how to switch between them!)
  • a couple of future functions using yield
  • vector font rendering


  • Felice: anti-aliased line optimisation genius!
  • Trammell Hudson: Asteroids font (https://trmm.net/Asteroids_font)
  • Atari: for the art cover (my lawers are on the copyright case :)
P#49676 2018-02-25 17:01 ( Edited 2018-08-21 20:55)

Cart #49509 | 2018-02-22 | Code ▽ | Embed ▽ | License: CC4-BY-NC-SA

This cart is just to provoke @zep (or any other true Pico-8 genius) into releasing a fast anti-aliasing demo cart!

The code is a LUA port of that paper:

Note: I don't get how an incremental line drawing routine (a la Bresenham) can be that slow (compared to the native version). 270% cpu usage for 16 lines sigh...

P#49510 2018-02-22 15:16 ( Edited 2018-02-28 07:42)

Cart #50452 | 2018-03-15 | Code ▽ | Embed ▽ | License: CC4-BY-NC-SA

Suzie and Bob are trapped in a merciless world. Can you fight your way out?

Gameplay Elements

  • Random maps
  • Multiple biomes

  • Multiple enemies
  • Multiple weapons (but one at a time!)
  • Loop-based difficulty
  • Supports keyboard/mouse



  • arrow keys: move & gun direction
  • bttn 1: fire & lock direction
  • bttn 2: pick up weapon

Mouse (selected in option menu):

  • arrow keys: move
  • mouse: gun direction
  • left click: fire
  • right click: pick up weapon

Note: any resemblance with a famous Vlambeer game must be purely accidental...



  • fixed: woobly sprites
  • fixed: actors stuck on corners
  • fixed: warp in/out effect
  • changed: impact feedback
  • changed: health upgrade on loop


  • fixed: unexpected god mode
  • fixed: boss hp
  • fixed: boss attack
  • changed: tweaked game speed
  • change:balanced high level gameplay (loop)


  • preview version

Dev Log

2nd finished game (last was Thunderblade). Took 4 months to complete & refine.
Un-minified source available on Github:

Tech Highlights
JSon Rules!
All entities (actors, weapons, particles, levels) defined using json (worth 3500 tokens!). A lightweight parser (450 tokens) converts strings into lua tables.

Entities are created using a parent template with support for:

  • lua references
  • random values
  • method & attributes override

Rotating Sprites
Player weapon (and couple of other sprites) are rotated in real-time using an optimized sprite routine. It is fast enough to allow ~10+ sprites on screen (before tanking FPS!)

An actor map is maintained each frame. It allows immediate bullet/actors lookup.
Only player/npc collisions are checked to ensure player cannot zip through enemies.

A-* path is refreshed for a single npc per frame. It ensures a large number of npc’s can be created without too much cpu stress.

Sprites are added to buckets matching their y pixel coordinate.
Saves both cpu and tokens as no global sort is required :]

Cart is minified using picotool (19k compressed). All json attributes are replaced by their short equivalent using output from minification script:
cat nuke.p8 | minify | replace > nuke_mini.p8

Missing In Action:

  • RPG aspects (upgrades/xp/abilities...)
  • Good music (for total lack of musical skills!!)
  • Scoreboard


P#48516 2018-01-24 15:49 ( Edited 2018-03-15 21:52)

While playing with the very handy picotool utility, I discovered that simply removing tabs on my well formatted code I was able to save 813 compressed bytes!!!


I've spent days trying to remove code, reshuffle stuff to save 50-100 bytes and simply making my code unreadable beats any of these optimizations??


P#46074 2017-11-09 16:07 ( Edited 2017-11-09 21:51)

I can get Windows, Linux and Raspberry updates but what about PocketCHIP?
My mobile development platform can no longer run a lot of the newly published games :[

P#46017 2017-11-08 16:50 ( Edited 2018-02-19 17:10)

Back 30 years ago, After Burner and Thunderblade ruled the arcades.
As a kid, I only had an Amiga and near zero coding skills to produce very (very) weak clones.
Now a seasoned programmer with the mighty power of PICO-8, I can beat a Sega X board!
Well, err...:

• Chris Butler (player + tank sprites lifted from the C64 1989 version)
• gamax92 for midi to pico-8 program
• dw817 (david w) for image decompression code (http://writerscafe.org/dw817)
• pico-8 community

What's Missing
• gameplay tweaking...
• levels 2,3,4,5
• gazillions of buildings on screen!

Tech Details

Drawn using sprite sheet (2), you can tweak the level using colors:
4: tank
6,7,13: building
8: enemy helicopter
9: Battleship boss
10: swtich to chase mode
11: switch to top-down mode
15: end_game (use carrefully!)

Title screen:
Title image is loaded from a stringified image, decompression done 'asynchronously' with yield.

Main screen:

Buildings are mostly drawn with many rectfill using a big checkerboard pattern to simulate windows/floors.

Everything is z-sorted (w actually ;) before being drawn. This 'zbuffer' is in charge of drawing every asset.

Game screen manager:
A light version of what I've extensively used during my XNA period. Allows nice decoupling between game loop and other loops (title, game over).

Used only for rare events (like player dying) to easily control animation and state changes.

Lessons Learned
• PICO-8 is a fantastic platform. Forces you to keep things simple (say that to my dozen or so failed Unity attempts...)
• token count is everything
• Coroutines are unfortunately too slow to be used in the core game loop
• Throw OOP techniques out. The nice class:method() construct eats up too many tokens - had to rewrite half of the code to stays within the limits :[
• bnot-cheating the platform is way too easy (but resisted against!)
• Did I say token count is everything?

P#44889 2017-10-03 16:02 ( Edited 2017-10-20 06:38)

Working on my game, I often find myself wondering how much cpu such or such construct uses.
I do my benchmarks using stat(1).
Issue is, my measures are all over the place according to the number of samples :[

Ex: Let's bench band vs. % and shr vs / @ 100 calcs/update

Good, % is almost free, / is slightly better than shr
Let's try 200:

Hu? shr is now better than /

Push it to 300:

Back to "normal"



How come number of samples for a given run is turning results upside down?
Note: if I push number of iterator further, I tend to have stable results - but who's performing 5000% per update cycle?!?
On top of that, @zep, we should be provided with op cost of basic operations (similar to cpu specs).

Reference code:

function bench(name,n,fn)
    local t0=stat(1)
    for i=1,n do
    return {name,(stat(1)-t0)}
function stat2pct(s)
    return flr(1000*s)/10
function bench_draw(name1,stat1,name2,stat2,y)
    print(name1.." vs. "..name2,1,y,7)
    local total=stat1+stat2
    local pct1,pct2=stat1/total,stat2/total
    local c1,c2=8,11
    if(stat1<stat2) c1=11 c2=8
    local x=flr(128*pct1)
    local x2=128*pct2
    local msgx2=x+x2/2
    if(x2<1) then
        x=127 x2=127 msgx2=120
    return y

local res={}
local n=100
function _update60()
    if(btnp(0)) n-=100
    if(btnp(1)) n+=100



function _draw()

    print(n.." iterations - \139\145 to change",1,1,7)

    local y=9
    for i=1,#res,2 do
P#43888 2017-09-03 05:12 ( Edited 2017-09-09 13:27)

View Older Posts
Follow Lexaloffle:        
Generated 2022-08-09 22:59:09 | 0.098s | Q:65