Jigsaw Structure Builder

Tool for planning Data-Driven Jigsaw Structures in Minecraft Bedrock Edition

Stable docs checked: 1.21.130 Official jigsaw reference
Jigsaw Structures are large structures comprised of multiple Structure Templates connected through Jigsaw Blocks. Uses the current stable jigsaw reference. If a retail build still gates this feature in your world, enable the Data-Driven Jigsaw Structures experiment before testing.

Basic Configuration

Generation Settings

Height Configuration

Advanced Settings

Jigsaw Blocks are the connectors between structure pieces. Configure how they should connect and what they generate.

Jigsaw Block Configuration

Priorities

Saved Jigsaw Configurations

No jigsaw configurations added yet
Template Pools contain weighted lists of structure templates that can be randomly selected during generation.

Pool Configuration

Add Template

Templates in Current Pool

No templates added yet
Processors modify structure templates when they are placed, allowing for random block replacements and loot tables.

Processor Configuration

Add Rule

Processor Rules

No rules added yet
Structure Sets define how structures are placed in the world, including spacing and separation between instances.

Structure Set Configuration

Manifest defines your behavior pack metadata and dependencies.

Pack Information

UUIDs

Complete Guide for creating and implementing Jigsaw Structures in Minecraft Bedrock Edition.

1. Prerequisites

  • Current Minecraft Bedrock retail build recommended
  • World with Data-Driven Jigsaw Structures enabled if your build still gates it
  • Creative mode with cheats enabled
  • Basic understanding of structure blocks

2. Creating Structure Templates

  1. Build your structure pieces in-game
  2. Place jigsaw blocks at connection points:
    • Use /give @s jigsaw to obtain jigsaw blocks
    • Face arrows must point where structures connect
    • Vertical jigsaws connect only to opposite vertical jigsaws
    • Horizontal jigsaws can connect to any horizontal jigsaw
  3. Save structures using structure blocks:
    • Use /give @s structure_block
    • Set to Save mode
    • Define structure boundaries
    • Export to behavior pack

3. Jigsaw Block Types

Generating Jigsaws:
  • Name: Usually minecraft:empty
  • Target Pool: Pool to select next piece from
  • Target Name: Name of connector jigsaw to find
  • Generate new structure pieces
Connector Jigsaws:
  • Name: Unique identifier (e.g., mypack:room_connector)
  • Target Pool: Leave empty
  • Target Name: Leave empty
  • Serve as connection points only

4. File Structure

behavior_pack/
|-- manifest.json
|-- structures/
|   `-- namespace/
|       |-- main_room.mcstructure
|       |-- corridor.mcstructure
|       `-- side_room.mcstructure
`-- worldgen/
    |-- jigsaw_structures/
    |   `-- my_structure.json
    |-- processors/
    |   `-- decay_processor.json
    |-- structure_sets/
    |   `-- my_set.json
    `-- template_pools/
        |-- main_pool.json
        `-- room_pool.json

5. Testing Commands

Locate structure:

/locate structure namespace:structure_id

Place structure manually:

/place jigsaw namespace:pool_id target_name max_depth ~ ~ ~

Example:

/place jigsaw mypack:main_pool mypack:connector 10 ~ ~ ~

6. Common Issues and Solutions

  • Structure not generating: Check biome filters and height settings
  • Pieces not connecting: Verify jigsaw names and target names match
  • JSON errors: Validate JSON syntax and required fields
  • Experiment not working: Ensure Data-Driven Jigsaw Structures is enabled
  • Can't find structures: Check structure set spacing and separation values
Important: Generate all components in their respective tabs before exporting.

No files generated yet. Create your structure components in the other tabs first.