Skip to main content
Blocks are the fundamental building units of every level. Each block is a cube placed at a specific 3D grid position (BlockSlot) and can have up to six sides (faces), each potentially holding an item, enemy, ball, or decoration.

​
The Block Grid

The level is a 3D grid where each position is defined by integer coordinates (X, Y, Z). The block selector cursor highlights the current position, and blocks can only be placed at these discrete grid points.
  • The grid extends in all directions — there is no hard limit on level size
  • Blocks cannot overlap — each BlockSlot can hold at most one block
  • The origin (0, 0, 0) is the default starting position

​
Block Templates

Each block uses a template that defines its visual appearance, material, and behavior. Templates come from the current theme — changing the theme changes which templates are available. Templates are categorized as:
  • Side templates — Standard blocks with 6 independent sides, each holding elements
  • BlockOnly templates — Blocks without distinct sides (the entire block is treated as one unit). These cannot hold items/enemies/decorations on individual faces

​
Placing Blocks

  1. Press B to open the Blocks Pool
  2. Select a block template from the grid
  3. Navigate with WASD/EQ to position the selector
  4. Press Space to insert the block
The block is created at the selector’s position using the selected template. If a block already exists at that position, pressing Space will grab it instead.

​
Block Properties Hold

When you copy a block template with Shift+Tab, the editor stores the element properties backup. The next block you insert will inherit those properties. This is useful for quickly placing blocks with identical configurations.

​
Moving Blocks

  1. Press Space on an existing block to grab it (all 6 faces highlight)
  2. Use WASD/EQ to move the selector — the grabbed block moves with it
  3. Press Space again to ungrab the block at the new position
When a block is moved, all attached items, enemies, and balls are repositioned to follow their respective sides. The editor also triggers the OnEditorBlockMoved callback on the block’s template.
You cannot move a block to a position that already contains another block. The movement is blocked and the selector stays in place.

​
Removing Blocks

Press Backspace to remove the block at the selector position (or the currently selected block). Removing a block:
  1. Triggers the OnEditorBlockRemoved callback on the template
  2. Destroys all enemies and balls attached to its sides
  3. Removes the block from the section’s block network
  4. Clears the block selector selection
  5. Recomputes the level illumination

​
Copying Block Templates

This lets you quickly replicate a block’s configuration: select a side, press Shift+Tab, then press Space on an empty position to place a copy.

​
Block Illumination

After any block insertion, removal, or movement, the editor calls DynamicGI.UpdateEnvironment() to recompute global illumination. This ensures lighting stays consistent as you build.

​
Score Contribution

Each block template has an EditorScore value that contributes to the level’s total score. BlockOnly templates contribute their score directly; side templates contribute per-side. The score is recalculated in real-time and displayed in the HUD.