Placement Conditions - Lithostitched

Placement conditions provide fine-grained control over where features can generate. They’re used with the ConditionPlacement modifier and structure placement systems.

AllOfPlacementCondition

Requires all sub-conditions to pass (logical AND).

Configuration

{
  "type": "lithostitched:all_of",
  "conditions": [
    {
      "type": "lithostitched:in_biome",
      "biomes": "#minecraft:is_mountain"
    },
    {
      "type": "lithostitched:height_filter",
      "range_type": "absolute",
      "permitted_range": {
        "min_inclusive": 100,
        "max_inclusive": 200
      }
    }
  ]
}

Fields

conditions

List<PlacementCondition>

required

List of conditions that must all pass

AnyOfPlacementCondition

Requires at least one sub-condition to pass (logical OR).

Configuration

{
  "type": "lithostitched:any_of",
  "conditions": [
    {
      "type": "lithostitched:in_biome",
      "biomes": "minecraft:desert"
    },
    {
      "type": "lithostitched:in_biome",
      "biomes": "minecraft:badlands"
    }
  ]
}

Fields

conditions

List<PlacementCondition>

required

List of conditions where at least one must pass

GridPlacementCondition

Evaluates a condition at multiple points in a grid pattern.

Configuration

{
  "type": "lithostitched:grid",
  "radius": 16,
  "distance_between_points": 4,
  "condition": {
    "type": "lithostitched:in_biome",
    "biomes": "minecraft:ocean"
  },
  "allowed_count": {
    "min_inclusive": 5,
    "max_inclusive": 10
  }
}

Fields

radius

int

required

Grid radius in blocks (must be positive)

distance_between_points

int

required

Spacing between grid sample points (must be positive)

condition

PlacementCondition

required

Condition to test at each grid point

allowed_count

InclusiveRange<Integer>

required

Required number of passing grid points

Example Use Cases

Ocean island detection:

{
  "type": "lithostitched:grid",
  "radius": 32,
  "distance_between_points": 8,
  "condition": {
    "type": "lithostitched:in_biome",
    "biomes": "#minecraft:is_ocean"
  },
  "allowed_count": {
    "min_inclusive": 10,
    "max_inclusive": 15
  }
}

Requires 10-15 ocean biome samples in a 32-block radius.

HeightFilterPlacementCondition

Filters placement based on absolute or heightmap-relative Y coordinates.

Configuration

Absolute height:

{
  "type": "lithostitched:height_filter",
  "range_type": "absolute",
  "permitted_range": {
    "min_inclusive": -64,
    "max_inclusive": 0
  }
}

Heightmap-relative:

{
  "type": "lithostitched:height_filter",
  "range_type": "heightmap_relative",
  "heightmap": "OCEAN_FLOOR_WG",
  "permitted_range": {
    "min_inclusive": -10,
    "max_inclusive": 10
  }
}

Fields

range_type

RangeType

required

absolute: Uses world Y coordinates
heightmap_relative: Relative to heightmap value

heightmap

Heightmap.Types

Required for heightmap_relative mode. Available types:

WORLD_SURFACE_WG: World generation surface
WORLD_SURFACE: Actual world surface
OCEAN_FLOOR_WG: Ocean floor (world generation)
OCEAN_FLOOR: Actual ocean floor
MOTION_BLOCKING: Blocks that block motion
MOTION_BLOCKING_NO_LEAVES: Motion blocking excluding leaves

permitted_range

InclusiveRange<Integer>

required

Allowed Y coordinate range

Example Use Cases

Underground only:

{
  "type": "lithostitched:height_filter",
  "range_type": "absolute",
  "permitted_range": {
    "min_inclusive": -64,
    "max_inclusive": 0
  }
}

Near surface:

{
  "type": "lithostitched:height_filter",
  "range_type": "heightmap_relative",
  "heightmap": "WORLD_SURFACE_WG",
  "permitted_range": {
    "min_inclusive": -5,
    "max_inclusive": 5
  }
}

Places within 5 blocks of the surface. Ocean floor:

