Popular
Minecraft
Knowledgebase
Guide to Configuring spigot.yml for Optimal Minecraft Server Performance
The spigot.yml
file in Spigot servers allows fine-tuned control over server settings to optimize performance, enhance gameplay, and balance resource usage. It complements bukkit.yml
and contains settings grouped under categories like commands, messages, advancements, stats, and world-specific options.
Key Sections in spigot.yml
1. Commands
tab-complete
: Configures how many characters players must type to enable command autocomplete.
Example:0
enables full auto-complete;-1
disables it entirely.replace-commands
: Restores vanilla behavior for specified commands likesetblock
orsummon
.
2. Messages
Customize server responses:
whitelist
: Default:"You are not whitelisted on this server!"
restart
: Default:"Server is restarting"
Use &
for color codes and \n
for line breaks.
3. Performance Settings
netty-threads
: Adjusts networking threads; Default:4
.timeout-time
: Server freeze threshold before restarting; Default:60 seconds
.view-distance
: Controls visible chunks around players. Lower values improve performance.
Entity Controls:
entity-activation-range
: Default:(animals: 32, monsters: 32, misc: 16)
reduces entity processing outside a specific range.entity-tracking-range
: Manages client-visible entities to reduce client-side lag.
4. World-Specific Configurations
simulation-distance
: Affects updates of entities, blocks, and fluids.chunks-per-tick
: Controls chunk updates; lower values save resources.growth-modifiers
: Adjust crop and resource growth rates (e.g., cactus, wheat).
5. Advanced Server Behavior
hopper-settings
:
ticks-per.hopper-transfer
: Default:8
(controls hopper item movement).
zombie-aggressive-towards-villager
: Reduces zombie AI load by disabling villager targeting.
Optimizing Your Server
- Reduce
view-distance
to6-8
for large servers. - Adjust
entity-activation-range
to limit far-off entities. - Enable
nerf-spawner-mobs
for lag-heavy mob farms. - Fine-tune
hopper-settings
to control hopper activity.