COWMODSКаталог модов

View Distance Control

PaperMC plugin for per-player view distance control via LuckPerms permission nodes.

Автор: hank8809074482обновлён 3 мая 2026 г.
УправлениеОптимизацияУтилиты

Описание

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

  • LuckPerms
  • EssentialsX
  • PlaceholderAPI

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

NodeDescription
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.reloadAllows /vdc reload
viewdistancecontrol.getAllows /vdc get <player> and /vdc list
viewdistancecontrol.afkbypassBypasses 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

PlaceholderDescription
%viewdistancecontrol_distance%Player's current view distance

Commands

CommandDescription
/vdc reloadReloads config and reapplies distances to all online players
/vdc get <player>Shows a player's current view distance and AFK state
/vdc listShows all online players' view distances

Последние версии

Все версии →
release

ViewDistanceControl 0.0.6

0.0.6
3 мая 2026 г.161Minecraft: 26.1, 26.1.1, 26.1.2paper
Скачать
Что нового
## overview Compatibility update for Paper 26.1.2, the first stable release under Minecraft's new year-based versioning scheme (formerly 1.21.x). No behaviour changes. ### Changed - Built and tested against Paper 26.1.2 (requires Java 25 server runtime).
release

ViewDistanceControl 0.0.5

0.0.5
30 апр. 2026 г.221Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
## overview This release improves robustness around view distance clamping and fixes two bugs in the LuckPerms listener. A new `debug` config option makes it easier to diagnose when and why listeners fire without having to add temporary logging. ### Added - New `debug` config option (default: `false`) logs when each listener fires, so misfiring or missing events can be diagnosed without touching the code. ### Changed - Config defaults (`default-view-distance`, `default-afk-view-distance`) and permission-node-granted distances are now clamped to the server's `view-distance` setting, with a warning logged when clamping occurs. ### Fixed - Race condition in `LuckPermsListener` debounce logic: concurrent async `UserDataRecalculateEvent` firings could both see an empty pending map and schedule duplicate tasks. The remove→cancel→schedule→put sequence is now synchronized. - `LuckPermsListener` no longer applies view distance if the player disconnects between when the event fires and when the scheduled task runs.
release

ViewDistanceControl 0.0.4

0.0.4
30 апр. 2026 г.20Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
### Added - New `afk-distance-delay` config option (default: `5`) delays AFK view distance reduction by a configurable number of seconds after a player goes AFK. Set to `0` for the previous immediate behaviour. - New `console-log` config option (default: `false`) logs view distance changes to the server console. - New `/vdc list` command shows every online player's current view distance at once. ### Changed - `/vdc check <player>` renamed to `/vdc get <player>`; the associated permission node is renamed from `viewdistancecontrol.check` to `viewdistancecontrol.get`. - `/vdc get` (and `/vdc list`) now show `(pending AFK)` while the AFK delay is counting down, so the real AFK state is visible immediately even before the view distance switches. - View distance is now only set on the player when the value actually changes; notifications and console logs are suppressed for no-op updates.
release

ViewDistanceControl 0.0.3

0.0.3
28 апр. 2026 г.16Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
## What's new ### Bug fix: view distance applied multiple times per permission change LuckPerms fires `UserDataRecalculateEvent` several times for a single permission mutation (due to internal cache invalidation steps). This caused the view distance notification message to appear multiple times simultaneously. The handler is now debounced so only the final event in each burst takes effect. ### View distance cap (`viewdistancecontrol.max.<N>`) You can now cap a player's view distance from above without touching their existing group permissions. Assign `viewdistancecontrol.max.<N>` to a group and the resolved distance (from `default.<N>` / `afk.<N>` nodes and config defaults) will be clamped to at most `N`. If a player has multiple `max` nodes the lowest value wins (most restrictive). The cap applies in both normal and AFK states. **Example** — limit a restricted group to at most 6 chunks regardless of other groups: ``` lp group restricted permission set viewdistancecontrol.max.6 true ```
release

ViewDistanceControl 0.0.2

0.0.2
23 апр. 2026 г.10Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
Uses `setSendViewDistance` instead of `setViewDistance`, so AFK view distance reduction no longer unloads chunks on the server side.
release

ViewDIstanceControl 0.0.1

0.0.1
23 апр. 2026 г.19Minecraft: 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5, 1.21.6, 1.21.7, 1.21.8, 1.21.9, 1.21.10, 1.21.11paper
Скачать
Что нового
initial release