minecraft-bedrock-json-schemas/source/behavior/features/features/minecraft.snap_to_surface_feature.json

{
  "title": "Snap To Surface Feature",
  "description": "`minecraft:snap_to_surface_feature` snaps the y-value of a feature placement pos to the floor or the ceiling within the provided `vertical_search_range`. The placement biome is preserved. \nIf the snap position goes outside of the placement biome, placement will fail.",
  "type": "object",
  "additionalProperties": false,
  "required": ["description", "feature_to_snap", "vertical_search_range"],
  "properties": {
    "description": {
      "$ref": "../types/description.json"
    },
    "feature_to_snap": {
      "title": "Feature To Snap",
      "description": "Named reference of feature to be snapped.",
      "type": "string",
      "$ref": "../../../general/feature/identifier.json"
    },
    "vertical_search_range": {
      "title": "Vertical Search Range",
      "description": "Range to search for a floor or ceiling for snaping the feature.",
      "type": "number"
    },
    "surface": {
      "title": "Surface",
      "description": "Defines the surface that the y-value of the placement position will be snapped to. Valid values: `ceiling` and `floor'",
      "type": "string",
      "enum": ["ceiling", "floor", "random_horizontal"]
    },
    "allow_air_placement": {
      "title": "Allow Air Placement",
      "description": "Determines whether the feature can snap through air blocks",
      "type":"boolean",
      "default": true
    },
    "allow_underwater_placement": {
      "title": "Allow Underwater Placement",
      "description": "Determines whether the feature can snap through water blocks",
      "type":"boolean",
      "default": false
    }
  }
}