About View Distance Tweaks
From SpigotMCDynamic per-world view distance and simulation distance.
Dynamic per-world view distance and simulation distance, giving a better balance of gameplay and performance.
This plugin will dynamically adjust the view distance and simulation distance of each world in order to meet your server's needs. In effect, it allows you to automatically decrease the view distance and simulation distance when the server is busy and then increase again when it is quiet.
Installation
To install the plugin simply place the downloaded jar file into your server's plugin directory.
Since different servers have different capabilities / preferences, you will be required to configure the plugin before it is enabled. To configure the plugin, edit the config.yml which is found in the ViewDistanceTweaks folder within your server's plugin directory. When you are happy with the changes you have made you can set the 'enabled' option in the config.yml to true and restart or reload the server.
Configuration
There are many things to configure:
# Plugin page: https://www.spigotmc.org/resources/75164/
# Github: https://github.com/froobynooby/ViewDistanceTweaks
# Please don't change this!
version : 8
# Set this to true to enable the plugin. The plugin is initially disabled so that you can make changes to the config
# appropriate to your server.
enabled : false
# How should we determine whether the simulation distance needs adjusting? Accepts three values:
# proactive : Adjust the simulation distance so that the player-loaded chunk count is always below a set threshold.
# reactive : Adjust the simulation distance in response to changes in the server's MSPT.
# mixed : Be both proactive and reactive; prioritising decreasing the simulation distance over increasing.
adjustment-mode : mixed
# These settings are for the proactive adjustment mode.
proactive-mode-settings :
# Set this to the maximum ticking chunk count your server can handle. The simulation distance of each world will be
# adjusted such that the total number of player-loaded chunks is sitting as close to this value as possible.
# If you know your server can handle up to p many players with a simulation distance of d, a reasonable choice is
# to set this to (2d + 1)^2 p.
# As an example, 5780 is the number of player-loaded ticking chunks for 20 players with a simulation distance of 8.
global-ticking-chunk-count-target : 5780
# Set this to the maximum number of non-ticking chunks you want to be loaded by the view distance.
# Note: this only counts chunks that are outside of the simulation distance of a player, but within the view
# view distance of a player.
# If you know your server can handle up to p many players with a view distance of v and a simulation distance of s,
# a reasonable choice is to set this to ((2v + 1)^2 - (2s + 1)^2) p.
# As an example, 6720 is the number of non-ticking chunks loaded by the view distance for 20 players with a view
# distance of 12 and a simulation distance of 8.
global-non-ticking-chunk-count-target : 6720
# These settings are for the reactive adjustment mode.
# MSPT stands for "milliseconds per tick", and tells you how long your server takes to tick on average. A server
# whose MSPT is above 50 will notice things slowing down, as the TPS drops.
reactive-mode-settings :
# Below what MSPT should we consider increasing the simulation distance?
increase-mspt-threshold : 40.0
# Above what MSPT should we consider decreasing the simulation distance?
decrease-mspt-threshold : 47.0
# These settings concern how we determine the server's MSPT.
# Only touch these settings if you know what you're doing.
mspt-tracker-settings :
# Over how many ticks should we collect tick durations for calculating the MSPT?
# Setting this too high will make the MSPT very slow to react to changes.
# Setting this too low will make the MSPT volatile.
collection-period : 1200
# We keep a history of MSPT vs. player-loaded chunk count in order to better predict what the MSPT will settle to
# after increasing the simulation distance.
mspt-prediction :
# Should we use MSPT prediction when we are considering increasing the simulation distance?
# * For example, we may be at 38 MSPT with a simulation distance of 6, meaning we would consider increasing the
Highlights
From source dataGame versions
Supports 7 Minecraft versions, the newest being 1.20.
Loaders
Runs on Spigot and Paper.
Footprint
Rated a light load on a server.
View Distance Tweaks on Nxeon
From our catalogue- One-click install
- Supported on Nxeon Minecraft servers, for Paper servers. We download it from SpigotMC, place it, and restart the server.
- Server side
- Required on the server
- Server type needed
- Spigot, Paper
- Server load
- light
- Smallest plan we suggest
- Minecraft — 2 GB (2 GB RAM). This follows our own load rating above, not a benchmark.
- Latest build
- 1.5.7, released 2023-10-13
Game versions by loader
| Loader | Game versions | Newest |
|---|---|---|
| Paper | 1.14 to 1.20 (7 versions) | 1.20 |
| Spigot | 1.14 to 1.20 (7 versions) | 1.20 |
From 10 recorded builds of View Distance Tweaks.
Recent builds
| Build | Released | Game versions | Loaders |
|---|---|---|---|
| 1.5.7 | 2023-10-13 | 1.14 to 1.20 (7 versions) | Spigot, Paper |
| 1.5.6 | 2023-06-12 | n/a | Spigot, Paper |
| 1.5.5 | 2023-04-01 | n/a | Spigot, Paper |
| 1.5.4 | 2022-12-19 | n/a | Spigot, Paper |
| 1.5.3 | 2022-09-27 | n/a | Spigot, Paper |
| 1.5.2 | 2022-08-06 | n/a | Spigot, Paper |
Run View Distance Tweaks on a Minecraft server
Pick a server or deploy a new one above; it is installed in one click.
What kind of mod it is
From the catalogAdmin & protection
Permissions, moderation, anti-cheat and land protection for the people running the server.
Runs on your server
From source side supportSpigotMC lists View Distance Tweaks as required on the server. Check its SpigotMC page to see whether players need it too.
Compatibility
- Game
- Minecraft
- Loaders
- SpigotPaper
- Runs on
- Serverrequired on the server
- Game versions
- 1.20 and 6 earlier
- Requires
- One-click install needs a Paper server.
Verified at the source
- ✓SpigotMCOfficial listing, checked 2026-10-01Open ↗
- ✓Authorfroobynooby, as published on SpigotMC
- ✓LicenseNot published by the sourceFree
View Distance Tweaks, answered
Generated from the mod’s own source data.
Do my players need to install View Distance Tweaks?
SpigotMC lists View Distance Tweaks as required on the server. Check its SpigotMC page to see whether players need it too.
Which loaders does it support?
Spigot and Paper.
Is it free?
Yes. View Distance Tweaks is free to download from SpigotMC.
How do I add it to my Nxeon server?
Use “Add to a server” on this page, or open NxLabs from your dashboard. We install it, restart your server and switch it on.

Run View Distance Tweaks on a Minecraft server.
Deploy in about a minute from $4.99 a month, then add View Distance Tweaks in one click.









