# 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
> - grey
> - darkgrey
> - lightgrey
> - gray
> - darkgray
> - lightgray
> - 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.