Skip to content

Dripstone cluster feature

Warning

Advanced Knowledge Required - This documentation page is intended for users with in-depth knowledge of the world generation system. Beginner users may find the content challenging to understand.

The dripstone_cluster feature allows you to add dripstone clusters to the world.

Configuration

The dripstone_cluster feature has the following configuration options:
Some of these options might be a bit hard to understand, We'd recommend just checking out the example below.

Option Type Description
floor_to_ceiling_search_range An int. (Range limit in Json is \([1;512]\)) Determines the maximum distance from the base of the dripstone cluster to the ceiling.
height An IntProvider (Range limit in Json is \([1;128]\)) The height of the cluster
radius An IntProvider. (Range limit in Json is \([1;128]\)) The radius of the cluster
max_stalagmite_stalactite_height_diff An int. (Range limit in Json is \([0;64]\)) The maximum difference in height between a stalagmite and a stalactite.
height_deviation An int. (Range limit in Json is \([1;64]\)) The height deviation.
dripstone_block_layer_thickness An IntProvider. (Range limit in Json is \([1;64]\)) The dripstone block layer thickness.
density A FloatProvider. (Range limit in Json is \([0.0;2.0]\)) The density of the dripstone cluster.
wetness A FloatProvider. (Range limit in Json is \([0.0;2.0]\)) The wetness of the dripstone cluster. A higher value will lead to more water blocks.
chance_of_dripstone_column_at_max_distance_from_center A float. (Range limit in Json is \([0.0;1.0]\)) The chance of a dripstone column at the maximum distance from the center.
max_distance_from_edge_affecting_chance_of_dripstone_column An int. (Range limit in Json is \([1;64]\)) The maximum distance from the edge affecting the chance of a dripstone column.
max_distance_from_center_affecting_height_bias An int. (Range limit in Json is \([1;64]\)) The maximum distance from the center affecting the height bias.

In code, the DripstoneClusterConfiguration class is used to configure the feature.

Example

ConfiguredFeatures.kt
val DRIPSTONE_CLUSTER = FeatureRegistry.registerConfiguredFeature(
    Machines,
    "dripstone_cluster",
    Feature.DRIPSTONE_CLUSTER,
    DripstoneClusterConfiguration(
        12, // floorToCeilingSearchRange
        UniformInt.of(3, 6), // height
        UniformInt.of(2, 8), // radius
        1, // maxStalagmiteStalactiteHeightDiff
        3, // heightDeviation
        UniformInt.of(2, 4), // dripstoneBlockLayerThickness
        UniformFloat.of(0.3f, 0.7f), // density
        ClampedNormalFloat.of(0.1f, 0.3f, 0.1f, 0.9f), // wetness
        0.1f, // chanceOfDripstoneColumnAtMaxDistanceFromCenter
        3, // maxDistanceFromEdgeAffectingChanceOfDripstoneColumn
        8 // maxDistanceFromCenterAffectingHeightBias
    )
)
PlacedFeatures.kt
val DRIPSTONE_CLUSTER = FeatureRegistry.registerPlacedFeature(
    Machines,
    "dripstone_cluster",
    ConfiguredFeatures.DRIPSTONE_CLUSTER,
    listOf(
        CountPlacement.of(UniformInt.of(48, 96)),
        InSquarePlacement.spread(),
        PlacementUtils.RANGE_BOTTOM_TO_MAX_TERRAIN_HEIGHT, // (1)!
        BiomeFilter.biome()
    )
)
  1. Constant for
    HeightRangePlacement.uniform(VerticalAnchor.bottom(), VerticalAnchor.absolute(256))
    
configured_feature/dripstone_cluster.json
{
  "type": "minecraft:dripstone_cluster",
  "config": {
    "chance_of_dripstone_column_at_max_distance_from_center": 0.1,
    "density": {
      "type": "minecraft:uniform",
      "value": {
        "max_exclusive": 0.7,
        "min_inclusive": 0.3
      }
    },
    "dripstone_block_layer_thickness": {
      "type": "minecraft:uniform",
      "value": {
        "max_inclusive": 4,
        "min_inclusive": 2
      }
    },
    "floor_to_ceiling_search_range": 12,
    "height": {
      "type": "minecraft:uniform",
      "value": {
        "max_inclusive": 6,
        "min_inclusive": 3
      }
    },
    "height_deviation": 3,
    "max_distance_from_center_affecting_height_bias": 8,
    "max_distance_from_edge_affecting_chance_of_dripstone_column": 3,
    "max_stalagmite_stalactite_height_diff": 1,
    "radius": {
      "type": "minecraft:uniform",
      "value": {
        "max_inclusive": 8,
        "min_inclusive": 2
      }
    },
    "wetness": {
      "type": "minecraft:clamped_normal",
      "value": {
        "deviation": 0.3,
        "max": 0.9,
        "mean": 0.1,
        "min": 0.1
      }
    }
  }
}
placed_feature/dripstone_cluster.json
{
  "feature": "minecraft:dripstone_cluster",
  "placement": [
    {
      "type": "minecraft:count",
      "count": {
        "type": "minecraft:uniform",
        "value": {
          "max_inclusive": 96,
          "min_inclusive": 48
        }
      }
    },
    {
      "type": "minecraft:in_square"
    },
    {
      "type": "minecraft:height_range",
      "height": {
        "type": "minecraft:uniform",
        "max_inclusive": {
          "absolute": 256
        },
        "min_inclusive": {
          "above_bottom": 0
        }
      }
    },
    {
      "type": "minecraft:biome"
    }
  ]
}

Result

Example