README.md

main 3.9 KB · 77 lines · markdown

OpenVibe.Casino

Learn it, play it, never pay it.

Live site: https://openvibe.casino · API docs: https://openvibe.services · For AI: https://openvibe.casino/llms.txt
Run it: npm ci && npm run dev (Node 22 or newer) · Tests: npm test

Domain: openvibe.casino · Port: 5210 · Service id: casino · Env prefix: CASINO

Every casino game with its insides showing: the rules, the exact odds and what each bet costs, tables you can play with
chips worth nothing, and a simulator that plays a million rounds in your browser. Plan: the new-domains plan, §5.14.

No real money, ever. Play chips are free, a fresh 1,000 arrive each day, they live in the player's browser, and they
cannot be bought, sold, won as anything or cashed out. No operator listings and no affiliate links: those wait for the
owner's legal review. The tables sit behind a self-declared 18+ gate, remind a player every 30 minutes, and every page
carries one calm line pointing at free help (1-800-GAMBLER, BeGambleAware, Gamblers Anonymous).

The engines (`engine/`)

Pure JavaScript, deterministic from a seed (rng.js, mulberry32), UMD so the same file runs on the server, at the table
and in the simulator's Web Worker.

| Engine | What it plays | How the edge is known |
|---|---|---|
| blackjack.js | 6 decks, S17, DAS, split to 4, split aces one card, peek, insurance, 3:2; basic strategy, "like the dealer", "never bust" | simulation; basic strategy checked against the published 0.40% |
| roulette.js | European and American, every layout bet | exact: 2.70%, 5.26%, top line 7.89% |
| baccarat.js | punto banco, 8 decks, the third-card tableau, 5% commission | exact, every six-card path weighted: 1.06 / 1.24 / 14.36% |
| craps.js | pass, don't pass, odds (3-4-5x), place, field | exact from the 36 dice outcomes |
| slots.js | three 24-stop reels, a paytable | exact over all 13,824 stops: RTP 93.63% |

engine/games.js is the catalogue every page and the API read; no edge in it is typed in.
test/engines.test.js checks every figure against Wizard of Odds' published one.

Pages

| Path | What |
|---|---|
| / | every bet's cost on one ladder, a real bankroll chart, what you can do, questions |
| /play, /play/:game | the tables (public/js/table.js), the 18+ gate, the chips (public/js/casino.js) |
| /learn, /learn/:game | the rules and each bet's edge, with the engine's own tables (basic strategy, the tableau, the strips) |
| /simulate | the simulator (public/js/simulate.js, public/js/sim-worker.js) |
| /s/:id | a shared run (noindex) |
| /safe, /developers | play safe; the API |

API (`/api/v1`, open, no key)

GET /games, GET /games/:id: rules, each bet's edge, how it is known and the published source.
POST /simulate { game, choice, rounds, seed?, share? }: a bounded run on the server (CASINO_SIM_MAX_ROUNDS,
default 200,000; CASINO_SIM_PER_MINUTE per address, default 6). With share, the run is kept and its link answered.
GET /sims/:id: a shared run. GET /openapi.json: OpenAPI 3.1.

Data

One table, casino_sims (a shared run: game, params with the seed, result). No column names a person. Casino keeps
nothing about anyone, so an account export says so and a deletion has nothing to erase (server/identity/account-data.js).

The service

Express, server-rendered through openvibe-shared/shell and the room kit (rooms.js id casino). Sign-in through
OpenVibe.Network (OAuth client casino, PKCE). PostgreSQL through openvibe-sdk/db (migrations/), PGlite in
development and tests. Deploy files: deploy/systemd/openvibe-casino.service, deploy/nginx/openvibe.casino.conf
(Meme's, renamed). Env: .env.example.

npm install
npm run dev        # http://localhost:5210
npm test           # node test/run.js on PGlite

AGPL-3.0-only.

openvibe-contracts: v0.419.0
openvibe-sdk: v0.161.0
openvibe-shared: v4.241.0