DynamicDistance

插件

· 作者 trxiuss

DynamicDistance 根据 Paper、Folia、Purpur、Spigot 和 Bukkit 上的实时服务器指标动态调整视距和模拟距离。在负载较高时减少范围,并在性能恢复后将其还原,支持 AFK/速度限制及群组加成

0 本站下载 0 关注 更新于 3 个月前

最新 1.0 · 26.2 · Bukkit / Folia

一键开服(送7天)

⚡ DynamicDistance

专为 Minecraft 服务器打造的下一代主动式视距与模拟距离引擎。DynamicDistance 持续读取服务器的实时关键指标——TPS、MSPT、CPU 占用率、内存使用量、已加载区块数及实体数量,并在卡顿发生之前做出反应。没有生硬的开关阈值,也没有突兀的距离跳变:只有一条经过数学平滑处理的曲线,在确保硬件负载可控的同时,让游戏世界保持最佳视觉效果。

不再需要在“美观的服务器”和“稳定的服务器”之间做选择。DynamicDistance 自动为你兼得二者。

? 多语言支持

DynamicDistance 开箱即用,内置28 种专业结构化的语言文件,让每位管理员和社区成员都能感受到宾至如归的体验:

?? English (en) | ?? Turkish (tr) | ?? German (de) | ?? Spanish (es) | ?? Russian (ru) | ?? Chinese (zh) | ?? Japanese (ja) | ?? Azerbaijani (az) | ?? French (fr) | ?? Arabic (ar) | ?? Dutch (nl) | ?? Indonesian (id) | ?? Armenian (hy) | ?? Italian (it) | ??????? Scottish Gaelic (gd) | ?? Swedish (sv) | ?? Kyrgyz (ky) | ?? Korean (ko) | ?? Hungarian (hu) | ?? Czech (cs) | ?? Greek (el) | ?? Persian (fa) | ?? Polish (pl) | ?? Romanian (ro) | ?? Vietnamese (vi) | ?? Portuguese (pt) | ?? Thai (th) | ?? Ukrainian (uk)

通过 config.yml 中的 language 字段即可瞬间切换语言——每个翻译文件都会自动生成至 /plugins/DynamicDistance/langs。

? 为什么选择 DynamicDistance?

  • ⚙️ 预测性而非被动响应。 大多数插件是在卡顿发生后才做出反应。DynamicDistance 的平滑负载评分能够预判性能下降并优雅地降低距离,随后再逐步恢复——绝不会出现可见的“跳动”。
  • ? 真正的智能算法,而非简单的 if/else 判断。采用加权多指标压力评分、双速平滑处理、迟滞冷却机制以及 smoothstep 质量曲线——像真正的性能系统一样设计,而非一个简单的开关。
  • ? 完全异步且兼容 Folia。 零主线程阻塞,插件本身不产生任何 TPS 开销。
  • ? 原生支持细粒度控制。 支持按世界、按玩家、按权限组设置上限,以及按玩家设置的定时覆盖——实现对单个玩家的极致掌控。

? 核心功能

? 自适应引擎 — 大脑

  • 将 MSPT、TPS、CPU 负载、内存使用量、已加载区块数和实体数量 结合为一个单一的加权压力评分(0–100)。
  • 双速平滑处理:当性能下降时反应迅速,而在恢复时则缓慢且稳定,以避免在不稳定帧期间出现距离闪烁。
  • 基于 smoothstep 的质量因子曲线将压力评分转换为距离值,提供自然、非线性的缓动效果——杜绝突然跳变。
  • 恢复冷却(迟滞保护):在经历严重尖峰后,距离会被暂时抑制并逐渐回升,而不是直接瞬间跳回最大值。
  • 可完全配置 MSPT、TPS、CPU、内存、区块和实体的目标/临界阈值。

? 真正的双距离控制

  • 独立且同时管理视距和模拟距离。
  • 按世界覆盖 — 可以为下界或末地设置比主世界更严格的限制,而无需修改全局设置。
  • 按玩家实时应用 — 每位玩家获得的距离都匹配其具体情况,而非单一的全服统一值。

? 通用平台架构

  • Folia Ready — 原生区域线程适配器,为 Minecraft 服务器性能的未来而生。
  • 现代 Paper (1.18+) — 自动检测并使用原生的模拟距离 API。
  • 传统 Spigot / Bukkit — 优雅地降级为仅优化视距,无错误且功能缺失为零。
  • 正确的适配器会在启动时自动检测——无需手动配置,无需猜测。

? AFK 限幅器

  • 自动检测闲置玩家(移动、聊天、命令、交互)并缩小其视距,以节省他们并未使用的资源。
  • 一旦玩家重新活跃,立即恢复其正常距离。

? 速度限幅器

  • 通过实时每秒方块数追踪,检测高速移动状态(鞘翅飞行、加速旅行等)。
  • 暂时缩减高速移动玩家的模拟距离,以防止区块加载激增——对玩家完全不可见。

? 基于权限组的加成系统

  • 完整集成 LuckPerms,并支持标准的 group.<name> 权限——使用你服务器已有的任意一种。
  • 每个权限组都可以拥有自己的视距/模拟距离加成、优先级权重,以及对动态缩放、AFK 限制和速度限制的独立绕过标志。
  • 预置了即插即用的 default、vip、vip_plus、mvp 和 admin 模板,你可自由重命名和调整。

?️ 管理员覆盖系统

  • /dd setoverride <player|all> <view> [sim] [duration] — 立即为单个玩家或整个服务器固定一个永久或限时的自定义距离。
  • 支持直观的时间单位,如 30s、10m、2h、1d。
  • 过期的覆盖设置会自动清理并实时更新——永远无需手动清理。

