games.moddable.tools/moddable-games-tools

Official39 tools

by Moddable-Games · JavaScript

Moddable Games Tools

15 tools for chess variant analysis, hex map generation, and board game utilities

Analyze chess variants, generate hex maps, and provide board game utilities.

Captured live from the server via tools/list.

chess_list_variants

List all available chess variants with their descriptions, board sizes, and rules.

Parameters (1)

groupstring
Filter by group name (Classic, Tactical, Alternate Rules, Asymmetric, Small Boards, Large Boards). Omit for all.

chess_get_legal_moves

Get all legal moves for the current position. Returns moves in algebraic notation with annotations (capture, promotion, castling, etc).

Parameters (2)

variantstring
Variant key (e.g. "standard", "atomic", "capablanca"). Defaults to "standard".
fenstring
FEN string of the position. Omit to use the variant starting position.

chess_analyze_position

Evaluate a chess position using the engine. Returns a score (centipawns from the side to move), best move, and the principal variation.

Parameters (3)

variantstring
Variant key. Defaults to "standard".
fenstring
FEN string. Omit for starting position.
depthnumber
Search depth (1-6). Higher is slower but more accurate. Defaults to 4.

chess_validate_move

Check whether a specific move is legal in the current position. Returns legal/illegal with explanation.

Parameters (3)

variantstring
Variant key. Defaults to "standard".
fenstring
FEN string. Omit for starting position.
movestringrequired
Move in coordinate notation (e.g. "e2e4", "e7e8q" for promotion).

chess_make_moves

Play a sequence of moves from a position and return the resulting FEN, game status, and move list.

Parameters (3)

variantstring
Variant key. Defaults to "standard".
fenstring
Starting FEN. Omit for variant start position.
movesarrayrequired
Moves in coordinate notation (e.g. ["e2e4", "e7e5", "g1f3"]).

chess_get_opening_book

Look up opening book moves for a position. Returns known good continuations from the variant opening book.

Parameters (2)

variantstring
Variant key. Defaults to "standard".
fenstring
FEN string. Omit for starting position.

chess_render_svg

Render a board position as a self-contained SVG string. No DOM or browser APIs required. Works in Cloudflare Workers.

Parameters (5)

variantstring
Variant key (e.g. "standard", "grand", "capablanca"). Defaults to "standard".
fenstring
FEN string of the position. Omit to use the variant starting position.
themestring
Board colour theme. Defaults to "classic".
highlightsarray
Squares to highlight (algebraic notation, e.g. ["e2", "e4"] for last move).
sizenumber
Board width in pixels. Height is derived from rows. Defaults to 480.

chess_generate_puzzle

Serve a random chess puzzle from a pool of 1,557 pre-generated puzzles across 66 variants (plus standard). Returns position, solution, metadata, and an SVG board image. Use chess_list_puzzle_types to discover available variant:type combinations.

Parameters (6)

variantstring
Variant key (e.g. "standard", "atomic", "racingKings") or "random" for a surprise variant. Defaults to "standard". Use chess_list_puzzle_types to see all available variants.
typestring
Puzzle type (e.g. "mate-in-1", "detonate-in-1", "sacrifice-your-king"). Defaults to the first available type for the variant. Use chess_list_puzzle_types to see all types.
rating_minnumber
Minimum puzzle rating filter (Lichess rating scale). Omit for no minimum.
rating_maxnumber
Maximum puzzle rating filter. Omit for no maximum.
themestring
Filter by puzzle theme (e.g. "backRankMate", "sacrifice", "endgame"). Only applies to Lichess-sourced puzzles.
include_svgboolean
Include an SVG board render of the puzzle position. Defaults to true.

hex_list_games

List all available hex map games with their map types, layouts, sizes, and style options.

No parameters.

hex_generate_map

Generate a hex map for a given game. Returns the full hex grid with terrain types, coordinates, and metadata.

Parameters (5)

