Moddable Games Tools

Moddable.Games

Creating games you already own.

A multi-page marketing site and tools platform for an open-source board game modding workshop. Ten mods. Three original games. Two open-source engines. One Discord.

---

Stack

HTML + Vanilla JS + Zero dependencies + Zero build step

Modular JS architecture: one loader (js/mg-loader.js) loads 12 shared modules + page-specific scripts. Zero inline scripts or styles.

---

Routes

---

Run locally

python3 -m http.server 8000

Open http://localhost:8000/. Clean URLs, no .html extensions.

---

Deploy to GitHub Pages

1. Push to GitHub
2. Settings → Pages → Deploy from main branch, root folder
3. Update the tag across pages to match your deploy path:

---

Design system

#d11a1a  red         Total conversion / Nukes

#3a9928 green Rebalance / Mongo / Endless Skies #0c4f8d blue Reskin / TI tools #0a0d2a cosmicDeep Hero backgrounds #f5f4ef canvasLight Warm off-white sections (not pure white) #14161c ink Primary text on light

Rules: No drop shadows. Pill buttons only. One RGB primary per surface. Hex grid SVG overlay on all dark heroes.

---

JS Architecture

js/

├── mg-loader.js ← entry point, loads all modules ├── mg-core.js ← tokens, el(), url(), MG.data (fetch layer) ├── mg-buttons.js ← btn(), linkBtn() ├── mg-cards.js ← modCard(), pageHero() ├── mg-navbar.js ← navbar() ├── mg-footer.js ← footer() ├── mg-search.js ← global Cmd+K search ├── mg-animations.js ← scroll reveal + TOC spy ├── mg-mods-content.js ← mod page content (rules, components, etc.) ├── mg-mod-page.js ← data-driven mod detail renderer ├── mg-news-article-page.js ← shared news article renderer └── mg-*-page.js ← page-specific scripts (home, tools, etc.)

data/ ├── mods.json ← mod library (10 entries) ├── games.json ← games (3 entries) ├── engines.json ← engine listings (2 entries) ├── mcp-tools.json ← MCP tool registry (50 tools, 7 namespaces) ├── news.json ← news posts (13 entries) └── team.json ← team members (4 entries)

Pages load mg-loader.js (shared modules) + their own page script. Data is fetched via MG.data.get('mods') → Promise, or MG.data.get('mod', 'slug') for single items. Legacy MG.data.load(['mods','news']).then(store => {...}) still works.

---

Changelog

2026-07-22

• Added Maze Rats (94 procedural tables) to oracle pipeline and oracles page
• Encounter Builder now supports D&D 5e and Pathfinder 1e via system selector
• Discord /encounter command uses autocomplete for future-proof system selection
• Rebuilt rules-index.json (8,426 entries across 41 games, added table-type indexing)
• MCP Worker bumped to v1.7.0

2026-07-20

• Added GA4 analytics tracking to all untracked interactive modules
• API playground: tool select, category expand, tool run events
• Hex embed: layout, size, player, style changes and map generation
• TI Dashboard: game start, strategy picks, pass, Mecatol claims, agenda draw/resolve, game over
• Registered tool_name custom dimension in GA4 for per-MCP-tool breakdowns
• D&D Encounter Builder, Discord oracle commands, and /test suite (from prior session)
• Closed issues #131, #132, #135

2026-06-10

