🚀 What This Mod Does

Teleport Optimizer replaces Minecraft’s default teleport handling with a high-performance teleport pipeline that:

✅ 1. Preloads chunks BEFORE the teleport happens

No more stutters when a player arrives in an unloaded area.
Chunks are intelligently requested, sorted, and prepared ahead of time.

✅ 2. Batches teleports to avoid lag spikes

If many players teleport at once (events, RTP spam, respawns), the mod processes them in controlled micro-batches to eliminate any server freeze.

✅ 3. Async & parallel scheduling

Using CompletableFutures and a lightweight executor, nearly all heavy work is offloaded away from the main server thread.

✅ 4. Mixins that patch vanilla teleport bottlenecks

The mod intercepts and replaces slow teleport logic inside ServerPlayerEntity, removing the synchronous stall that normally occurs.

⚙️ Core Features

🔹 ChunkPreloader

• Preloads destination chunks around the target location

• Ensures chunk readiness before teleport

• Uses smart radii & ordering to preload only what’s necessary

• Avoids “teleport into void” delays

🔹 TeleportBatcher

• Queues teleports instead of forcing them instantly

• Smooths out load spikes

• Dramatically improves MSPT stability during heavy player activity

🔹 Teleport Metrics

• Optional lightweight profiling

• Tracks average & worst-case teleport performance

• Helps server admins debug chunk-loading hotspots

🔹 Admin Command

/teleportoptimizer reload
— Reloads config and recalculates batching rules on the fly.

🧩 Compatibility

✅ Waystones
✅ FTB Essentials
✅ FastRTP / RTP Mods
✅ Vanilla /tp, /spreadplayers
✅ Claims & protection mods
✅ Pure server-side — clients DO NOT need the mod

📦 Technical Details

• Fabric Loader ≥ 0.16.14

• Minecraft 1.20.1

• Fabric API required

• Java 17+

• Server-side only