> 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/bubble-shooter-toolkit/getting-started/specification.md).

# Specification

## **MAIN Game OBJECTS**

<table><thead><tr><th width="66">#</th><th width="218">Image</th><th width="291">Description</th><th width="152">Sprite name</th><th data-hidden></th><th data-hidden></th></tr></thead><tbody><tr><td>1</td><td><img src="/files/reWPCtQO2wy6biGpCjuK" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>6 Basic Color Bubbles..</strong></mark> To destroy them, need to match at least three bubbles of the same color or more.</td><td><strong>Item-1(2, 3, 4, 5, 6)</strong>.png</td><td></td><td></td></tr><tr><td>2</td><td><img src="/files/rmRuJE7rldTej0tP9Vwj" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Bomb Item.</strong></mark> Explodes neighboring objects within one cell radius when this bubble is touched.</td><td><strong>Bomb-item</strong>.png</td><td></td><td></td></tr><tr><td>3</td><td><img src="/files/4tHnAJeYwK5piKhl0mCg" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Direction Bomb.</strong></mark> When touched, destroys visible bubbles in the specified direction (horizontal, diagonal, vertical and etc).</td><td>Direction-bomb-1(2,3).png</td><td></td><td></td></tr><tr><td>5</td><td><img src="/files/u3aCi7uKIcJOUN8z0XJI" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Unbreakable Item.</strong></mark> Impossible to destroy. But it can fall if to destroy the bubbles it's attached to.</td><td><strong>Unbreakable-item</strong>.png</td><td></td><td></td></tr><tr><td>6</td><td><img src="/files/9zZEW402A1XHiI94EYZ4" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Hardbreakable Item.</strong></mark> To destroy this Item, you must hit it directly. Has 2 damage levels.</td><td><strong>Hardbreakable-item-1(2)</strong>.png</td><td></td><td></td></tr><tr><td>7</td><td><img src="/files/Zv1vINAosiY6SMevu53B" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Chameleon Item.</strong></mark> If two or more nearby bubbles are the same color, this bubble will adopt their characteristics to match.</td><td><strong>Chameleon-item-1(2)</strong>.png</td><td></td><td></td></tr><tr><td>8</td><td><img src="/files/ZtCGSd2pVpzS8g1RHznA" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Holding Item.</strong></mark> Keeps objects from falling until the central bubble is destroyed. Has 2 parts.</td><td><strong>Holding-item-1(2).png</strong></td><td></td><td></td></tr><tr><td>9</td><td><img src="/files/zbjnkn04pkEV9XnW71wX" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Fragile Item.</strong></mark> Transparent object. To destroy this item, the player needs to shoot it with any bubble. Can be destroyed when nearby objects are eliminated.</td><td><strong>Fragile-item</strong>.png</td><td></td><td></td></tr><tr><td>10</td><td><img src="/files/MuvBU8OI2IpeR0Kzn8vX" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Cover Item.</strong></mark> Not transparent object. By default, a randomly colored bubble hides under this game object. In the level editor, any game object can be placed under this item. <br><br>To destroy this item, the player needs to shoot it with any bubble or cause an explosion.</td><td><strong>Cover-item</strong>.png</td><td></td><td></td></tr><tr><td>11</td><td><img src="/files/1fVwUTRrlzRhdHZvGAQV" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Extra Score Item.</strong></mark> Gives 3 times more points. </td><td><strong>Extra-Score-item.</strong>png</td><td></td><td></td></tr><tr><td>12</td><td><img src="/files/cSebh9ePeteD9HsVQtMG" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Sharp Item.</strong></mark> Can be rotated by 60 degrees in Editor. Destroys any colored and bonus bubble upon contact. <br><br>This object can be destroyed by the following game objects: Bomb Item, Direction Bomb, Bonus bubble awarded for combos. Can fall if to destroy the bubbles it's attached to.</td><td><strong>Sharp-item</strong>.png</td><td></td><td></td></tr><tr><td>13</td><td><img src="/files/1goRWnESOJgEelyNVdFq" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Collapsar Item.</strong></mark> Absorbs any bubble irretrievably. <br><br>This item has 5 lives when hit by regular colored bubbles. It is instantly destroyed by any bomb or if detached.</td><td><strong>Collapsar-item</strong>.png</td><td></td><td></td></tr><tr><td>14</td><td><img src="/files/d1kQ76SGXd47mu29LHnX" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Empty Item.</strong></mark> Can place various collectable game items inside it. <br><br>To destroy this object, you need to destroy the bubbles it is attached to.</td><td><strong>Empty-item</strong>.png</td><td></td><td></td></tr><tr><td>15</td><td><img src="/files/p5E8KTp65weENT1pFngF" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Random Destructor.</strong></mark> Animated game item. Upon destruction of the hosting object, it is released, duplicates, and destroys 2 other random objects on the game board.</td><td>Random-destructor.png</td><td></td><td></td></tr><tr><td>16</td><td><img src="/files/JV1ds9jAaKuhIm3LEZ2Q" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Bonus Item Bomb</strong>.</mark> It bursts two rows of bubbles around itself.</td><td>Consists of two parts - a yellow bubble and a spiral particle</td><td></td><td></td></tr><tr><td>17</td><td><img src="/files/PlDrnSNg3CmORmi12rU2" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Extra +5 Moves / Time.</strong></mark> Place this label on top of any colored bubble. Upon destruction, this bubble will add 5 to the total number of moves/time.</td><td><strong>Extra-moves-time.png</strong></td><td></td><td></td></tr><tr><td>18</td><td><img src="/files/PHYf5tsHwCR60zFvjOCq" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Random Bubble:</strong></mark> <mark style="color:green;"><strong>Editor ONLY.</strong></mark> Use this tool to design levels. Set colors in the editor for automatic generation upon level start.</td><td>Random-item-editor.png</td><td></td><td></td></tr></tbody></table>

