Level Editor — Building Levels Visually

The RollingQuest level editor is a built-in tool that lets you design levels visually without any external software. You place blocks, items, enemies, and decorations using keyboard shortcuts and mouse clicks, configure properties through menus, and test your level instantly.

​

Opening the Editor

From the Main Menu, click Level Editor. This loads the editor scene where you can create a new level or continue working on the current one.

---

​

Basic Controls

​

Navigation

​

Block Manipulation

---

​

Placing Elements

​

Blocks

1. Press B to open the Blocks Pool — a grid of available block templates from the current theme.
2. Select a block template from the pool.
3. Navigate with WASD/EQ to position the selector cursor in 3D space.
4. Press Space to place the block.

​

Items

1. Left-click a block side to select it.
2. Press I to open the Items Pool.
3. Select an item template — it is automatically placed on the selected side.

​

Enemies

1. Left-click a block side to select it.
2. Press O to open the Enemies Pool.
3. Select an enemy template — it is automatically placed on the selected side.

​

Balls

1. Left-click a block side to select it.
2. Press P to open the Balls Pool.
3. Select a ball template — it is placed on the selected side.

​

Decorations

1. Left-click a block side to select it.
2. Press U to open the Decorations Pool.
3. Select a decoration template — it is placed on the selected side.

---

​

Configuring Elements

Press V on a selected side to open the Element Properties panel. From here you can configure:

• Type — Change the element template
• Script — Attach a Lua script to this element
• Variables — Set local script variables (key-value pairs)
• Direction — Set orientation (North/East/South/West)
• Skin — For balls with multiple skins
• Order — Ball execution order
• Enemy Interactions — For enemies, configure which hazards they interact with
• Item Respawn — Enable/disable respawn and set respawn time

---

​

Level Properties

Press Escape to open the Main Menu, then select Level Properties:

• Max Time — Maximum time allowed for the level
• Initial Time — Starting time for the countdown
• Lives — Number of lives the player starts with
• Hourglass — Enable/disable the hourglass mechanic
• Infinite Lives — Give the player infinite lives
• Script — Attach a level-wide script

---

​

Scripts in the Editor

​

Creating Scripts

Press C to open the Script Editor. From here you can:

• Create new scripts — give each a unique name
• Edit existing scripts — modify Lua source code
• Delete scripts you no longer need

​

Attaching Scripts

Each element (level, block, side, item, enemy, ball, decoration) can have a script attached:

1. Select the element
2. Press V to open properties
3. In the Script section, enter the script name or click More Scripts to browse
4. Set a Script Tag to identify this specific element instance
5. Configure Script Variables — key-value pairs accessible from the script

---

​

Saving and Loading

​

Save

1. Press Escape → Save
2. Enter a path like folder/levelName
3. The level is saved as a .rqlevel file with a thumbnail

​

Load

1. Press Escape → Load
2. Browse directories and select a level
3. The editor rebuilds from the saved data

---

​

Testing

Press T or use Escape → Test Level to play your level immediately. The game creates a virtual campaign with your level and lets you play it in the current editor session. Press Escape to return to the editor.

---

​

Rotating the Level

Press R to open the rotation menu. You can rotate the entire level layout by 90-degree increments. The editor rebuilds all block positions and orientations.

---

​

Score Info

The editor displays live score information based on the blocks, items, and enemies you place. This helps you balance the level’s difficulty and reward structure.

---

​

Complete Workflow Example

Here is a typical workflow for creating a simple level:

1. Main Menu → Level Editor → new level
2. Press B → select a floor block → press Space repeatedly to create a 5×5 floor
3. Press E to move selector up → place wall blocks around the perimeter
4. Left-click a side → press P → select ball template → ball is placed
5. Left-click another side → press I → select key template → key is placed
6. Left-click another side → press O → select enemy template → enemy is placed
7. Press V on the level → Script → enter level_main
8. Press C → Create → name it level_main → write your hooks
9. Press T to test → play through → press Escape to return
10. Press Escape → Save → enter path → done!