> For the complete documentation index, see [llms.txt](https://docs.candy-smith.com/main/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.candy-smith.com/main/match-3-kit-home-design/editors-and-settings/level-editor.md).
# Level editor
[Video TUTORIAL](https://youtu.be/WAhG0di6b-A)
To open **Level Editor,** follor the menu **HomeDesignMatch3Kit->Editors->Level Editor** or key **C**
### Main Level Settings
| Field | Description |
| ----------- | ------------------------------------------------------------------------------------------------------------------- |
| LevelEditor | Editor title. |
| Test level | Runs the level |
| Save | Saves the current level. Ctrl+S / Cmd+S can also be used. |
| Level | Current level number. |
| Sub level | Current sub-level and total number of sub-levels. |
| Targets | List of level objectives, including target type, color, and amount. |
| Limit | Level limit: MOVES or TIME. |
| Color Items | Colored items available in the level. The number in parentheses is the value displayed by the editor for that item. |
| Tutorial | Tutorial type used for the level. |
| Field size | Number of columns and rows in the field. |
Changing the field size recreates the current sub-level field and clears the existing layout.
### Level Navigation
* < — open the previous level.
* \> — open the next level.
* \>> — open the latest available level.
* \+ — create a new level.
* \- — delete the current level.
### Sub-Level Navigation
* << — open the previous sub-level.
* \>> — open the next sub-level.
* 1 / 1 — current sub-level number and total count.
* \+ — add a new sub-level.
* \- — delete the current sub-level.
### Editor Tools
Click the foldout arrow to expand or collapse the Tools panel.
Tools panel
| Button | Description |
| ------- | ------------------------------------------------------------------------------------------------------ |
| Clear | Clears the data associated with the active tab. |
| Fill | Fills available cells with the selected block. Select a block first. |
| -1 | Removes one block layer from a cell. Click a cell with the left mouse button after selecting the tool. |
| Hole | Converts a cell into an empty field cell. |
| Refresh | Fully resets the field, including holes, items, teleports, spawners, and directions. |
Use LMB (left mouse button) to paint across multiple cells. Use RMB (right mouse button) to remove cell content or the top block layer. Ctrl+LMB can also be used for removal.
### Palette Tabs
#### Blocks
Blocks palette
Contains blocks and obstacles available for placement.
Select a block and click a field cell to place it. The editor checks whether multi-cell blocks fit inside the field.
Additional controls:
* Separator — adds a separator to a cell. Available directions are LEFT, RIGHT, UP, DOWN, and NONE.
* \+ — creates a new block.
#### Items
Items palette
Contains colored items, bonuses, and other gameplay objects.
The Keep cell clear until the game starts button marks a cell that must remain empty until gameplay begins.
* Use LMB on an item to select it.
* Use LMB on a field cell to place the selected item.
* \+ — creates a new item.
#### Directions
Directions tab
Used to configure item movement directions.
* Each arrow shows the configured movement direction for that cell.
* Set Enter Point — assigns an entry point to a cell.
* Set Regular Direction — restores regular cell behavior.
* Rotate One Arrow — rotates the direction of one cell.
* Rotate All — rotates all field directions.
* Default — resets directions to the default state.
A red indicator on the Directions tab means that directions have changed and should be reviewed.
#### Teleports
Teleports tab
Create a teleport connection with two clicks:
1. Click the source cell.
2. Click the destination cell.
The editor displays a red line with an arrow between the cells. Click a teleport cell again to remove the connection.
#### The red line and arrow show the configured source-to-destination direction.
#### Spawner
Spawner tab
Used to create and configure item spawners.
Modes:
* Add — creates a spawner on the selected cell.
* Edit — opens an existing spawner for editing.
* Remove — removes a spawner.
Spawner settings include:
* Each percentage controls the spawn probability of its corresponding item. When configuring two items, confirm the project's normalization rules before assuming the values must total 100%.
* Hide Spawner — hides the spawner visual.
* Item Prefab 1 and Percentage — first item and its spawn probability.
* Item Prefab 2 and Percentage 2 — second item and its spawn probability.
* Close — closes the settings popup.
Ingredient only from spawner allows ingredients to be generated only by spawners.
### Layer
Use the Layer control when working with blocks that contain multiple layers. The slider selects the visible layer, and the layer value can also be entered manually.
### Generator
Generator tab
Contains procedural field-generation tools.
The Generator tab calls field cells "squares"; this guide uses "cell" consistently.
Parameters:
* Fill Percentage — percentage of filled cells.
* Blocks to Add — block types that can be generated.
* Add Items to Squares — adds items to generated cells.
* Item Placement % — item placement probability.
* Select Item Type — selects the item to generate.
* Symmetrical Generation — enables horizontal symmetry.
Buttons:
* Generate Random Grid — creates a random field layout.
* Generate Blocks — adds selected blocks to the existing field.
* Generate Items — places the selected item on random cells.
* Clear Grid — removes blocks and items while preserving holes.
* Clear Item Selection — clears the selected item.
* AI Generator — opens AI-based level generation.
The editor automatically updates related targets and target counts when objects are added or removed.
\