Bird's-eye view of a PuzzleScript file

A puzzlescript file is divided into 8 sections:

Objects

Here's where your in-game objects are all declared. The simplest way is to give something a name and a color:

Player
Blue

If you do this, the player will be a blue square.

You can specify a sprite as a 5x5 grid as follows:

Player 
PINK YELLOW BLACK    
.222.
.000.
22122
.222.
.2.2.

Which gives you this wee fella:

The dots represent transparency, and the numbers 0..9 index the colours in the second line.

I'm getting slightly ahead of myself here, but I should mention the following convenience: instead of doing it in the legend section, you can specify a character that you can use to refer to the object when level editing just by putting it after its real name:

Player P
PINK WHITE BLACK    
.222.
.000.
22122
.222.
.2.2.

The available colour names are:

black
white
lightgray/grey
gray/grey
darkgray/grey
red
darkred
lightred
brown
darkbrown
lightbrown
orange
yellow
green
darkgreen
lightgreen
blue
lightblue
darkblue
purple
pink
transparent

You can use hex-codes instead of these names, if you prefer:

Player 
#FF5555 #FFFFFF #000000    
.222.
.000.
22122
.222.
.2.2.