# View Distance Control<\/p>\n
View Distance Control gives different chunk view distances to different groups of players on your server. Assign larger
\ndistances as a perk for donors or VIPs, limit guests to save bandwidth, or let the plugin automatically pull back the
\nview distance for AFK players and restore it when they return. Getting started takes a single LuckPerms command per
\ngroup; players with no matching permission fall back to the defaults in config.<\/p>\n
> **Note:** This plugin controls how much of the world is *streamed* to each player, not how much the server loads.
\n> Players see fewer chunks, but the server still keeps the same area loaded. If you want to reduce server load, lower
\n`simulation-distance` in `server.properties` instead.<\/p>\n
## Dependencies<\/p>\n
– LuckPerms
\n– EssentialsX
\n– PlaceholderAPI<\/p>\n
## Configuration<\/p>\n
`plugins\/ViewDistanceControl\/config.yml`:<\/p>\n
“`yaml
\ndefault-view-distance: 10 # Fallback view distance
\ndefault-afk-view-distance: 4 # Fallback AFK view distance
\nafk-view-distance-enable: true # Set to false to disable AFK distance reduction
\nafk-distance-delay: 5 # Seconds before AFK distance applies (0 = immediate)
\nnotify-player: false # Notify player when their view distance changes
\nnotify-message: “Your view distance has been changed to %viewdistancecontrol_distance%”
\nconsole-log: false # Log view distance changes to the console
\ndebug: false # Log debug messages for diagnosing listener triggers
\n“`<\/p>\n
The `notify-message` supports `&` color codes and other PlaceholderAPI placeholders.<\/p>\n
## Permissions<\/p>\n
| Node | Description | **Example** \u2014 give a VIP group a view distance of 16:<\/p>\n “` **Example** \u2014 cap a restricted group to at most 6 chunks, regardless of other groups:<\/p>\n “` > **Note:** The view distance is capped by `view-distance` in `server.properties`. If a value greater than the ## PlaceholderAPI<\/p>\n | Placeholder | Description | ## Commands<\/p>\n | Command | Description | PaperMC plugin for per-player view distance control via LuckPerms permission nodes.<\/p>\n","protected":false},"featured_media":166174,"template":"","meta":{"_minecraft_slug":"viewdistancecontrol","_minecraft_project_id":"EI18paZi","_minecraft_author":"hank880907","_minecraft_license":"MIT","_minecraft_downloads":26,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"viewdistancecontrol.zip","_minecraft_size_bytes":87293,"_minecraft_version_count":6,"_minecraft_updated_at":"2026-05-15T22:15:33.217109Z","_minecraft_date_created":"2026-05-02T21:16:18.005323Z","_minecraft_date_modified":"2026-05-03T22:15:51.829166Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/viewdistancecontrol","_minecraft_icon_attachment_id":166174,"_minecraft_imported_at":"2026-06-09T18:15:06+00:00","_minecraft_import_hash":"e4c46479af60c37c231b9e26c1008a03","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,90,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-166173","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-optimization","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n|———————————–|————————————————————————–|
\n| `viewdistancecontrol.default.
\n| `viewdistancecontrol.afk.
\n| `viewdistancecontrol.max.
\n| `viewdistancecontrol.reload` | Allows `\/vdc reload` |
\n| `viewdistancecontrol.get` | Allows `\/vdc get
\n| `viewdistancecontrol.afkbypass` | Bypasses AFK view distance reduction |<\/p>\n
\nlp group vip permission set viewdistancecontrol.default.16 true
\n“`<\/p>\n
\nlp group restricted permission set viewdistancecontrol.max.6 true
\n“`<\/p>\n
\n`view-distance` is set, the `view-distnace` would apply.<\/p>\n
\n|———————————-|——————————–|
\n| `%viewdistancecontrol_distance%` | Player’s current view distance |<\/p>\n
\n|———————|————————————————————–|
\n| `\/vdc reload` | Reloads config and reapplies distances to all online players |
\n| `\/vdc get
\n| `\/vdc list` | Shows all online players’ view distances |<\/p>\n","protected":false},"excerpt":{"rendered":"