FartherViewDistance-Archive - FartherViewDistance - 异步多线程视距扩展

💡项目已终止

本插件旨在为 Minecraft 服务器提供扩展的视距功能，允许玩家看到超出服务器默认加载范围的区块。它通过多线程和异步处理，直接从区域缓存读取区块，在保持服务器 TPS 稳定的同时，为玩家提供更广阔的视野。请注意，此项目已停止开发。

🎮核心特性

• 多线程与异步处理：大部分区块直接从区域缓存读取，性能高效。
• 独立视距：玩家的扩展视距独立于服务器实际加载的区块，这些区块不会被游戏刻处理。
• 智能适配：不会发送超出客户端视距的区块，并能自动适应玩家的网络速度。
• 反透视支持：插件自身可配置反矿物透视功能（需注意与服务器反透视插件的区别）。

工作原理示例

假设 server.properties 中 view-distance=8，插件配置中 max-view-distance=25。

• 玩家拥有权限：max_view_distance.20 和 max_view_distance.30。
• 插件将自动选取最大值 30。若无权限，则使用配置值 25。
• 若玩家视距 ≤ 8，则由服务器完全提供。
• 若玩家视距 > 8，则超出部分由插件补充。
• 最终，玩家实际获得的扩展视距上限为 max-view-distance 配置值（本例为 25）。

🔧命令列表

• /viewdistance reload - 重载插件配置。
• /viewdistance report [server|thread|world|player] - 打印指定类型的报告。
• /viewdistance start - 继续执行区块发送。
• /viewdistance stop - 暂停执行区块发送。
• /viewdistance permissionCheck <玩家名> - 重新检查指定玩家的权限。
• /viewdistance debug view <玩家名> - 调试玩家视距。

权限节点：command.viewdistance

✨占位符列表

插件支持以下 PlaceholderAPI 占位符：

• %viewdistance_delay% - 临时停止发送区块的剩余时间（毫秒）。
• %viewdistance_max_extend_view_distance% - 最大扩展视距。
• %viewdistance_now_extend_view_distance% - 当前扩展视距。
• %viewdistance_now_server_view_distance% - 当前服务器视距。
• %viewdistance_network_speed_avg% - 单游戏刻平均网络速度（字节）。
• %viewdistance_network_report_load_fast_5s% - 5秒内处理的快速区块数量。
• %viewdistance_network_report_load_fast_1m% - 1分钟内处理的快速区块数量。
• %viewdistance_network_report_load_fast_5m% - 5分钟内处理的快速区块数量。
• %viewdistance_network_report_load_slow_5s% - 5秒内处理的慢速区块数量。
• %viewdistance_network_report_load_slow_1m% - 1分钟内处理的慢速区块数量。
• %viewdistance_network_report_load_slow_5m% - 5分钟内处理的慢速区块数量。
• %viewdistance_network_report_consume_5s% - 5秒内处理的数据包大小（字节）。
• %viewdistance_network_report_consume_1m% - 1分钟内处理的数据包大小（字节）。
• %viewdistance_network_report_consume_5m% - 5分钟内处理的数据包大小（字节）。
• %viewdistance_forcibly_max_distance% - 强制最大距离。
• %viewdistance_forcibly_send_second_max_bytes% - 强制每秒最大发送字节数。

⭐配置详解 (config.yml)

主要设置

• view-distance-mode：视距模式。越大需要越多计算和内存。
• "X15"：最大有效视距 15，最快。
• "X31"：最大有效视距 31，推荐。
• "X63"：最大有效视距 63。
• "X127"：最大有效视距 127。
• "X383"：最大有效视距 383。

• server-view-distance：服务器本身视距。设为 -1 则使用 server.properties 中的值。

• auto-adapt-player-network-speed：是否自动适应玩家网速。

• player-network-speed-use-degree：使用玩家网速的百分比（例如 0.6 表示使用 60%）。

• async-thread-amount：异步线程数量，建议 1~10。

• server-send-second-max-bytes：服务器每秒最大传输数据量（字节，默认 20971520 = 20 MB）。

• server-tick-max-generate-amount：服务器每游戏刻最大生成区块数。设为 0 则不生成。

• calculate-missing-height-map：是否计算缺失的高度图。关闭可提升性能，但可能导致雪/雨穿透地面。

• disable-fast-process：是否禁用快速处理区块。开启后每次发送都重新加载。

• periodic-millisecond-check：定期检查玩家权限的间隔（毫秒）。设为 -1 禁用。

世界独立配置 (worlds)

所有世界共用 default 下的配置，可为特定世界（如 world_nether）覆盖设置。

• enable：是否在此世界启用扩展视距。
• max-view-distance：此世界的最大扩展视距。
• world-tick-max-generate-amount：此世界每游戏刻最大生成区块数。
• send-title-data：发送的区块是否包含方块实体数据（如箱子、告示牌）。关闭则玩家仍能看到方块，除非启用 prevent-xray。
• world-send-second-max-bytes：此世界每秒最大传输数据量（字节）。
• player-send-second-max-bytes：玩家每秒最大传输数据量（字节）。
• read-server-loaded-chunk：是否读取服务器已加载的区块。若关闭，则总是读取最后保存的状态。
• delay-before-send：切换世界、长距离传送或死亡重生后，等待多少毫秒才开始传输区块（建议 2000~20000）。
• speeding-not-send：玩家水平移动速度超过此值时，暂时停止提供扩展视距。设为 -1 忽略。若启用了 prevent-xray，强烈不建议设置高于 1.2 或关闭，否则高速移动可能导致区块覆盖和矿物显示错误。

反透视配置 (prevent-xray)

• enable：是否启用反方块透视。
• conversion-list：方块转换列表。将指定的矿物方块在发送给玩家时替换为普通方块。
• 格式：替换成的方块: - 被替换的方块A - 被替换的方块B
• 示例：STONE: - COAL_ORE - IRON_ORE

重要提示：此功能仅作用于本插件发送的区块。若需要服务器全局的反透视，请使用 Paper 核心并启用 paper.yml 中的 anti-xray 配置。

权限配置 (permissions)

• node-list：权限节点列表，格式为 <视距>;<权限节点>。
• 示例："16;max_view_distance.16"

❓支持与注意事项

支持的版本

• Paper：1.19.4, 1.18.2, 1.17.1, 1.16.5, 1.15.2, 1.14.4
• Spigot：1.19.4, 1.18.2, 1.17.1, 1.16.5, 1.15.2, 1.14.4

重要配置调整

• Paper/Airplane/Purpur 服务器：需在 paper.yml 中将 no-tick-view-distance 设置为 -1。
• Spigot/Bukkit 服务器：需在插件 config.yml 中将 server-tick-max-generate-amount 设置为 0，并将 read-server-loaded-chunk 设置为 false。
• Minecraft 版本升级：若升级服务端版本，需要在启动脚本中加入 --forceUpgrade 参数。
• 反透视：插件自带的反透视功能是独立的。如需服务器全局反透视，必须使用 Paper 核心的 anti-xray 功能。

附加语言

插件配置内置英文 (en) 和繁体中文 (zh-tw) 说明。