Moddable Games Tools

Official56 toolsLive

by Moddable-Games · JavaScript

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

This MCP server provides a tools-oriented platform for an open-source board game modding workshop. The catalog entry describes 15 tools supporting chess variant analysis, hex map generation, and board game utilities. The referenced tool suite totals 56 tools and is paired with a modular web stack and defined routes.

🛠️ Key Features

15 tools for chess variant analysis, hex map generation, and board game utilities
Tool suite size reported as 56 tools
Modular JavaScript loader architecture (12 shared modules plus page-specific scripts)
Routes include /, /mods/, and /mods/[slug]/ pages

🚀 Use Cases

Analyze chess variants
Generate hex maps
Use board game utilities within a modding workflow

⚡ Developer Benefits

HTML + Vanilla JS with zero dependencies and zero build step
Modular JS architecture using js/mg-loader.js
Filterable mod library at /mods/

⚠️ Limitations

Provided description specifies routes and tooling context, but does not document individual tool interfaces.

Captured live from the server via tools/list.

chess_list_variants

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

Parameters1

group

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "group": {
      "type": "string",
      "description": "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).

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "Variant key (e.g. \"standard\", \"atomic\", \"capablanca\"). Defaults to \"standard\"."
    },
    "fen": {
      "type": "string",
      "description": "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.

Parameters3

variant	string	optional	Variant key. Defaults to "standard".
fen	string	optional	FEN string. Omit for starting position.
depth	number	optional	Search depth (1-6). Higher is slower but more accurate. Defaults to 4.

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "Variant key. Defaults to \"standard\"."
    },
    "fen": {
      "type": "string",
      "description": "FEN string. Omit for starting position."
    },
    "depth": {
      "type": "number",
      "description": "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.

Parameters3

variant	string	optional	Variant key. Defaults to "standard".
fen	string	optional	FEN string. Omit for starting position.
move	string	required	Move in coordinate notation (e.g. "e2e4", "e7e8q" for promotion).

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "Variant key. Defaults to \"standard\"."
    },
    "fen": {
      "type": "string",
      "description": "FEN string. Omit for starting position."
    },
    "move": {
      "type": "string",
      "description": "Move in coordinate notation (e.g. \"e2e4\", \"e7e8q\" for promotion)."
    }
  },
  "required": [
    "move"
  ]
}

chess_make_moves

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

Parameters3

variant	string	optional	Variant key. Defaults to "standard".
fen	string	optional	Starting FEN. Omit for variant start position.
moves	array	required	Moves in coordinate notation (e.g. ["e2e4", "e7e5", "g1f3"]).

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "Variant key. Defaults to \"standard\"."
    },
    "fen": {
      "type": "string",
      "description": "Starting FEN. Omit for variant start position."
    },
    "moves": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Moves in coordinate notation (e.g. [\"e2e4\", \"e7e5\", \"g1f3\"])."
    }
  },
  "required": [
    "moves"
  ]
}

chess_get_opening_book

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

Parameters2

