Usage Instructions
Ultimate Slot Machine — Web & Mobile is a configurable slot machine engine for Bubble with dedicated support for standard Web applications and Mobile/BubbleGo.

These instructions cover the recommended setup process and the main gameplay systems available in the plugin.

1. Add the Plugin Element

After installing the plugin, add the appropriate Ultimate Slot Machine element to your Bubble page.

Use the Web version for standard Bubble web applications and the Mobile version for Bubble mobile/BubbleGo applications.

Resize the element according to your application layout. The Mobile version automatically adapts the slot interface to the available mobile screen area.

2. Configure the Slot Grid

Set the number of reels and rows required for your game.

A typical configuration is:

Reels: 4
Rows: 3

This creates a grid containing 12 visible slot positions.

Your grid configuration also affects paylines, Full Grid bonuses, Hold & Respin and MEGAPRIZE conditions.

3. Configure Your Symbols

The plugin uses parallel lists to define the symbols.

Each position across the lists represents the same symbol.

Example:

Symbols IDs

1
2
3
4
5

Symbols Names

Cowboy
Train
Money Bag
Prize
Dancer

Symbols Points

100
250
500
1500
5000

Symbols Types

NORMAL
NORMAL
NORMAL
PRIZE
MEGAPRIZE

If you use images, the corresponding symbol images must follow the same order.

Therefore, Symbol ID 4 in the example above is:

Name: Prize
Points: 1500
Type: PRIZE
Image: fourth image in the symbol image list.

Always keep all symbol lists synchronized.

4. Symbol Types
NORMAL

Standard slot symbol used for regular winning combinations.

WILD

Used as a Wild symbol when evaluating compatible winning combinations.

BONUS

Used for bonus mechanics such as Free Spins.

PRIZE

Used by the Hold & Respin / Forced Result bonus system.

PRIZE symbols can become locked while the remaining positions continue spinning.

MEGAPRIZE

Used for the special MEGAPRIZE Full Grid mechanic.

A valid MEGAPRIZE requires the entire visible grid to contain the same MEGAPRIZE symbol.

For a 4 × 3 configuration, all 12 positions must contain the same MEGAPRIZE symbol.

5. Configure Symbol Images

When using image symbols, provide one image for each configured Symbol ID.

Square images are recommended for the best visual result.

Keep the image list in exactly the same order as:

symbols_ids

symbols_names

symbols_points

symbols_types

Transparent PNG or optimized WebP/PNG assets are recommended when appropriate.

6. Configure Paylines

The plugin supports up to 12 paylines.

Available patterns include horizontal, vertical, diagonal, V-shaped and zigzag combinations.

Supported payline names include:

top
middle
bottom
left
center
right
diag_down
diag_up
v_down
v_up
zigzag_down
zigzag_up

Add the desired values to the Active Paylines field.

To enable all available paylines, use all 12 values.

The plugin can display numbered indicators beside the reels. When a payline wins, the corresponding number is highlighted.

Payline numbers can be configured for the left side, right side or both sides.

7. Configure Scoring

Each symbol can have its own point value through the symbol points list.

The plugin evaluates winning combinations and publishes score information through Bubble States.

You can also configure thresholds for special win levels such as:

BIG WIN

MEGA WIN

JACKPOT

These thresholds determine when the corresponding special prize level is activated.

8. Configure Credits / Spin Balance

Enable the Spin Balance system if you want the plugin to manage credits internally.

Configure:

Initial Spin Balance — starting number of credits.

Spin Cost — number of credits consumed by each paid spin.

Show Balance Bar — controls whether the balance/credits information is displayed.

The current balance can also be accessed through the plugin States for integration with Bubble workflows.

9. Auto Spin

The plugin supports automatic spin sequences.

The interface provides predefined spin controls, including:

1 Spin

10 Spins

50 Spins

Auto Spin automatically stops when the selected number of spins has been completed or when gameplay conditions prevent another spin.

Special prize presentations are respected by Auto Spin. It waits for major animations and bonus sequences before starting the next automatic spin.

10. Free Spins

Enable the Free Spins system if required.

Configure the appropriate BONUS symbol and the number of Free Spins awarded when the trigger condition is reached.

Free Spins do not consume normal paid-spin credits while they are available.

The number of remaining Free Spins is available through the plugin States.

11. Forced Result

The Forced Result system allows you to configure controlled results using Symbol IDs.

This feature is useful for:

Testing
Demonstrations
Tutorials
Promotional mechanics
Bonus sequences
Controlled game experiences

Enter the Symbol IDs required by your sequence into the Forced Result field.

Use Forced Result Chance Percent to control how frequently the configured result occurs.

Example:

0

means the probability system does not activate it.

50

