General settings
Top-level Dynamic Join Greetings configuration fields and selection settings.
configVersion
number- Default
1- Accepted
- Must equal 1
Schema version for the configuration file. Unsupported values cause reload validation to fail and leave the previous configuration active.
enabled
boolean- Default
true- Accepted
- true or false
Master switch. When false, automatic join greetings are not scheduled.
serverName
string- Default
"Minecraft Server"- Accepted
- Non-empty string
Literal text substituted for the {server} placeholder after escaping.
delayTicks
number- Default
40- Accepted
- Integer from 0 to 1200
Ticks to wait before delivering a join greeting. Twenty ticks is approximately one second. A value of 0 delivers immediately.
Selection settings
These fields live under selection.
selection.mode
enum- Default
SHUFFLE_BAG- Accepted
- RANDOM, NO_REPEAT, SHUFFLE_BAG
Chooses how messages are picked from a pool. See the selection-modes page for exact behavior.
selection.avoidImmediateRepeats
boolean- Default
true- Accepted
- true or false
When possible, prevents selecting the same message twice in a row. NO_REPEAT always avoids consecutive duplicates when another message exists.
selection.rememberPerPlayer
boolean- Default
true- Accepted
- true or false
When true, each player has independent selection history. When false, the pool shares one server-wide selection history.
Selection state is held in memory only. It resets on server restart and on successful /joingreetings reload. Persistent first-join history is separate.
Found a problem in these docs? Report a documentation issue on GitHub.