Fast Chunks

插件

· 作者 Hyper-Mayank

适用于 Bukkit、Spigot、Paper、Purpur 和 Folia 的 1.16.5-26.3 异步区块预取与内存引擎。在 20 TPS 下阻止鞘翅/载具区块墙。

0 本站下载 0 关注 更新于 4 天前

最新 1.6.0 · 26.3 · Bukkit / Folia

一键开服(送7天)

.

⚡ Fast Chunks — 通用异步区块预取与内存控制器

彻底消除从 Minecraft 1.16.5 到 26.3 所有服务器平台上的鞘翅区块墙、冰路卡顿以及 TPS 尖峰——无需重置配置,且绝不阻塞主线程。


🌟 更多来自开发者

感谢关注本项目!如果你对更多我的作品感兴趣,或者正在寻找顶级的多人游戏体验,欢迎加入 HYDRAZ Network:

🌐 服务器 IP 🎮 Discord
play.hydraz.online

🚀 核心架构支柱 (v1.6.0)

🌊 1. 超音速动能速度与重生前瞻

  • 预测性轨迹锥体:计算高速移动的前进向量,并沿玩家视线方向预先缓存最多前方 8 个区块的区块数据。
  • 全动能覆盖:动态扩展前瞻范围以支持鞘翅滑翔、引雷三叉戟、风弹、高速载具(冰路船、矿车、快马)、传送以及远距离重生。
  • 已加载区块快速跳过:在堆内存分配之前立即跳过已驻留在内存中的区块——将队列波动和 GC 压力降低高达 80%。

🧠 2. 通用跨加载器并发 (Bukkit · Spigot · Paper · Purpur · Folia)

  • 原生 Folia 区域化架构:原生使用 GlobalRegionScheduler、RegionScheduler 和 EntityScheduler,确保区块操作从不违反 Folia 区域线程所有权规则。
  • Paper & Purpur 非阻塞分发:利用完全解耦于刻循环的异步 getChunkAtAsync 工作线程。
  • Bukkit & Spigot 安全回退:自动切换到严格的时间切片刻预算 (sync-fallback.max-per-tick) + 真实的 100 刻滚动 TPS/MSPT 心跳遥测——消除在非 Paper 服务器上出现的 NoSuchMethodError 崩溃。

🛡️ 3. 自主内存控制器与区域安全修剪器

  • 实时堆监控:持续监控 JVM 堆压力,如果内存超过你配置的阈值(默认 85%),则节流低优先级的移动预取队列。
  • 出生点保护自动修剪器:尊重 1.16.5 – 26.3 版本中传统的 keep-spash-in-memory 和现代的 spawnChunkRadius 游戏规则,安全卸载超出活跃玩家视距外的陈旧空闲区块。

📊 4. 交互式 GUI 面板与 PlaceholderAPI 遥测

  • /fastchunks 内提供一键切换安全、平衡和激进预设,并显示实时运行时遥测数据(TPS、MSPT、堆内存百分比、跳过的快速加载数以及队列深度)。
  • 可选的 PlaceholderAPI 扩展 (%fastchunks_*%),用于记分板、标签页列表和诊断仪表盘。

📊 为什么 Fast Chunks 优于其他替代方案

功能 原版服务器 静态预生成器 其他优化模组 ⚡ Fast Chunks v1.6.0
方向性移动预取 ❌ 无 ❌ 仅预生成 ⚠️ 基础半径 ✅ 速度锥体前瞻
鞘翅与引雷三叉戟高速流 ❌ 遭遇区块墙 ❌ 仅静态 ❌ 无 ✅ 最远前方 8 个区块
Bukkit / Spigot + Paper / Folia 混合 ⚠️ 引擎默认 ✅ 因情况而异 ⚠️ 仅限 Paper ✅ 全部 5 种加载器 (1.16.5–26.3)
已加载区块快速跳过与背压控制 ❌ 固定 ❌ 无 ⚠️ 部分支持 ✅ 堆内存 + TPS/MSPT 自适应
原生 PlaceholderAPI 指标 ❌ 无 ❌ 无 ⚠️ 有限 ✅ 14 个实时占位符

🧾 命令与权限

