Config

Config

Every setting lives in config/nerocompanion.properties and reloads with /neroland config reload. Server settings are decided by the server and apply to everyone; client settings are each player's own.

Limits and throttling (server)

Key	Default	Range	What it does
maxCompanionsPerPlayer	4	1-64	Most companions one player may have deployed at once (parked and capsuled ones do not count)
maxActiveBotsPerChunkRegion	16	1-512	Most deployed companions of all players in one 8x8-chunk region
throttleDistance	32	8-256	Beyond this many blocks from its owner a companion thinks on every 4th tick only
sleepDistance	64	16-512	Beyond this many blocks from its owner an idle companion falls asleep

Energy (server)

Key	Default	Range	What it does
energy.lowBatteryPercent	10	1-50	At or below this charge a companion heads home, or sleeps if it has no home in range
energy.returnHomeRange	96	8-512	A low-battery companion only goes home when its home is within this many blocks

Authority (server)

Key	Default	What it does
pvpBots	false	Let combat companions attack players (still needs server PvP and only against a player who attacked first)
mining.enabled	true	Let mining companions break blocks at all
mining.maxJobSize	9 (1-16)	Edge length of the largest box one mining job may cover
combat.enabled	true	Let combat companions attack at all

Recovery and death salvage (server)

Key	Default	Range	What it does
lostAfterMinutes	30	1-10080	A companion unseen this long while its owner is online counts as lost
lostAfterOfflineDays	30	1-3650	A companion unseen this many days counts as lost even if its owner never returns
reclaimCost	0	0-1000000	Credits a reclaim costs; only charged with an economy mod
salvage.enabled	true		Companions gather their owner's dropped items after a death
salvage.carryBotsByDefault	true		Carry Bots salvage without a Salvage Chip
salvageWindowTicks	1200	100-12000	How long after a death companions keep gathering (20 ticks = 1 second)
salvageHoldMinutes	60	1-1440	How long a companion holds salvaged items (counted only while the owner is online)

Privacy (server)

Key	Default	Range	What it does
privacy.ledgerRetentionDays	180	1-3650	Days of inactivity after which a player's companion data is deleted from every store
privacy.allowNames	true		Show companion names to other players as nameplates
privacy.exportCooldownSeconds	300	10-86400	Wait between two /nscomp export requests

Looks (server)

Key	Default	What it does
season	none	none, spring, summer, autumn, winter or festive, for seasonal looks. Never read from the real clock

Debug (server)

Key	Default	Range	What it does
debug.maxSpawn	64	1-256	Most test companions one /nscomp debug spawn may create

Client

Key	Default	What it does
telemetryEnabled	true	Anonymous crash reports (see Privacy); takes effect on restart. A server never sets it for you
hud.enabled	true	Draw the companion strip
hud.anchor	TOP_LEFT	TOP_LEFT, TOP_CENTRE, TOP_RIGHT, MIDDLE_LEFT, CENTRE, MIDDLE_RIGHT, BOTTOM_LEFT, BOTTOM_CENTRE or BOTTOM_RIGHT
hud.offsetX	0	Extra horizontal offset in GUI pixels (-2000 to 2000)
hud.offsetY	0	Extra vertical offset in GUI pixels (-2000 to 2000)
hud.showNames	true	Show names on the strip
hud.compact	false	Always use the compact strip (no names)