Advanced Warp Mechanics

X-SetWarps offers a high level of control over who can use warps and how they behave, going far beyond simple teleportation.

Server-Wide Warp Limit

You can limit the maximum number of Warps that can be created on your server to avoid spam or clutter.

warps:
  max-warps: 50

(If you set it to -1, the limit will be infinite).

🔐 Individual Permissions (per-warp-permission)

On most servers, if someone has permission to use the /warp command, they have access to all warps. With X-SetWarps, you can make each warp a VIP or unlockable point.

By enabling per-warp-permission: true in config.yml, players will not only need the base permission but will also require the individual permission for the specific warp: xsetwarps.warp.<warp_name>

Practical Example: If you create a /warp vip, normal players will not be able to go there unless you give them the xsetwarps.warp.vip permission.

⏱️ Movement Tolerance System

If you configure a wait time (Delay) before teleporting using delay: 3, players will have to wait 3 seconds. However, what happens if they move?

teleport:
  delay: 3
  cancel-on-move: true
  move-tolerance: 0.1

• cancel-on-move: Cancels the teleport if the player walks, to force them to stay still or prevent them from escaping combat.
• move-tolerance: 0.1: This is the key! If you set a very low tolerance like 0.0, the teleport will be canceled even if the player only moves their head to look around. A value of 0.1 allows the player to look around without canceling the teleport, but it will be canceled if they take a step.