variant	string	optional	Variant key. Defaults to "standard".
fen	string	optional	FEN string. Omit for starting position.

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "Variant key. Defaults to \"standard\"."
    },
    "fen": {
      "type": "string",
      "description": "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.

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "Variant key (e.g. \"standard\", \"grand\", \"capablanca\"). Defaults to \"standard\"."
    },
    "fen": {
      "type": "string",
      "description": "FEN string of the position. Omit to use the variant starting position."
    },
    "theme": {
      "type": "string",
      "enum": [
        "classic",
        "cosmic",
        "wood",
        "marble",
        "neon",
        "minimal"
      ],
      "description": "Board colour theme. Defaults to \"classic\"."
    },
    "highlights": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Squares to highlight (algebraic notation, e.g. [\"e2\", \"e4\"] for last move)."
    },
    "size": {
      "type": "number",
      "description": "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.

Parameters6

variant	string	optional	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.
type	string	optional	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_min	number	optional	Minimum puzzle rating filter (Lichess rating scale). Omit for no minimum.
rating_max	number	optional	Maximum puzzle rating filter. Omit for no maximum.
theme	string	optional	Filter by puzzle theme (e.g. "backRankMate", "sacrifice", "endgame"). Only applies to Lichess-sourced puzzles.
include_svg	boolean	optional	Include an SVG board render of the puzzle position. Defaults to true.

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "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."
    },
    "type": {
      "type": "string",
      "description": "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_min": {
      "type": "number",
      "description": "Minimum puzzle rating filter (Lichess rating scale). Omit for no minimum."
    },
    "rating_max": {
      "type": "number",
      "description": "Maximum puzzle rating filter. Omit for no maximum."
    },
    "theme": {
      "type": "string",
      "description": "Filter by puzzle theme (e.g. \"backRankMate\", \"sacrifice\", \"endgame\"). Only applies to Lichess-sourced puzzles."
    },
    "include_svg": {
      "type": "boolean",
      "description": "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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

hex_generate_map

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

Parameters5

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

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game key (e.g. \"nukes\", \"colony\", \"twilight\", \"talisman\", \"mongo\", \"endless\")."
    },
    "seed": {
      "type": "string",
      "description": "Seed string for reproducible generation. Omit for a default seed."
    },
    "size": {
      "type": "number",
      "description": "Map size (ring count). Meaning varies by game. Omit for the game default."
    },
    "players": {
      "type": "number",
      "description": "Player count. Omit or 0 for no player bases."
    },
    "layout": {
      "type": "string",
      "description": "Layout variant (e.g. \"standard\", \"expanded\", \"6p\"). Only for games with multiple layouts."
    }
  },
  "required": [
    "game"
  ]
}

hex_get_info

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

Parameters7

game	string	required	Game key.
seed	string	optional	Seed used to generate the map.
size	number	optional	Map size.
players	number	optional	Player count.
layout	string	optional	Layout variant.
q	number	required	Axial q coordinate of the target hex.
r	number	required	Axial r coordinate of the target hex.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game key."
    },
    "seed": {
      "type": "string",
      "description": "Seed used to generate the map."
    },
    "size": {
      "type": "number",
      "description": "Map size."
    },
    "players": {
      "type": "number",
      "description": "Player count."
    },
    "layout": {
      "type": "string",
      "description": "Layout variant."
    },
    "q": {
      "type": "number",
      "description": "Axial q coordinate of the target hex."
    },
    "r": {
      "type": "number",
      "description": "Axial r coordinate of the target hex."
    }
  },
  "required": [
    "game",
    "q",
    "r"
  ]
}

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.

Parameters9

game	string	required	Game key.
seed	string	optional	Seed used to generate the map.
size	number	optional	Map size.
players	number	optional	Player count.
layout	string	optional	Layout variant.
q	number	required	Axial q coordinate of the observer.
r	number	required	Axial r coordinate of the observer.
range	number	optional	Vision range in hex steps (default 3).
blocking	array	optional	Terrain types that block line of sight (e.g. ["mount", "mountains"]). Defaults to none.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game key."
    },
    "seed": {
      "type": "string",
      "description": "Seed used to generate the map."
    },
    "size": {
      "type": "number",
      "description": "Map size."
    },
    "players": {
      "type": "number",
      "description": "Player count."
    },
    "layout": {
      "type": "string",
      "description": "Layout variant."
    },
    "q": {
      "type": "number",
      "description": "Axial q coordinate of the observer."
    },
    "r": {
      "type": "number",
      "description": "Axial r coordinate of the observer."
    },
    "range": {
      "type": "number",
      "description": "Vision range in hex steps (default 3)."
    },
    "blocking": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Terrain types that block line of sight (e.g. [\"mount\", \"mountains\"]). Defaults to none."
    }
  },
  "required": [
    "game",
    "q",
    "r"
  ]
}

hex_export_svg

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

Parameters8

