HomeJavaModsView Distance Control
View Distance Control
ModsJava

View Distance Control

by hank880907 · on Modrinth

Which Minecraft do you have?

Every version of the game needs its own build. Pick yours, then download — the wrong build installs fine and then does nothing in the game. This mod is built for Paper only.

⬇ Download for 26.1–26.1.2⬇ Download for 1.21–1.21.11
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.

View Distance Control

View Distance Control gives different chunk view distances to different groups of players on your server. Assign larger distances as a perk for donors or VIPs, limit guests to save bandwidth, or let the plugin automatically pull back the view distance for AFK players and restore it when they return. Getting started takes a single LuckPerms command per group; players with no matching permission fall back to the defaults in config.

Note: This plugin controls how much of the world is streamed to each player, not how much the server loads. Players see fewer chunks, but the server still keeps the same area loaded. If you want to reduce server load, lower simulation-distance in server.properties instead.

Dependencies

Configuration

plugins/ViewDistanceControl/config.yml:

default-view-distance: 10       # Fallback view distance
default-afk-view-distance: 4    # Fallback AFK view distance
afk-view-distance-enable: true  # Set to false to disable AFK distance reduction
afk-distance-delay: 5           # Seconds before AFK distance applies (0 = immediate)
notify-player: false            # Notify player when their view distance changes
notify-message: "Your view distance has been changed to %viewdistancecontrol_distance%"
console-log: false              # Log view distance changes to the console
debug: false                    # Log debug messages for diagnosing listener triggers

The notify-message supports & color codes and other PlaceholderAPI placeholders.

Permissions

Node Description
viewdistancecontrol.default.<N> Sets normal view distance to N. Highest granted value wins.
viewdistancecontrol.afk.<N> Sets AFK view distance to N. Highest granted value wins.
viewdistancecontrol.max.<N> Caps the resolved view distance to at most N. Lowest granted value wins.
viewdistancecontrol.reload Allows /vdc reload
viewdistancecontrol.get Allows /vdc get <player> and /vdc list
viewdistancecontrol.afkbypass Bypasses AFK view distance reduction

Example — give a VIP group a view distance of 16:

lp group vip permission set viewdistancecontrol.default.16 true

Example — cap a restricted group to at most 6 chunks, regardless of other groups:

lp group restricted permission set viewdistancecontrol.max.6 true

Note: The view distance is capped by view-distance in server.properties. If a value greater than the view-distance is set, the view-distnace would apply.

PlaceholderAPI

Placeholder Description
%viewdistancecontrol_distance% Player's current view distance

Commands

Command Description
/vdc reload Reloads config and reapplies distances to all online players
/vdc get <player> Shows a player's current view distance and AFK state
/vdc list Shows all online players' view distances
Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

Verified by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more