Level editing - Basics

Level editing is currently supported on desktop only. You will need a built copy of the consuming game (an executable launcher and the corresponding <game>-x.x.x.jar). The JAR contains all the resources the game needs at runtime — it is essentially a zip file and can be unpacked with 7-Zip.

Extract the data folder next to the JAR. The structure used by Lisa Engine is:

data/
├── levels/
│   ├── objects/
│   │   └── *.png
│   ├── world1/
│   │   ├── level1.tmx
│   │   ├── level2.tmx
│   │   ├── levelN.tmx
│   │   ├── ...
│   │   ├── rule1.tmx
│   │   ├── rule2.tmx
│   │   ├── rule3.tmx
│   │   └── rules.txt
│   ├── world2/
│   │   └── ...
│   ├── worldN/
│   │   └── ...
│   ├── blocks.tsx
│   ├── objects.tsx
│   ├── tileset1.tsx
│   ├── tileset2.tsx
│   └── tilesetN.tsx
├── scripts/
│   ├── cutscenes/
│   │   └── *.json
│   └── *.json
└── resources.json

  • levels: Tileset tsx, Tilemap tmx, and Rules tmx/txt files.

    • objects.tsx — the Objects that can be placed on the Objects layer.

    • blocks.tsx — the Tiles used on the Blocks layer.

    • tilesetN.tsx — Tiles for any other (purely visual) layer.

    • rule1.tmx — automapping rules for the Ground layer.

    • rule2.tmx — automapping rules for the Grass layer.

    • rule3.tmx — automapping rules for the Water layer.

    • rules.txt — list of rules applied on Ctrl + M (automapping).

  • scripts: JSON files for cutscene scripts and in-game scripts.

    • cutscenes/ — cutscene scripts, kept separate from in-game scripts.

  • resources.json: registry of all resources used by the game (worlds, levels, textures, sounds, animations, …) in JSON format.