Log In  
:: Unfold ::

Cart #crystal-9 | 2022-07-11 | Code ▽ | Embed ▽ | No License

Colonize the planet!

To win the game, find, activate and connect 5 ancient crystal drills with the core!

How to play

  • start building solar panels and hydro-power-plants
  • connect them to quarries to get more minerals
  • build more stuff using minerals


O - choose things to build (terrain dependent). Destroy building.
X - construct building. mass building with X+arrows. terrain sensitive. pipette tool.

hold X on building - investigate requirements, connected suppliers and consumers, and the cluster's netto production
keep holding X - show map and stats

Game Mode: Post Apocalypse

You find the ruins of a lost civilization scattered on the planet. The mineral resources have been depleted and the yield of mineral mining is low.

You have to refactor, rebuild and recycle of what is left on the surface.

You can start this game mode from the pause menu.


P#113929 2022-07-03 14:44 ( Edited 2022-07-11 20:39)

:: Unfold ::

Cart #gobliiins-16 | 2022-07-08 | Code ▽ | Embed ▽ | No License

You play 3 goblins:

  • one is intelligent and can do wizardry
  • one is strong and can move things
  • one is crafty and can use items

Together they set out
To find great riches,
Which are said to be found
On level 20 of the Lost City!


  • Tutorial: 12 hand crafted levels
  • The Lost City: 20 procedurally generated levels
  • 3 characters with different abilities
  • items, spells and interactive blocks
  • music. each character got its own tape played in the boom box.


  • Thanks for all the play testers and their feedback!
  • Special thanks to the Lazy Devs Community (Discord)

Recent changes

  • Level 10 (Wizard Magic) changed to have many ways to solve it
  • New Level 12: Teleporters and Explosives!
  • Level 7 redesigned (was too hard)
  • Hold C (O) to restart
  • Removed back-up (regenerate) in the Lost City
  • New Level: Lasers and Diamonds!
  • New Level: Teleporters!
  • Added music for each character
P#113583 2022-06-24 13:16 ( Edited 2022-07-08 12:20)

:: Unfold ::

I recently tried to implement an enum structure in Lua, which turned out to be very useful. So I thought I might share it here :)

Find the latest version here (it's part of a Pico-8 library) https://github.com/sulai/Lib-Pico8/blob/master/lang.lua

Then enum(...) function generates an enum structure from a list of names.

The generated structure is useful when it comes to readability and object orientation.

As a use case for Pico-8, you can comfortably generate named objects that map to sprite ids. So if you want to associate names to your sprites like "sword", "shield", etc to show that to the user, this is a nice way to do it.

Example usage in a RPG:

tiles = enum( {"grass" ,"water", "rock"} )     -- landscape sprites start at 1
items = enum( {"sword" ,"shield", "bow"}, 16 ) -- item sprites start at 16
colors = enum( {"black", "blue", ... }, 0 )    -- map color palette.
actions = enum( {"look", "take", ... } )       -- just an enum.

You can now use the enums to make your code more readable:

if action==actions.take then
  • You can resolve to its name like tiles.water.name.
  • You can resolve by its id, eg: tiles[3].name
  • you can iterate over all enum entries like: for item in items.all() do print(item.name) end
  • You can offset the ids by using tiles=enum(names, 10). Useful if your sprites start at index 10.
  • You can also map arbitrary ids to objects like furniture=enum({[15]="table", [20]="chair"}).
  • You can use the generated objects as a starting point for more complex objects like furniture.table.heavy=true,
    or attach functionality like:
actions.look.execute = function(item)
    print("Looks like a usual "..item.name)
actions.take.execute = function(item)
    if not item.heavy then
        add(inventory, item)
function onactionuse(action, item)

Keep in mind that the usage of enums consumes more tokens than using magic numbers. You trade tokens for readability and elegant code.

P#43901 2017-09-03 18:33 ( Edited 2017-09-03 22:33)

:: Unfold ::

I'm just starting a new game from scratch and programming pico-8 feels really nice :)

So the first step is to have a cursor moving on a map. I wanted it to be really smooth and snappy and fast. So this is what I came up with.

Feel free to use it in your projects :)

Cart #43864 | 2017-09-02 | Code ▽ | Embed ▽ | License: CC4-BY-NC-SA

P#43862 2017-09-02 13:08 ( Edited 2017-09-02 17:22)

:: Unfold ::

I'm happy to announce my very first contribution to the Pico-8 community, which is a spin-off of Makiki's game title "A lone colony on a small planet".

Your goal now is to colonize an even smaller planet, but with some difficulties added to it. So this one is a more of a thinking game, while Makikis original is more of fast builder.



"You have been given a mission. You need to purify a small planet, so we will be able to colonize it. It is rich in resources, so it shouldn't pose a big problem for you. We believe in your management skills. Good luck." -- Makiki


  • O to build.
  • X is a multi tool.
    • build faster. you can keep it pressed and move around.
    • select what to build by using X over an existing building
    • get information about a building
    • change transport type
    • show the map and statistics