game	string	required	Game key.
seed	string	optional	Seed used to generate the map.
size	number	optional	Map size.
players	number	optional	Player count.
layout	string	optional	Layout variant.
hexSize	number	optional	Hex radius in pixels (default from game config).
labels	boolean	optional	Show terrain labels on hexes (default false).
bgColor	string	optional	Background colour (e.g. "#1a1a2e"). Omit for transparent.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game key."
    },
    "seed": {
      "type": "string",
      "description": "Seed used to generate the map."
    },
    "size": {
      "type": "number",
      "description": "Map size."
    },
    "players": {
      "type": "number",
      "description": "Player count."
    },
    "layout": {
      "type": "string",
      "description": "Layout variant."
    },
    "hexSize": {
      "type": "number",
      "description": "Hex radius in pixels (default from game config)."
    },
    "labels": {
      "type": "boolean",
      "description": "Show terrain labels on hexes (default false)."
    },
    "bgColor": {
      "type": "string",
      "description": "Background colour (e.g. \"#1a1a2e\"). Omit for transparent."
    }
  },
  "required": [
    "game"
  ]
}

hex_pathfind

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

Parameters10

game	string	required	Game key.
seed	string	optional	Seed used to generate the map.
size	number	optional	Map size.
players	number	optional	Player count.
layout	string	optional	Layout variant.
fromQ	number	required	Start hex axial q.
fromR	number	required	Start hex axial r.
toQ	number	required	End hex axial q.
toR	number	required	End hex axial r.
impassable	array	optional	Terrain types that cannot be traversed (e.g. ["water", "mount"]). Defaults to none.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game key."
    },
    "seed": {
      "type": "string",
      "description": "Seed used to generate the map."
    },
    "size": {
      "type": "number",
      "description": "Map size."
    },
    "players": {
      "type": "number",
      "description": "Player count."
    },
    "layout": {
      "type": "string",
      "description": "Layout variant."
    },
    "fromQ": {
      "type": "number",
      "description": "Start hex axial q."
    },
    "fromR": {
      "type": "number",
      "description": "Start hex axial r."
    },
    "toQ": {
      "type": "number",
      "description": "End hex axial q."
    },
    "toR": {
      "type": "number",
      "description": "End hex axial r."
    },
    "impassable": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Terrain types that cannot be traversed (e.g. [\"water\", \"mount\"]). Defaults to none."
    }
  },
  "required": [
    "game",
    "fromQ",
    "fromR",
    "toQ",
    "toR"
  ]
}

rules_list_games

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

Parameters1

status

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "status": {
      "type": "string",
      "enum": [
        "published",
        "live",
        "all"
      ],
      "description": "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.

Parameters1

slug

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Game slug (e.g. \"backgammon\", \"draughts\", \"nukes\", \"moddable-chess\"). Use rules_list_games to see all."
    }
  },
  "required": [
    "slug"
  ]
}

rules_get_variant

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game family slug (e.g. \"backgammon\", \"draughts\")."
    },
    "variant": {
      "type": "string",
      "description": "Variant name (e.g. \"Acey-Deucey\", \"Standard Rules\", \"German Draughts\"). Partial match supported."
    }
  },
  "required": [
    "game",
    "variant"
  ]
}

rules_search

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

Parameters2

query	string	required	Search query (e.g. "capture", "dice", "promotion", "4 players").
limit	number	optional	Max results to return (default 10, max 50).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search query (e.g. \"capture\", \"dice\", \"promotion\", \"4 players\")."
    },
    "limit": {
      "type": "number",
      "description": "Max results to return (default 10, max 50)."
    }
  },
  "required": [
    "query"
  ]
}

rules_random

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

Parameters1