{
  "type": "lithostitched:height_filter",
  "range_type": "heightmap_relative",
  "heightmap": "OCEAN_FLOOR_WG",
  "permitted_range": {
    "min_inclusive": 0,
    "max_inclusive": 0
  }
}

Only at ocean floor level.

InBiomePlacementCondition

Checks if the position is in specified biomes.

Configuration

Single biome:

{
  "type": "lithostitched:in_biome",
  "biomes": "minecraft:desert"
}

Multiple biomes:

{
  "type": "lithostitched:in_biome",
  "biomes": [
    "minecraft:desert",
    "minecraft:badlands"
  ]
}

Biome tag:

{
  "type": "lithostitched:in_biome",
  "biomes": "#minecraft:is_ocean"
}

Fields

biomes

HolderSet<Biome>

required

Biome ID, list of IDs, or biome tag

MultipleOfPlacementCondition

Requires a specific count of sub-conditions to pass.

Configuration

{
  "type": "lithostitched:multiple_of",
  "conditions": [
    {
      "type": "lithostitched:in_biome",
      "biomes": "minecraft:plains"
    },
    {
      "type": "lithostitched:height_filter",
      "range_type": "absolute",
      "permitted_range": {
        "min_inclusive": 60,
        "max_inclusive": 80
      }
    },
    {
      "type": "lithostitched:sample_noise_router",
      "target": "temperature",
      "min_inclusive": 0.5
    }
  ],
  "allowed_count": {
    "min_inclusive": 2,
    "max_inclusive": 3
  }
}

Fields

conditions

List<PlacementCondition>

required

List of conditions to evaluate

allowed_count

InclusiveRange<Integer>

required

Required number of passing conditions

Example Use Cases

At least 2 of 3 conditions:

{
  "allowed_count": {
    "min_inclusive": 2,
    "max_inclusive": 3
  }
}

Exactly 1 condition:

{
  "allowed_count": {
    "min_inclusive": 1,
    "max_inclusive": 1
  }
}

NotPlacementCondition

Inverts a condition (logical NOT).

Configuration

{
  "type": "lithostitched:not",
  "condition": {
    "type": "lithostitched:in_biome",
    "biomes": "#minecraft:is_ocean"
  }
}

Fields

condition

PlacementCondition

required

Condition to invert

OffsetPlacementCondition

Evaluates a condition at an offset position.

Configuration

{
  "type": "lithostitched:offset",
  "condition": {
    "type": "lithostitched:in_biome",
    "biomes": "minecraft:ocean"
  },
  "offset": {
    "x": 0,
    "y": -10,
    "z": 0
  }
}

Fields

condition

PlacementCondition

required

Condition to test at offset position

offset

BlockPos

required

Position offset (x, y, z)

SampleDensityPlacementCondition

Samples a density function and checks value range.

Configuration

{
  "type": "lithostitched:sample_density",
  "density_function": "minecraft:overworld/caves/entrances",
  "min_inclusive": 0.0,
  "max_inclusive": 0.5
}

Fields

density_function

Holder<DensityFunction>

required

Reference to a density function

min_inclusive

double

Minimum density value (inclusive)

max_inclusive

double

Maximum density value (inclusive)

Only works with NoiseBasedChunkGenerator. Returns false for other generator types.

SampleNoiseRouterPlacementCondition

Samples a noise router target and checks value range.

Configuration

{
  "type": "lithostitched:sample_noise_router",
  "target": "temperature",
  "min_inclusive": 0.5,
  "max_inclusive": 1.0
}

Fields

target

NoiseRouterTarget

required

Noise router target to sample. Available targets:

barrier
fluid_level_floodedness
fluid_level_spread
lava
temperature
vegetation
continents
erosion
depth
ridges
initial_density_without_jaggedness
final_density
vein_toggle
vein_ridged
vein_gap

min_inclusive

double

Minimum noise value (inclusive)

max_inclusive

double

Maximum noise value (inclusive)

Only works with NoiseBasedChunkGenerator. Returns false for other generator types.

TruePlacementCondition

