Module aquifer 

Noise-based aquifer system for underground fluid placement.

Matches vanilla’s Aquifer.NoiseBasedAquifer. Divides the world into a 16×12×16 grid of aquifer cells, each with a randomly-jittered center point. For each non-solid block, finds the 4 nearest aquifer centers and computes fluid status (water vs lava, surface level) based on noise functions. Barrier pressure between neighboring aquifer cells creates solid rock walls between fluid pockets.

Structs

Aquifer

Noise-based aquifer for a single chunk.

AquiferColumnCache 🔒

Column-scan state for the 12 aquifer-neighborhood cells, stored SoA so the per-Y distance computation can be SIMD-batched as 3× i32x4.

FluidStatus 🔒

Fluid status at an aquifer cell center.

LazyAquifer

Deferred Aquifer. Used by create_structures so chunks where no structure queries the aquifer skip its (expensive) max_preliminary_surface_level scan.

Enums

AquiferResult

Result of the aquifer substance check.

Constants

FLOWING_UPDATE_SIMILARITY 🔒

LAVA_LEVEL 🔒

PACKED_X_MASK 🔒

PACKED_Y_MASK 🔒

PACKED_Z_MASK 🔒

SAMPLE_OFFSET_X 🔒

SAMPLE_OFFSET_Y 🔒

SAMPLE_OFFSET_Z 🔒

SURFACE_SAMPLING_OFFSETS 🔒

Chunk offsets (in chunks, ×16 for blocks) used when sampling preliminary surface levels around an aquifer cell center.

WAY_BELOW_MIN_Y 🔒

Sentinel for “no fluid” — well below any real Y coordinate.

X_OFFSET 🔒

X_RANGE 🔒

Y_RANGE 🔒

Y_SPACING 🔒

Z_OFFSET 🔒

Z_RANGE 🔒

Functions

cached_preliminary_surface_level 🔒

preliminary_surface_level with a per-quart-column result cache (vanilla’s Long2IntMap). On a hit it returns the memoized i32 and skips the expensive flat-router recompute in cache.ensure. Bit-identical: the cached value is the same deterministic function of the quart column.

from_grid_x 🔒

from_grid_y 🔒

from_grid_z 🔒

global_fluid 🔒

Global fluid picker matching vanilla’s NoiseBasedChunkGenerator.createFluidPicker.

grid_x 🔒

grid_y 🔒

grid_z 🔒

is_deep_dark_region 🔒

Deep dark region check matching OverworldBiomeBuilder.isDeepDarkRegion.

pack_pos 🔒

preliminary_surface_level

Evaluate preliminary surface level at quart-quantized coordinates.

quantize 🔒

Quantize: snap value down to the nearest multiple of quantum.

similarity 🔒

Similarity between two squared distances. Positive when the two nearest aquifer cells are close together (near a boundary).

unpack_x 🔒

unpack_y 🔒

unpack_z 🔒