Welcome to the Hangar Open Beta. Please report any issue you encounter on GitHub!
Avatar for LucasTHCR

Dynamic view & simulation distance adjustment per world — automatic, MSPT-aware, and fully configurable in a single conf

Report ViewDistanceTweaks?

R

2.1-RELEASE

ViewDistanceTweaks v2.1

Dynamic view distance and simulation distance adjustment per world — lightweight, fully configurable, and built for performance-critical servers.

Changelog

  • Added config validation: the plugin now warns on startup/reload for config mistakes that used to fail silently — unknown adjustment-mode values, increase-mspt-threshold set higher than decrease-mspt-threshold, mspt-variance.min-samples exceeding sample-window, and per-world max-view-distance conflicting with min-simulation-distance
  • mspt-tracker-settings.collection-period now actually does something: MSPT is tracked over the plugin's own rolling window sized to this value, instead of being silently capped at Paper's internal ~5-second tick-time buffer
  • Added per-world check intervals: any world can now override ticks-per-check independently via world-settings.<world>.ticks-per-check, instead of every world sharing one global timer. A busy overworld can react quickly while a quiet nether/end checks far less often
  • Added /vdt preset <small-server|large-network|performance-first>: applies a bundle of tuned config values in one command instead of hand-editing ~40 options from scratch
  • /vdt status now shows a per-world "next check" countdown, accounting for per-world interval overrides and any still-pending start-delay
  • Added a new bStats chart tracking how often revert-increase-if-overloaded fires — a high count signals the configured thresholds/step sizes are too aggressive for that server
  • Internal: replaced the single global check-scheduler with a per-tick dispatcher in DistanceEngine, needed to support independent per-world intervals; /vdt simulate and the real check cycle now share one target-calculation method so they can never drift apart

New Permissions

  • viewdistancetweaks.vdt.command.preset — required for /vdt preset

Config Changes

  • New (optional): world-settings.<world>.ticks-per-check
  • Removed: world-settings.<world>.chunk-counter-settings.exclude-overlap (was loaded but never had any effect)

Dependencies

Support

Join our Discord: dc.gg/paperstream

Author: LucasTHCR

Information

Author
LucasTHCR
Published
August 7, 2026
Downloads
0

Platforms

Paper
Paper
1.21–26.2