Configuration

Configuration

The shipped config.yml documents every setting in plain language next to the setting itself. The defaults are the safe recommended settings, and the file can be left alone.

Changes are applied with /chunkcarts reload (see Commands). Running journeys are not interrupted.

The four worth knowing about

enforcement

STRICT (default) or PERMISSIVE.

STRICT is the mode the safety claim is about: a minecart cannot be used as a chunk loader. PERMISSIVE deliberately turns that off. Set it and minecarts on your server can be used as chunk loaders, by anyone able to build a loop of powered rail. It prints a warning at every startup. Set it only if you trust everyone who plays there.

departure-requirement

How much human involvement a cart needs before it may set off.

• PLAYER_SEEN (default): a player must have been near the cart since its last trip.
• PLAYER_ONLINE: the rail network runs while anyone is online, and goes quiet overnight.
• NONE: fully automatic shuttles with nobody present.

progress-slack-chunks

The loop detector's tolerance. Raise it slightly if very winding but legitimate track is being cut off. Lowering it kills loops faster.

journey-cooldown

Minimum time between journeys for the same cart. It is waived if a player has touched the cart since, so stopping a cart, topping it up and sending it off again just works.

STRICT clamps rather than trusts

In STRICT mode the abusable settings are clamped to sane ceilings instead of being taken at face value. STRICT is a promise about behaviour, so it cannot also be a set of dials that quietly undo the promise. If you want a value above the ceiling, that means moving to PERMISSIVE and accepting everything else permissive mode brings.

Default values

Setting	Default
enforcement	STRICT
departure-requirement	PLAYER_SEEN
journey-cooldown	10m
journey-budget-chunks	256
progress-slack-chunks	16
region-radius	1
max-concurrent-journeys	16
poll-interval-ticks	10
min-tps	18.0
pause-tolerance	15s
arrival-hold-ticks	60
unload-hold	0s
min-speed	0.05
cart types enabled	normal, chest, hopper, furnace
cart types permanently disabled	TNT, command block
worlds.mode	BLOCKLIST (empty list)
stranded.log	true
stranded.notify-last-interactor	false
metrics	true

TNT and command block carts are permanently disabled and are not a setting you can change.

unload-hold is only useful in PERMISSIVE mode, and the reasoning is on Unattended Stations. metrics is covered on Metrics.