? 实时性能 HUD(BossBar)

  • /dd statusbar 切换一个时尚的、颜色编码的实时 BossBar,一目了然地显示 TPS、MSPT、CPU、内存、视距和模拟距离。
  • 条状图颜色会根据服务器实时健康状况在绿色、黄色和红色之间自动变化。

? PlaceholderAPI 集成

将实时服务器性能数据直接带入你的计分板、Tab 列表或聊天中: %dynamicdistance_tps% · %dynamicdistance_mspt% · %dynamicdistance_cpu% · %dynamicdistance_ram% · %dynamicdistance_ram_mb% · %dynamicdistance_chunks% · %dynamicdistance_entities% · %dynamicdistance_load_score% · %dynamicdistance_state% · %dynamicdistance_view_distance% · %dynamicdistance_sim_distance% · %dynamicdistance_target_view% · %dynamicdistance_target_sim% · %dynamicdistance_reason%

? 深度诊断命令

  • /dd status — 完整的实时系统报告:平台、TPS/MSPT、CPU(含核心数)、RAM(已用/最大,单位 MB)、世界区块与实体负载、当前的查看距离/模拟距离,以及实时压力评分与健康状态。
  • /dd info <player> — 检查特定玩家的具体状况及原因:激活的查看距离/模拟距离、AFK 状态、权限组、覆盖状态,以及应用该设置的确切原因(动态缩放、群组加成、AFK 限制、速度限制、管理员绕过或手动覆盖)。

? 企业级软件架构

  • 自修复配置 — 每次启动和重载时,自动检测并修正无效或冲突的配置范围,并在控制台输出清晰的警告信息。
  • 内置 Modrinth 更新检查器 — 有新版本可用时,自动在游戏内通知管理员。
  • 轻量级 基于 JSON 的存储,定期自动保存自定义玩家覆盖设置。
  • 可选的 bStats 指标,提供透明且匿名的使用洞察。

?️ 配置

config.yml 将引擎的每一层控制权交给你:

⚙️ 引擎

  • check_interval — 引擎评估性能的时间间隔(秒)。
  • smoothing_factor_degrade / recover — 在负载下距离缩小的激进程度 vs. 恢复时的温和程度。
  • recovery_cooldown — 关键事件发生后,允许距离重新上升前的迟滞延迟时间。
  • permission_cache_seconds — 权限组/身份查找结果的缓存时长,以优化性能。

? 距离限制

  • 全局的查看距离和模拟距离的 min / max / default_start 值。
  • worlds: 部分用于设置特定世界的 min/max 覆盖值(例如对下界和末地采用更严格的限制)。

? 阈值

  • 目标与临界 MSPT 和 TPS 值。
  • 最大 RAM 和 CPU 使用百分比。
  • 目标 chunk(区块)和 entity(实体)数量。
  • 最佳与临界 stress score(压力评分)边界。

? 模块与群组

  • AFK Limiter 和 Speed Limiter 模块的每个参数均可独立配置。
  • groups: 部分定义每个权限组的优先级、加成距离及绕过行为。

⚡ 命令

命令 权限 描述 别名
/dynamicdistance status dynamicdistance.admin 显示详细的实时性能报告 /dd status
/dynamicdistance statusbar [player] dynamicdistance.admin 切换实时 HUD BossBar /dd statusbar, /dd bar, /dd hud
/dynamicdistance reload dynamicdistance.admin 重载配置文件和语言文件 /dd reload
/dynamicdistance setoverride <player|all> <view> [sim] [duration] dynamicdistance.admin 设置永久或定时的自定义距离限制 /dd setoverride
/dynamicdistance clearoverride <player|all> dynamicdistance.admin 移除自定义距离限制 /dd clearoverride
/dynamicdistance info <player> dynamicdistance.admin 检查玩家的实时档案及应用距离的原因 /dd info

基础命令别名:/dd, /dynview, /vdist

?️ 权限

权限 描述
dynamicdistance.admin 授予所有管理命令的访问权限(默认:OP)。
dynamicdistance.bypass 豁免玩家免受所有动态距离调整的影响。

⚙️ 支持的服务器软件

核心 支持状态 模拟距离
✅ Folia 完全支持 ✅
✅ Paper (1.18+) 完全支持 ✅
✅ Purpur 完全支持 ✅
✅ Spigot 完全支持 仅查看距离
✅ Bukkit 完全支持 仅查看距离
  • 正确的引擎适配器(Folia / Modern Paper / Legacy)会在插件加载时自动检测——部署在任何地方即可正常运行。

? 占位符

需要安装 PlaceholderAPI。

  • %dynamicdistance_tps% / %dynamicdistance_mspt% — 实时刻健康状态。
  • %dynamicdistance_cpu% / %dynamicdistance_ram% / %dynamicdistance_ram_mb% — 硬件使用情况。
  • %dynamicdistance_chunks% / %dynamicdistance_entities% — 世界负载计数器。
  • %dynamicdistance_load% / %dynamicdistance_load_score% / %dynamicdistance_state% — 压力评分与健康状态。
  • %dynamicdistance_view_distance% / %dynamicdistance_sim_distance% — 当前应用的距离。
  • %dynamicdistance_target_view% / %dynamicdistance_target_sim% — 引擎当前的全局目标值。
  • %dynamicdistance_reason% — 当前距离被应用的原因。

⚖️ 许可证

根据 CC BY-NC-SA 4.0(知识共享署名-非商业性使用-相同方式共享 4.0 国际许可协议)发布。 严格禁止商业使用和转售。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源