gamestringrequired
Game key (e.g. "nukes", "colony", "twilight", "talisman", "mongo", "endless").
seedstring
Seed string for reproducible generation. Omit for a default seed.
sizenumber
Map size (ring count). Meaning varies by game. Omit for the game default.
playersnumber
Player count. Omit or 0 for no player bases.
layoutstring
Layout variant (e.g. "standard", "expanded", "6p"). Only for games with multiple layouts.

hex_get_info

Get detailed information about a specific hex coordinate on a generated map: terrain type, neighbors, and distances to other hexes.

Parameters (7)

gamestringrequired
Game key.
seedstring
Seed used to generate the map.
sizenumber
Map size.
playersnumber
Player count.
layoutstring
Layout variant.
qnumberrequired
Axial q coordinate of the target hex.
rnumberrequired
Axial r coordinate of the target hex.

hex_compute_fov

Compute field-of-view from a hex position: all hexes visible within a given range, respecting line-of-sight through the grid.

Parameters (9)

gamestringrequired
Game key.
seedstring
Seed used to generate the map.
sizenumber
Map size.
playersnumber
Player count.
layoutstring
Layout variant.
qnumberrequired
Axial q coordinate of the observer.
rnumberrequired
Axial r coordinate of the observer.
rangenumber
Vision range in hex steps (default 3).
blockingarray
Terrain types that block line of sight (e.g. ["mount", "mountains"]). Defaults to none.

hex_export_svg

Export a generated hex map as an SVG string for rendering or embedding.

Parameters (8)

gamestringrequired
Game key.
seedstring
Seed used to generate the map.
sizenumber
Map size.
playersnumber
Player count.
layoutstring
Layout variant.
hexSizenumber
Hex radius in pixels (default from game config).
labelsboolean
Show terrain labels on hexes (default false).
bgColorstring
Background colour (e.g. "#1a1a2e"). Omit for transparent.

hex_pathfind

Find the shortest path between two hexes on a generated map using breadth-first search. Optionally specify impassable terrain types.

Parameters (10)

gamestringrequired
Game key.
seedstring
Seed used to generate the map.
sizenumber
Map size.
playersnumber
Player count.
layoutstring
Layout variant.
fromQnumberrequired
Start hex axial q.
fromRnumberrequired
Start hex axial r.
toQnumberrequired
End hex axial q.
toRnumberrequired
End hex axial r.
impassablearray
Terrain types that cannot be traversed (e.g. ["water", "mount"]). Defaults to none.

rules_list_games

List all game families in the Moddable Games rules library. Returns titles, player counts, variant counts, and URLs.

Parameters (1)

statusstring
Filter by status. "published" (default) shows all published games, "live" shows only fully released, "all" includes unpublished.

rules_get_game

Get full metadata and variant list for a specific game family. Returns players, duration, tagline, variant names, and rules URL.

Parameters (1)

slugstringrequired
Game slug (e.g. "backgammon", "draughts", "nukes", "moddable-chess"). Use rules_list_games to see all.

rules_get_variant

Get rules content for a specific variant within a game family. Returns headings, rules text, and direct URL.

Parameters (2)

gamestringrequired
Game family slug (e.g. "backgammon", "draughts").
variantstringrequired
Variant name (e.g. "Acey-Deucey", "Standard Rules", "German Draughts"). Partial match supported.

rules_search

Search the entire rules library by keyword. Returns matching entries ranked by relevance across all games and variants.

Parameters (2)

querystringrequired
Search query (e.g. "capture", "dice", "promotion", "4 players").
limitnumber
Max results to return (default 10, max 50).

rules_random

Pick a random game or variant from the library. Optionally constrain to a specific game family for a random variant within it.

Parameters (1)

familystring
Optional game family slug to pick a random variant from (e.g. "backgammon" for a random backgammon variant).

ti4_draw_objectives

