View Distance Tweaks - 视距优化 - View Distance Tweaks

View Distance Tweaks 是一款动态调整各世界视距与模拟距离的插件，旨在根据服务器负载自动平衡游戏体验与性能表现。它能在服务器繁忙时自动降低视距与模拟距离以减轻负担，并在空闲时恢复，从而优化整体运行效率。

💡安装

• 将下载的 .jar 文件放入服务器的 plugins 文件夹。
• 由于不同服务器的性能与需求各异，启用前必须进行配置。请编辑 plugins/ViewDistanceTweaks 目录下的 config.yml 文件。
• 完成配置后，将 config.yml 中的 enabled 选项设为 true，然后重启或重载服务器。

🎮配置

配置文件 config.yml 包含多项可调整的设置，主要结构如下：

基础设置

• enabled：设为 true 以启用插件。
• adjustment-mode：调整模拟距离的模式，可选：

- `proactive`：主动模式，确保玩家加载的区块总数低于设定阈值。

- `reactive`：响应模式，根据服务器 MSPT（每刻毫秒数）的变化进行调整。

- `mixed`：混合模式，结合主动与响应策略，优先降低模拟距离。

主动模式设置 (`proactive-mode-settings`)

• global-ticking-chunk-count-target：服务器能处理的最大 ticking 区块总数目标值。
• global-non-ticking-chunk-count-target：视距加载的非 ticking 区块最大数量目标值。

响应模式设置 (`reactive-mode-settings`)

• increase-mspt-threshold：低于此 MSPT 值时考虑增加模拟距离（默认 40.0）。
• decrease-mspt-threshold：高于此 MSPT 值时考虑减少模拟距离（默认 47.0）。

MSPT 追踪与预测

• collection-period：计算 MSPT 时收集的刻数周期（默认 1200）。
• mspt-prediction：启用 MSPT 预测以避免频繁调整。
• history-length：MSPT 与区块数量历史记录的保留时长（分钟）。

调整行为

• ticks-per-check：每次检查是否需要更新距离的间隔刻数（默认 600）。
• start-up-delay：插件启动后等待多少刻再开始检查（默认 2400）。
• passed-checks-for-increase：连续多少次检查通过后才实际增加距离（默认 10）。
• passed-checks-for-decrease：连续多少次检查通过后才实际减少距离（默认 1）。
• log-changes：是否在控制台输出距离变更日志。

世界特定设置 (`world-settings`)

可为每个世界单独配置，未指定的世界将使用 default 中的设置。

• simulation-distance：模拟距离相关设置，包括是否排除管理、最小/最大值。
• view-distance：视距相关设置，包括是否排除管理、最小/最大值。
• chunk-weight：该世界区块的性能权重（例如末地可设为 0.5）。
• chunk-counter-settings：区块计数设置，如是否排除玩家间重叠的区块。

🔧兼容性

• 本插件不兼容 CraftBukkit，必须使用 Spigot 或其衍生服务端（如 Paper）。
• 由于区块系统的变更，不支持 1.14 以下的 Minecraft 版本。

❓命令

使用基础命令需要权限节点 viewdistancetweaks.command.vdt。

• /vdt reload

- 重载插件配置。

- 权限：`viewdistancetweaks.vdt.command.reload`

• /vdt status [--weight]

- 显示各世界视距等信息，`--weight` 可显示区块权重。

- 权限：`viewdistancetweaks.vdt.command.status`

• /vdt simulationdistance <距离> [世界] [--duration <分钟>]

- 设置指定世界（未指定则所有世界）的模拟距离，可设定持续时间。

- 权限：`viewdistancetweaks.vdt.command.simulationdistance`

• /vdt viewdistance <距离> [世界] [--duration <分钟>]

- 设置指定世界（未指定则所有世界）的视距，可设定持续时间。

- 权限：`viewdistancetweaks.vdt.command.viewdistance`

⭐PlaceholderAPI 变量

安装 PlaceholderAPI 后可使用以下变量：

%viewdistancetweaks_simulation_distance%
%viewdistancetweaks_simulation_distance_<世界名>%
%viewdistancetweaks_view_distance%
%viewdistancetweaks_view_distance_<世界名>%
%viewdistancetweaks_min_view_distance%
%viewdistancetweaks_max_view_distance%
%viewdistancetweaks_min_view_distance_{世界名}%
%viewdistancetweaks_max_view_distance_{世界名}%
%viewdistancetweaks_min_simulation_distance%
%viewdistancetweaks_max_simulation_distance%
%viewdistancetweaks_min_simulation_distance_{世界名}%
%viewdistancetweaks_max_simulation_distance_{世界名}%
%viewdistancetweaks_chunk_count%
%viewdistancetweaks_chunk_count_<世界名>%
%viewdistancetweaks_tick_chunk_count%
%viewdistancetweaks_tick_chunk_count_<世界名>%
%viewdistancetweaks_no_tick_chunk_count%
%viewdistancetweaks_no_tick_chunk_count_<世界名>%
%viewdistancetweaks_global_chunk_count%
%viewdistancetweaks_global_tick_chunk_count%
%viewdistancetweaks_global_no_tick_chunk_count%
%viewdistancetweaks_mspt%
%viewdistancetweaks_tps%
%viewdistancetweaks_mspt_colour%
%viewdistancetweaks_tps_colour%

✨统计与数据

本插件使用 bStats 收集匿名服务器数据以帮助改进。你可以在 plugins/bStats 目录下的 config.yml 中禁用数据收集。