EN 5 4 Warp

Warp Module

中文版本 | English version

Function

This module provides server-wide shared warp points, maintained by admins and used directly by players.

It fits repeated-access public destinations such as cities, market areas, event zones, or shared infrastructure. Compared to home, warp is public infrastructure rather than private points.

Typical Usage

When a server wants a stable public teleport network, warp is usually the best fit.

Commands

/warp <name>
/warps
/warps <page>
/setwarp <name>
/delwarp <name>
/renamewarp <name> <newName>
/updatewarp <name>
/mapwarp <name> <true|false>
/gwarpmap
/gwarpmap <name> <true|false>

Related Config

Mainly related: warp.enabled, warp.maximum, warp.deleteInvalid, teleporting.delay, teleporting.cooldown.

Behavior Notes

warp.maximum=0 means unlimited warps. /setwarp, /delwarp, /renamewarp, and /updatewarp are admin maintenance commands. With warp.deleteInvalid=true, invalid warps are auto-cleaned during storage load.

When players run /warp, global delay/cooldown still applies. This module includes teleport behavior and content lifecycle (naming, rename, delete, in-place update, invalid cleanup). /warps now also supports paginated display.

If Xaero integration is enabled, /mapwarp controls whether the current player keeps seeing one specific warp on their own map, while /gwarpmap controls whether that warp should continue syncing as a public waypoint for everyone.

Important Caveats

If players report a warp "not found", distinguish between name mismatch and invalid dimension target. With warp.deleteInvalid enabled, invalid entries are usually removed on load.