File formats

The tools save small text files you can open in any editor. These notes say what each part means, so you can read them, make them with a script, or use them in your own game.

Sprite file (.json)

Saved by the pixel sprite editor. Every sprite uses a small palette, and each pixel points at one palette colour or is empty.

{
  "schema": "oddshed.sprite.v1",
  "width": 4,
  "height": 2,
  "palette": ["#000000", "#ff0000", "#0000ff"],
  "pixels": [0, 2, 2, 0,
             1, 0, 0, 1]
}

schema: always oddshed.sprite.v1. A file with another value is refused.
width and height: whole numbers from 1 to 128.
palette: 1 to 32 colours, each written like #1a2b3c. The first colour is number 1.
pixels: exactly width x height numbers, row by row from the top left. 0 means empty (transparent). 1 means the first palette colour, 2 the second, and so on. A number past the end of the palette is refused.

A sprite can also be a sheet of equal frames, left to right then top to bottom. The file does not record the frame size; you choose it in the editor. The PNG downloads are normal PNG files with transparency.

Level file (.json)

Saved by the tile level editor. A level is a grid of tile numbers, in one or more layers drawn from the bottom layer to the top one.

{
  "schema": "oddshed.level.v1",
  "width": 3,
  "height": 2,
  "layers": [
    { "name": "Ground",  "tiles": [1, 1, 1,
                                   2, 2, 2] },
    { "name": "Objects", "tiles": [0, 5, 0,
                                   0, 0, 0] }
  ]
}

schema: always oddshed.level.v1.
width and height: whole numbers of tiles, from 1 to 256.
layers: 1 to 8 layers, listed from the bottom to the top. Each has a name (1 to 40 characters) and a list of tiles with exactly width x height numbers, row by row from the top left.
tile numbers: 0 means empty. 1 is the first tile of the tile sheet, 2 the second, and so on, up to 1024. The level file does not contain the pictures; it only points at tiles. Open the same tile sheet again to see them. A tile number past the end of the sheet is drawn as nothing.
Hiding a layer in the editor is only a view setting. The file always keeps every layer.

Tile sheets and frames (.png)

A tile sheet is a normal PNG made of 8 x 8 pixel tiles, read left to right then top to bottom, up to 128 x 128 pixels in all. Draw one in the sprite editor and download it, then open it in the level editor. Fully transparent pixels stay transparent.

Sound files (.wav)

The sound variants tool reads 16-bit PCM WAV files (mono or stereo; stereo is mixed down to mono) and saves 16-bit mono WAV files, so they open in any game engine or sound editor. When you choose a file name start, it is cleaned to letters, digits, dots, dashes and underscores.

Nothing in these files is uploaded anywhere by the tools. The files are yours.