Draw random public objectives for a Twilight Imperium 4e game round. Supports expansion filtering.

Parameters (3)

stagenumber
Stage 1 or Stage 2. Defaults to 1.
countnumber
Number of objectives to draw (default 5).
expansionsarray
Expansions to include: "base", "pok", "ds", "te". Defaults to ["base","pok"].

ti4_draw_agendas

Draw random agenda cards for a Twilight Imperium 4e agenda phase. Returns for/against text.

Parameters (2)

countnumber
Number of agendas to draw (default 2).
expansionsarray
Expansions to include: "base", "ds", "te". Defaults to ["base"].

ti4_draft_factions

Run a Milty-style faction draft: deal N factions per player to choose from. Supports ban lists.

Parameters (4)

playersnumber
Number of players (3-8). Defaults to 6.
pool_sizenumber
Factions dealt to each player to pick from (default 3).
expansionsarray
Expansions: "base","pok","ds","te","codex". Defaults to ["base","pok"].
banarray
Faction names to exclude from the draft.

nukes_setup_generator

Generate random starting positions for a Nukes game. Assigns territories to players on a generated hex map.

Parameters (2)

playersnumber
Number of players (2-6). Defaults to 3.
seedstring
Map seed for reproducible setups.

colony_dice_odds

Calculate probability of each resource number being rolled on 2d6. Returns the odds table and expected output for a given board position.

Parameters (1)

numbersarray
Array of numbers on your settlements (e.g. [5, 6, 8, 9, 11]). Returns probability of rolling at least one.

mancala_simulate_move

Simulate a mancala move: sow seeds from a pit and return the resulting board state. Supports Oware and Kalah rules.

Parameters (3)

boardarrayrequired
Array of 14 values: pits[0-5] = player 1, pit[6] = store 1, pits[7-12] = player 2, pit[13] = store 2.
pitnumberrequired
Pit index (0-5 for player 1, 7-12 for player 2) to sow from.
variantstring
Rule variant. Defaults to "kalah".

mancala_legal_moves

List legal moves for the current player in a mancala position.

Parameters (2)

boardarrayrequired
Array of 14 values (same format as mancala_simulate_move).
playernumber
Which player to move (1 or 2). Defaults to 1.

morris_legal_moves

List legal moves in a Nine Men's Morris position. Handles placement, sliding, and flying phases.

Parameters (4)

boardarrayrequired
Array of 24 values (0=empty, 1=player1, 2=player2) for the 24 intersections.
playernumberrequired
Which player to move.
phasestring
Game phase. "place" during initial placement, "slide" during normal play, "fly" when player has 3 pieces.
pieces_in_handnumber
Pieces not yet placed (0-9). Required during place phase.

morris_detect_mill

Check if a placement/move forms a mill (three in a row) in Nine Men's Morris.

Parameters (3)

boardarrayrequired
Array of 24 intersection values.
positionnumberrequired
The intersection index (0-23) to check for mills.
playernumberrequired
Which player to check.

ur_roll_dice

Roll the four tetrahedral dice for the Royal Game of Ur. Each die has 2 marked corners (50% chance). Sum is 0-4.

No parameters.

ur_legal_moves

List legal moves for a Royal Game of Ur position given a dice roll.

Parameters (4)

boardarrayrequired
Array of 14 track positions (0=empty, 1=player1, 2=player2). Indices 0-13 represent the shared track.
playernumberrequired
Which player to move.
rollnumberrequired
Dice roll result (0-4).
pieces_homearray
Pieces at home for each player [p1, p2].

pachisi_roll_cowries

Roll cowrie shells for Pachisi/Chaupar. 6 shells, count faces up. Special values: 0 faces = 25 (grace), 1 face = 10 (grace).

Parameters (2)

shellsnumber
Number of cowrie shells (default 6). Pachisi uses 6, Chaupar uses 3 long dice.
gamestring
Which game rules to apply. Defaults to "pachisi".

