🚀 Waypoint Warp

• Ultra Optimized Teleportation System

Waypoint Warp is a next-generation server-side teleportation engine that replaces slow, repetitive vanilla command-block systems with an ultra-efficient global waypoint framework.

Designed for Fabric 1.20.1, this mod drastically reduces MSPT cost and provides a clean, scalable teleport solution without requiring any client installation.

---

🌩️ Why Replace Command Blocks?

Traditional vanilla teleport systems rely on:

• repeating command blocks
• complex /execute distance checks
• scoreboard conditions
• datapack tick functions
• long command chains
• command dispatcher spam
• rooms full of ticking command blocks

A typical vanilla teleporter looks like this:

execute as @a at @s if entity @s[x=..,y=..,z=..,distance=..] run tp @s <destination>

This runs every tick × every player × every waypoint, quickly becoming expensive as servers grow.

---

❌ Problems with Vanilla Teleport Systems

• Constant tick load
• Cost scales with players × waypoints
• Heavy command dispatcher overhead
• Datapack tick performance drop
• Lag spikes from long command chains
• Hard to manage in large adventure or RPG maps

---

✅ What Waypoint Warp Does Better

Waypoint Warp replaces all of that with a single optimized engine:

• Global PersistentState storage
• Zero tile entities
• Teleport checks only when players are nearby
• No command block spam
• No datapack tick spam
• Built-in summon system
• Built-in particle effects
• Cooldown system
• Pure server-side (no client mod required)

---

📊 Performance Comparison (MSPT)

Image is not real 100%, generate by AI. on server schedule tick 0.0012 > 0.0016

Summary

• Vanilla command blocks scale linearly and often reach 3–6ms per tick
• Waypoint Warp stays around 0.01–0.03ms, even with 50+ waypoints

---

🧭 Features

• Global waypoint system
• Trigger radius detection
• Arrival summon (any entity)
• Particle effects
• Cooldown system
• Activation-radius optimization
• Debug commands
• Server-only mod (no client installation)

---

🔧 Commands

Create Waypoint

waypoint set <name> <from_pos> <to_pos>
waypoint set <name> <from_pos> <to_pos> summon <entity> <dy>
waypoint set <name> <from_pos> <to_pos> particle <id>
waypoint set <name> <from_pos> <from_dimension> <to_pos> <to_dimension> <summon|particle> <dy|id> sound <mcsound_id> <volume> <pitch>

Example Using

/waypoint set test1 1 10 0 minecraft:overworld 10 50 10 minecraft:the_end summon minecraft:lightning_bolt 0 sound minecraft:entity.experience_orb.pickup 1 1

Edit Waypoint

waypoint edit <name> from <pos>
waypoint edit <name> to <pos>
waypoint edit <name> radius <value>
waypoint edit <name> particle <id>
waypoint edit <name> summon <entity> <dy>

Utility

waypoint distance <name> <radius>
waypoint list
waypoint remove <name>

Debug

waypoint debug mspt
waypoint debug active

---

🧩 Perfect For

• Adventure maps
• RPG servers
• Dungeon systems
• Hub teleporters
• Cutscenes
• Minigames
• Event automation
• Any project replacing command-block spam

---

🔗 Links

• Website: https://ppekkungz.in.th
• Documentation: https://docs.ppekkungz.in.th
• GitHub: https://github.com/PPekKunGz
• Author: @PPekKunGzDev