NeroEvents reads config/neroevents.properties (created on first launch). Every event key below is
decided by the server and synced to players; only telemetryEnabled is a per-player setting. Run
/neroland config reload after editing — the event engine picks up the new values at its next
scheduler check (every schedulerIntervalTicks).
Times are in ticks: 20 ticks = 1 second, 1200 = 1 minute, 72000 = 1 hour.
Roll events automatically. false stops automatic events; /neroevents start still works.
schedulerIntervalTicks
600
How often the scheduler checks whether an event is due (100 to 6000).
schedulerBaseIntervalTicks
36000
Average time between automatic events at a population multiplier of 1.0 (30 minutes).
schedulerJitterFraction
0.5
Random spread on that time: 0.5 means anywhere from half to one and a half times as long.
schedulerRetryTicks
6000
When nothing was eligible, how long until the scheduler tries again.
schedulerGlobalCooldownTicks
6000
The shortest gap allowed between two automatic events.
schedulerBands
0-1:2.0:1;2-4:1.0:1;5-9:0.8:2;10+:0.6:3
Population bands, see below.
schedulerDefinitionsCap
256
The most event definitions loaded from data packs; extras are skipped with a warning.
schedulerPassWarnMicros
2000
A scheduler check slower than this logs one debug line per server start.
calmWindowHours
48
Hours of server uptime before automatic events begin (only events marked calm-exempt may fire earlier). Uptime is world time, so it does not count while the server is off.
maxConcurrentEvents
4
Hard ceiling on events running at once.
maxConcurrentBossEvents
1
World-boss events at once. There is never more than one boss per dimension.
These apply only while one player is alone on an integrated (non-dedicated) server — a single-player
world, or one opened to LAN with nobody else connected. As soon as a second player joins, the next
scheduler check uses the server pacing above.
Key
Default
What it does
singlePlayerPacing
true
Use the singlePlayer* keys below when one player is alone on an integrated (non-dedicated) server; false keeps dedicated-server pacing in single-player too.
singlePlayerFirstEventMinutes
8
Minutes of play (world time) in a single-player world before the first automatic event is rolled; 0 = no wait (0 to 720).
singlePlayerCalmWindowMinutes
30
Minutes of play (world time) in a single-player world before automatic events other than calm-exempt ones start; replaces calmWindowHours while alone (0 to 1440).
singlePlayerIntervalMultiplier
1.0
Multiplies schedulerBaseIntervalTicks while alone in a single-player world, in place of the population band's multiplier (1.0 = about 30 minutes between events).
singlePlayerCooldownMultiplier
0.5
Multiplies every event definition's cooldown when it fires while alone in a single-player world (0.1 to 1.0).
Busy servers see events more often than quiet ones. Each band is name:multiplier:cap:
the name is an online-player range, a-b or a+ for the last one,
the multiplier scales schedulerBaseIntervalTicks (2.0 = half as often, 0.6 = more often),
the cap is how many events may run at once in that band.
With the default, one player online on a server gets an automatic event about once an hour and at most
one at a time (a single-player world uses the single-player keys instead); ten or more players get one roughly every 18 minutes and up to three at once. Bands must start
at 0 and follow on without gaps; a table with a mistake is replaced by the default (the log says
which entry was wrong).
Allow events that can change blocks. false removes them from the schedule and refuses /neroevents start for them.
combatEventsEnabled
true
Allow combat, raid, invasion, boss and war events.
economyEventsEnabled
true
Allow economy events.
pushNotificationsEnabled
true
Allow companion-app notifications and stored alerts about events. false sends none to anyone (live event rows in the app still update). Has no effect until a NeroLink module is present.
eventsDisabled
(empty)
Comma-separated event ids that never fire automatically.
Areas events never touch: name@dimension:x1,z1,x2,z2, separated by ;. Example: base@minecraft:overworld:-100,-100,100,100. You can also add zones in game with /neroevents zones add.
protectSpawnRadiusBlocks
64
Events keep this far from world spawn (the server's own spawn protection applies if it is larger). A single-player or LAN world has no server spawn-protection setting, so only this value applies there.
Meteors dig small craters. false makes every impact a soft landing (one loot pocket, no crater).
craterAvoidsBlockEntities
true
A meteor that would land near a chest, machine or any other block entity lands softly instead.
craterBlockEntityMarginBlocks
4
How far around an impact those blocks are looked for (0 to 16).
raidBlockDamage
false
Reserved. NeroEvents never breaks blocks for a raid in this version (the creatures follow the server's normal mob rules); keep it false.
wreckLingerDays
3
Real days before a crashed wreck starts to rust away (twice that and it is rubble). 0 keeps wrecks forever. A crate that still holds loot is never removed.
wreckRecordsMax
200
Most wrecks remembered for decay; the oldest are forgotten first (their blocks then stay).
stormEffectsEnabled
true
Server-wide switch for what storms do to players out in the open (each storm event can also turn this off).
stormDrainFractionPerPass
0.01
Share of stored energy a draining storm (solar, ion) takes from an exposed storage per check at full strength. Checks are every 10 seconds.
stormDrainMaxPerPass
5000
Most energy taken from one storage per check.
stormDrainFloorFraction
0.2
A storm never drains a storage below this share of its capacity.
stormDrainChunkRadius
3
Storages are drained only within this many chunks of a player.
stormDrainMaxStoragesPerPass
64
Most storages drained per check.
warMinMembersOnline
2
Members a faction needs online to be drawn into a faction war.
An energy storage counts as exposed when the sky is open above it. On Fabric only Neroland storages are
drained; on NeoForge and Forge any storage that exposes standard energy is.
Some events need another Neroland mod (or a claims mod) on the server. Nothing needs configuring: each
integration switches itself on when the mod is installed and this build of NeroEvents carries support for
it, and /neroevents status (operators) lists which integrations are live.
Mod
What it adds
Nerospace
Solar storms in space and planetary storms (dust, ion, cryo).
NeroAgriculture
Storms slow crop growth while they rage.
NeroCreatures
Pirate raids, alien invasions and the world boss.
NeroFactions
Faction wars.
NeroEconomy
Market shocks.
NeroColonies
Colonies are protected from destructive events.
Open Parties and Claims
Claimed chunks are protected from destructive events.
Other claim mods (FTB Chunks, Flan) are not integrated yet; use eventExclusionZones to protect those
areas.