Source-checkedAdmin & protection

View Distance Tweaks

by froobynooby · for Minecraft

Dynamic per-world view distance and simulation distance.

79KDownloads
3 yr agoLast updated
Spigot · PaperLoaders
1.20Latest game version

About View Distance Tweaks

From SpigotMC

Dynamic per-world view distance and simulation distance.

View Distance Tweaks
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:
<button type="button" class="button bbCodeSpoilerButton ToggleTrigger Tooltip JsOnly" title="Click to reveal or hide spoiler" data-target="> .SpoilerTarget">Spoiler: config.yml</button>
Code (YAML):
# Configuration for View Distance Tweaks.
# 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:
# &nbsp; proactive : Adjust the simulation distance so that the player-loaded chunk count is always below a set threshold.
# &nbsp;
reactive &nbsp;: Adjust the simulation distance in response to changes in the server's MSPT.
# &nbsp; mixed &nbsp; &nbsp; : 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 :
&nbsp; # Set this to the maximum ticking chunk count your server can handle. The simulation distance of each world will be
&nbsp; # adjusted such that the total number of player-loaded chunks is sitting as close to this value as possible.
&nbsp; # &nbsp;
If you know your server can handle up to p many players with a simulation distance of d, a reasonable choice is
&nbsp; # &nbsp; &nbsp;to set this to (2d + 1)^2 p.
&nbsp; # &nbsp;
As an example, 5780 is the number of player-loaded ticking chunks for 20 players with a simulation distance of 8.
&nbsp; global-ticking-chunk-count-target : 5780

&nbsp; # Set this to the maximum number of non-ticking chunks you want to be loaded by the view distance.
&nbsp; # &nbsp; Note: this only counts chunks that are outside of the simulation distance of a player, but within the view
&nbsp; # &nbsp; &nbsp;view distance of a player.
&nbsp; # &nbsp;
If you know your server can handle up to p many players with a view distance of v and a simulation distance of s,
&nbsp; # &nbsp; &nbsp;a reasonable choice is to set this to ((2v + 1)^2 - (2s + 1)^2) p.
&nbsp; # &nbsp;
As an example, 6720 is the number of non-ticking chunks loaded by the view distance for 20 players with a view
&nbsp; # &nbsp; &nbsp;distance of 12 and a simulation distance of 8.
&nbsp; global-non-ticking-chunk-count-target : 6720

# These settings are for the reactive adjustment mode.
# &nbsp; MSPT stands for "milliseconds per tick", and tells you how long your server takes to tick on average. A server
# &nbsp; &nbsp;whose MSPT is above 50 will notice things slowing down, as the TPS drops.
reactive-mode-settings :

&nbsp; # Below what MSPT should we consider increasing the simulation distance?
&nbsp; increase-mspt-threshold : 40.0

&nbsp; # Above what MSPT should we consider decreasing the simulation distance?
&nbsp; decrease-mspt-threshold : 47.0

&nbsp; # These settings concern how we determine the server's MSPT.
&nbsp; # &nbsp;
Only touch these settings if you know what you're doing.
&nbsp; mspt-tracker-settings :
&nbsp; # Over how many ticks should we collect tick durations for calculating the MSPT?
&nbsp; &nbsp; # &nbsp; Setting this too high will make the MSPT very slow to react to changes.
&nbsp; &nbsp; # &nbsp;
Setting this too low will make the MSPT volatile.
&nbsp; &nbsp;collection-period : 1200

&nbsp; # We keep a history of MSPT vs. player-loaded chunk count in order to better predict what the MSPT will settle to
&nbsp; # after increasing the simulation distance.
&nbsp; mspt-prediction :
&nbsp; # Should we use MSPT prediction when we are considering increasing the simulation distance?
&nbsp; &nbsp; # &nbsp;* For example, we may be at 38 MSPT with a simulation distance of 6, meaning we would consider increasing the
&nbsp; &nbsp;

Read the full description on SpigotMC →

Highlights

From source data

Game 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

LoaderGame versionsNewest
Paper1.14 to 1.20 (7 versions)1.20
Spigot1.14 to 1.20 (7 versions)1.20

From 10 recorded builds of View Distance Tweaks.

Recent builds

BuildReleasedGame versionsLoaders
1.5.72023-10-131.14 to 1.20 (7 versions)Spigot, Paper
1.5.62023-06-12n/aSpigot, Paper
1.5.52023-04-01n/aSpigot, Paper
1.5.42022-12-19n/aSpigot, Paper
1.5.32022-09-27n/aSpigot, Paper
1.5.22022-08-06n/aSpigot, 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 catalog
Listed on SpigotMC as “Admin”

Admin & protection

Permissions, moderation, anti-cheat and land protection for the people running the server.

Runs on your server

From source side support

SpigotMC 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.

NxLabs

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.