Web developers and event marketers frequently need lightweight, interactive mini-games to boost user engagement or run promotional giveaway campaigns without developing custom physics engines.
Lucky Wheels is a flexible HTML5 spin-the-wheel game engine built using CreateJS and the P2.js physics library. It enables developers to integrate customizable promotional wheels featuring customizable odds, dual-wheel mechanics, and multiple game modes. Best for digital agency campaigns, arcade portals, and web reward programs seeking a lightweight, easily reskinnable browser game. It is not designed for native compiled app platforms without a webview container, nor does it include full server-side backend infrastructure out of the box.
| Technical Specification | Details |
|---|---|
| Current Version | v3.1 |
| Core Frameworks | CreateJS, P2.js Physics Engine |
| Native Resolution | 1280×768 (Auto-scaling with devicePixelRatio support) |
| Control Methods | Mouse and Touch Responsive Controls |
| Operating Modes | Place Bet Mode (Bet per play), Total Chances Mode (Fixed plays) |
| Included Deliverables | HTML5 Source Files, Layered Photoshop PSD, Full Documentation |
Key Engine Capabilities & Customization
- Flexible Segment Rendering: Wheel segments accept dynamic text, drawn shapes, custom colors, or standard graphic asset overlays.
- Dual Wheel Configuration: Toggle an optional secondary inner wheel to offer risk/reward bonus spins or loss multipliers.
- Controlled Probabilities: Adjust outcome ratios using percentage-based odds configuration or set deterministic preset results for specific rounds.
- Broad Platform Compatibility: Responsive auto-resizing scales the display to fit mobile and desktop screens, supported by a mobile orientation helper screen for landscape layout guidance.
- Social Integration: Native score sharing functions for Facebook, Twitter, WhatsApp, Telegram, Reddit, and LinkedIn.
- Modular Add-on Compatibility: Integrates with external leaderboard systems and user account reward frameworks for point redemption features.
Frequently Asked Questions
Can I configure dynamic win probabilities for each slot?
Yes, the script features both percentage-based result control and manual outcome presets, enabling precise control over winning probability rates across all wheel slots.
Does modifying the game artwork require editing code?
Most visual changes can be made by replacing asset files in the project folder or modifying configuration settings. Slot graphics can be rendered directly from image assets or generated dynamically using color and text parameters.
Is Lucky Wheels compatible with mobile browsers?
Yes, the game is built on HTML5 with responsive auto-resizing, touch controls, and devicePixelRatio scaling to ensure full functional compatibility across desktop and mobile browsers.