• Deployed MCP tools server at tools.moddable.games (42 AI-callable tools across 6 namespaces)
• Serves MCP protocol (SSE), REST API, llms.txt, OpenAPI 3.1, .well-known/mcp.json discovery
• New /developers/ section: landing page + /api/ sub-page + /examples/ sub-page
• Purple section accent (#8b5cf6), SVG hero feature, unique OG images
• Homepage "For Developers" band between Featured Mod and Nukes sections
• Nav reordered: Mods, Engines, Games, Tools, Developers, About, News (SVG/cube alternation)
• Added dice_roll and ti4_random_factions as site-native tools
• Puzzle generation uses pre-computed pool (Cloudflare Workers free tier)
• AI Integration sections added to chess.moddable.games and hex.moddable.games
• Favicon and full OG/Twitter meta tags on tools.moddable.games Worker

2026-06-09

• TI4 Objective Tracker: full game-session mode with player scoring, secret objectives, bonus VP tracking
• Supports all expansions (base, Prophecy of Kings, Discordant Stars, Thunder's Edge)
• Setup screen with player count, VP target, expansion toggles, and colour assignment
• Scoreboard with progress bars, tabbed interface (public/secrets/bonus), winner detection

2026-06-05

• Unified hero system across all 17 pages with new shared sectionHero() component
• Two-tier design: full cosmic heroes (tier-1 indexes) and reduced sub-page heroes (tier-2)
• Colour system: RGB accents for consistent-sub-page sections, CMYK for divergent ones
• Added parallax scroll with dramatic text fade-out, hex grid zoom, and gradient darkening
• Added animated 3D feature elements: spinning cubes (Tools, Engines, About) and animated SVGs (Mods, Games, News)
• Reordered nav to alternate cube/SVG features: Mods, Engines, Games, Tools, News, About
• Fixed Endless Skies accent (green→blue to match detail page)
• Fixed mods page hash-change filtering from navbar dropdown
• Fixed tools page auto-scrolling to search on load
• Normalised all hero copy: tier-1 gets 2-line titles with single highlighted keyword + 2-line balanced ledes
• Created GitHub issue #81 for static site build system migration
• New assets: hex-grid-purple.svg, hex-grid-cyan.svg, hex-grid-magenta.svg, hex-grid-amber.svg

2026-06-04

• Rewrote Planet Mongo game page from real rulebook (v0.9.0): 4X hex territory control, 8 factions, hidden orders, central market
• Rewrote Endless Skies game page from real rulebook (v0.2.0): 4X worker placement, 8 factions, ship rooms, wormhole network
• Both pages now honestly marked "In development" with no fabricated content
• Removed fake community mods from both pages (no real mods exist yet)
• Deleted dead per-game JS files and custom CSS (pages use shared data-driven renderer)
• Updated meta tags and OG descriptions for both games
• Synced all mod metadata from moddable-rules: versions, taglines, stats, development status
• Replaced Talisman Worlds logo (new circular emblem from moddable-rules, properly on 410x410 canvas)
• Fixed Talisman Worlds hero title (was still "Talisman: Hexed")
• Replaced fabricated Econopoly content with real rulebook mechanics (resources, VP, choose-your-action)
• Replaced fabricated Hyper Imperium content with real mechanics (3D exploration, promissory trades, mercenary builder)
• Rewrote games-sync.json from actual rulebook front matter (all entries were stale)
• Added RGB cube placeholder logo for all 6 community mods (#61 partial)
• Closed #25 (mod download links complete on website side), #78, #79

2026-06-02

• Synced MCE to v0.7.1 / 70 variants (from v0.6.8 / 64): stats, features, consumer APIs, developer guides
• Moved Dungeon Chess from /games/ to /mods/ — it's a total conversion of chess, not an original game
• Added news article: "Building Games on Chess" (MCE v0.7.1 consumer APIs + DC v1.2.0 renderer migration)
• Rewrote Nukes game page from actual moddable-rules rulebook (removed all hallucinated content)
• Added game logos to games index cards (410x410 normalized PNGs)
• Updated all counts site-wide: 10 mods, 3 games, 13 news articles
• Regenerated OG images for games page and new article
• Added .game-card__logo CSS for logo thumbnails in game/mod cards
• Fixed body text centering in games engines callout section
• Created issues #78 (Mongo sync) and #79 (Endless Skies sync) for future rulebook rewrites
• Bumped to v1.0.60

2026-05-28

• Synced chess engine stats from moddable-chess v0.6.8: variant count 39/54→64, engine version, board types
• Updated all stale chess references across 9 files (engines page, tools page, news cards, data files)
• Added Colony as 4th hexmaps-powered game across engines page, stats, and consumer listings (#71)
• TI4 tools: added Discordant Stars + Thunder's Edge expansions (36 factions, 26 objectives, 20 agendas) (#68)
• Galaxy map generator: replaced player count dropdown with 7 official TI4 layout variants (3p–8p + Hyper Imperium)
• Hexmap embed: added style selector (Artistic/Classic/Kenney/Realistic per game) with consistent URL params
• Hexmap embed: postMessage bridge for "New map" regeneration without iframe reload
• New Dice Lab at /tools/dice/ — dice roller + battle simulators for Risk, TI4, Axis & Allies, X-Wing, Blood Bowl, Memoir '44, Custom (#67)
• Merged dice roller from tools index into Dice Lab as first tab
• Removed strike planner widget from Nukes tools (redundant with full hexmaps embed)
• Removed Hex Map Generator card from tools index (belongs under Engines, not Tools)
• Updated "Games supported" count 3→4 on all hexmaps engine bands
• Footer column titles now clickable links to their respective index pages
• Renamed "Mod-specific tools" → "Per-game tools" with consistent spacing and anchors
• Tab selection persists in URL hash (/tools/dice/#risk) for sharing
• Mod detail page TOC scroll-spy fixed (calls initTocSpy after dynamic render)
• Mod buttons wired up with real URLs: rules.moddable.games, BGG, Wikipedia, itch.io (#25 Part 1)
• Removed Nuke Catan mod (invented, no supporting material) — homepage section now links to Nukes game + nuking-catan article
• Related mods auto-derived from category/baseGame (no more hardcoded arrays)
• Fixed mod/game counts: 9 mods, 4 games across all references

2026-05-27

• New tools: Resource Dashboard, Bag Tracker, Role Distributor (all fully configurable with game presets)
• Removed: Map Grid Generator (redundant), Voting Booth (needs server), Combat Odds (rebuilt as Dice Lab #67)
• Fixed invisible buttons on tools page (wrong variants for light backgrounds)
• Tools index: added Hex Map Generator card, updated mod-specific card descriptions
• Hexmaps tools card links to engine page (not external generator)
• Nukes game page: added "Generate Map" hero CTA
• Embed moddable-hexmaps engine in tools pages: /tools/nukes/, /tools/talisman/, /tools/ti/ (#62)
• Shared embed module (js/mg-hexmap-embed.js) + CSS (css/tools-hexmaps.css)
• "Powered by Moddable Hexmaps" engine band on all three pages
• Seed sharing via URL params works through iframe
• New /engines/ section: top-level nav item, index page, Moddable Chess + Moddable Hexmaps pages
• Reclassified Chess and Hexmaps from "Games" to "Engines" — they're SDKs, not games
• Nav updated: Mods | Games | Engines | Tools | News | About
• Moved /games/moddable-chess/ → /engines/moddable-chess/ (old URL r