# Space settings

Travel, worldgen, mobs, fluid reserves, radiation and machines.

Registry: `hbmspace:space_config`. Files: `data/hbmspace/hbmspace/space_config/<group>.json`. The settings load when the world opens and sync to joining clients; `/reload` leaves them unchanged. A higher-priority file replaces the whole group, and an omitted key uses its code default, which equals the shipped value. A missing group, an undeclared group or key, or an invalid value stops the world from loading.

## travel

| Field | Meaning and default | Range |
| - | - | - |
| `allow_nether_portals` | Accepted for compatibility; it has no effect. Default `false`. | |
| `max_probe_distance` | Half-width `R`: a player leaving their station cell is teleported to the orbited body at X and Z uniform in `[-R, R)`, Y 800. A Hard Drive without a survey centre rolls one in the same range. Default `32000`. | `[1, 1073741823]` |
| `max_station_distance` | A new orbital station takes a random cell within $\pm n$ per axis, $n = \mathrm{value}/1024$. Default `32000`. | `[1024, i32::MAX]` |
| `combat_pod_despawn` | `true` removes a combat drop pod block on its scheduled tick. Default `false`. | |

```json
{"allow_nether_portals": false, "combat_pod_despawn": false, "max_probe_distance": 32000, "max_station_distance": 32000}
```

## worldgen

