OpenKye documentation

Creating levels

The level editor provides both a visual editing surface and a source view for Kye level data. Use the visual tools to arrange the board, then inspect the source when you need to work directly with the file format.

The first palette row in both editors contains Select (the dashed square) and Auto wall (the wall marked A). Auto wall reshapes connected walls as you paint; right-click erases. Choosing a tile returns to normal painting.

In the pack overview, Select lets you drag a tile or box-select a group, then move it. Ctrl/Command-drag copies, Shift toggles cells, and Alt includes blanks. Ctrl/Command+C and Ctrl/Command+V copy and paste, Delete erases, and Ctrl/Command+Z undoes. Moves stay staged until Escape, a tool or level change, or leaving the overview; undo cancels a staged move.

Start small

  1. Place Kye and a diamond in a simple enclosed area.
  2. Add a block or another piece to create a small puzzle.
  3. Click Play above that level to test it in a modal. Use Restart to try again and Close or Escape to return to editing. For replay and inspection tools, click Advanced editor to open Kye Level Lab. Choose Back to pack to return to the source and overview. Your edits stay in the same pack.
  4. Add complexity gradually, testing each new interaction.

Work in Level Lab

The starting board is on the left and its replay is on the right. Use the arrow keys or WASD to record moves, or Play to advance at eight ticks per second. Step records an idle tick. Drag the timeline to inspect an earlier state; recording there replaces the later inputs. Reset clears the recording.

Paint or erase tiles on the starting board to replay the same inputs against an edited puzzle. Undo restores edits without losing the recording. Auto wall reshapes connected walls as you paint. The view filters show player trails, hovered actor trails, or placement ghosts. Click a destination on the replay to place the selected tile at a starting position that reaches it; Tab cycles between possible origins.

With Select, drag over empty space to select a group, then drag the group to move it. Hold Ctrl or Command while dragging to copy. Shift toggles cells, Alt includes blank cells in a box, and Ctrl/Command+C and Ctrl/Command+V copy and paste. Selection moves are staged until you deselect, switch tools, or leave the lab; undo cancels a staged move. Escape commits and clears the selection.

Use the level selector to switch puzzles, New level to append a puzzle, and the metadata fields to edit its name, hint and completion message. Open .kye imports a pack and Download .kye exports the whole pack. The editor keeps a draft for the current browser session; download a file for a permanent copy.

Keep a saved copy of your level before making large changes. Existing .kye files are useful examples of how a level pack is structured.

For implementation details and the compatibility tests, visit the project repository.

← Documentation home