Waypoint Warp

# 🚀 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 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 ! https://cdn.modrinth.com/data/cached_images/36ba6485ceef97776cc053664c5837f21b527cc1.png **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