editors

This is what you will see every time you start up PICO-8. It is a fun retro style command line like the original home computers. You have to type in commands to navigate your folders, load, save, or run your games.

See our Commands Guide to learn what commands you can use in this screen.

To begin editing a blank game, just press:

Pressing ESC while in a game or in an editor will bring you back to the Command Line.

This is where you can type the code of your games. You can organize your code into tabs at the top left. Some information is provided at the bottom about where you are in the code, and how close you are to reaching the limitations of a single game cartridge ("cart" for short). You can click on the bottom right icon (3 horizontal lines) to change the type of limitation that is displayed.

Here are what the buttons and indicators on this screen are:

This is where you can draw the art of your games, called "sprites". There is a large drawing canvas in the upper left, color and tool selections beside it, and at the bottom is your collection of sprites called a "sprite sheet".

To get started, first click somewhere on the sprite sheet, then click on a color of your choice, and then click and drag on the drawing canvas.

Here are what the buttons and indicators on this screen are:

See our Sprites Guide for more details.

This is where you can place your game art to create larger art. You will mostly use this map area to create backgrounds for your games. You can use one sprite from your spritesheet many times in the map. So it is a good idea to create certain sprites that are drawn like tile patterns that look nice when you put many of them next to each other. In fact, we use the word "tile" to refer to a single 8x8 sprite.

To get started, first click on a sprite or "tile" from your sprite sheet, then click anywhere in the map canvas above. You can also click and drag to place many of these tiles down on the map.

You have the same tools here as you do in the Sprite Editor: 

This is where you can make all the beeps and boops of your game. There are many options to create the exact sound effect you want to have. Sometimes you will create just a simple noise for small actions in your game, but sometimes you will also use this editor to create the rhythms and melodies of each layer in your game music. Both your sound effects and your musical layers will share the space in this Sound Editor.

There are actually two modes of viewing this sound editor:

Pitch Mode

Tracker Mode

Instruments

Loop Controls

 

This is where you can put your different sound effects together and create music for your game. For example, in Sound Effect #1, you can create a drum beat. In #2, you can create a melody. Then you come here and select the drum beat in one channel, and the melody in another channel to be played at the same time. You can play up to four sound effects at a time in the four channels, which are displayed as columns in this editor.

The music editor will display your notes as you would see them in the Tracker Mode of the Sound Editor.

Here are the tools available at the top of the Music Editor, and an example screen of using Sound #1 in the first column (channel #0).