Codex
Open Codex Generators Explore

Topic Hub

Designing and Running RPG Puzzles

#puzzle

A tabletop puzzle goes wrong in a predictable way: one intended answer, held in the GM's notes, with no way forward until someone says it aloud. Codex Cryptica's Puzzle cluster is built around the opposite habit. It covers designing puzzles with more than one route through, preparing hints in advance, worked examples with clues, alternate solutions and failure states written out, and a generator that produces all of it.

Why puzzles stall, and what fixes it

A stall has one cause: a single answer with no exit

Difficulty and cleverness are secondary. A hard puzzle with three routes through it does not stall the table, while an easy puzzle with one route stalls the moment nobody happens to think of it. Making puzzles easier treats the symptom; giving being stuck a way out treats the cause.

Failure should cost something other than time

When a wrong answer only costs minutes, the table's only strategy is to keep guessing. When it spends a resource, makes noise or alerts something, a wrong attempt is still play. Partial-progress feedback, such as three of five symbols glowing, keeps people trying because they can tell they are getting closer.

Hints work as a ladder, prepared in advance

A single hint has to guess the right amount of help mid-session. A three-step ladder does not: repeat a clue in a new form, point at what changed after the last attempt, then state the goal without the method. Climb one step at a time, and only when the table has genuinely stalled.

Learn the design

Start here. These guides cover building a puzzle that keeps the table moving, rescuing one that has stopped, and laying out clues so they can be found.

See a puzzle, start to finish

Each worked example includes the setup, layered clues, spotlight moments for different characters, alternate solutions, and what happens on failure. Pick the one closest to your table's genre.

  • A tarnished silver bell hanging without chains over a basin of pale blue flame in a ruined stone abbey crypt

    Classic Fantasy

    The Bell Beneath Blackglass (Classic Fantasy)

    A silver bell in an abbey crypt is draining a valley's protective ward. The party must realign its three magical rings, or free the spirit powering it, before the next toll.

    What it shows: A magical device that responds to meaning rather than one answer, with more than one way to disable it.

  • A flooded underground transit vault with a six by six grid of brass route plates and glowing indicator lamps

    Cyberpunk

    The Null-Key Reliquary (Cyberpunk)

    A stolen ledger sits behind a mechanical train-routing maze in a flooded transit vault. Its brass relays must be synchronised before an eleven-minute security purge floods the chamber.

    What it shows: A visible countdown that punishes stalling rather than thinking, on a purely mechanical puzzle.

  • A frost-choked maintenance gantry above a wildly spinning cryogenic core, lit by strobing emergency beacons

    Space Opera

    The Venting Helix (Space Opera)

    A runaway atmospheric purge loop on a derelict hull is spinning its core off-axis. The crew must halt it before the counter-rotating rings tear themselves apart.

    What it shows: Four separate routes to a solution, none of them the single right answer, under physical danger.

Generate a puzzle

Produce a table-ready puzzle with layered clues, alternate solutions and consequences for failure, then place it in a dungeon or a heist with the supporting tools.

  • Codex Cryptica RPG Puzzle Generator showing the input form, generated puzzle draft, and GM reference rail

    Primary Tool

    Puzzle Generator

    Build an encounter puzzle with layered clues, alternate solutions, character spotlight opportunities and fail-forward consequences, adjusted for genre, complexity, puzzle style and the pressure of failure.

  • Supporting Tool

    Heist Generator

    When the puzzle guards a vault or a sanctum, generate the score around it: the security rings, alarm track and getaway that give the lock a reason to matter.

  • Supporting Tool

    Dungeon Generator

    Generate the rooms and corridors a puzzle sits in, so its clues can be spread across the location rather than stated in one place.

Run one tonight

Four steps from a blank page to a puzzle that will not stall. Each step points at the single resource that carries it.

  1. Give the puzzle a way out

    Check that the puzzle has more than one route, that failure spends something other than time, and that the party can convert being stuck into a task. How Do You Design RPG Puzzles That Do Not Stall the Game?.

  2. Prepare the hint ladder

    Write all three hint steps before the session, from a repeated clue to a stated goal, so a stalled table never forces you to improvise the answer. How Do You Give Hints for an RPG Puzzle Without Giving Away the Answer?.

  3. See it written out

    Read a complete puzzle with its clues, alternate solutions and failure states laid out, and borrow the structure for your own. Worked Example: The Bell Beneath Blackglass.

  4. Generate your own

    Set the genre, complexity and pressure, and get a puzzle with layered clues and consequences ready to run. Puzzle Generator.

Keep exploring

  • RPG Heists — Vault locks, security rings and access obstacles, where a puzzle is one layer of a larger operation.
  • All Puzzle Material on Explore — Browse every guide, generator and worked example tagged #puzzle across the Codex Cryptica discovery graph.