| Field | Meaning and default |
| - | - |
| `enable_volcano_gen` | `false` omits the active vent block at the top of [`hbmspace:volcano`](https://movblock.mov/ntm-next/wiki/space/world-generation/volcano.md) cones; the cones still generate. Default `true`. |

```json
{"enable_volcano_gen": true}
```

## mobs

| Field | Meaning and default |
| - | - |
| `enable_mun_cows` | `false` stops Mun Cows spawning in the Mun biome. Default `true`. |
| `server_safety` | NTM's Quackos ignores kills. `true` counts each kill as 2, minus 1 per tick, and removes the entity once the count exceeds 20, so rapid repeated kills remove it. Default `false`. |

```json
{"enable_mun_cows": true, "server_safety": false}
```

## reserves

Fluid amounts of celestial oil, gas and brine deposits, read by NTM's oil drills. The [pumpjack's](https://movblock.mov/ntm-next/wiki/machine-settings/pumpjack.md) reserve multipliers apply on top. NTM's oil and bedrock oil deposits use the `earth_*` and `bedrock_*` values while Space is installed.

| Field | Meaning and default | Range |
| - | - | - |
| `bedrock_oil_per_deposit` | mB of oil from a bedrock oil deposit outside Tekto per drill operation. Default `100`. | `[0, i32::MAX]` |
| `bedrock_gas_per_deposit_min` | Minimum mB of gas per operation. Default `10`. | `[0, i32::MAX]` |
| `bedrock_gas_per_deposit_max` | Maximum mB of gas per operation, exclusive; a maximum at or below the minimum yields the minimum. Default `50`. | `[0, i32::MAX]` |
| `tekto_bedrock_oil_per_deposit` | mB of oil from a Tekto bedrock oil deposit per drill operation. Default `100`. | `[0, i32::MAX]` |
| `tekto_bedrock_gas_per_deposit_min` | Minimum mB of gas per operation. Default `10`. | `[0, i32::MAX]` |
| `tekto_bedrock_gas_per_deposit_max` | Maximum mB of gas per operation, exclusive; a maximum at or below the minimum yields the minimum. Default `50`. | `[0, i32::MAX]` |
| `earth_oil_per_deposit` | mB of oil on Kerbin and on bodies without their own keys per drill operation. Default `500`. | `[0, i32::MAX]` |
| `earth_gas_per_deposit_min` | Minimum mB of gas per operation. Default `100`. | `[0, i32::MAX]` |
| `earth_gas_per_deposit_max` | Maximum mB of gas per operation, exclusive; a maximum at or below the minimum yields the minimum. Default `500`. | `[0, i32::MAX]` |
| `earth_oil_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.05`. | `[0, 1]` |
| `duna_oil_per_deposit` | mB of oil on Duna per drill operation. Default `200`. | `[0, i32::MAX]` |
| `duna_gas_per_deposit_min` | Minimum mB of gas per operation. Default `100`. | `[0, i32::MAX]` |
| `duna_gas_per_deposit_max` | Maximum mB of gas per operation, exclusive; a maximum at or below the minimum yields the minimum. Default `500`. | `[0, i32::MAX]` |
| `duna_oil_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.1`. | `[0, 1]` |
| `laythe_oil_per_deposit` | mB of desulfurized oil on Laythe per drill operation. Default `500`. | `[0, i32::MAX]` |
| `laythe_gas_per_deposit_min` | Minimum mB of gas per operation. Default `100`. | `[0, i32::MAX]` |
| `laythe_gas_per_deposit_max` | Maximum mB of gas per operation, exclusive; a maximum at or below the minimum yields the minimum. Default `500`. | `[0, i32::MAX]` |
| `laythe_oil_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.05`. | `[0, 1]` |
| `tekto_oil_per_deposit` | mB of tektonic crude on Tekto per drill operation. Default `500`. | `[0, i32::MAX]` |
| `tekto_gas_per_deposit_min` | Minimum mB of heavy gas per operation. Default `100`. | `[0, i32::MAX]` |
| `tekto_gas_per_deposit_max` | Maximum mB of heavy gas per operation, exclusive; a maximum at or below the minimum yields the minimum. Default `500`. | `[0, i32::MAX]` |
| `tekto_oil_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.05`. | `[0, 1]` |
| `eve_gas_per_deposit` | mB of gas on Eve per drill operation. Default `500`. | `[0, i32::MAX]` |
| `eve_petroleum_per_deposit_min` | Minimum mB of petroleum gas per operation. Default `20`. | `[0, i32::MAX]` |
| `eve_petroleum_per_deposit_max` | Maximum mB of petroleum gas per operation, exclusive; a maximum at or below the minimum yields the minimum. Default `100`. | `[0, i32::MAX]` |
| `eve_gas_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.05`. | `[0, 1]` |
| `mun_brine_per_deposit` | mB of brine on Mun per drill operation. Default `300`. | `[0, i32::MAX]` |
| `mun_brine_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.05`. | `[0, 1]` |
| `minmus_brine_per_deposit` | mB of brine on Minmus per drill operation. Default `300`. | `[0, i32::MAX]` |
| `minmus_brine_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.05`. | `[0, 1]` |
| `ike_brine_per_deposit` | mB of brine on Ike per drill operation. Default `300`. | `[0, i32::MAX]` |
| `ike_brine_drain_chance` | Chance per operation, times the drill's multiplier, that the deposit becomes its drained block. Default `0.05`. | `[0, 1]` |

## radiation

| Field | Meaning and default | Range |
| - | - | - |
| `celestial_rad_multiplier` | Sky radiation at sky-lit positions on celestial bodies and in orbit: $(\mathrm{sun\ power} - 4 \times \mathrm{atmospheric\ pressure}) \times$ this value, unless incoming radiation is higher. At 1, the open sky of the Mun gives 1 RAD/s. Default `0.25`. | `[0, f64::MAX]` |

```json
{"celestial_rad_multiplier": 0.25}
```

## radiator

| Field | Meaning and default | Range |
| - | - | - |
| `input_tank_capacity` | Spent-steam tank capacity of the Steam Radiator, in mB; read when the machine is created. Default `500`. | `[0, i32::MAX]` |
| `output_tank_capacity` | Water tank capacity of the Steam Radiator, in mB. Default `500`. | `[0, i32::MAX]` |

```json
{"input_tank_capacity": 500, "output_tank_capacity": 500}
```

> **since Space 1.0.1**
>
> ## machines
>
> | Field | Meaning and default |
> | - | - |
> | `unavoidable_gravity` | Machines that tilt when unsupported settle outside orbit; `false` disables the settling everywhere. Default `true`. |
>
> ```json
> {"unavoidable_gravity": true}
> ```