Always passes. Useful as a placeholder or default.

Configuration

{
  "type": "lithostitched:true"
}

Complex Examples

Mountain Peak Detection

{
  "type": "lithostitched:all_of",
  "conditions": [
    {
      "type": "lithostitched:in_biome",
      "biomes": "#minecraft:is_mountain"
    },
    {
      "type": "lithostitched:height_filter",
      "range_type": "heightmap_relative",
      "heightmap": "WORLD_SURFACE_WG",
      "permitted_range": {
        "min_inclusive": -2,
        "max_inclusive": 2
      }
    },
    {
      "type": "lithostitched:grid",
      "radius": 8,
      "distance_between_points": 2,
      "condition": {
        "type": "lithostitched:height_filter",
        "range_type": "absolute",
        "permitted_range": {
          "min_inclusive": 150,
          "max_inclusive": 320
        }
      },
      "allowed_count": {
        "min_inclusive": 12,
        "max_inclusive": 25
      }
    }
  ]
}

This complex condition:

Requires mountain biome
Must be near the surface
Samples surrounding area to ensure it’s elevated

Cave Entrance Detection

{
  "type": "lithostitched:all_of",
  "conditions": [
    {
      "type": "lithostitched:sample_density",
      "density_function": "minecraft:overworld/caves/entrances",
      "min_inclusive": 0.3
    },
    {
      "type": "lithostitched:not",
      "condition": {
        "type": "lithostitched:in_biome",
        "biomes": "#minecraft:is_ocean"
      }
    }
  ]
}

Source References

AllOfPlacementCondition: AllOfPlacementCondition.java:9
AnyOfPlacementCondition: AnyOfPlacementCondition.java:8
GridPlacementCondition: GridPlacementCondition.java:10
HeightFilterPlacementCondition: HeightFilterPlacementCondition.java:15
InBiomePlacementCondition: InBiomePlacementCondition.java:10
MultipleOfPlacementCondition: MultipleOfPlacementCondition.java:11
NotPlacementCondition: NotPlacementCondition.java:6
OffsetPlacementCondition: OffsetPlacementCondition.java:7
SampleDensityPlacementCondition: SampleDensityPlacementCondition.java:14
SampleNoiseRouterPlacementCondition: SampleNoiseRouterPlacementCondition.java:14
TruePlacementCondition: TruePlacementCondition.java:6

Worldgen Modifiers

Structures & Templates

Surface & Terrain

Features & Placement

Blocks & State

​AllOfPlacementCondition

​Configuration

​Fields

​AnyOfPlacementCondition

​Configuration

​Fields

​GridPlacementCondition

​Configuration

​Fields

​Example Use Cases

​HeightFilterPlacementCondition

​Configuration

​Fields

​Example Use Cases

​InBiomePlacementCondition

​Configuration

​Fields

​MultipleOfPlacementCondition

​Configuration

​Fields

​Example Use Cases

​NotPlacementCondition

​Configuration

​Fields

​OffsetPlacementCondition

​Configuration

​Fields

​SampleDensityPlacementCondition

​Configuration

​Fields

​SampleNoiseRouterPlacementCondition

​Configuration

​Fields

​TruePlacementCondition

​Configuration

​Complex Examples

​Mountain Peak Detection

​Cave Entrance Detection

​Source References

Build docs developers (and LLMs) love

AllOfPlacementCondition

Configuration

Fields

AnyOfPlacementCondition

Configuration

Fields

GridPlacementCondition

Configuration

Fields

Example Use Cases

HeightFilterPlacementCondition

Configuration

Fields

Example Use Cases

InBiomePlacementCondition

Configuration

Fields

MultipleOfPlacementCondition

Configuration

Fields

Example Use Cases

NotPlacementCondition

Configuration

Fields

OffsetPlacementCondition

Configuration

Fields

SampleDensityPlacementCondition

Configuration

Fields

SampleNoiseRouterPlacementCondition

Configuration

Fields

TruePlacementCondition

Configuration

Complex Examples

Mountain Peak Detection

Cave Entrance Detection

Source References