chess_list_puzzle_types

List all available puzzle types in the pool with counts. Returns variant:type keys, total puzzles per key, and rating ranges. Use this to discover what puzzles are available before calling chess_generate_puzzle.

Parameters (1)

variantstring
Filter to a specific variant (e.g. "standard", "atomic"). Omit to see all variants.

dice_roll

Roll dice using standard notation (e.g. "2d6+3", "4d8-1", "d20"). Supports any combination of dice, modifiers, and multiple pools.

Parameters (1)

notationstringrequired
Dice notation (e.g. "2d6+3", "4d8", "d20+5", "3d6"). Multiple pools separated by commas.

ti4_random_factions

Generate random faction assignments for a Twilight Imperium 4e game. Supports base game and Prophecy of Kings expansion.

Parameters (2)

playersnumber
Number of players (3-8). Defaults to 6.
expansionstring
Include Prophecy of Kings factions. Defaults to "pok".

coin_flip

Flip a coin or pick randomly from a list of options. Use for quick binary decisions or random selection.

Parameters (1)

optionsarray
Custom options to pick from (e.g. ["pizza","tacos","sushi"]). Defaults to ["heads","tails"].

team_split

Randomly split a list of players into balanced teams. Handles odd numbers gracefully.

Parameters (2)

playersarrayrequired
Player names to split into teams.
teamsnumber
Number of teams (default 2).

jam_status

Get the current Mod Jam status: active/inactive, theme, base game, time remaining, and submission count.

No parameters.

jam_timer

Get the countdown timer for the current Mod Jam phase (voting, building, or judging).

No parameters.

jam_vote

Get current vote standings for the active Mod Jam vote. Returns anonymised tallies per option.

No parameters.

README.md20 KBView on GitHub

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

code

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

URL	Page
`/`	Home
`/mods/`	Filterable mod library
`/mods/[slug]/`	10 mod detail pages (incl. Dungeon Chess)
`/games/`	Games hub
`/games/nukes/`	Nukes
`/games/mongo/`	Mongo
`/games/endless-skies/`	Endless Skies
`/engines/`	Engines hub
`/engines/moddable-chess/`	Moddable Chess engine
`/engines/moddable-hexmaps/`	Moddable Hexmaps engine
`/developers/`	Developers / Tools API
`/news/`	News index
`/news/[slug]/`	13 article pages
`/tools/`	Tools hub (dice, names, scores)
`/tools/ti/`	Twilight Imperium tools
`/tools/talisman/`	Talisman tools
`/tools/nukes/`	Nukes tools
`/submit/`	Mod submission form
`/about/`	About
`/about/roadmap/`	18-month roadmap
`/team/`	Team
`/community/`	Community / Discord

Run locally

bash

python3 -m http.server 8000

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

Deploy to GitHub Pages

Push to GitHub
Settings → Pages → Deploy from main branch, root folder
Update the <meta name="mg-base"> tag across pages to match your deploy path:

Scenario	`mg-base` value
Custom domain (root)	(remove the tag)
`username.github.io` repo	(remove the tag)
Project repo (`/repo-name/`)	`/repo-name`

Design system


Display	Inter Tight 500–700
Body	Inter 400–700
Mono	JetBrains Mono 400–600
Pixel	Press Start 2P (eyebrows only)

code

#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