family

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "family": {
      "type": "string",
      "description": "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.

Parameters3

stage	number	optional	Stage 1 or Stage 2. Defaults to 1.
count	number	optional	Number of objectives to draw (default 5).
expansions	array	optional	Expansions to include: "base", "pok", "ds", "te". Defaults to ["base","pok"].

Raw schema

{
  "type": "object",
  "properties": {
    "stage": {
      "type": "number",
      "enum": [
        1,
        2
      ],
      "description": "Stage 1 or Stage 2. Defaults to 1."
    },
    "count": {
      "type": "number",
      "description": "Number of objectives to draw (default 5)."
    },
    "expansions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "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.

Parameters2

count	number	optional	Number of agendas to draw (default 2).
expansions	array	optional	Expansions to include: "base", "ds", "te". Defaults to ["base"].

Raw schema

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of agendas to draw (default 2)."
    },
    "expansions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "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.

Parameters4

players	number	optional	Number of players (3-8). Defaults to 6.
pool_size	number	optional	Factions dealt to each player to pick from (default 3).
expansions	array	optional	Expansions: "base","pok","ds","te","codex". Defaults to ["base","pok"].
ban	array	optional	Faction names to exclude from the draft.

Raw schema

{
  "type": "object",
  "properties": {
    "players": {
      "type": "number",
      "description": "Number of players (3-8). Defaults to 6."
    },
    "pool_size": {
      "type": "number",
      "description": "Factions dealt to each player to pick from (default 3)."
    },
    "expansions": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Expansions: \"base\",\"pok\",\"ds\",\"te\",\"codex\". Defaults to [\"base\",\"pok\"]."
    },
    "ban": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "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.

Parameters2

players	number	optional	Number of players (2-6). Defaults to 3.
seed	string	optional	Map seed for reproducible setups.

Raw schema

{
  "type": "object",
  "properties": {
    "players": {
      "type": "number",
      "description": "Number of players (2-6). Defaults to 3."
    },
    "seed": {
      "type": "string",
      "description": "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.

Parameters1

numbers

array

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "numbers": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "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.

Parameters3

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

Raw schema

{
  "type": "object",
  "properties": {
    "board": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Array of 14 values: pits[0-5] = player 1, pit[6] = store 1, pits[7-12] = player 2, pit[13] = store 2."
    },
    "pit": {
      "type": "number",
      "description": "Pit index (0-5 for player 1, 7-12 for player 2) to sow from."
    },
    "variant": {
      "type": "string",
      "enum": [
        "kalah",
        "oware"
      ],
      "description": "Rule variant. Defaults to \"kalah\"."
    }
  },
  "required": [
    "board",
    "pit"
  ]
}

mancala_legal_moves

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

Parameters2

board	array	required	Array of 14 values (same format as mancala_simulate_move).
player	number	optional	Which player to move (1 or 2). Defaults to 1.

Raw schema

{
  "type": "object",
  "properties": {
    "board": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Array of 14 values (same format as mancala_simulate_move)."
    },
    "player": {
      "type": "number",
      "enum": [
        1,
        2
      ],
      "description": "Which player to move (1 or 2). Defaults to 1."
    }
  },
  "required": [
    "board"
  ]
}

morris_legal_moves

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

Parameters4

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

Raw schema

{
  "type": "object",
  "properties": {
    "board": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Array of 24 values (0=empty, 1=player1, 2=player2) for the 24 intersections."
    },
    "player": {
      "type": "number",
      "enum": [
        1,
        2
      ],
      "description": "Which player to move."
    },
    "phase": {
      "type": "string",
      "enum": [
        "place",
        "slide",
        "fly"
      ],
      "description": "Game phase. \"place\" during initial placement, \"slide\" during normal play, \"fly\" when player has 3 pieces."
    },
    "pieces_in_hand": {
      "type": "number",
      "description": "Pieces not yet placed (0-9). Required during place phase."
    }
  },
  "required": [
    "board",
    "player"
  ]
}

morris_detect_mill

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

Parameters3

board	array	required	Array of 24 intersection values.
position	number	required	The intersection index (0-23) to check for mills.
player	number	required	Which player to check.

Raw schema

{
  "type": "object",
  "properties": {
    "board": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Array of 24 intersection values."
    },
    "position": {
      "type": "number",
      "description": "The intersection index (0-23) to check for mills."
    },
    "player": {
      "type": "number",
      "enum": [
        1,
        2
      ],
      "description": "Which player to check."
    }
  },
  "required": [
    "board",
    "position",
    "player"
  ]
}

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.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

ur_legal_moves

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

Parameters4

board	array	required	Array of 14 track positions (0=empty, 1=player1, 2=player2). Indices 0-13 represent the shared track.
player	number	required	Which player to move.
roll	number	required	Dice roll result (0-4).
pieces_home	array	optional	Pieces at home for each player [p1, p2].

Raw schema

{
  "type": "object",
  "properties": {
    "board": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Array of 14 track positions (0=empty, 1=player1, 2=player2). Indices 0-13 represent the shared track."
    },
    "player": {
      "type": "number",
      "enum": [
        1,
        2
      ],
      "description": "Which player to move."
    },
    "roll": {
      "type": "number",
      "description": "Dice roll result (0-4)."
    },
    "pieces_home": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Pieces at home for each player [p1, p2]."
    }
  },
  "required": [
    "board",
    "player",
    "roll"
  ]
}