## **COLLECTABLE Items**

<mark style="color:green;">**Sprites --> GameScene --> Items**</mark>

<table><thead><tr><th width="60.333333333333314">#</th><th width="211">Image</th><th width="297">Description</th><th>Sprite Name</th></tr></thead><tbody><tr><td>1</td><td><img src="/files/vRNJLvVb5jrrov19Jmhf" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Babies.</strong></mark> They are located <strong>INSIDE</strong> <strong>colored</strong> <strong>bubbles</strong>. To collect these objects, need to destroy the bubble in which they are located.<br><br><mark style="color:green;"><strong>Sprites--> Character</strong></mark> </td><td>Little bunnies are made up of parts</td></tr><tr><td>2</td><td><img src="/files/ZwSYCjZ9Tp2ocCgSlU7M" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Baby in empty bubble.</strong></mark> They are located <strong>INSIDE empty</strong> <strong>bubbles.</strong> Can be activated only by destroying bubbles around it or with any type of bomb.</td><td></td></tr><tr><td>3</td><td><img src="/files/fBtPikBIekPSTnHOSinA" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Carrot.</strong></mark> The default <strong>center item</strong> in the <strong>rotating level</strong>, inside an empty bubble. To release it, clear all colored bubbles around. You can use it anywhere on the field as you like.</td><td><strong>Carrot-items.</strong>png</td></tr><tr><td>4</td><td><img src="/files/9NDET5aXpDHxdrLaFM9J" alt=""></td><td><mark style="color:orange;"><strong>White Star.</strong></mark> You can hide the object <strong>UNDER</strong> any in-game item.</td><td><strong>Star-item.</strong>png</td></tr><tr><td>5</td><td><img src="/files/GwcARrmDdyf6QMZGr279" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Extra item.</strong></mark>  Collectable item. Can be placed <strong>ON</strong> any game object.</td><td><mark style="color:green;"><strong>Extra Items</strong></mark></td></tr><tr><td>6</td><td><img src="/files/UFnmwGA0GW23C8AU93TP" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Score.</strong></mark> Set the needed points in the editor for players to win 1-2-3 stars and pass the level.</td><td>Win-star-2.png</td></tr></tbody></table>

## BOOSTERS

