Launch URL format
The game is launched with GET parameters that provide context to the module:
start?subscription_id=xx&player_id=xx&token=xx&room_index=x&transparent=falseParameters
| Parameter | Purpose |
|---|---|
subscription_id | 4-digit subscription identifier |
player_id | Public player identifier |
token | Temporary private token for validation |
room_index | Room number (0 for standard, 0–5 for VIP) |
transparent | True for transparent background over your interface |
Integration flow
- Configure subscription and endpoints.
- Host game files or use hosted URLs.
- Generate a launch URL with the required parameters.
- Redirect the player to the game.
- The game validates the token via your auth endpoint.
Setup steps
The full setup process has 8 steps:
| Step | Page | Purpose |
|---|---|---|
| 01 | Subscription | Activate your subscription |
| 02 | Tables | Configure room tables (join amount, winner amount, max players) |
| 03 | Game Files | Host game files or use hosted URL |
| 04 | Init Game | Build the launch URL with parameters |
| 05 | Player Data | Configure player data endpoint |
| 06 | Balance Endpoint | Configure balance credit/debit endpoint |
| 07 | Exit URL | Set redirect destination after game exit |
| 08 | Customize Theme | Connect theme assets folder |
Launch modes
Lucky Roll supports two launch modes:
- Direct Game Launch (
start) — Opens the game directly into the specified room index. - Game Menu / Home (
home.html) — Opens the main menu where players select their preferred room type.
Warning
Keep tokens private. Do not expose private endpoint URLs or credentials in public pages. All endpoints use server-to-server communication.