> 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

Description of all game objects.

## **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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2Fs2qxqGGryMqtKq5jvqfh%2Fmain-bubbles.png?alt=media&amp;token=d375eebb-83a4-414e-b33e-a6bbd32fd685" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FB1r9N1ojC5uxSwg2QAxy%2Fbomb1.png?alt=media&amp;token=293f6aea-1141-4a04-a01d-5b091607047d" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2F2Yzw6KEB5pufiOC8yoUr%2Fbomb2.png?alt=media&amp;token=65a27607-0b65-4142-9c2a-1fddd765c199" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FONJOi9ar7ww5wjXmfKzX%2Funbreakable.png?alt=media&amp;token=367dbfa1-a69e-4c8b-bcb7-46ff97cbd745" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FJTPYtm2H7ky2jcUA1yFR%2Fstone.png?alt=media&amp;token=9e671848-b2de-41e6-8626-24a317ed907c" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FjKPwHLGeW4tIiqXi3VM6%2Fhameleon.png?alt=media&amp;token=d0183892-264b-4b89-996e-5b8f7f76d697" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FzJq5FosBnHj9R8wZzgB2%2Fspider.png?alt=media&amp;token=ab6aca04-a816-4423-8d50-25d8a6c234c0" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FYJzy6XRUs9xESqssPio2%2Fice.png?alt=media&amp;token=f71ef123-bdd5-40a2-bd1f-4b704132f66d" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FiB7dSCbiOnUdpiukDD5G%2Fbush.png?alt=media&amp;token=c3a58460-77f3-45ec-b47a-73b61631b740" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2Fs3yYVdA2frAoIRAcxug6%2Fx5.png?alt=media&amp;token=d7ed0b00-ae7c-41ab-bcc7-4d6661ea31de" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FAdDqdMGWTNJEaK6DHe7k%2Fsharp.png?alt=media&amp;token=2ff47595-e459-4fc5-93c5-7ead9a621c83" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FWvE4ttWeZrcC6AiFBDH4%2Fcollapsar.png?alt=media&amp;token=b3e38988-a4b2-4e4e-b291-f941fa8b7b43" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FRNFhMMurLP98JfnIzyBg%2Fempty.png?alt=media&amp;token=e7dcf357-5b90-4840-98ab-20bb35cc816e" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FG7mK2NLHwazEJPLLrlY6%2Fdestructor.png?alt=media&amp;token=69930163-95a0-4271-8b5c-6eed774aa237" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FS1Y3z6GE9YyQrVCE7UWc%2Ffire.png?alt=media&amp;token=9850489c-5230-4124-a355-33e4fa6d941f" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2Fd5FNpnCa2cLZQnyqxvJN%2Fextra5.png?alt=media&amp;token=7877da71-585c-4e74-9070-7ea74040de65" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2Fu9EYXkncgQXMzJKgsYnl%2Frandom.png?alt=media&amp;token=ccda6625-4d97-46e0-8d26-bc257c985215" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FDpjLgZBN410nJN1sUirx%2Fbabies.png?alt=media&amp;token=fdf8b05c-4f7c-4614-bcdf-da0c4088852a" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2F6nmiAPU3mg3OTV8mEELv%2Fbaby-empty.png?alt=media&amp;token=c8c71ff0-0254-4cc3-b9e6-2f3ae634639a" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FJrrw8kOzh0DItoKXkOVg%2Fcarrot.png?alt=media&amp;token=9f257e9a-3a61-4528-8fa2-503f2cff5422" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FRJFFDfZBcH7lkoQZ7tFr%2Fstar.png?alt=media&amp;token=5005f5c3-3fd7-4886-9bf2-d38148d8b011" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FldW3JcZBIryWMhdMUSys%2Fbug.png?alt=media&amp;token=35b5bed2-fb25-44a6-9423-b2cfef976eb7" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2F7jfpQMnfZjtkWjP2pnwx%2Fstar.png?alt=media&amp;token=a09e7123-27c3-4df0-a44d-56b9c7e20109" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FvAQnY0vhu6GYiTfYtuAt%2Fmulticolor.png?alt=media&amp;token=d1d6b9de-ff49-41d1-83a8-3d5493e38372" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2F74Yx1XrC90E3GObbE4bu%2Faim.png?alt=media&amp;token=f44653ed-61f8-4913-8ab2-821465ac64d9" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FhhLyAx5MfwEIGo4HaxRx%2F3.png?alt=media&amp;token=258984fd-51d2-4242-8e78-e364002dcdca" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FweOMNOgbOY1jaJ9rFyOq%2F%D0%B5%D1%88%D1%8C%D1%83%D0%BA.png?alt=media&amp;token=08769253-d6a5-4788-b41c-d9cc53ca7705" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FNQPl9U4zl1itccLnqJyU%2Fimage.png?alt=media&amp;token=f1a10824-18e8-4bde-b8f2-00a984c1fd0e" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FNJ4uefyWxFJj9me3U0PT%2Fimage.png?alt=media&amp;token=ea8a1672-d930-4f7b-ac14-5c370937f81e" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FpbE86Znmc6D3tXazJKOE%2Fimage.png?alt=media&amp;token=fe46201d-99be-4787-a3fa-df6a845b1dca" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2Fy5tZR7XPHRrxkmLEHuax%2Farrows.png?alt=media&amp;token=79923bfb-261c-4624-ba63-4717b6f16a53" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FrkeU9SCN2kCS0PLD0oQk%2Fimage.png?alt=media&amp;token=657ae4da-3714-4830-ac71-121d5b4f00d2" 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="https://3431102767-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FGB7CK9gu3AIGgNgqIdcY%2Fuploads%2FdPH02jngiP4qOCW76cih%2Fbee.png?alt=media&amp;token=adea06b8-4cc4-4ce7-91e6-2d6d2fde45e8" 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>
