PuzzleEngine

Turn any image into a puzzle your players can solve together.

PuzzleEngine is an interactive jigsaw puzzle module for Foundry Virtual Tabletop.

Separate builds are available for Foundry VTT Versions 13 and 14.

Foundry VTT Version 13 uses PuzzleEngine 1.0.0. This build has been tested directly and is the recommended version for Foundry VTT v13 users.

Foundry VTT Version 14 uses PuzzleEngine 0.4.0. Compatibility support for Foundry VTT v14 is included, but this build has not yet been personally tested by the developer.

Choose an image, turn it into puzzle pieces, and let your players work together to complete it directly inside Foundry.

A torn map, an ancient mural, a mysterious letter, a shattered emblem, or the pattern sealing a forgotten door — PuzzleEngine turns visual clues into playable tabletop activities.

Build Your Puzzle

The GM-only Puzzle Builder gives you control over how each puzzle is created.

• 4–150 pieces — Create anything from a short diversion to a more demanding group challenge.
• Adjustable piece shapes — Change irregularity and tab size to alter the appearance of the pieces.
• Optional rotation — Require players to place pieces in both the correct position and orientation.
• Visual guides — Use a silhouette or faded image to make difficult puzzles easier to solve.
• Preview before play — Check the generated puzzle before sending it to your players.
• Local testing — Test the puzzle yourself before starting a shared session.

Solve Together

Choose which players will participate and launch a shared puzzle session.

Players can drag pieces around the board and, when rotation is enabled, right-click pieces to rotate them.

When one player is holding a piece, that piece is temporarily unavailable to the others. Once a piece reaches the correct position and orientation, it snaps into place and locks automatically.

A progress counter keeps track of how many pieces have been completed.

Meanwhile, the GM can watch the puzzle through a dedicated spectator view and follow the players' progress in real time.

Save Your Progress

Not every puzzle has to be completed in a single session.

PuzzleEngine stores the position, rotation, and locked state of each piece in your Foundry world data.

Saved puzzles are available through the Puzzle Archive.

View lets you inspect a saved puzzle without changing its progress.

Resume lets an unfinished puzzle continue from its previous state instead of creating a new puzzle record.

Completed puzzles remain available in the archive for later viewing, while the GM can remove puzzles and their saved progress when they are no longer needed.

Use It in Your Story

PuzzleEngine is system-agnostic and can be used anywhere a visual puzzle fits your game.

Use it to:

• Reassemble a torn treasure map
• Restore an ancient symbol
• Decode a damaged document
• Reconstruct a magical seal
• Reveal a hidden image
• Create a collaborative downtime activity
• Turn artwork and handouts into interactive encounters

You decide what the puzzle means and what happens when it is solved.

PuzzleEngine handles the pieces.

Features

• Foundry VTT Version 13 support
• Foundry VTT Version 14 compatibility build
• System-agnostic
• 4–150 puzzle pieces
• Custom irregularity and tab size
• Optional piece rotation
• Silhouette and faded-image guides
• Shared multiplayer puzzles
• Player-specific participation
• Automatic snapping and locking
• Live GM spectator view
• Persistent puzzle progress
• Puzzle Archive
• Resume unfinished puzzles
• View completed puzzles
• GM puzzle management

Compatibility

Foundry VTT v13

PuzzleEngine 1.0.0 — Tested and recommended.

Foundry VTT v14

PuzzleEngine 0.4.0 — Compatibility build. Support has been implemented, but this build has not yet been personally tested by the developer.

PuzzleEngine is system-agnostic and does not require a specific game system.

If you encounter a problem, please leave a comment with your Foundry version, game system, and a short description of the issue.