# Level EDITOR

How to use a Level Editor [VIDEO Tutorial](https://www.youtube.com/watch?v=DGVYLoflQLc)\
\
To open **Level Editor** - go to `Tools -> Bubble Shooter -> Level Editor` `-> Editor` (or use the hotkey <mark style="color:green;">**C**</mark>)

#### To open all levels <mark style="color:green;">for testing</mark>, use the '<mark style="color:green;">Open all levels</mark>' tab

<figure><img src="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FcEudFBNGoz4gcL8L7gcI%2Fimage.png?alt=media&#x26;token=ac865fe7-3104-4347-9f02-0a7cce6753ce" alt=""><figcaption></figcaption></figure>

<figure><img src="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FxaQSA7jSI8oi3UUJUsVQ%2Fgameeditor.png?alt=media&#x26;token=a30cc0c6-a6b8-4c90-8b3f-c16fad201881" alt=""><figcaption></figcaption></figure>

<table data-header-hidden><thead><tr><th width="74"></th><th width="139"></th><th width="174"></th><th></th></tr></thead><tbody><tr><td>1</td><td>+</td><td></td><td>Add a new level.</td></tr><tr><td>2</td><td>Level Number</td><td></td><td>Display the number of the edited level.</td></tr><tr><td>3</td><td>Play Level</td><td></td><td>Button to test the level.</td></tr><tr><td>4</td><td>&#x3C;&#x3C;  >></td><td></td><td>Arrows to switch between levels. Also, you can choose a specific level: <br><mark style="color:green;"><strong>Assets</strong></mark> -> <mark style="color:green;"><strong>BubbleShooterGameToolkit</strong></mark> -> <mark style="color:green;"><strong>Resources</strong></mark> -> <mark style="color:green;"><strong>Levels</strong></mark></td></tr><tr><td>5</td><td>General TAB</td><td><img src="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FqPAThymjkn8LJuNxeQQd%2Fimage.png?alt=media&#x26;token=9300ebaa-3b95-4282-95a5-a61affb6f095" alt="" data-size="original"></td><td>Tab displaying general level settings. You can use the ⏷ icon to collapse and expand the tab.</td></tr><tr><td>6</td><td>Moves / Times</td><td><img src="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FSnsAaK3i1yRnsdNsILO2%2Fmoves-time.png?alt=media&#x26;token=bb19360b-25f4-4cc8-b889-2379c5a483e2" alt="" data-size="original"></td><td>Choose the level type: moves / time. Specify the required number of moves / time.</td></tr><tr><td>7</td><td>Level Type</td><td><img src="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2Fp4aI9vsUKouqyQGsrkPg%2Flevel-type.png?alt=media&#x26;token=be0b1c1c-de77-4b0a-b1d5-1c680118eef7" alt="" data-size="original"></td><td>Choose the level type: vertical / rotating.</td></tr><tr><td>8</td><td>Holes</td><td><img src="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FZiZmo14JDMNGt7Nb0ZQP%2Fimage.png?alt=media&#x26;token=fb8845b3-18b1-4f90-abe6-47543856fae2" alt="" data-size="original"></td><td>Check the box to enable or disable holes and bugs for the current level. This function is enabled by default.</td></tr><tr><td>9</td><td>Size Y</td><td></td><td>Allows editing the level length.</td></tr><tr><td>10</td><td>Stars</td><td></td><td>Set the number of points for each star here</td></tr><tr><td>11</td><td>Tutorial</td><td></td><td>Choose the tutorial for the current level (you can create your own tutorial, see this video ***</td></tr><tr><td>12</td><td>Background</td><td></td><td>Choose the desired background. <br><br>Also, you can set one background for multiple levels at once. Go to <mark style="color:green;"><strong>Assets</strong></mark> -> <mark style="color:green;"><strong>BubbleShooterGameToolkit</strong></mark> -> <mark style="color:green;"><strong>Resources</strong></mark> -> <mark style="color:green;"><strong>Levels</strong></mark>, select the necessary levels from the list, and assign the required background.</td></tr><tr><td>13</td><td>Colors Random ball</td><td></td><td>When creating a level using a random bubble, colors will be generated based on the checkboxes set here.</td></tr><tr><td>14</td><td>Targets TAB</td><td></td><td>Tab displaying level objectives.</td></tr><tr><td>15</td><td>Targets</td><td><img src="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2F5J7Gsa625H47OvpiFOHA%2Ftargets.png?alt=media&#x26;token=274c8af5-8f7c-4a41-bc62-c28bfdf5ec93" alt="" data-size="original"></td><td><p></p><p>Targets that need to be <strong>set manually</strong>:</p><ul><li>Points. The number of stars required to pass the level, from 1 to 3.</li><li>Colored bubbles. For example, 10 red and 20 blue bubbles, etc.</li></ul><p>Other targets are <strong>collectible</strong> and are <strong>set automatically</strong> after these targets are placed on the game field:</p><ul><li>Saving babies</li><li>Bugs</li><li>Carrots</li><li>White star</li></ul></td></tr><tr><td>15 ab</td><td>+ - </td><td></td><td>Add and remove targets.</td></tr><tr><td>16</td><td>Editor TAB</td><td></td><td>Tab containing all the tools for level design.</td></tr><tr><td>17</td><td>X</td><td></td><td>Tool for removing objects from the game field.</td></tr><tr><td>18</td><td>Fill</td><td></td><td>Fill the game field with random bubbles.</td></tr><tr><td>18a</td><td>-1</td><td></td><td>Remove 1 layer</td></tr><tr><td>19</td><td>Clear</td><td></td><td>Clear the game field.</td></tr><tr><td>20</td><td>Palette</td><td></td><td>Palette with game objects.</td></tr><tr><td>21</td><td>Game Field Grid</td><td></td><td>Field for creating the game level.</td></tr></tbody></table>

To obtain more information about game objects, refer to the [specifications](https://docs.candy-smith.com/main/bubble-shooter-toolkit/getting-started/specification).


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.candy-smith.com/main/bubble-shooter-toolkit/tutorials/level-editor.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