命令 权限 描述
/fastchunks fastchunks.admin 打开交互式控制面板 GUI 及实时遥测
/fastchunks help fastchunks.admin 显示所有命令和语法
/fastchunks status fastchunks.status 检查活动的运行时适配器 (Folia/Paper/Spigot) 及预算
/fastchunks stats fastchunks.stats 显示实时队列、飞行中、快速跳过、TPS 和 MSPT 指标
/fastchunks memory fastchunks.memory 显示 JVM 堆使用情况、控制器状态以及已加载/跟踪的区块
/fastchunks warm [radius] fastchunks.warm 预热你位置周围的区块(或从控制台预热世界出生点)
/fastchunks profile <safe|balanced|aggressive> fastchunks.profile 瞬间切换调优预设,无任何残留监听器
/fastchunks trim [world|all] fastchunks.trim 在一个或多个世界中触发出生点安全的区块修剪器
/fastchunks purge fastchunks.purge 非阻塞地清除队列中的预取任务
/fastchunks reload fastchunks.reload 热重载并自我修复 config.yml,清理无误

🧩 PlaceholderAPI 占位符

占位符 输出说明
%fastchunks_tps% 当前实时服务器 TPS(Paper 原生或 100 刻滚动心跳)
%fastchunks_mspt% 当前平均每秒刻数(毫秒/刻)
%fastchunks_mode% 活动引擎适配器(Folia、Paper Async 或 Spigot Compat)
%fastchunks_status% 内存调节器状态(NORMAL 或 THROTTLED)
%fastchunks_queue% 待处理的区块预加载请求队列
%fastchunks_inflight% 当前正在执行的异步区块加载任务
%fastchunks_completed% 自启动以来已完成的区块预加载总数
%fastchunks_skipped_loaded% 因已在内存中而快速跳过的区块
%fastchunks_avg_ms% 平均区块加载延迟(毫秒)
%fastchunks_heap_percent% 当前 JVM 堆内存使用百分比
%fastchunks_heap_used% / %fastchunks_heap_max% JVM 堆内存已用/最大容量(MB)
%fastchunks_loaded_chunks% 已加载的区块总数(在 Folia 上为区域跟踪的区块)

⚙️ 点击查看默认 config.yml 配置
# ====================================================== #
#                 FAST CHUNKS v1.6.0                     #
#    Universal Async Prefetch, Folia & Memory Engine     #
# ====================================================== #

process-interval-ticks: 2
max-requests-per-cycle: 96
max-in-flight: 384

# 在没有异步区块 API 的纯 Bukkit/Spigot 运行时,严格的刻安全上限
sync-fallback:
  max-per-tick: 4

move-trigger-chunk-distance: 1
max-queue-size: 12000
dedupe-ttl-ms: 2000
skip-already-loaded: true

max-per-player-in-flight: 24
max-per-player-queued: 400

base-prefetch-radius: 2
adaptive-radius:
  min: 1
  max: 4
  tps-good: 19.0
  tps-low: 17.0
  speed-fast: 0.45
  speed-slow: 0.12

directional-prefetch:
  cone-degrees: 70.0
  boost-distance: 2

flight-stream:
  enabled: true
  lookahead-chunks: 6
  cone-degrees: 45.0

vehicle-stream:
  enabled: true
  lookahead-chunks: 8
  cone-degrees: 40.0
  speed-threshold: 0.6

memory-governor:
  enabled: true
  max-heap-percent: 85.0

chunk-trimmer:
  enabled: true
  interval-minutes: 10
  buffer-distance: 3

max-generating-in-flight: 2
idle-chunk-ttl-seconds: 30
generate-new-chunks: true

prefetch-on-join: true
prefetch-on-teleport: true
prefetch-on-respawn: true
prefetch-on-world-change: true
prefetch-on-move: true

paper-hints:
  enabled: true
enable-debug-particles: false

world-overrides:
  world:
    prefetch-radius: 2
    generate-new-chunks: true
  world_nether:
    prefetch-radius: 2
    generate-new-chunks: true
  world_the_end:
    prefetch-radius: 1
    generate-new-chunks: false

warmup-hotspots:
  - world: world
    x: 0
    z: 0
    radius: 2
    interval-seconds: 20

📜 内容与资产披露

所有区块预加载算法、异步队列调度器、优先级堆、兼容性适配器和监听器均为生产级 Minecraft 服务器专门设计。UI 品牌图形和宣传矢量图使用了 AI 辅助绘图工具,已根据 Modrinth 内容规则第 6.1 节完全披露。

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源