represents approximately a 50% chance when eligible.

100

forces the configured result whenever the Forced Result condition is evaluated.

For development and testing, temporarily use 100.

Return it to your desired production probability after testing.

12. Hold & Respin Bonus

The Hold & Respin system uses symbols configured with:

PRIZE

Enable the Hold & Respin feature and configure the following fields.

Prize Symbol Type

Recommended value:

PRIZE
Bonus Trigger Count

Number of PRIZE symbols required to start the bonus.

Example:

3
Bonus Start Respins

Number of respins initially available.

Example:

3
Bonus Reset Respins On New Lock

When enabled, landing another PRIZE symbol resets the available respins.

Bonus Max Respins

Defines the maximum number of standard respins allowed by the bonus configuration.

Bonus Prize Multiplier

Multiplier applied to the accumulated PRIZE value.

Example:

1

uses the original accumulated value.

13. Dynamic Hold & Respin Counter

During Hold & Respin, the plugin displays an animated accumulated prize counter.

Instead of immediately displaying the final amount, the counter progressively increases until it reaches the new accumulated total.

When another PRIZE symbol locks, its value is added to the existing total and the counter continues toward the updated value.

This creates a continuous prize accumulation experience throughout the bonus.

14. Full Grid Bonus

Enable Bonus Full Grid Mega to activate the special reward when every available grid position becomes locked with PRIZE symbols.

For a 4 × 3 grid, the bonus reaches Full Grid when all 12 positions are filled.

Use Bonus Full Grid Image to upload your custom celebration artwork.

Transparent PNG images are recommended.

The current Full Grid special presentation lasts approximately 6 seconds, after which the final celebration image can remain visible until the next valid spin.

15. Bonus Sound

Use Bonus Sound to provide dedicated audio for the Hold & Respin bonus.

When the bonus audio is active, the normal spin audio is managed separately to prevent both sounds from interfering with each other.

Longer audio files can be used when you want continuous music or effects throughout an extended bonus sequence.

16. MEGAPRIZE

MEGAPRIZE is a special Full Grid result.

Configure at least one symbol with:

MEGAPRIZE

as its Symbol Type.

A MEGAPRIZE result is only valid when every visible slot contains the same MEGAPRIZE symbol.

For example, in a 4 × 3 grid:

12 identical MEGAPRIZE symbols

are required.

A normal payline containing MEGAPRIZE symbols is not sufficient to trigger the complete MEGAPRIZE celebration.

17. MegaPrize Chance Percent

Use MegaPrize Chance Percent to control the probability of the special MEGAPRIZE result.

Example:

100

is useful during testing.

After confirming that the animation, sound and result work correctly, change the percentage to the probability required by your game.

18. MegaPrize Overlay Image

Use MegaPrize Overlay Image to provide the custom image displayed when MEGAPRIZE occurs.

Transparent PNG artwork is recommended.

The image is displayed with animation, glow and fireworks effects.

The current MEGAPRIZE animation lasts approximately 4 seconds.

The final image remains visible until the next valid spin begins.

19. JACKPOT

Configure the desired score threshold for JACKPOT.

When the player's result reaches the JACKPOT condition, the plugin activates the special JACKPOT presentation.

You can configure a dedicated:

Jackpot Sound

and:

Jackpot Overlay Image

for this prize level.

20. Jackpot Overlay Image

Upload a custom image to Jackpot Overlay Image.

Transparent PNG artwork is recommended.

When JACKPOT occurs, the image appears over the slot machine with glow, movement and fireworks effects.

The current JACKPOT animation lasts approximately 5 seconds.

After the animation completes, the image remains visible until the next valid spin.

21. Special Prize Timing

The current special celebration durations are:

JACKPOT    = 5 seconds
MEGAPRIZE  = 4 seconds
FULL GRID  = 6 seconds

The final special-prize artwork can remain visible until the next valid spin.

When Auto Spin is running, the plugin waits for these special presentations before continuing.

22. Configure Sounds

The plugin supports multiple independent audio effects.

Depending on your configuration, available sounds include:

Spin Sound

Reel Stop Sound

Win Sound

Jackpot Sound

MegaPrize Sound

Bonus Sound

Use Enable Sounds to control global sound playback.

Use Sound Volume to adjust the audio level.

For mobile applications, optimized audio files are recommended to reduce loading time.

23. Background and Visual Customization

Configure the slot background according to your application's visual theme.

You can combine your background artwork with custom:

Symbol images
Winning line colors
Winning line width
Symbol glow
Glow colors
Special prize images
Sounds

This allows the same engine to be transformed into completely different slot themes.

24. Winning Line Effects

Enable winning line effects to visually identify successful paylines.

Configure the desired:

