# Configuration

NeroLogistics config is managed by Neroland Core's config manager (schema id `nerologistics`). Every
value below is **server-authoritative** — the server's values win and sync to clients.

## Network controller

- **`enableController`** (default `true`) — master toggle for the controller's managed throughput boost.
- **`controllerUpkeepPerTick`** (default `8`) — NE/tick to keep a controller powered; below this it
  manages at base speed.
- **`controllerModuleBonusPercent`** (default `25`) — throughput bonus (%) each connected network module
  adds to a powered controller.
- **`controllerMaxModules`** (default `16`) — max modules a controller counts (bounds the flood-fill).
- **`controllerMaxPercent`** (default `500`) — cap on the managed throughput multiplier (`100` = no boost).

See [Network Controller](Controller.md) for how it works.

## Buffers

- **`enableBuffers`** (default `true`) — master toggle for keep-stocked buffer leveling (passive buffers
  always hold).
- **`bufferIntervalTicks`** (default `20`) — ticks between a keep-stocked buffer's top-up/overflow passes.

See [Buffers](Buffers.md).

## Auto-crafting

- **`enableAutoCrafting`** (default `true`) — master toggle for the auto-crafter.
- **`craftIntervalTicks`** (default `20`) — ticks between an auto-crafter's crafting passes.
- **`autoCraftEnergyPerCraft`** (default `200`) — NE charged per item crafted.
- **`autoCraftsPerInterval`** (default `4`) — base crafts per pass, scaled by the managing controller's
  capacity.

See [Auto-Crafting](Auto-Crafting.md).

## Local transport (conduits)

- **`itemTransferPerTick`** (default `64`) — max items moved per item network per tick.
- **`fluidTransferPerTick`** (default `1000`) — max mB moved per fluid network per tick.
- **`energyTransferPerTick`** (default `2560`) — max NE moved per energy network per tick.
- **`maxNodesPerNetwork`** (default `2000`) — max conduits in one network; a conduit past the cap stays
  isolated rather than costing tick time.

## Wireless

- **`enableWireless`** (default `true`) — master toggle for wireless cargo terminals.
- **`wirelessRange`** (default `64`) — max block distance between two terminals on a channel.
- **`wirelessEnergyPerItem`** (default `16`) — NE charged per item moved over a channel.
- **`wirelessIntervalTicks`** (default `10`) — ticks between wireless transport passes (batching window).

## Drones

- **`enableDrones`** (default `true`) — master toggle for drone hubs, drone ports and delivery drones.
- **`droneRange`** (default `48`) — max block distance a drone travels from its hub.
- **`dronesPerHub`** (default `4`) — hard cap on live drones per hub.
- **`droneEnergyPerDelivery`** (default `512`) — NE charged per delivery dispatched.

### Drone ports

- **`maxDronesPerPort`** (default `8`) — hard cap on drones (lanes) a port counts.
- **`dronePortRange`** (default `256`) — max distance an export port ships to an import port.
- **`dronePerDroneCapacity`** (default `16`) — items each drone carries per dispatch.
- **`dronePortEnergyPerStack`** (default `256`) — NE charged per dispatch.

See [Drone Ports](Drone-Ports.md).

## Native trains

- **`enableTrains`** (default `true`) — master toggle for native train stations.
- **`trainStationIntervalTicks`** (default `100`) — ticks between a load station's haul attempts.
- **`trainTicksPerBlock`** (default `2`) — transit ticks added per block of distance.
- **`trainMinTransitTicks`** (default `40`) — minimum transit time for a haul.
- **`trainMaxRange`** (default `2048`) — max distance a load station ships to an unload station.
- **`trainBulkPerTrip`** (default `27`) — max buffer slots hauled per trip.

See [Trains](Trains.md).

## Cross-dimension shipping

- **`enableCrossDimension`** (default `true`) — master toggle for rocket cargo ports.
- **`shipTransitTicks`** (default `1200`) — transit time for a shipment.
- **`shipEnergyPerStack`** (default `10000`) — NE charged per stack shipped.
- **`shipFuelPerLaunch`** (default `1`) — rocket-fuel-tagged items consumed per launch.
- **`shipIntervalTicks`** (default `100`) — ticks between a port's auto-ship attempts.
- **`maxPendingShipments`** (default `1024`) — hard cap on in-transit shipments; ports stop launching at
  the cap.

## Dashboards and privacy (POPIA/GDPR)

- **`perPlayerThroughputAttribution`** (default `false`) — opt-in: attribute cargo-port shipments to the
  placing player (UUID only). Off means no player data is stored.
- **`attributionRetentionDays`** (default `30`) — days to retain per-player attribution before
  auto-prune (`0` = keep until erased).

See [Dashboard & Privacy](Dashboard-and-Privacy.md) for the data posture.

> **Standalone:** NeroLogistics needs only **Neroland Core**. Everything works out of the box with no
> progression unlock and nothing to configure, whether or not the other Nero mods are installed.

## See also

- [Conduits](Conduits.md) · [Terminals](Terminals.md) · [Drones](Drones.md) ·
  [Cross-Dimension Shipping](Cross-Dimension-Shipping.md)