Module jigsaw 

Jigsaw assembly. Ports vanilla’s JigsawPlacement BFS: connects pieces via jigsaw blocks given a start pool + config. Produces typed piece state; block placement runs in a later worldgen stage.

Structs

ActiveSourceJigsaw 🔒

Active source connector during jigsaw BFS.

AssemblyResult

Result of a successful jigsaw assembly.

AssemblyScratch 🔒

JigsawJunction

Junction between two jigsaw pieces (terrain adaptation).

JigsawPieceData

Typed state needed to place or compare a vanilla jigsaw piece.

JigsawStructure

Registered under minecraft:jigsaw for pool-based structures such as villages, bastions, ancient cities, and trail ruins.

PieceQueueEntry 🔒

BFS queue entry ordered by descending placement_priority, FIFO within ties.

PlacedPiece

A placed piece produced by jigsaw assembly.

StartedAssembly 🔒

TransformedJigsaw 🔒

A jigsaw block with its position transformed by rotation.

Enums

FreeSpace 🔒

Free-space tracker. Small contexts use a flat list; larger contexts switch to BoxOctree for nearby-box queries.

PieceQueue 🔒

Constants

CANDIDATE_DEDUPE_THRESHOLD 🔒

FREE_SPACE_OCTREE_THRESHOLD 🔒

JIGSAW_PRIORITY_CACHE_THRESHOLD 🔒

QUEUE_HEAP_THRESHOLD 🔒

Statics

SYNTHETIC_BOTTOM_JIGSAW 🔒

SYNTHETIC_EMPTY_POOL 🔒

Functions

append_shuffled_templates_cached 🔒

Appends vanilla’s StructureTemplatePool.getShuffledTemplates to out.

assemble

Vanilla’s JigsawPlacement.addPieces. Returns None on failure (empty start pool, dimension padding violation, etc.).

cached_descending_priorities 🔒

cached_pool_max_y_size 🔒

cached_runtime_rotated_jigsaws 🔒

candidate_bounding_box_at_origin 🔒

descending_priorities 🔒

descending_priorities_into 🔒

element_bounding_box 🔒

Gets the bounding box for a pool element at a position with rotation.

element_location 🔒

Gets the template location from a pool element.

expand_pool_weights 🔒

feature_synthetic_jigsaw 🔒

finish_assembly 🔒

get_random_template 🔒

Vanilla’s StructureTemplatePool.getRandomTemplate.

java_center 🔒

Java integer midpoint used by vanilla jigsaw placement: (min + max) / 2.

order_jigsaw_indices_by_priorities 🔒

pool_max_y_size 🔒

Vanilla’s StructureTemplatePool.getMaxSize — max Y span across all templates.

prime_duplicate_candidate_rng 🔒

Consumes the same RNG draws as a failed placement attempt for a duplicate pool element.

resolve_aliases

Resolves pool aliases for a specific structure instance.

rotation_index 🔒

sample_start_height 🔒

shuffle_jigsaw_indices_into 🔒

shuffle_jigsaw_indices_with_priority_cache 🔒

shuffled_element_jigsaws 🔒

start_assembly 🔒

Vanilla’s JigsawPlacement.addPieces before the lazy GenerationStub child builder.

transform_template_jigsaws 🔒

try_placing_children 🔒

Vanilla’s tryPlacingChildren. context_idx is this piece’s collision context in free_spaces — external children get the parent’s context, internal children get the parent’s internal free space.

vanilla_shuffle 🔒

Vanilla-matching shuffle (reverse Fisher-Yates).

Type Aliases

JigsawRotationCache 🔒

PoolTemplateCache 🔒