🎮 Game Types Reference

Each game type has its own params schema and purpose-built validator. Here's the full reference for all types.

🧩 grid-stealth

Grid-based stealth puzzles with patrol avoidance and pathfinding. Powers Spinnerzeit's Nightly Feed game. Every puzzle is validated to have at least one viable path avoiding all patrols.

Param	Type	Required	Description
`width`	`number`	`Yes`	`Grid width (4–64)`
`height`	`number`	`Yes`	`Grid height (4–64)`
`pieces`	`string[]`	`Yes`	`Piece types (e.g. guard, wall, exit, key, door)`
`playerStart`	`[number, number]`	`No`	`Starting position (default [0,0])`
`exitPosition`	`[number, number]`	`No`	`Exit position (default bottom-right)`
`maxPieces`	`Record<string, number>`	`No`	`Max count per piece type`
`patrolPatterns`	`'static' \| 'linear' \| 'loop'`	`No`	`Guard movement patterns`
`allowDiagonalMove`	`boolean`	`No`	`Player can move diagonally (default false)`

📝 word-puzzle

Wordle variants, anagram puzzles, and other word games. With 399+ Wordle clones on the market, this is one of the most in-demand content types. All words validated against real dictionaries.

Param	Type	Required	Description
`variant`	`'wordle' \| 'anagram' \| 'crossword'`	`Yes`	`Word puzzle variant`
`wordLength`	`number`	`Yes`	`Target word length (3–15)`
`dictionary`	`'en' \| 'es' \| 'de' \| 'fr'`	`No`	`Dictionary language (default 'en')`
`excludeWords`	`string[]`	`No`	`Words to exclude (already used)`
`maxObscurity`	`number`	`No`	`0.0 (common) to 1.0 (obscure), default 0.5`

📦 sokoban

Push-box puzzles with optimal move validation. Every generated puzzle is guaranteed solvable with the reported optimal solution. Difficulty is based on optimal move count, deadlock complexity, and branching factor.

Param	Type	Required	Description
`width`	`number`	`Yes`	`Grid width (5–20)`
`height`	`number`	`Yes`	`Grid height (5–20)`
`boxes`	`number`	`Yes`	`Number of boxes/goals (1–10)`
`minOptimalMoves`	`number`	`No`	`Minimum optimal solution length`
`maxOptimalMoves`	`number`	`No`	`Maximum optimal solution length`
`allowDeadlockStates`	`boolean`	`No`	`Allow reachable deadlock states (default true)`

🔢 sudoku

Classic 9×9 Sudoku puzzles with difficulty grading. Each puzzle has a unique solution. Difficulty based on required solving techniques (naked singles → hidden pairs → X-wing, etc.).

Param	Type	Required	Description
`size`	`9 \| 16`	`No`	`Grid size (default 9)`
`symmetry`	`'rotational' \| 'mirror' \| 'none'`	`No`	`Clue placement symmetry`
`minClues`	`number`	`No`	`Minimum given clues (17–50 for 9×9)`
`maxClues`	`number`	`No`	`Maximum given clues`
`requiredTechniques`	`string[]`	`No`	`Solving techniques puzzle must require`

🎨 nonogram

Nonogram / Picross logic puzzles. Every puzzle guaranteed to have a unique solution (critical for nonograms). Can optionally generate puzzles that form recognizable pixel art.

Param	Type	Required	Description
`width`	`number`	`Yes`	`Grid width (5–30)`
`height`	`number`	`Yes`	`Grid height (5–30)`
`colors`	`number`	`No`	`Number of colors (default 1 = black/white)`
`targetImage`	`string`	`No`	`Keyword for pixel art target (e.g. 'cat', 'star')`
`uniqueSolution`	`boolean`	`No`	`Guarantee unique solution (default true)`

🔜 Coming Soon

The following game types are in active development:

Type	Description	ETA
`dungeon-layout`	`Roguelike room generation with connectivity validation`	`Q3 2025`
`tower-defense`	`Wave spawn composition, timing, and difficulty balancing`	`Q3 2025`
`platformer-chunk`	`Difficulty-calibrated obstacle sequences for platformers`	`Q4 2025`

📋 On the Roadmap

Type	Description
`tcg-balance`	`TCG card stat blocks, abilities, mana costs — verified balanced against each other`
`quest-encounter`	`RPG quest templates with branching narratives and encounter balance`

🛠️ custom

Bring your own rules and validator. Set validatorUrl to your endpoint — GameplayGen will POST generated content there for verification. See the Custom Validators section for details.