pachisi_roll_cowries

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

Parameters2

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

Raw schema

{
  "type": "object",
  "properties": {
    "shells": {
      "type": "number",
      "description": "Number of cowrie shells (default 6). Pachisi uses 6, Chaupar uses 3 long dice."
    },
    "game": {
      "type": "string",
      "enum": [
        "pachisi",
        "chaupar"
      ],
      "description": "Which game rules to apply. Defaults to \"pachisi\"."
    }
  }
}

piece_gallery_search

Search and filter piece sets from the Moddable Chess piece gallery (96 sets, 2,550 SVGs across 19 game families). Filter by family, license, author, or search by name. Returns metadata for matching sets with preview URLs.

Parameters7

query	string	optional	Search term to match against set name, author, or ID (case-insensitive).
family	string	optional	Filter by game family (e.g. "chess", "shogi", "xiangqi", "janggi", "draughts", "go", "emoji", "oware", "abalone", "othello", "backgammon", "amazons", "breakthrough", "fairy-chess", "lines-of-action", "makruk", "sittuyin", "playing-cards", "togyzkumalak").
license	string	optional	Filter by SPDX license (e.g. "MIT", "CC-BY-4.0", "CC0-1.0", "Apache-2.0", "GPL-2.0+").
author	string	optional	Filter by author name (case-insensitive partial match).
playable	boolean	optional	Filter to only playable sets (usable in the chess.moddable.games play UI).
recolorable	boolean	optional	Filter to only recolorable sets (SVGs support color theming).
limit	number	optional	Max results to return (default 20, max 96).

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search term to match against set name, author, or ID (case-insensitive)."
    },
    "family": {
      "type": "string",
      "description": "Filter by game family (e.g. \"chess\", \"shogi\", \"xiangqi\", \"janggi\", \"draughts\", \"go\", \"emoji\", \"oware\", \"abalone\", \"othello\", \"backgammon\", \"amazons\", \"breakthrough\", \"fairy-chess\", \"lines-of-action\", \"makruk\", \"sittuyin\", \"playing-cards\", \"togyzkumalak\")."
    },
    "license": {
      "type": "string",
      "description": "Filter by SPDX license (e.g. \"MIT\", \"CC-BY-4.0\", \"CC0-1.0\", \"Apache-2.0\", \"GPL-2.0+\")."
    },
    "author": {
      "type": "string",
      "description": "Filter by author name (case-insensitive partial match)."
    },
    "playable": {
      "type": "boolean",
      "description": "Filter to only playable sets (usable in the chess.moddable.games play UI)."
    },
    "recolorable": {
      "type": "boolean",
      "description": "Filter to only recolorable sets (SVGs support color theming)."
    },
    "limit": {
      "type": "number",
      "description": "Max results to return (default 20, max 96)."
    }
  }
}

piece_gallery_get_set

