Compatibility
Minecraft: Java Edition
26.3
26.2
26.1.x
1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.5
Platforms
Tags
Creators
Details
Licensed ARR
Published 4 months ago
Updated 5 days ago

⚡ 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 |
discord.gg/hydraz |
🚀 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, andEntitySchedulernatively so chunk operations never violate Folia region thread ownership. - Paper & Purpur Non-Blocking Dispatch: Leverages async
getChunkAtAsyncworker 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—eliminatingNoSuchMethodErrorcrashes 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-memoryand modernspawnChunkRadiusgamerules across1.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
/fastchunksplus 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.


