### ShapeBuilder / Sphere

**Spherical/ellipsoidal vein** — forms a sphere or ellipsoid that can be flattened/stretched vertically.

| Field | Type                             | Required | Description                                                 |
|-------|----------------------------------|----------|-------------------------------------------------------------|
| `type` | string                           | ✅ Yes | **`Sphere`**                                                |
| `baseRadius` | [RandomFloat](../RandomInt.md)   | ✅ Yes | Horizontal sphere radius                                    |
| `verticalScale` | [RandomFloat](../RandomFloat.md) | ❌ No | Compresses or stretches the sphere vertically; values <1 create flattened, lens‑shaped bodies, >1 make elongated, egg‑like forms. |
| `surfaceNoise` | [NoiseConfig](../NoiseConfig.md) | ❌ No | Adds smooth, wavy deformations to the outer surface of the sphere, creating natural-looking bumps and dents without sharp edges.    |
| `volumeNoise` | [NoiseConfig](../NoiseConfig.md) | ❌ No | Creates cloudy, uneven density patterns inside the sphere, forming rich pockets and empty voids for more varied ore distribution.    |
| `filters` | [VoxelFilter](../VoxelFilter.md) | ❌ No |         |

**How it works:**
1. Creates an ellipsoid centered at `pivot` (parameter from external generator)
2. Horizontal radius = `baseRadius`
3. Vertical radius = `baseRadius × verticalScaleRange` (can differ)
4. `density` determines filling from center to edge
5. `surfaceRoughness` adds surface irregularities

**Example:**
```json
{
  "type": "Sphere",
  "baseRadius": {
    "type": "AreaBalanced",
    "min": 4,
    "max": 12
  },
  "verticalScale": {
    "type": "Uniform",
    "min": 0.5,
    "max": 1.5
  },
  "surfaceNoise": {
    "amplitude": 0.2
  },
  "filters": [
    {
      "type": "RadialDensityFilter",
      "falloff": { "type": "Quadratic" }
    }
  ]
}
// Ellipsoid with horizontal radius 4-12,
// vertical radius = horizontal × (0.5-1.5)
// Rapid density falloff from center (QUADRATIC)
// Slightly rough surface
```