Plugin missing when opening the example
Install the matching JigsawPuzzle plugin separately. The example ZIP does not bundle it. Keep ProceduralMeshComponent enabled. Match the engine version of precompiled binaries; do not accept an unexpected rebuild prompt as proof of a compatible install.
Blank board or no puzzle
Assign a valid Artwork texture and a grid between 2 and 16 on each axis. A gallery needs a nonempty Puzzles array and a local player controller. For a custom UMG board, allocate enough space for both the board and the adjacent tray.
A piece will not snap
Check its target, rotation and Snap Distance. A paused or completed session rejects placement. Locked pieces cannot be dragged. Rotation only applies to Interlocking mode.
3D input does nothing
The ready-made gallery uses JigsawPuzzlePlayerController through JigsawDemoGameMode. A custom game mode/controller needs equivalent pointer-plane interaction. Check that another UI panel is not consuming pointer input. The procedural meshes use silhouette tests rather than physics collision for the supplied drag workflow.
Packaged materials are missing
The plugin content includes the two board master materials, referenced by the board's class defaults so the cooker can include them. Keep the plugin enabled and retain its Materials directory. If you override Artwork Material, include that material and its dependencies in your project.
Compatibility
Current local validation uses Unreal Engine 5.8.2 on Win64. Editor, Development and Shipping plugin compile checks passed. The extracted example launched with a separately installed plugin, and the standalone Development game was inspected in 2D and 3D. Other engine versions, operating systems, mobile hardware, consoles, VR and network multiplayer are not validated. Keyboard shortcuts require board focus; touch supports 2D piece dragging only.
Report a JigSaw Puzzle issue. Include the engine version, puzzle mode, grid, seed, input device and steps to reproduce. Shared support guide.