Backgammon

Classic backgammon with 3D dice and a smart computer — HTML5

Overview

Complete backgammon on an ornate inlaid board with 3D tumbling dice: full rules, doubling cube, gammons and backgammons, two computer levels and two players on one device.

  • Full rules: bar entry, hitting, blocking, doubles, forced moves, bearing off
  • Gammons, backgammons and an optional doubling cube
  • Computer opponent with two levels (Normal and Hard look-ahead)
  • Two players on one device (hot-seat) mode
  • 3D dice that tumble and land on the rolled number, with a 2D fallback
  • Ornate inlaid board, ivory and ebony checkers, sound effects and music
  • Tap or drag to move, legal moves highlighted, touch and mouse
  • Rules engine in a separate file, reusable on its own

Requirements

  • Any modern browser (Chrome, Edge, Firefox, Safari 15+, iOS and Android)
  • Serve over http(s) — any static host or a local server

Technology: HTML5 Canvas · three.js r159 (3D dice) · Web Audio · JavaScript.

Quick start

  1. Unzip the package.
  2. Upload the game/ folder to your web host, for example as /games/backgammon/.
  3. Open https://your-site.com/games/backgammon/index.html. No install, no database, no server code.

To try it on your computer first, start any local web server inside game/:

cd game
python3 -m http.server 8080
# then open http://localhost:8080/index.html

Browsers block some features (workers, 3D model files) for pages opened straight from disk, so always test through a web server.

How to play & controls

Roll the dice, then tap a checker and a highlighted point to move it (or drag it). Hit lone checkers, build points, bring everyone home and bear off first. The doubling cube is optional.

RollTap the dice button
MoveTap a checker, then a highlighted point · or drag
Bear offTap the tray when all your checkers are home
Sound / optionsButtons on the board screen · Menu bottom-left

File structure

game/index.htmlThe page: start menu markup and the GAME_CONFIG settings (texts, difficulty levels, colours).
game/host.js · game/host.cssThe host: start menu, loading, countdown, pause on tab switch, result card.
game/games/backgammon/game.jsThe game itself: rules, computer opponent, rendering, input, sound.
game/games/backgammon/rules.jsbackgammon rules engine (legal moves, bearing off, results)
game/games/backgammon/assets/Models, textures and sound (39 files).
game/vendor/three.js r159 and its loaders / post-processing (MIT).
game/fonts/Inter and Unbounded fonts, self-hosted (OFL).
documentation/index.htmlThis documentation.
LICENSE.txt · THIRD-PARTY.txt · CHANGELOG.mdLicence terms, bundled components, version history.

Configuration

The start menu is driven by window.GAME_CONFIG in game/index.html:

name, titleHtml, kicker, lead, howToTexts of the start menu (titleHtml may use <em> for the coloured word).
levelsDifficulty buttons: [key, label, hint]. The keys are the computer levels the game knows: normal, hard.
defaultLevelLevel selected on the first visit (the player's last choice is remembered).
hotseattrue = show the "2 Players · same device" button.
playersNames used for the two players in two-player mode.
backUrl (optional)Adds a "← All games" link to the start menu, e.g. back to your games page.

Colours: --acc and --acc2 in the <style> line of index.html; --menu-bg is the menu background picture.

Customise & rebrand

Gameplay settings live near the top of game/games/backgammon/game.js. Search for these names:

GEOBoard geometry (point width, bar, trays).
FILESSound effect file names.
DICE_MSDice throw duration.
rules.jsRules engine: move generation and scoring.

Art and sound

Replace files in game/games/backgammon/assets/ with your own, keeping the same file names and formats (WebP images, MP3 sound, GLB models).

Name and credit

Change the <title>, the meta description and the menu texts in index.html. The small "Made by Vortaxis Studio" credit may be kept or removed.

Embed in a page

<iframe src="/games/backgammon/index.html" title="Backgammon"
        width="100%" height="680" allow="fullscreen; autoplay"
        style="border:0;border-radius:16px"></iframe>

Game portals (CrazyGames, Poki, itch.io and similar) accept the game/ folder as an HTML5 upload; add their SDK calls in host.js (start, result, pause).

FAQ

Does it need a server or database?

No. It is static HTML, CSS and JavaScript. Any web host works; it plays fully offline once loaded.

Is there online multiplayer?

Not out of the box: you play against the computer or with a friend on the same device. The game code accepts a multiplayer adapter (ctx.multiplayer: sendMove / onMove), so online play can be added with your own real-time server — we can quote it as custom work.

Can I change the art, colours and texts?

Yes. Texts and colours are in index.html, gameplay values near the top of game.js, and all pictures, models and sounds are plain files you can replace.

Does it work on phones?

Yes — touch, mouse and keyboard controls, portrait and landscape, high-DPI screens.

What is the difference between Licence and Full source?

Licence = one end product (yours or one client's). Full source = one production domain for you and your clients, including white-label, paid games and SaaS. Neither allows reselling the game or its source on its own.

Can I put it on game portals and show ads?

Yes, in your own end product. Add the portal or ad SDK calls in host.js.

Support & updates

Updates are free. Questions are answered for 6 months after purchase (12 months with Full source) — write to hello@vortaxis.com or use vortaxis.com/store. Need a custom version (your art, online play, leaderboards, a portal SDK)? Ask for a quote.

Licence and production activation

Single-domain and Full-source purchases each activate one production hostname. Full source adds editable code, white-label and SaaS rights; it does not include unlimited installations or redistribution. Localhost and .test development hosts are allowed.

Set the delivered key and production hostname in LICENSING/licence.json. Use https://vortaxis.com/licence/ to view activation or request a domain transfer. Vortaxis Studio approves replacement domains. Production activation requires a network connection; public demos remain unrestricted.

See LICENSE.txt for the complete terms. Existing purchases retain their original terms.