⚡ 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 国际许可协议)发布。
严格禁止商业使用和转售。
⚡ DynamicDistance
The next-generation, proactive View & Simulation Distance engine for Minecraft servers. DynamicDistance continuously reads your server's real vitals — TPS, MSPT, CPU, RAM, loaded chunks, and entity count — and reacts before lag ever hits your players. No harsh on/off thresholds, no jarring distance jumps: just a smooth, mathematically smoothed curve that keeps your world looking great while your hardware breathes.
Stop choosing between a beautiful server and a stable one. DynamicDistance gives you both, automatically.
? Multi-Language Support
DynamicDistance ships with 28 professionally structured languages out of the box, so every admin and every community feels right at home:
?? 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)
Switch languages instantly with the language field in config.yml — every translation file is auto-generated into /plugins/DynamicDistance/langs.
? Why DynamicDistance?
- ⚙️ Predictive, not reactive. Most plugins react to lag after it happens. DynamicDistance's smoothed load score anticipates degradation and scales down gracefully, then eases back up — never a visible "pop."
- ? Actually intelligent math, not a simple if/else. A weighted multi-metric stress score, dual-speed smoothing, hysteresis cooldowns, and a smoothstep quality curve — engineered like a real performance system, not a toggle.
- ? Fully async and Folia-ready. Zero main-thread blocking, zero TPS overhead from the plugin itself.
- ? Granular by design. Per-world limits, per-player application, per-rank bonuses, per-player timed overrides — total control down to the individual player.
? Core Features
? Adaptive Engine — The Brain
- Combines MSPT, TPS, CPU load, RAM usage, loaded chunk count, and entity count into a single weighted Stress Score (0–100).
- Dual-speed smoothing: reacts fast when performance degrades, recovers slowly and steadily to avoid flickering distances during unstable ticks.
- A smoothstep-based Quality Factor curve translates the stress score into distance values with a natural, non-linear easing — no sudden jumps.
- Recovery Cooldown (hysteresis protection): after a critical spike, distances are held back and ramp up gradually instead of snapping straight back to max.
- Fully configurable target/critical thresholds for MSPT, TPS, CPU, RAM, chunks, and entities.
? True Dual-Distance Control
- Manages View Distance and Simulation Distance independently and simultaneously.
- Per-world overrides — give the Nether or The End tighter limits than your Overworld without touching global settings.
- Per-player real-time application — every player gets the distance that matches their exact situation, not a single server-wide value.
? Universal Platform Architecture
- Folia Ready — native region-threaded adapter, built for the future of Minecraft server performance.
- Modern Paper (1.18+) — automatically detects and uses native Simulation Distance APIs.
- Legacy Spigot / Bukkit — gracefully falls back to View Distance–only optimization with zero errors or missing features.
- The correct adapter is auto-detected on startup — no manual configuration, no guesswork.
? AFK Limiter
- Automatically detects inactive players (movement, chat, commands, interactions) and shrinks their distance to save resources they're not even using.
- Instantly restores their normal distance the moment they become active again.
? Speed Limiter
- Detects high-speed movement (Elytra flight, boosted travel, etc.) via real-time blocks/second tracking.
- Temporarily trims Simulation Distance for fast-moving players to prevent chunk-loading spikes — completely invisible to the player.
? Rank & Permission-Based Bonus System
- Full LuckPerms integration, plus standard
group.<name> permission support — use whichever your server already runs.
- Every rank can have its own bonus View/Simulation Distance, priority weighting, and independent bypass flags for Dynamic scaling, AFK limiting, and Speed limiting.
- Ships with ready-to-use
default, vip, vip_plus, mvp, and admin templates you can rename and tune freely.
?️ Admin Override System
/dd setoverride <player|all> <view> [sim] [duration] — instantly pin a permanent or timed custom distance for one player or your entire server.
- Supports intuitive durations like
30s, 10m, 2h, 1d.
- Expired overrides are cleaned up automatically and reapplied in real time — no manual cleanup, ever.
? Live Performance HUD (BossBar)
/dd statusbar toggles a sleek, color-coded real-time BossBar showing TPS, MSPT, CPU, RAM, View Distance, and Simulation Distance at a glance.
- Bar color shifts automatically between green, yellow, and red based on live server health.
? PlaceholderAPI Integration
Bring live server performance data straight into your Scoreboard, Tab list, or chat:
%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%
? Deep Diagnostics Commands
/dd status — a full live system report: platform, TPS/MSPT, CPU (with core count), RAM (used/max in MB), world chunk & entity load, current View/Simulation distances, and the live stress score with health state.
/dd info <player> — inspect exactly what a specific player is getting and why: active View/Simulation distance, AFK status, rank group, override status, and the precise reason it's being applied (dynamic scaling, group bonus, AFK restriction, speed restriction, admin bypass, or override).
? Built Like Enterprise Software
- Self-healing configuration — on every startup and reload, invalid or conflicting config ranges are automatically detected and corrected, with clear console warnings.
- Built-in Modrinth update checker — automatically notifies admins in-game the moment a new version is available.
- Lightweight JSON-based storage with periodic auto-save for custom player overrides.
- Optional bStats metrics for transparent, anonymous usage insights.
?️ Configuration
config.yml puts every layer of the engine in your hands:
⚙️ Engine
- check_interval — how often (in seconds) the engine evaluates performance.
- smoothing_factor_degrade / recover — how aggressively distances shrink under load vs. how gently they recover.
- recovery_cooldown — hysteresis delay before distances are allowed to climb back up after a critical event.
- permission_cache_seconds — how long rank/group lookups are cached for performance.
? Distance Limits
- Global min / max / default_start values for both View and Simulation Distance.
- worlds: section for world-specific min/max overrides (e.g. tighter limits for the Nether and The End).
? Thresholds
- Target & critical MSPT and TPS values.
- Maximum RAM and CPU usage percentages.
- Target chunk and entity counts.
- Optimal and critical stress score boundaries.
? Modules & Groups
- Every parameter of the AFK Limiter and Speed Limiter modules is independently configurable.
- The groups: section defines priority, bonus distances, and bypass behavior per rank.
⚡ Commands
| Command |
Permission |
Description |
Aliases |
/dynamicdistance status |
dynamicdistance.admin |
Displays a detailed live performance report |
/dd status |
/dynamicdistance statusbar [player] |
dynamicdistance.admin |
Toggles the real-time HUD BossBar |
/dd statusbar, /dd bar, /dd hud |
/dynamicdistance reload |
dynamicdistance.admin |
Reloads config and language files |
/dd reload |
/dynamicdistance setoverride <player|all> <view> [sim] [duration] |
dynamicdistance.admin |
Sets a permanent or timed custom distance limit |
/dd setoverride |
/dynamicdistance clearoverride <player|all> |
dynamicdistance.admin |
Removes a custom distance limit |
/dd clearoverride |
/dynamicdistance info <player> |
dynamicdistance.admin |
Inspects a player's live profile and applied-distance reason |
/dd info |
Base command aliases: /dd, /dynview, /vdist
?️ Permissions
| Permission |
Description |
dynamicdistance.admin |
Grants access to all administrative commands (default: OP). |
dynamicdistance.bypass |
Exempts a player from all dynamic distance adjustments. |
⚙️ Supported Server Software
| Core |
Support Status |
Simulation Distance |
| ✅ Folia |
Fully Supported |
✅ |
| ✅ Paper (1.18+) |
Fully Supported |
✅ |
| ✅ Purpur |
Fully Supported |
✅ |
| ✅ Spigot |
Fully Supported |
View Distance only |
| ✅ Bukkit |
Fully Supported |
View Distance only |
- The correct engine adapter (Folia / Modern Paper / Legacy) is detected automatically the moment the plugin loads — deploy it anywhere and it just works.
? Placeholders
Requires PlaceholderAPI to be installed.
%dynamicdistance_tps% / %dynamicdistance_mspt% — live tick health.
%dynamicdistance_cpu% / %dynamicdistance_ram% / %dynamicdistance_ram_mb% — hardware usage.
%dynamicdistance_chunks% / %dynamicdistance_entities% — world load counters.
%dynamicdistance_load% / %dynamicdistance_load_score% / %dynamicdistance_state% — stress score & health state.
%dynamicdistance_view_distance% / %dynamicdistance_sim_distance% — currently applied distances.
%dynamicdistance_target_view% / %dynamicdistance_target_sim% — the engine's current global targets.
%dynamicdistance_reason% — why the current distance is being applied.
⚖️ License
Released under CC BY-NC-SA 4.0 (Attribution-NonCommercial-ShareAlike 4.0 International).
Commercial use and resale are strictly prohibited.
评论 0
登录后参与评分
还没有评论,来抢沙发吧