Hint to get started: produce energy and connect the energy producer to quarries. Once powered, they start mining minerals.

More hints (spoiler):

  • you can build "transport" tiles to transport about everything: energy, coal and oil
  • prefer hydro plants over solar panels, they are cheaper. connect the hydro plants to your quarries with transport
  • building transportation is cheap. you can use them as a switch by removing a transport tile. It's possible to re-route energy that way.
  • activate the core by delivering coal and oil to it
  • once activated, it functions as the core of a purifier cluster. All purifiers adjacent to it work together.

Development details (spoiler):

I liked the setting of Makiki's game, so I invested 2 weeks into it to add features, tweak the game and learn about Pico-8 and Lua along the way.

Feature list:

  • random map generator (had to remove Makiki's hand drawn map, sadly)
  • producers of energy, coal and oil need to be connected to their producers
    • to get the path finding/validation to work took me ages. My very first experience with Lua though.
  • transport tiles to transport any goods over a larger distance
  • core works as a purifier cluster core.
    • I think this one is a nice idea, as it replaces late-game grinding with late-game "I need to rewire a few things". On the other hand, It's perfectly possible to win without activating and using the core, and I think it's both fun in their own ways.
  • lots of tweaks and balancing on the ui, controls and game elements
  • lots of memory and cpu optimization. I still ended up to reduce map size to prevent out of memory errors in the late game. Which actually results in a good game length. It finishes just before you need to start grinding. Thus the title "Colony on a tiny planet. ;)
P#43859 2017-09-02 10:55 ( Edited 2018-11-10 00:56)

:: Unfold ::

Hi there,

I wrote a script which helps to write lua code in an external editor. The script listens to changes in the .lua file and re-integrates the lua code back into the .p8 cartridge. Each time you save.

So you can happily change lua files and edit assets in Pico-8 and everything gets merged back as soon as you save. Write some code in your editor, switch to Pico-8 and press ctrl-R to reload. It's quick :)

Works great for me in Intelij Idea, where I have syntax highlighting, code analysis and code completion. When trying to call a function, the IDE even shows the function parameters and lua-doc. What more can you ask for?

Some other things the script can do for you

  • include library code (#include library)
  • remove debug code on release (#define debug, #if debug, #end debug)
  • strip comments if you hit the size limit (please consider that comments are helpful for the Pico-8 community ;))
  • convert pico-8 specific statements like += to plain .lua. Some IDEs might work better with plain lua.

That's it, hope you like it. Download it here:


Have a look in the python file, there is more detailled und up to date instructions on the features.

PS: one down side though: the script works for Linux only at the moment, since it uses pyinotify for getting notified about file changes. I'm happy to accept pull requests if you want to port it to windows, maybe doing polling on the .lua files.

P#43725 2017-08-29 07:30 ( Edited 2017-09-07 03:59)

:: Unfold ::

In case your game gets slow, it's always helpful to identify the parts of code that take up too much time to compute. This is how you can measure execution time:

local start = stat(1)
-- .... do some intensive stuff ....
printh("this took "..((stat(1)-start)*100).."% of a frame")

Hope it helps, and thanks to @Felice for pointing out how to accomplish this.


P#43676 2017-08-27 08:46 ( Edited 2017-08-27 14:51)

:: Unfold ::

You can use this function in your program to do some basic memory profiling. Given the limit of 1MB memory for Lua variables, a little profiling will be much needed for many of us ;) It will return the amount of all elements of a table, including the content of sub tables.

It will not show the actual amount of bytes used, would be interesting if there is a way to calculate that? But you can use this as a rough estimation and check if your optimizations show any effect on the table size.

function table.size(t)
    local size=0
    for k,v in pairs(t) do
     if type(v)=="table" then
    return size
P#43654 2017-08-26 16:03 ( Edited 2017-08-27 15:20)

:: Unfold ::
-- converts anything to string, even nested tables
function tostring(any)
    if type(any)=="function" then 
        return "function" 
    if any==nil then 
        return "nil" 
    if type(any)=="string" then
        return any
    if type(any)=="boolean" then
        if any then return "true" end
        return "false"
    if type(any)=="table" then
        local str = "{ "
        for k,v in pairs(any) do
            str=str..tostring(k).."->"..tostring(v).." "
        return str.."}"
    if type(any)=="number" then
        return ""..any
    return "unkown" -- should never show

Example usage:

> print(""..tostring({true,x=7,{"nest"}}))
{ 1->true 2->{ 1->nest } x->7 }
P#43636 2017-08-26 07:12 ( Edited 2017-12-07 14:13)

Follow Lexaloffle:          
Generated 2023-10-02 08:25:19 | 0.075s | Q:25