Win Line Color

Win Line Width

Win Line Animation

Winning symbols can also use configurable glow effects.

These effects are independent from the numbered payline indicators.

25. Bubble States

Ultimate Slot Machine publishes gameplay information through Bubble States.

Use these States to connect the slot engine to your Bubble workflows.

Depending on the enabled systems, States can provide information such as:

Current Score
Last Score
Total Score
Spin Count
Current Credits / Balance
Can Spin
Auto Spin status
Auto Spins remaining
Free Spins remaining
Winning Symbol
Winning Positions
Winning Paylines
Win Level
Jackpot status
MegaPrize result
Bonus status
Accumulated bonus prize

Use Bubble's Do when condition is true, element state conditions or plugin Events to react to these values.

26. Bubble Events

The plugin exposes Events for important gameplay situations.

These Events can be used to start Bubble workflows when specific results occur.

Examples include normal wins, special prize levels, JACKPOT, MEGAPRIZE, bonus activity, Auto Spin completion and other gameplay conditions exposed by the plugin.

Use Bubble workflows to connect these Events to your own:

Database records
User rewards
Notifications
Animations
Leaderboards
Achievements
External APIs
Loyalty systems
27. Plugin Actions

Ultimate Slot Machine provides Actions that allow Bubble workflows to interact with the slot engine programmatically.

Use the available Actions when you need to control gameplay from buttons, workflows or other elements outside the built-in interface.

This allows the plugin to operate as part of a larger Bubble application rather than as an isolated game.

28. Web Setup

For standard Bubble web applications, use the Web implementation.

Configure your symbols, paylines, sounds, scoring and bonus systems through the plugin fields.

The Web version supports the advanced gameplay systems described above, including JACKPOT, MEGAPRIZE, Forced Result, Hold & Respin and Full Grid celebrations.

Make sure the plugin element has enough width and height for your desired reel configuration.

29. Mobile / BubbleGo Setup

Use the Mobile implementation for Bubble mobile applications and BubbleGo.

The Mobile version automatically adjusts important interface elements according to the available screen size.

Responsive elements include:

Reels
Symbols
Payline indicators
Score
Credits
Spin controls
Special prize overlays

Always test your final configuration in BubbleGo and on the target mobile screen sizes before publishing.

30. Recommended Testing Procedure

Before releasing your application, test the major systems individually.

A recommended order is:

Test normal spins.
Verify Credits and Spin Cost.
Verify symbol scoring.
Test every configured payline.
Verify payline number highlighting.
Test WILD behavior.
Test Free Spins.
Test BIG WIN.
Test MEGA WIN.
Force JACKPOT and verify its image and sound.
Set MegaPrize Chance Percent to 100 and test MEGAPRIZE.
Set Forced Result Chance Percent to 100 and test Forced Result.
Test Hold & Respin.
Verify PRIZE symbols lock correctly.
Verify the accumulated prize counter.
Complete all positions and test Full Grid.
Test Auto Spin with normal wins.
Test Auto Spin during JACKPOT.
Test Auto Spin during MEGAPRIZE.
Test Auto Spin during Hold & Respin / Full Grid.
Test Reset.
Test the final Web layout.
Test the final Mobile/BubbleGo layout.

After testing, restore all probability fields to their intended production values.

31. Important Configuration Rule

When working with symbols, always remember:

Symbol ID, Name, Image, Points and Type must refer to the same list position.

Incorrect list ordering can produce unexpected results, especially with Forced Result, PRIZE and MEGAPRIZE mechanics.

32. Recommended Assets

For best results:

Slot Symbols: square PNG/WebP images.

JACKPOT Overlay: transparent PNG.

MEGAPRIZE Overlay: transparent PNG.

Full Grid Overlay: transparent PNG.

Use optimized image sizes to keep Web and Mobile loading times reasonable.

Special-prize images with transparent backgrounds and glowing/degraded edges work especially well with the built-in celebration effects.

33. Workflow Integration Example

A common Bubble integration is:

Ultimate Slot Machine's Jackpot is triggered
       ↓
Run Bubble Workflow
       ↓
Save result to database
       ↓
Add reward to Current User
       ↓
Display application-specific notification

You can use the same concept with other plugin Events and States.

This separates the slot gameplay engine from your application's business logic.

34. Important Production Notice

Ultimate Slot Machine provides slot machine gameplay mechanics and visual functionality.

If your application involves real-money gambling, wagering, lotteries, sweepstakes, cash prizes or any regulated gaming activity, you are responsible for complying with applicable laws, licensing requirements, platform rules and regulations in every jurisdiction where your application operates.

The plugin does not provide gambling licenses, payment processing, regulatory approval or legal authorization for real-money gaming.