
⚡ 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 节完全披露。

⚡ Fast Chunks — Universal Async Chunk Prefetch & Memory Governor
Eliminate Elytra chunk walls, ice-highway freezes, and TPS spikes across every server platform from Minecraft 1.16.5 through 26.3—with zero config resets and zero main-thread hitching.
🌟 More from the Developer
Thanks for checking out this project! If you're interested in more of my work or looking for a premier multiplayer experience, come play on HYDRAZ Network:
| 🌐 Server IP |
🎮 Discord |
play.hydraz.online |
🚀 Key Architectural Pillars (v1.6.0)
🌊 1. Super-Sonic Kinetic Velocity & Respawn Lookahead
- Predictive Trajectory Cone: Calculates forward vectors for high-speed travel and pre-caches chunks up to 8 chunks ahead along the player's line of sight.
- Full Kinetic Coverage: Dynamically expands lookahead for Elytra gliding, Riptide tridents, Wind Charges, high-speed vehicles (ice-road boats, minecarts, fast horses), teleports, and far respawns.
- Already-Loaded Fast-Skip: Immediately bypasses chunks already resident in memory before heap allocation—slashing queue churn and GC pressure by up to 80%.
🧠 2. Universal Cross-Loader Concurrency (Bukkit · Spigot · Paper · Purpur · Folia)
- Native Folia Regionized Architecture: Uses
GlobalRegionScheduler, RegionScheduler, and EntityScheduler natively so chunk operations never violate Folia region thread ownership.
- Paper & Purpur Non-Blocking Dispatch: Leverages async
getChunkAtAsync worker threads decoupled completely from the tick loop.
- Bukkit & Spigot Safe Fallback: Automatically switches to a strict time-sliced tick budget (
sync-fallback.max-per-tick) + real 100-tick rolling TPS/MSPT heartbeat telemetry—eliminating NoSuchMethodError crashes on non-Paper servers.
🛡️ 3. Autonomous Memory Governor & Region-Safe Trimmer
- Real-Time Heap Monitor: Continuously watches JVM heap pressure and throttles low-priority movement prefetch queues if memory exceeds your configured threshold (default
85%).
- Spawn-Protected Auto Trimmer: Respects both legacy
keep-spawn-in-memory and modern spawnChunkRadius gamerules across 1.16.5 – 26.3, safely unloading stale idle chunks outside active player view distances.
📊 4. Interactive GUI Panel & PlaceholderAPI Telemetry
- One-click Safe, Balanced, and Aggressive presets inside
/fastchunks plus real-time runtime telemetry (TPS, MSPT, heap %, skipped fast-loads, and queue depth).
- Optional PlaceholderAPI expansion (
%fastchunks_*%) for scoreboards, tablists, and diagnostics dashboards.
📊 Why Fast Chunks Beats Alternatives
| Feature |
Vanilla Server |
Static Pre-Generators |
Other Optimizers |
⚡ Fast Chunks v1.6.0 |
| Directional Movement Prefetch |
❌ No |
❌ Pre-gen only |
⚠️ Basic radius |
✅ Velocity Cone Lookahead |
| Elytra & Riptide High-Speed Stream |
❌ Hits Chunk Walls |
❌ Static only |
❌ No |
✅ Up to 8 Chunks Ahead |
| Bukkit / Spigot + Paper / Folia Hybrid |
⚠️ Engine default |
✅ Varies |
⚠️ Paper-locked |
✅ All 5 Loaders (1.16.5–26.3) |
| Already-Loaded Fast-Skip & Backpressure |
❌ Fixed |
❌ None |
⚠️ Partial |
✅ Heap + TPS/MSPT Adaptive |
| Native PlaceholderAPI Metrics |
❌ None |
❌ None |
⚠️ Limited |
✅ 14 Live Placeholders |
🧾 Commands & Permissions
| Command |
Permission |
Description |
/fastchunks |
fastchunks.admin |
Opens the interactive Control Panel GUI & live telemetry |
/fastchunks help |
fastchunks.admin |
Displays all commands and syntax |
/fastchunks status |
fastchunks.status |
Inspects active runtime adapter (Folia/Paper/Spigot) & budgets |
/fastchunks stats |
fastchunks.stats |
Shows live queue, in-flight, fast-skip, TPS, and MSPT metrics |
/fastchunks memory |
fastchunks.memory |
Displays JVM heap usage, governor state, and loaded/tracked chunks |
/fastchunks warm [radius] |
fastchunks.warm |
Pre-warms chunks around your position (or world spawns from console) |
/fastchunks profile <safe|balanced|aggressive> |
fastchunks.profile |
Switches tuning presets instantaneously with zero stale listeners |
/fastchunks trim [world|all] |
fastchunks.trim |
Triggers the spawn-safe chunk trimmer across one or all worlds |
/fastchunks purge |
fastchunks.purge |
Non-blocking purge of queued prefetch tasks |
/fastchunks reload |
fastchunks.reload |
Hot-reloads & self-heals config.yml cleanly |
🧩 PlaceholderAPI Placeholders
| Placeholder |
Output Description |
%fastchunks_tps% |
Current live server TPS (Paper native or 100-tick rolling heartbeat) |
%fastchunks_mspt% |
Current average milliseconds per tick |
%fastchunks_mode% |
Active engine adapter (Folia, Paper Async, or Spigot Compat) |
%fastchunks_status% |
Memory Governor state (NORMAL or THROTTLED) |
%fastchunks_queue% |
Queued chunk prefetch requests |
%fastchunks_inflight% |
Currently executing async chunk loads |
%fastchunks_completed% |
Total completed chunk prefetches since boot |
%fastchunks_skipped_loaded% |
Fast-skipped chunks already in memory |
%fastchunks_avg_ms% |
Average chunk load latency in milliseconds |
%fastchunks_heap_percent% |
Current JVM heap utilization percentage |
%fastchunks_heap_used% / %fastchunks_heap_max% |
JVM heap memory used / max in MB |
%fastchunks_loaded_chunks% |
Total loaded chunks (or region-tracked chunks on Folia) |
⚙️ Click to View Default config.yml Configuration
# ====================================================== #
# FAST CHUNKS v1.6.0 #
# Universal Async Prefetch, Folia & Memory Engine #
# ====================================================== #
process-interval-ticks: 2
max-requests-per-cycle: 96
max-in-flight: 384
# Strict tick-safety cap when running on pure Bukkit/Spigot without async chunk API
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
📜 Content & Asset Disclosures
All chunk prefetch algorithms, async queue dispatchers, priority heaps, compatibility adapters, and listeners are engineered for production Minecraft servers. UI branding graphics and promotional vectors utilize AI-assisted illustration tools, fully disclosed per Modrinth Content Rules Section 6.1.
评论 0
登录后参与评分
还没有评论,来抢沙发吧