Overview
Neon Flamingo Roulette is an HTML5 mini roulette simulation game: a wheel
with 13 pockets (the green 0 and the numbers 1 to 12), a 1980s Miami beach casino at night in pink and cyan
neon, and a cool flamingo in a white suit and sunglasses as the host and croupier. It ships as a
ready-to-host game (game/) and as its complete editable source (source/). It runs
in any current browser, on phones, tablets and desktops, in portrait and landscape, with no server, database
or account.
Features: every bet of a roulette table on a 13-pocket board (straight up, split, street, corner, six line, columns, red/black, even/odd, 1-6/7-12), lucky numbers with ×15 to ×100 multipliers, the half-back rule on 0, a ball that really flies and bounces on the separators, big/mega/epic win celebrations, quick bets (wheel neighbours, favourite bets, rebet, double), auto play and turbo, player levels, a daily wheel, timed free coins, daily missions, 14 interface languages, recorded announcer voice and music.
Simulation only. The player gets free fictional demo credits. They have no monetary value
and cannot be bought, transferred, sold or redeemed. There are no deposits, withdrawals, prizes or rewards
of economic value. The purchase price is for a software licence, not participation in gambling. Real-money
or other real-value gambling use is not permitted under the licence. Read SCOPE.md (at the root
of the package and inside game/): it is part of the licence terms.
Install on your website
The playable game is the folder game/. It is plain HTML, CSS and JavaScript: no build, no
Node.js and no database are needed to host it.
- Open your hosting file manager, or connect with an FTP program (for example FileZilla).
- Create a folder for the game, for example
/games/neon-flamingo/. -
Upload the contents of
game/into it:index.html,neon-flamingo.config.js,SCOPE.md,DOCUMENTATION.txtand the foldersart/,audio/,assets/andmodules/. -
Open the address in a browser, for example
https://your-site.example/games/neon-flamingo/.
The game uses relative paths, so it works in any folder or subdomain. Opening
index.html straight from your disk (file://) does not work, because browsers block
JavaScript modules there: test it on a web host or with the local preview described in "Editing the source".
Put it inside a page (iframe)
<iframe src="/games/neon-flamingo/" style="width:100%;aspect-ratio:16/9;border:0" allow="fullscreen; autoplay"></iframe>
Leave the on-screen credits notice visible and keep SCOPE.md with the game when you publish it
to the public.
Requirements
- Any static HTTP or HTTPS web host (shared hosting, a CDN, GitHub Pages, Netlify...). No PHP, database or server code.
- A current browser: Chrome, Edge, Firefox, Safari (macOS and iOS), Samsung Internet or Opera.
- Only for editing the source: Node.js 26 LTS (the current LTS line) and npm, see "Editing the source".
-
No internet connection is needed to play: art, sounds and code are all inside
game/. The game makes no requests to other sites.
How to play and the screens
The player taps TAP TO PLAY, picks a chip in the tray, taps the table to place it and taps SPIN. The flamingo croupier throws the ball; when it rests, the number rises out of its pocket, the lost chips are raked away and the winning bets are paid. All amounts are fictional demo credits.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
- Balance: the free demo credits
- Level: grows with play, gives free credits and opens the bigger chips
- Gifts: free coins, the daily wheel and the daily missions
- Menu: INFO, numbers, favourite bets, auto play, turbo, sound, full screen
- The wheel: 13 pockets; tap a number on it to bet on it and its two neighbours
- Last results (tap: the NUMBERS page)
- BET: what is on the table; after a round, WIN
- The table: tap a number, a line, a corner or an outside box to place the chip in hand
- Chips: pick the value; the locked ones open at higher levels
- Undo the last chip
- Clear the table
- Rebet: the bets of the last round again
- ×2: double every bet
- SPIN (hold it: auto play)
- Turbo on/off
- The credits notice (keep it visible:
SCOPE.md)
The bets and what they pay
A bet "pays 5 to 1" returns the chip plus 5 times the chip.
| Bet | Numbers | Pays | Where to tap |
|---|---|---|---|
| Straight up | 1 | 11 to 1 (9 to 1 while lucky numbers are on) | a number |
| Split | 2 | 5 to 1 | the line between two numbers |
| Street | 3 | 3 to 1 | the outer line of a row of three |
| Trio | 3 (0 and two numbers) | 3 to 1 | the corner where the 0 meets two numbers |
| Corner | 4 | 2 to 1 | the point where four numbers meet |
| First four | 0, 1, 2, 3 | 2 to 1 | the outer corner of the 0 and the first row |
| Six line | 6 | 1 to 1 | the outer line between two rows |
| Column | 4 | 2 to 1 | a 2:1 box |
| Red / black, even / odd, 1-6 / 7-12 | 6 | 1 to 1 | the boxes under the table |
Holding a finger on the table (or pointing with the mouse) lights the numbers a bet covers and shows a tag with its name and pay before the chip is placed. Tapping a number on the wheel places a chip on it and on its two neighbours on the wheel.
-
The 0 rule: when the ball lands on 0, every losing bet that does not cover the 0 gets
half of its chips back (rounded down). This is the shipped setting;
rules.zeroRulechanges it. - Lucky numbers: when the player taps SPIN, 2 numbers light up with a multiplier (×15, ×20, ×25, ×50, ×100). A chip straight up on a lucky number that wins returns that many times the chip. Every other bet pays as usual.
Quick bets and buttons
- Undo, clear, rebet (the bets of the last round) and ×2 (double every bet) are the round buttons beside SPIN.
- Favourite bets (menu): save up to three layouts and place one again with a tap.
- Auto play: hold SPIN, or open it from the menu, and choose how many rounds. A tap on SPIN stops it.
- Turbo: the small bolt on SPIN, or the menu, shortens the throw.
Rewards outside the table
Levels (the round LV button) grow with play, give free credits and open the bigger chips. The daily wheel gives free credits once a day (in the shipped demo setting it is offered on every visit). The gift button gives free coins every few hours and shows three daily missions about trying the kinds of bets. When the credits run out, a free refill is offered.
1
2
3
- The prizes, in free demo credits
- Spin the wheel
- Later: back to the table
INFO: pays, rules, numbers and options
The menu opens INFO with four pages: what every bet pays (drawn on a small board), the rules, the statistics of the last results and the options (music, sound effects, turbo, less motion, language).
1
2
3
4
5
6
7
- PAYS
- RULES
- NUMBERS (statistics)
- OPTIONS
- Close
- Where the chip of that bet goes, and the numbers it covers
- What it pays, "to 1" (the chip also comes back)
1
- The language drop-down
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
- Balance: the free demo credits
- Level: grows with play, gives free credits and opens the bigger chips
- Gifts: free coins, the daily wheel and the daily missions
- Menu: INFO, numbers, favourite bets, auto play, turbo, sound, full screen
- The wheel: 13 pockets; tap a number on it to bet on it and its two neighbours
- Last results (tap: the NUMBERS page)
- BET: what is on the table; after a round, WIN
- The table: tap a number, a line, a corner or an outside box to place the chip in hand
- Chips: pick the value; the locked ones open at higher levels
- Undo the last chip
- Clear the table
- Rebet: the bets of the last round again
- ×2: double every bet
- SPIN (hold it: auto play)
- Turbo on/off
- The credits notice (keep it visible:
SCOPE.md)
Keyboard
Space or Enter spins. Backspace or Z takes back the last chip, R places the last bets again, T switches turbo, M switches the sound, and Escape closes an open sheet.
What is in the package
neon-flamingo-static-1.0.0/
START-HERE.txt first steps
DOCUMENTATION.html opens this guide
CUSTOMIZATION.html opens the customization guide (recipes, no coding)
CHANGELOG.txt
SCOPE.md what the product is and what the licence does not allow
documentation/ this guide and the customization guide (EN/PT/ES), screenshots
game/ UPLOAD THE CONTENTS OF THIS FOLDER
index.html the page
neon-flamingo.config.js your settings (edit on the host, no rebuild)
modules/ the JavaScript, one readable file per source module
assets/ui/ the stylesheets
art/ images (WebP)
audio/ sounds, voice and music (MP3)
SCOPE.md, DOCUMENTATION.txt
source/ the complete editable project
index.html the page (development version)
src/main.js start-up, the round, lucky numbers, the daily wheel and gifts
src/table/ hud.js, betting.js, celebration.js, input.js (parts of main.js)
src/config.js defaults, events, save key
src/logic/ rules.js (the table), engine.js (bets, credits, return), progress.js, missions.js
src/ui/ roulette.js (the wheel), spin-sim.js (the ball), board.js (the table), fx, sheets, feel.js, theme.js, styles.css, game.css, i18n.css
src/locales/ the 14 languages (en.js is the reference)
src/audio/audio.js the list of sounds, music and voices
public/ art/, audio/, neon-flamingo.config.js (copied to the build as they are)
tests/ npm test
tools/ return of every bet, translation check, in-page text check, build formatter
package.json, package-lock.json, vite.config.js, .prettierrc, README.md
licenses/ licences of the development tools
THIRD-PARTY-LICENSES/ the same licence texts
game/ is exactly what npm run build makes from source/ (checked file
by file before packaging). Edit source/ and build again, or edit only
neon-flamingo.config.js on the host.
Settings (neon-flamingo.config.js)
game/neon-flamingo.config.js is read every time the game opens, so you can change these
settings on your host with a text editor and no rebuild. Every field is optional: remove the
// in front of a line to use it. A wrong value stops the game with a message that says what to
fix.
window.NEON_FLAMINGO_CONFIG = {
brand: { name: 'Neon Flamingo Roulette', storageKey: 'mysite.neon-flamingo' },
language: 'auto',
languages: ['en', 'pt', 'es'],
texts: { tapToPlay: 'PLAY NOW', de: { tapToPlay: 'LOS!' } },
audio: { volume: 0.8, muted: false },
ageGate: true,
notice: true,
showRtp: true,
rules: { zeroRule: 'half', lucky: { enabled: true }, chips: [10, 50, 100, 500, 1000], startBalance: 50000, limits: { spot: 5000, table: 25000 } },
progress: { wheel: { alwaysReady: false, everyHours: 24 }, coins: { everyHours: 3, amount: 50 } },
winTiers: { big: 5, mega: 12, epic: 25 },
};
| Option | What it does |
|---|---|
brand.name |
game name used in the page and messages |
brand.storageKey |
prefix of the saved data in the browser (default neon-flamingo.template.save.v1);
change it to start a fresh save
|
language |
'auto' = the device language (English when not offered), or a code:
en pt es fr de it nl pl tr ru id ja ko zh. A player's pick in OPTIONS and
?lang=xx in the address come first
|
languages |
the languages offered in OPTIONS (default: all 14). One language hides the picker |
texts |
replace any text of src/locales/en.js in every language, or in one language (texts: { pt: {...} })
|
audio |
starting volume (0 to 1) and muted state |
ageGate |
true shows the 18+ badge and the social-casino notice |
notice |
the one-line credits notice under the table. Leave it on: SCOPE.md requires it on
public releases
|
showRtp |
prints the return of the bets on the rules page |
debug |
testing only: allows ?seed=123 (the same rounds every time) and
?result=7 (the ball lands on 7) on any host
|
rules |
the table: zeroRule ('half' about 96.15% return,
'evenHalf' only the 1:1 bets get half back, 'none' the classic table at
92.31%), pays, lucky (enabled, count,
straight, mults, weights), chips,
startBalance, limits, wheel (the order of the pockets),
red. A payout that would return more than 100% is refused with a message. Run
npm run rtp after changing it
|
progress |
levels (levels.enabled, need, reward, unlock),
the daily wheel (enabled, alwaysReady, everyHours,
prizes, weights), free coins (enabled,
everyHours, amount) and missions (enabled,
perDay, reward). Amounts are multiples of the smallest chip
|
winTiers |
at how many times the credits staked the big, mega and epic celebrations start |
integration, callbacks |
events for your own page, see "Events" |
The file in the package lists every option with a comment. The full defaults are in
source/src/config.js, source/src/logic/rules.js and
source/src/logic/progress.js.
The table's math
With the shipped rules the return to player of each bet is between 92.31% (bets that cover the 0) and 96.15%
(the others, thanks to the half-back rule on 0). Lucky numbers do not change it: while they are on, a
straight-up bet pays 9 to 1 instead of 11 to 1, and the multipliers give that difference back on average.
npm run rtp (in source/) computes the exact return of every bet from your settings
and checks it with a simulation of millions of rounds.
The pockets clockwise on the wheel: 0, 7, 2, 9, 4, 12, 6, 1, 8, 3, 10, 5, 11. Red: 1, 3, 5, 7, 9, 12; the
other six are black and 0 is green. The minimum chip is the first value of rules.chips (10, 50,
100, 500, 1000 in the shipped setting); the most on one spot is 5,000 and on the whole table 25,000 per
round. A new player starts with 50,000 free demo credits.
The number is drawn when SPIN is tapped, each of the 13 with the same chance (or by ?seed= /
?result= while testing). The ball's flight is simulated afterwards so that it rests in that
pocket: it only shows the result.
Languages
The interface is translated into 14 languages: English, Portuguese, Spanish, French, German, Italian, Dutch,
Polish, Turkish, Russian, Indonesian, Japanese, Korean and Chinese (simplified). The announcer voice (the
flamingo host) and the painted titles (BIG WIN, MEGA WIN, EPIC WIN, DAILY WHEEL) are in English in every
language. The game opens in the device language; the player can change it in OPTIONS, and
?lang=pt in the address forces one.
Texts live in source/src/locales/<code>.js, one file per language, with the same keys as
en.js. A missing key falls back to English. To change a few texts without rebuilding, use
texts in neon-flamingo.config.js. After editing the locale files, run
npm run locales to check that no translation lost a {value} placeholder.
Saved data
The game keeps the balance, the bets on the table, the last results, level, missions, favourite bets,
settings and reward timers in the browser's localStorage, under keys that start with
neon-flamingo.template.save.v1. (for example
neon-flamingo.template.save.v1.balance). Nothing is sent anywhere. Every round is settled the
moment SPIN is tapped, so closing the page in the middle of a round loses nothing: the next visit says what
it paid. Clearing the site data in the browser resets the game. If you publish two copies of the game on the
same domain, give each one its own brand.storageKey.
Events for your page
The game sends events so your page can show statistics, achievements or a leaderboard of fictional scores. They are not an accounting or payment interface and must not be used as one.
-
callbacksinneon-flamingo.config.js:onReady,onBet({ spot, amount, total }),onSpin(round),onWin(round),onBalance({ balance }),onBonus({ kind, amount, balance }). -
window.NeonFlamingo.on('spin', fn),window.NeonFlamingo.getBalance(),window.NeonFlamingo.version. - DOM events on
window:neonflamingo:spin,neonflamingo:win... -
With
integration: { postMessage: true, targetOrigin: 'https://your-site.example' }the game also posts{ source: 'neon-flamingo', type, payload }to the parent page when it runs in an iframe.
round.result is the number, round.spent the demo credits put into the round,
round.payout the demo credits it returned, round.lucky the lucky numbers of the
round ([{ n, x }]).
Editing the source (Node.js for beginners)
You only need this to change code, styles, art or sounds and build a new game/. To change
settings, edit neon-flamingo.config.js instead.
1. Install Node.js
-
Go to
https://nodejs.organd download the LTS version (Node.js 26 LTS). Windows and macOS: run the installer with the default options. Linux: use your package manager or the official binaries. - Close and open your terminal again (Windows: PowerShell or Command Prompt; macOS: Terminal).
- Check the versions: both commands must print a number, and Node must be 26.13.0 or newer.
node --version
npm --version
2. Install the project tools
Open the terminal in the source/ folder (Windows: open the folder in Explorer, click the
address bar, type powershell and press Enter; macOS: drag the folder onto the Terminal icon).
Then run:
npm ci
This installs the exact versions in package-lock.json (Vite and Prettier) into
node_modules/. It needs an internet connection once.
3. Test, preview and build
npm test
npm run dev
npm run build
-
npm testruns the engine tests (bets, pays, the 0 rule, lucky numbers, credits, return) and checks that the ball always lands where the round says. All must pass. -
npm run devstarts a local preview athttp://localhost:5220/that reloads when you save a file. Press Ctrl+C to stop it. On the preview,?result=7makes the ball land on 7 and?lucky=7x50chooses the lucky numbers. -
npm run buildwrites the finished game tosource/dist/. Upload the contents ofdist/to your host (it replacesgame/). The build is not minified and is formatted with Prettier, so it stays readable.
Other commands
-
npm run rtpprints the exact return of every bet of your table (src/logic/rules.jsplus therulesofpublic/neon-flamingo.config.js) and a simulation of millions of rounds. npm run localeschecks the translations.npm run formatformats the whole project with Prettier.-
tools/qa-fit.jsis an in-page check for the preview: in the browser console,(await import('/tools/qa-fit.js')).check()lists any text that does not fit its plate.
Common problems
-
nodeornpmis not recognised: Node.js is not installed or the terminal was opened before installing it. Reinstall and open a new terminal. -
Windows says running scripts is disabled (
npm.ps1): use the Command Prompt, or runnpm.cmd ci. ENOENT ... package.json: the terminal is not in thesource/folder.EBADENGINE: your Node.js is older than 26.13.0. Install the current LTS.-
npm cifails with a network error: check the connection or the proxy of your company network, then run it again. -
npm cisays the lock file is out of sync: you changedpackage.json; runnpm installonce, thennpm ciworks again. - Port 5220 is busy: Vite picks the next free port and prints it.
Customize and reskin
The customization guide (CUSTOMIZATION.html) has step-by-step recipes for
people who do not program: replacing the background, the logo, the croupier, the chips, sounds and music,
colours, texts, table rules and rewards. In short:
-
Art:
source/public/art/(orgame/art/on the host). Replace a file with another WebP of the same name and the same size. -
Sounds:
source/public/audio/(orgame/audio/). Replace an MP3 with another of the same name. -
The wheel: its pockets and numbers are drawn by code
(
source/src/ui/roulette.js), so they always followrules.wheelandrules.red; the gold rim and the turret are art (rim.webp900 × 900,hub.webp420 × 420). -
Timings and effects:
source/src/ui/feel.js(how long every part of a round takes, slow motion, shakes, coins) andsource/src/ui/theme.js(colours of the glow and rays). Presentation only: nothing there changes a result. -
Layout and styles:
source/src/ui/styles.css(the shared shell) andgame.css(the roulette table). -
Texts:
textsinneon-flamingo.config.jsorsource/src/locales/. -
Table rules:
rulesinneon-flamingo.config.jsorsource/src/logic/rules.js, thennpm run rtp.
Changes in source/ need npm run build. Changes to files in game/ on
the host (art, audio, neon-flamingo.config.js) need no build.
Internal names
Part of the code is shared with other games of the same family, so a few names describe something else than they say. They are only names:
| Name in the code | What it is |
|---|---|
SLOTS, slot, slotOf() |
a pocket of the wheel: SLOTS = 13 pockets, slot = the position of a pocket on the wheel, clockwise (not a slot machine) |
jackpot (src/ui/wheel.js) |
the gold wedge of the daily wheel: its top prize, in free demo credits |
fx.snow, THEME.ambient |
the cyan neon motes that rise in the night air (THEME.ambient.rise = true) |
fx.frost() |
an effect of the shared code that this game does not use |
.entry-cta, .entry-logo, .entry-mascot |
the title screen: TAP TO PLAY, the logo and the flamingo host |
CreditBank, round.spent, round.payout |
the fictional demo credits: credits put into and returned by one round (no money) |
Updating the game and clearing the cache
After you upload a new version, browsers and hosts may keep the old files for a while. If a change does not show:
- Reload without the cache: Ctrl+F5 or Ctrl+Shift+R (Windows/Linux), Cmd+Shift+R (macOS). On a phone, close the tab and open it again.
- Clear the cached files of the site in the browser settings ("Cached images and files"). Do not clear "cookies and site data" unless you want to reset the saved game.
- Try a private (incognito) window.
- If your host or CDN (for example Cloudflare) has a cache, purge it.
- Add a version to the address once, for example
index.html?v=2.
Saved data survives an update as long as brand.storageKey does not change.
What the product is (and is not)
- Free, fictional demo credits only, with no monetary value. They cannot be bought, transferred, sold or redeemed. No prizes of any kind.
- No payment, deposit, withdrawal, account or wallet system: none is hidden, switched off or shipped in the package.
- The standard licence does not allow using this game, or any modified version of it, for gambling with real money or anything of real value: no buying credits, no cash-out, no prizes based on results, no connection to a gambling wallet, payment system or real-money operator, no advertising of real-money gambling.
-
You must follow the laws of every place where you publish the game (age ratings, minors, consumer
protection). Keep the credits notice visible;
ageGate: trueadds an 18+ notice. - Support does not cover wallet, deposit, withdrawal or any real-money integration; such requests are declined.
The full text is SCOPE.md.
Questions and problems
-
The page is blank. Check that you uploaded the contents of
game/(withmodules/andassets/) and that you open it through http(s), notfile://. The browser console (F12) shows the missing file. - No sound. Browsers allow sound only after a tap: the game starts it on TAP TO PLAY. Check the menu (sound button) and OPTIONS (music, effects) and the device volume. If a phone stops the sound (a call, another app), the next tap brings it back.
-
Can I change the return? Yes:
rules.zeroRule,rules.paysandrules.lucky;npm run rtpmeasures your table, and a setting that would return more than 100% is refused. -
Can I play the classic table without lucky numbers? Yes:
rules: { lucky: { enabled: false } }(straight up pays 11 to 1).zeroRule: 'none'removes the half-back rule. - Can players buy credits or win prizes? No. The game has no payment or prize system, and the licence does not allow adding one.
- Does it work offline? Once loaded, yes; it needs no other site.
-
Can I remove the credits notice? For a public release it must stay visible (see
SCOPE.md). -
The daily wheel opens on every visit. That is the demo setting
alwaysReady: true; setprogress: { wheel: { alwaysReady: false } }. -
How do I show a chosen result? On the local preview, or with
debug: truewhile testing, add?result=7(and?lucky=7x50) to the address.
Support and credits
Support e-mail: willian@polargames.com.br (bugs, installation, layout on supported browsers, translations, visual and audio customization and the settings in this guide). Please include your purchase or licence code, the browser and device, and a screenshot.
Development tools: Vite and Prettier (MIT licences in THIRD-PARTY-LICENSES/). No third-party
code is shipped in game/. Art, music, voice and effects are part of the game and covered by the
licence of your purchase.