Get full details for a specific piece set including manifest, piece file list, direct SVG URLs, and a preview image URL. Use piece_gallery_search to find set IDs first.

Parameters1

string

required

The piece set ID (e.g. "chessnut", "kahu-shogi-international", "fluent-emoji").

Raw schema

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "The piece set ID (e.g. \"chessnut\", \"kahu-shogi-international\", \"fluent-emoji\")."
    }
  },
  "required": [
    "id"
  ]
}

piece_gallery_stats

Get aggregate statistics for the piece gallery: total sets, SVG count, breakdown by family, license distribution, author list, and playable/recolorable counts.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

oracle_list_games

List all supported RPG game systems with their available features (tables, entities). Returns game IDs for use in other tools.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

oracle_list_tables

List all available oracle/random tables for a game system, optionally filtered by category. Returns table IDs, names, and roll types.

Parameters2

game	string	optional	Game system ID. Defaults to "starforged". Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged
category	string	optional	Filter by category. Omit to list all.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game system ID. Defaults to \"starforged\". Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged"
    },
    "category": {
      "type": "string",
      "description": "Filter by category. Omit to list all."
    }
  }
}

oracle_roll

Roll on a specific oracle/random table. Returns the dice roll and result text. Use oracle_list_tables to discover table IDs.

Parameters3

game	string	optional	Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged
table	string	required	Table ID (e.g. "action", "theme", "dungeon-themes").
count	number	optional	Number of rolls (1-5). Defaults to 1.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged"
    },
    "table": {
      "type": "string",
      "description": "Table ID (e.g. \"action\", \"theme\", \"dungeon-themes\")."
    },
    "count": {
      "type": "number",
      "description": "Number of rolls (1-5). Defaults to 1."
    }
  },
  "required": [
    "table"
  ]
}

oracle_ask

Ask the Oracle a yes/no question with a likelihood modifier. Implements the Ironsworn/Starforged mechanic with match detection.

Parameters2

likelihood	string	optional	How likely is "yes"? Defaults to "fifty_fifty".
question	string	optional	Optional question text (returned in response for context).

Raw schema

{
  "type": "object",
  "properties": {
    "likelihood": {
      "type": "string",
      "enum": [
        "almost_certain",
        "likely",
        "fifty_fifty",
        "unlikely",
        "small_chance"
      ],
      "description": "How likely is \"yes\"? Defaults to \"fifty_fifty\"."
    },
    "question": {
      "type": "string",
      "description": "Optional question text (returned in response for context)."
    }
  }
}

oracle_scene

Generate a narrative seed by rolling on multiple oracle tables. Use a named recipe or provide a custom array of table IDs. Auto-resolves cross-references.

Parameters4

recipe	string	optional	Recipe ID. Use oracle_list_recipes to see options.
tables	array	optional	Custom table IDs to roll. Ignored if recipe is provided.
game	string	optional	Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged
region	string	optional	Region for tables with regional variants (Starforged only).

Raw schema

{
  "type": "object",
  "properties": {
    "recipe": {
      "type": "string",
      "description": "Recipe ID. Use oracle_list_recipes to see options."
    },
    "tables": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Custom table IDs to roll. Ignored if recipe is provided."
    },
    "game": {
      "type": "string",
      "description": "Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged"
    },
    "region": {
      "type": "string",
      "enum": [
        "terminus",
        "outlands",
        "expanse"
      ],
      "description": "Region for tables with regional variants (Starforged only)."
    }
  }
}

oracle_list_recipes

List all predefined scene recipes — curated multi-table compositions that produce coherent narrative prompts.

Parameters1

game

string

optional

Filter by game. Omit to see all.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Filter by game. Omit to see all."
    }
  }
}

oracle_interpret

Resolve oracle cross-references. Given a result like "Action + Theme" or "Roll twice", follows the reference and returns expanded results.

Parameters3

result	string	required	Oracle result text to interpret.
source_table	string	optional	Table ID the result came from (needed for "Roll twice" re-rolls).
game	string	optional	Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged

