Create a definition
- In the Content Browser, choose Miscellaneous → Data Asset and select JigsawPuzzleDefinition.
- Open the asset. Assign Artwork, a Display Name, Columns, Rows and Mode.
- Add the asset to the gallery actor's Puzzles array, or assign it to a Jigsaw Puzzle Board / Jigsaw Puzzle Widget.
- Play and move pieces. Reuse the definition across instances, or duplicate it for a different layout.
| Parameter | Default or example | Effect and use |
|---|---|---|
| Artwork | Texture2D; required for the visible picture | Replace with your own image. The board preserves its aspect ratio. Rectangular cells are expected when the grid differs from the image ratio. |
| Columns / Rows | Integer; defaults 4 / 3; range 2–16 each | Choose board density. A sliding board reserves one cell as the gap. |
| Shuffle Seed | Integer; default 1337 | Repeat the same initial arrangement and matching edge shapes. Shuffle increments the seed. |
| Mode | Interlocking (default), Swap or Sliding | Changes interaction rules. Selecting Sliding in the gallery starts with a 3 × 3 layout. |
| Interlocking Edges | Boolean; default enabled | Generate complementary tabs and sockets in Interlocking mode. Disable for straight picture-piece edges. |
| Allow Rotation | Boolean; default disabled | Interlocking pieces may begin at quarter turns. Correct orientation is required for snapping. |
| Snap Distance | Float; default 0.25; range 0.05–0.45 | Maximum distance from the correct center in logical cell space. Increase for more forgiving drops. |
| Hint Budget | Integer; default 5; Details range 0–999 | Maximum hints per session. Zero disables hints. |
| Show Reference / Reference Opacity | Enabled / 0.12 by default; opacity 0–0.4 | The 2D board can show a faint complete picture. The 3D board uses its own dark reference material. |
| Accent / Background Color | Linear Color | Style the 2D frame, locked outlines and board background. |
| Puzzle Id | Optional Name | Stable save identity. Empty asset definitions use their asset path. Supply a unique stable ID for definitions created dynamically. |
The sample textures were generated with AI and are distributed as artwork. Generation is not a runtime plugin feature. Supply textures you have permission to use. The plugin does not import images from files at runtime or generate a picture from a text prompt.