Moddable Games Tools

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

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.

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

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

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.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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.

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

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

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.

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.

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

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

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

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

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

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

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

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

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

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

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

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