Raw schema

{
  "type": "object",
  "properties": {
    "result": {
      "type": "string",
      "description": "Oracle result text to interpret."
    },
    "source_table": {
      "type": "string",
      "description": "Table ID the result came from (needed for \"Roll twice\" re-rolls)."
    },
    "game": {
      "type": "string",
      "description": "Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged"
    }
  },
  "required": [
    "result"
  ]
}

oracle_table_view

View the complete contents of an oracle table — all entries with roll ranges and results.

Parameters2

game	string	optional	Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged
table	string	required	Table ID to view.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game system ID. Available: cairn, dungeon-world, ironsworn, knave, maze-rats, starforged"
    },
    "table": {
      "type": "string",
      "description": "Table ID to view."
    }
  },
  "required": [
    "table"
  ]
}

oracle_encounter

Generate a tabletop RPG encounter (D&D 5e or Pathfinder 1e). Selects CR-appropriate monsters, picks terrain, and rolls loot.

Parameters7

system	string	optional	Game system. Defaults to "dnd-5e".
party_level	number	optional	Average party level (1-20). Defaults to 5.
party_size	number	optional	Number of players (1-10). Defaults to 4.
difficulty	string	optional	Encounter difficulty. Defaults to "medium".
monster_type	string	optional	Filter monsters by type (e.g. "undead", "dragon", "beast").
terrain	string	optional	Terrain type (e.g. "Forest", "Cavern"). Omit for random.
loot_tier	string	optional	Loot rarity tier. Defaults to "medium".

Raw schema

{
  "type": "object",
  "properties": {
    "system": {
      "type": "string",
      "enum": [
        "dnd-5e",
        "pathfinder-1e"
      ],
      "description": "Game system. Defaults to \"dnd-5e\"."
    },
    "party_level": {
      "type": "number",
      "description": "Average party level (1-20). Defaults to 5."
    },
    "party_size": {
      "type": "number",
      "description": "Number of players (1-10). Defaults to 4."
    },
    "difficulty": {
      "type": "string",
      "enum": [
        "easy",
        "medium",
        "hard",
        "deadly"
      ],
      "description": "Encounter difficulty. Defaults to \"medium\"."
    },
    "monster_type": {
      "type": "string",
      "description": "Filter monsters by type (e.g. \"undead\", \"dragon\", \"beast\")."
    },
    "terrain": {
      "type": "string",
      "description": "Terrain type (e.g. \"Forest\", \"Cavern\"). Omit for random."
    },
    "loot_tier": {
      "type": "string",
      "enum": [
        "none",
        "low",
        "medium",
        "high",
        "legendary"
      ],
      "description": "Loot rarity tier. Defaults to \"medium\"."
    }
  }
}

rpg_list_categories

List entity categories for an RPG system (or all systems). Shows browseable content: spells, monsters, classes, equipment, skills, bestiary, etc.

Parameters1

game

string

optional

Game system ID. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e. Omit for all games.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game system ID. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e. Omit for all games."
    }
  }
}

rpg_search

Search RPG entities across games and categories. Full-text search over names, descriptions, and metadata.

Parameters4

query	string	required	Search term (e.g. "fireball", "dragon", "healing", "two-handed").
game	string	optional	Filter to a specific game. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e
category	string	optional	Filter to a specific category (e.g. "spells", "monsters", "equipment").
limit	number	optional	Max results (1-25). Defaults to 10.

Raw schema

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "Search term (e.g. \"fireball\", \"dragon\", \"healing\", \"two-handed\")."
    },
    "game": {
      "type": "string",
      "description": "Filter to a specific game. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e"
    },
    "category": {
      "type": "string",
      "description": "Filter to a specific category (e.g. \"spells\", \"monsters\", \"equipment\")."
    },
    "limit": {
      "type": "number",
      "description": "Max results (1-25). Defaults to 10."
    }
  },
  "required": [
    "query"
  ]
}