<mark style="color:green;">**Sprites --> GameScene --> Items**</mark>

<table><thead><tr><th width="66">Image</th><th></th><th width="291">Description</th><th>Sprite Name</th></tr></thead><tbody><tr><td></td><td><img src="/files/mIgL8JcSEDnl4FcELcrP" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Multicolor Bubble Booster.</strong></mark> Matches with any touched color</td><td><strong>Multicolor-bubble</strong>.png</td></tr><tr><td></td><td><img src="/files/JeSm47tynCdWnljNS1ZI" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Good Aim Booster.</strong></mark> Extends the line of aim.</td><td><strong>Aim-booster.</strong>png</td></tr><tr><td></td><td><img src="/files/ad2J3JzUtoOIKX4SBuwL" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>More Bubbles Booster.</strong></mark> Gives +5 extra bubbles.</td><td>Is made up of base bubbles</td></tr><tr><td></td><td><img src="/files/ZQXc4WQEFEnxsi1LmjeD" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>More Time Booster.</strong></mark> Gives +1 extra minute .</td><td><p><strong>clock-icon</strong>.png</p><p></p><p><mark style="color:yellow;"><strong>Sprites -></strong></mark> <mark style="color:green;"><strong>GeneralMenus</strong></mark> </p></td></tr></tbody></table>

## Types of Gameplay

<mark style="color:green;">**The engine has 2 types of gameplay:**</mark>

<table><thead><tr><th width="354">Image</th><th>Description</th></tr></thead><tbody><tr><td><img src="/files/Y1iNBPpWnzoVmPkOvGAb" alt="" data-size="original"></td><td><p><mark style="color:orange;"><strong>Classic "Top to down".</strong></mark> <br></p><p>You need to destroy the bubbles that descend from under the top game menu</p></td></tr><tr><td><img src="/files/W1HOSFADkoT3MyU7fON7" alt="" data-size="original"></td><td><p><mark style="color:orange;"><strong>"Circle".</strong></mark> <br></p><p>A level that rotates around a central object.</p></td></tr></tbody></table>

## FEATURES

<mark style="color:green;">**Sprites -> GameScene -> UI**</mark>

<table><thead><tr><th width="249">Image</th><th width="366.3333333333333">Description</th><th>Sprite Name</th></tr></thead><tbody><tr><td><img src="/files/pgoXiqS3rt0yWpo1gatz" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Holes.</strong></mark> Bubbles fall into it. In the Level EDITOR, you can <strong>ASSIGN</strong> a certain number of points for hitting each hole. Or <strong>DISABLE</strong> this feature if you wish<br><br></td><td><strong>Hole-theme-1(2,3)</strong>.png</td></tr><tr><td><img src="/files/esEsknDIB0dplF8p8PWm" alt=""></td><td><mark style="color:orange;"><strong>Circle Arrows.</strong></mark> Use the area around these arrows to swap the bubbles</td><td><strong>Circle-arrows.</strong>png</td></tr><tr><td><img src="/files/bKJWFPJPryhmFrSisxK9" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Bonus Item.</strong></mark><strong> T</strong>he same like <strong>Bonus Item Bomb</strong>. A special type of bubble that needs to be accumulated by destroying game objects. You can see the progress bar in the lower right corner of the playing field.</td><td><strong>Bonus-item.</strong>png</td></tr><tr><td><img src="/files/707en2G5WbLoDGF0PNAN" alt="" data-size="original"></td><td><mark style="color:orange;"><strong>Bouncing item</strong></mark>. If the <mark style="color:green;"><strong>holes are activated</strong></mark>, the bouncing item will appear on a successful match and give more points for each hit with a bubble. <br><br>These objects will disappear one by one when a player's throw fails.<br><br>There can be up to 3 of these objects on the playing field at the same time</td><td><mark style="color:yellow;"><strong>Sprites -></strong></mark> <mark style="color:orange;"><strong>GamScene -></strong></mark><strong> </strong><mark style="color:blue;"><strong>Items -></strong></mark><strong> Bouncing Item Folder</strong></td></tr></tbody></table>