Moddable Games Tools

Get a random chess puzzle. Filter by variant or difficulty. Variant puzzles have no themes and max rating 1400 — theme and hard difficulty filters only apply to standard puzzles.

List available puzzle variants, themes, and per-variant counts from the puzzle pool

[DEPRECATED — use play_list_variants] List chess variants. Removal: v1.0.0.

[DEPRECATED — use play_create_game + play_get_moves] Get legal moves for a chess position. Removal: v1.0.0.

[DEPRECATED — use play_suggest_move] Analyse a chess position. Removal: v1.0.0.

[DEPRECATED — use play_apply_move] Apply a move to a chess game. Removal: v1.0.0.

[DEPRECATED — use play_validate_move] Check if a chess move is legal. Removal: v1.0.0.

[DEPRECATED — use play_check_status] Get chess game status. Removal: v1.0.0.

[DEPRECATED — use play_render_board] Render a chess position as SVG. Removal: v1.0.0.

[DEPRECATED — use play_make_moves] Apply a sequence of chess moves. Removal: v1.0.0.

[REMOVED — engine#98] Opening book resolution is broken in Worker context. No replacement.

List all available hex map game types with configuration options

Generate a hex map for a specific game and player count

Generate a hex map and export as SVG

Get info about a specific hex coordinate (terrain, neighbours, distance)

Compute field of view from a hex position

Find shortest path between two hex coordinates

List all playable game families supported by the engine (chess, draughts, go, reversi, shogi, xiangqi)

List available variants for a game family. Each variant can be passed to play_create_game. Variants with flags (e.g. +random) can be requested as "slug+flag".

Get the full engine definition (topology, render config, pieces, setup FEN) for a game variant. Returns the resolved frontmatter used to render and play the game.

Create a new game instance for a given family. Returns initial state to pass to subsequent calls. Variant can include flags like "grand+random" or "standard+drops".

Get all legal moves for the current position. Requires state from play_create_game or play_apply_move.

Apply a move to the game and return the new state. Pass the move object exactly as returned by play_get_moves (format varies by family: chess uses {from,to}, go uses {coord} or {action:"pass"}).

Check the current game status: whose turn it is, whether the game is over, and who won.

Use AI to analyse the position and suggest the best move. Supports 5 difficulty levels across all 6 playable families.

Render the current board position as SVG for any playable family (chess, draughts, go, reversi, shogi, xiangqi).

Export the current board position as a FEN-style notation string. Works for all 6 families (chess, draughts, go, reversi, shogi, xiangqi).

Create a game state from a FEN-style position string. Works for all 6 families.

Check whether a move is legal in the current position without applying it. Pass the move object in the same format as play_get_moves returns.

Apply a sequence of moves to a game and return the final state. Stops at the first illegal move. Move objects must match play_get_moves format.

List all available game rulebooks with metadata (players, duration, complexity, mechanics). Filterable by type, complexity, and mechanics.

Get full rulebook content for a specific game (markdown). For metadata only, use rules_get_game_meta instead.

Get structured metadata for a game: players, duration, complexity, mechanics, how_to_play, variant list, page list, related games. Lightweight alternative to fetching the full rulebook.

Get a specific page/section from a game rulebook (e.g. character creation, combat rules, marketplace). Use rules_get_game_meta to see available pages.

List all variants for a game with structured metadata (players, board, playable status, topology, engine config). Much richer than parsing the rulebook.

Get board diagram SVG URL for a game variant. Returns the diagram path, topology, and rendering metadata.

Get rules for a specific game variant

Full-text search across all published rulebooks. Returns section-typed results with deep-link anchors.

Get a random game suggestion from the library

Search the board gallery (333 rendered board layouts across 33 game families)

Get details of a specific board layout by ID

Search hex tile sets by name, game, or terrain type

Get details of a specific tile set with all tile types

Get statistics about available tile sets

Get statistics about the board gallery (total boards, families, topologies)

Search the piece set gallery by name, style, or game type

Get full details and piece list for a specific set

Get statistics about the piece gallery (total sets, styles, authors, game families)

List all supported RPG systems with oracle tables and entity data availability

Generate a random character for an RPG system (D&D 5e, Pathfinder, Ironsworn, Cairn, Knave, etc)

Roll on a random oracle table (Ironsworn, Starforged, Maze Rats, etc)

List available oracle tables for a system

Ask the oracle a yes/no question with likelihood modifier

Generate a scene using oracle tables. With a recipe, rolls each table in the recipe, resolves cross-references, and composes a narrative sentence. Without, picks random tables.

Search RPG entities (spells, monsters, classes, items) across all systems

Get full details of a specific RPG entity by name

Generate a random encounter for a system and difficulty level

Browse entities by category with pagination

Generate random loot/treasure for a system and tier

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

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

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

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

List entity categories for an RPG system (spells, monsters, classes, equipment, etc)

Get random entities from an RPG system for inspiration or encounter prep

Generate random faction assignments for Twilight Imperium 4th Edition

Milty-style TI4 draft with pick pools per player

List all TI4 factions with colors, flags, and expansion info

Draw random public objectives for TI4

Draw random agenda cards for TI4 political phase

Generate random territory/resource setup for a Nukes game

Resolve a Nukes combat encounter between units

Calculate settlement dice probability for Colony/Catan-style resource numbers

Create, shuffle, and optionally draw/deal from a card deck

List all available deck types with metadata

Shuffle and deal a custom deck of arbitrary named cards

Track scores for players in any game

Draw random characters from the Talisman 4e (revised) base set for a character lottery

Draw a random encounter for a Talisman ring (outer, middle, inner, crown)

Get the current Mod Jam status (active jam, deadline, submissions)

Get time remaining in the current Mod Jam

Get voting status for the current Mod Jam

Roll dice using standard notation (e.g. 2d6+3, 4d8, d20). Supports comma-separated pools and keep-high/low (4d6kh3).

Flip one or more coins, or pick from a list of choices

Randomly divide players into teams

Randomise turn order for a list of players

Suggest time controls for a game based on player count and complexity

Generate a random game jam theme combining mechanics and themes

Calculate probability of meeting a target with a dice expression. Supports keep-high/low (4d6kh3).

Analyse a chess position from FEN notation

Help design a custom chess variant

Plan a hex-based game map