rpg_browse

Browse entities in a category with pagination. Good for exploring what is available in a game system.

Parameters4

game	string	required	Game system ID. Required. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e
category	string	required	Category ID (e.g. "spells", "monsters", "classes"). Required.
page	number	optional	Page number (1-based). Defaults to 1.
page_size	number	optional	Items per page (5-50). Defaults to 20.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game system ID. Required. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e"
    },
    "category": {
      "type": "string",
      "description": "Category ID (e.g. \"spells\", \"monsters\", \"classes\"). Required."
    },
    "page": {
      "type": "number",
      "description": "Page number (1-based). Defaults to 1."
    },
    "page_size": {
      "type": "number",
      "description": "Items per page (5-50). Defaults to 20."
    }
  },
  "required": [
    "game",
    "category"
  ]
}

rpg_get_entity

Get full details of a specific RPG entity by name. Supports exact and fuzzy (partial) matching.

Parameters3

game	string	required	Game system ID. Required. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e
name	string	required	Entity name to look up (e.g. "Fireball", "Ancient Red Dragon", "Longsword").
category	string	optional	Narrow search to a specific category. Optional.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game system ID. Required. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e"
    },
    "name": {
      "type": "string",
      "description": "Entity name to look up (e.g. \"Fireball\", \"Ancient Red Dragon\", \"Longsword\")."
    },
    "category": {
      "type": "string",
      "description": "Narrow search to a specific category. Optional."
    }
  },
  "required": [
    "game",
    "name"
  ]
}

rpg_random

Get random entities from an RPG system. Great for inspiration, encounter prep, or NPC generation.

Parameters3

game	string	required	Game system ID. Required. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e
category	string	optional	Category to draw from. Omit for any category.
count	number	optional	Number of random picks (1-10). Defaults to 1.

Raw schema

{
  "type": "object",
  "properties": {
    "game": {
      "type": "string",
      "description": "Game system ID. Required. Available: brp, cairn, dnd-5e, dungeon-world, fate-core, knave, pathfinder-1e"
    },
    "category": {
      "type": "string",
      "description": "Category to draw from. Omit for any category."
    },
    "count": {
      "type": "number",
      "description": "Number of random picks (1-10). Defaults to 1."
    }
  },
  "required": [
    "game"
  ]
}

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.

Parameters1

variant

string

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "variant": {
      "type": "string",
      "description": "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.

Parameters1

notation

string

required

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

Raw schema

{
  "type": "object",
  "properties": {
    "notation": {
      "type": "string",
      "description": "Dice notation (e.g. \"2d6+3\", \"4d8\", \"d20+5\", \"3d6\"). Multiple pools separated by commas."
    }
  },
  "required": [
    "notation"
  ]
}

ti4_random_factions

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

Parameters2

players	number	optional	Number of players (3-8). Defaults to 6.
expansion	string	optional	Include Prophecy of Kings factions. Defaults to "pok".

Raw schema

{
  "type": "object",
  "properties": {
    "players": {
      "type": "number",
      "description": "Number of players (3-8). Defaults to 6."
    },
    "expansion": {
      "type": "string",
      "enum": [
        "base",
        "pok"
      ],
      "description": "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.

Parameters1

options

array

optional

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

Raw schema

{
  "type": "object",
  "properties": {
    "options": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "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.

Parameters2

players	array	required	Player names to split into teams.
teams	number	optional	Number of teams (default 2).

Raw schema

{
  "type": "object",
  "properties": {
    "players": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Player names to split into teams."
    },
    "teams": {
      "type": "number",
      "description": "Number of teams (default 2)."
    }
  },
  "required": [
    "players"
  ]
}

jam_status

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

jam_timer

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

jam_vote

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

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {}
}

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 (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 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

Tools (56)

chess_list_variantschess_get_legal_moveschess_analyze_positionchess_validate_movechess_make_moveschess_get_opening_bookchess_render_svgchess_generate_puzzle

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://tools.moddable.games/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

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.