code

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 (42 tools, 6 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-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 redirects)
Created /engines/moddable-hexmaps/ showcase page (green accent, no embed yet — pending hexmaps#7)
Footer, search, tools chess page, news.json all updated to new paths
Games index: removed chess, added "Powered by our engines" callout
Created data/engines.json as data source for engine listings
Cross-project issues: moddable-chess#47, moddable-hexmaps#17
Fix homepage crash: "Fog of War Chess" removed from mods.json but still referenced in homepage featured list
Fix hero parallax spilling past section boundary — wrap in overflow:hidden container
Fix home-tabs nav hidden under section above — remove overflow:hidden that clipped negative margin
Bump version 1.0.29 → 1.0.30 (was missing from previous commit)
News articles: author sidebar card with breakout team photo, name, role, profile link
News articles: real share links (X, Facebook, LinkedIn, copy URL)
News articles: all 12 posts now have callout cards with real links (no more dead # hrefs)
News articles: hybrid auto-derive callout from tags when no manual modCard specified
News articles: improved right rail spacing (topics, mod card)
Added teamSlug field to all news posts — author rendered from team.json, not hardcoded
Per-team-member OG images with breakout photo + shadow slit effect
Replaced 16 template OG images: 10 mod pages (hex-grid cards) + 6 tool pages (geometric icons)
OG scripts data-driven: build/gen-mod-og.py (reads mods.json), build/gen-tools-og.py
Mod logos: added logo field to mods.json, logos display on cards, detail heroes, and OG images
Copied Talisman: Hexed + Econopoly logos from moddable-rules; Hyper Imperium already had one
Fix mod detail page hero never rendering (DOMContentLoaded race condition)
Component list styling: accent-coloured outlined bullets, better spacing
Generated ALL remaining OG images — zero template placeholders left (closes #53)
4 build scripts for future regeneration: gen-team-og.py, gen-mod-og.py, gen-tools-og.py, gen-remaining-og.py
Created #61 (missing mod/tool logos) and moddable-chess#44 (board themes)

2026-05-26

Update chess variant count 20→39 across all pages (closes #55, #54)
Remove dead mg-game-dungeon-chess-page.js — orphaned file not loaded anywhere (closes #52)
Fix inline style="display:none" on chess tools page → CSS class with classList toggle
Refactor navbar, footer, and cards from inline style:{} objects to dedicated CSS files
New files: css/navbar.css, css/footer.css, css/cards.css (63 rules total)
Loader auto-injects component CSS via document.write — no per-page HTML changes needed
Only data-driven dynamic values (accent colors, image URLs) remain as inline style strings

2026-05-24

Added per-page OG/Twitter meta tags via build/stamp-meta.py (closes #35)
Fleshed out 4 stub pages: /press (stat cards, swatches, assets), /subscribe (form + success state), /tools/decks (deck builder), /tools/chess (variant picker)
Added all new pages to navbar dropdowns, footer links, and tools index
Created new Moddable-Games/moddable-chess repo — shared chess engine with 14 variants
Renamed existing chess repo to Moddable-Games/dungeon-chess
Added favicon set (SVG + PNG), apple-touch-icon, PWA manifest, theme-color (closes #8)
Added CNAME for web.moddable.games, production OG URLs, GitHub Pages ready (closes #9)
47 branded OG social images generated for all pages
Auto-detect local dev path from URL — no manual mg-base meta tag needed
Responsive design audit: mobile breakpoints across 11 CSS files (closes #6)
ARIA landmarks, skip-to-content link, aria-current=page on nav (closes #24)
Fixed placeholder # links — community channels now non-link divs (closes #26)
TI4 agenda voter expanded: 6 → 46 cards, full base game deck (closes #3)
Accessibility: stone colour darkened for WCAG AA contrast (closes #11)
Performance: lazy-load below-fold images (closes #14)
Tools interactivity audit: all widgets verified functional (closes #27)
Repo made public, GitHub Pages live at web.moddable.games
Team member detail pages with authored posts, long bios, teammate links (closes #32)

2026-05-25

Rebuild Nukes tools (#49): strike planner, combat calculator, hostage tracker, unit reference — based on real rulebook
Chess tools: 20 playable variants (added No Castling, Torpedo, Horde, Extinction, Breakthrough, Maharaja)
Chess game page: stats reflect v0.4.2 engine, CTAs link to chess.moddable.games, 6-category variant grid
Fix nav dropdowns clipped by overflow:hidden on header
Featured card style (dark bg) for Dungeon Chess on Moddable Chess page
Hero cube centred on mobile
Fix mobile nav: drawer hidden on load, prevent horizontal overflow
Fix homepage hero bg repeating on mobile
Fix team page pop-out overlap on mobile (increased row-gap)
Version system: bump.sh single-source from version.txt, footer displays version
Cache-busting ?v= on all CSS/JS loads across 52 HTML files
Removed fan-made disclaimer from footer (to licensing page later)
Chess embed: live playable board via iframe from chess.moddable.games
Chess engine params: theme=light, boardonly=1, bg=, accent=, radius=
Match setup: mode selector (vs AI / Pass & Play), player names passed to engine
Dynamic iframe aspect ratio from variant board dimensions
Chess engine promo: full-width dark band section with USPs
Press kit: styled bullet lists as bordered accent cards
Auto-detect local moddable-chess path for iframe testing

2026-05-23

Refactored MG.data to Promise-based API: get(name) → Promise, get(type, slug) → single item lookup
Deduplicates in-flight fetches (no double-requests for same resource)
Removed ready() method (unused); load() kept for backward compat
Fixed responsive team page: breakout images scale down on mobile (≤600px)
Search index loads news asynchronously on first open (no longer relies on sync cache)
Templated all 13 mod pages — identical HTML shells, hero rendered from data
Extracted all 12 news article bodies to data/articles/{slug}.html partials
Article metadata (author, lede, TOC, modCard) moved into data/news.json
News page shells are now identical templates — full page rendered by JS
Created issue #35 for per-page Open Graph / Twitter meta tags

2026-05-22

Extracted all data from JS modules to JSON files (data/mods.json, games.json, news.json, team.json)
Added MG.data fetch layer in mg-core.js — async load()/get() pattern
Removed 4 data JS modules (mg-mods-data.js, mg-games-data.js, mg-news-data.js, mg-team-data.js)
Updated all consumer scripts to use MG.data.load().then() pattern
Added text-wrap: pretty to global CSS resets for orphan prevention
Redesigned tools page: filterable card grid with category bar (Game Night, Planning, Creative, Mod-Specific)
Converted 3 dark-themed tool widgets (Dice, Timer, Seating) to unified light card style
Added 3D spinning CSS dice to tools hero section
Redesigned team page with photo avatars breaking out of cards (4-column grid)
Removed font-test.html

2026-05-21

Extracted ALL inline scripts to external JS files (zero remain across 45 pages)
Created data-driven mod page renderer (mg-mod-page.js + mg-mods-content.js)
Created shared news article renderer (mg-news-article-page.js with data-toc)
Extracted team data to mg-team-data.js
Added TOC scroll-spy with accent colour highlighting
Added global rule: no inline <script> blocks (matches no inline styles)
Net: -5220 lines of inline JS removed, +3537 lines in proper external modules

2026-05-20

Extracted mods and games data into shared JS modules (mg-mods-data.js, mg-games-data.js)
Extracted all inline styles to external CSS files; complete JS module split
Split _mg.js into semantic modules (core, components, animations)
Added global search (Cmd+K) and made mod cards fully clickable
Scroll-reveal animation system, hero entrance choreography, button micro-interactions
Game page heroes: two-column layout with floating logos
Homepage: nuked-family illustration, Hyper Imperium logo, glowing section dividers
All 12 news articles created from WordPress, news index linked correctly
Nav dropdowns upgraded with animation and blue accent states
Removed all inline style attributes; semantic BEM class system throughout
Created 12 mod detail pages, games hub, Moddable Chess, Dungeon Chess, roadmap
Fixed double-url bug, removed redundant nav items, cleaned unused assets

2026-05-19

Restructured for clean URLs and GitHub Pages deployment
Initial site commit

License

MIT

Install

claude_desktop_config.json

{
  "mcpServers": {
    "moddable-games-tools": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://tools.moddable.games/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.