Moddable Games Tools

Get a random chess puzzle. Filter by variant, difficulty or theme. Not every variant puzzle carries themes; use chess_list_puzzle_types to see what the pool holds.

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

No parameters. Call it with no arguments.

[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

No parameters. Call it with no arguments.

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, mancala, morris, hex, landlords-game, backgammon, standard-52, bavarian-32, flower-48, double-six-dominoes, mahjong, standard-dice, agon, asalto, chaupar, dou-shou-qi, fanoro...

No parameters. Call it with no arguments.

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 30 playable families.

Render the current board position as SVG for any playable family (chess, draughts, go, reversi, shogi, xiangqi, mancala, morris, hex, landlords-game, backgammon, standard-52, bavarian-32, flower-48, double-six-dominoes, mahjong, standard-dice, agon, asalto, chaupar, dou-shou-q...

Export the current board position as a FEN-style setup string, in the form the variant's own frontmatter declares its starting position. Card, tile and dice games have no board position to export.

Create a game from a FEN-style setup string, as returned by play_export_fen. Pass the same variant the position was exported from.

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 (335 rendered board layouts across 34 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

No parameters. Call it with no arguments.

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

No parameters. Call it with no arguments.

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)

No parameters. Call it with no arguments.

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

No parameters. Call it with no arguments.

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

No parameters. Call it with no arguments.

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)

No parameters. Call it with no arguments.