?
Host a server
Modrinth App
Sign in
ModsPluginsData PacksShadersResource PacksModpacks
Settings
Waypoint Warp

Waypoint Warp

A next-generation waypoint teleport system that replaces slow, repetitive command block chains with a single ultra-optimized server-side engine. Designed to maximize MSPT efficiency, reduce lag, and simplify teleport automation.

22
0

Compatibility

Minecraft: Java Edition

1.20.1

Platforms

Supported environments

Server-side
Singleplayer

Links

View source

Creators

PPekKunGz
PPekKunGzMember

Details

Licensed MIT
Published last week
Updated last week

🚀 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

performance

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>

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