ViewDistanceTweaks v1.0
Your server. Your performance.
Dynamic view & simulation distance adjustment per world — lightweight, MSPT-aware, and fully configurable in a single config.yml. Automatically reduces distances under load and increases them when the server is idle.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
| 1.21 API Version |
Java 25 Required |
Paper Platform |
Free License |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✨ Features
Dynamic Sim & View Distance Automatically adjusts per world based on server load and player count. No manual restarts needed.
MSPT-based Prediction Linear regression model prevents bad increases — stops the increase → lag → decrease loop.
Per-world Configuration Each world has its own min/max distances, chunk weight, priority flag, and exclusion settings.
Temporary Overrides Lock distances for a set duration via /vdt viewdistance or /vdt simulationdistance.
PlaceholderAPI Support 20+ placeholders for scoreboards and tab lists — MSPT, TPS, chunk counts, distances per world.
/vdt Command Suite Status overview, reload, enable/disable, manual distance override — all in one command.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⚖️ Adjustment Modes
| Proactive Chunk-count based Targets a configured maximum chunk count and mathematically calculates the ideal distance before lag occurs. |
Reactive MSPT threshold based Reacts to MSPT crossing configurable thresholds — increases when idle, decreases when overloaded. |
Mixed (Recommended) Both combined Combines proactive and reactive. Always prioritizes reducing distance when the server is under load. |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Dependencies ● Paper 1.21.x / 26.x — required ● PlaceholderAPI — optional
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
⌨️ Commands & Permissions
| /vdt reload |
...command.reload |
Reload config live |
| /vdt status [--weight] |
...command.status |
Show world distances & chunk counts |
| /vdt simulationdistance [world] |
...simulationdistance |
Set sim distance temporarily |
| /vdt viewdistance [world] |
...viewdistance |
Set view distance temporarily |
| /vdt enable / disable |
...command.reload |
Toggle plugin on/off live |
| /vdt mspt |
...command.vdt |
Show current MSPT & TPS |
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI Placeholders Requires PlaceholderAPI to be installed on your server.
Code (Text):
%viewdistancetweaks_mspt% %viewdistancetweaks_tps% %viewdistancetweaks_mspt_color% %viewdistancetweaks_tps_color% %viewdistancetweaks_mode% %viewdistancetweaks_enabled% %viewdistancetweaks_sim_distance% %viewdistancetweaks_sim_distance_% %viewdistancetweaks_view_distance_% %viewdistancetweaks_min_sim_distance_% %viewdistancetweaks_max_sim_distance_% %viewdistancetweaks_chunk_count% %viewdistancetweaks_chunk_count_% %viewdistancetweaks_ticking_chunk_count% %viewdistancetweaks_nonticking_chunk_count% %viewdistancetweaks_chunk_weight_%
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Credits LucasTHCR — Creator & Maintainer Discord: dc.gg/лукас