ViewTune
为 Paper 1.21+/26.x 提供基于玩家个体的视距和模拟距离,并具备 TPS 自适应上限。
view-distance=10 会为所有玩家加载相同的 441 个区块,包括那些客户端设置仅为 6 的玩家。ViewTune 会根据每个玩家客户端实际请求的量来加载区块,该量介于你设定的下限与上限之间——当 TPS 下降时,它会以每次一个区块的幅度逐步降低所有人的上限,直到服务器恢复后再将其调回。
- 基于客户端自身设置的个体视距
- 个体模拟距离(怪物、红石、农作物),保持不高于视距
- 带有下限、迟滞效应和单区块步长的 TPS 调节器
- 基于权限组的上限 (
viewtune.view.<n>, viewtune.sim.<n>)、基于世界的限制、玩家数量缩放
- 提升是即时的,降低是延迟的——当玩家拖动滑块时不会产生区块频繁卸载/加载的抖动
/viewtune savings 报告你未加载的区块数
命令:/viewtune [status|players|savings|reload](别名 /vt)· 权限:viewtune.admin
测试环境
Paper 1.21.11, 26.2 和 26.3 —— 已在运行时测试,而不仅仅是“能加载”。决策逻辑在两个真实服务器上经过断言验证,使用的是随插件发布的 jar 包中的原始类。该类通过插件的类加载器加载,以确保断言不会因副本差异而失效:涵盖了对上限、下限以及 Minecraft 硬性最小值 2 的钳制、未知客户端设置、模拟距离与视距的耦合、TPS 调节器的每一个分支(包括其下限和上限)、玩家数量阈值以及节省区块数的计算逻辑 —— 共 19 项断言,在两个版本上均全部通过。
市场定位
现有的支持个体视距的插件(约 57k 下载量)最后一次发布是在 2023 年 10 月;第二名则不到 2,000 次下载且几乎同样久未更新。旧的 jar 包在当前 Paper 上仍可运行,因此本插件并非为了救援旧项目——而是在一个近三年来无人维护的位置上提供更强大的工具集,新增了模拟距离、TPS 调节器、基于权限组的上限、基于世界的限制以及玩家数量缩放功能。
许可证
MIT — 见 LICENSE。
开发说明
本项目采用 AI 辅助开发:代码由 Claude 编写,但全程由维护者指导、测试并最终批准发布。每个版本在正式发布前都会在真实的 Paper 服务器上进行测试。
人类主导的开发:人类维护者指导、测试并对每个版本负责;AI 仅作为开发工具使用(根据 Modrinth 政策披露)。图标为手工制作的几何艺术作品,非 AI 生成。
ViewTune
Per-player view and simulation distance for Paper 1.21+/26.x, plus a TPS-adaptive ceiling.
view-distance=10 loads the same 441 chunks for everyone, including the players running their client
at 6. ViewTune gives each player what their client actually asked for, between your floor and your
ceiling — and when TPS drops it lowers that ceiling for everyone one chunk at a time, raising it back
once the server recovers.
- Per-player view distance from the client's own setting
- Per-player simulation distance (mobs, redstone, crops), kept at or below the view distance
- TPS regulator with a floor, hysteresis and one-chunk steps
- Per-rank caps (
viewtune.view.<n>, viewtune.sim.<n>), per-world limits, player-count scaling
- Raising is instant, lowering is delayed — no chunk churn when a player drags the slider
/viewtune savings reports the chunks you are not loading
Commands: /viewtune [status|players|savings|reload] (alias /vt) · Permission: viewtune.admin
Tested on
Paper 1.21.11, 26.2 and 26.3 — runtime-tested, not just "it loads". The decision logic is asserted on
both live servers against the shipped jar's own class, loaded through the plugin's classloader so
the assertions cannot drift from a copy: clamping against ceiling, floor and Minecraft's hard minimum
of 2, unknown client settings, the simulation/view coupling, every branch of the TPS regulator
including its floor and ceiling, player-count thresholds and the savings arithmetic —
19 assertions, green on both versions.
Niche
The established plugin for per-player view distance (~57k downloads) last shipped in October 2023;
the runner-up has under 2,000 downloads and has been silent almost as long. The old jar still loads on
current Paper, so this is not a rescue — it is a larger tool in a slot nobody has tended for nearly
three years, and simulation distance, the TPS regulator, per-rank caps, per-world limits and
player-count scaling are new.
License
MIT — see LICENSE.
Development note
This project is AI-assisted: the code is written with Claude under the direction, testing and
release approval of the maintainer. Every release is run against a live Paper server before it ships.
Human-led development: a human maintainer directs, tests and takes responsibility for every release; AI is used as a development tool (disclosed per Modrinth policy). The icon is hand-made geometric artwork, not AI-generated.
评论 0
登录后参与评分
还没有评论,来抢沙发吧