EssentialsC / Warps

Warps

Named teleport destinations that any player with the right permission can use.

Overview

Warps are server-wide teleport destinations created by admins. Unlike homes, warps are shared across all players and can have per-warp permissions, costs, descriptions, and category groupings. The warp list is printed in chat as a clickable, paginated list organised by category.

Commands

Command Description
/warp [name] Teleport to a warp. Without arguments, lists all available warps (same as /warps).
/setwarp <name> Create a warp at your current location.
/delwarp <name> Delete an existing warp.
/warps List all available warps in chat, grouped by category when warp.group-by-category is enabled.
/warpadmin ... Admin warp management - see Warp Admin section below.

Configuration

Warp settings live under the warp section in config.yml.

Key Type Default Description
warp.enabled Boolean true Whether the warp system is enabled.
warp.cooldown Seconds 5 Cooldown between warp uses.
warp.warmup Seconds 3 Delay before the warp teleport executes.
warp.cancel-on-movement Boolean true Whether movement during warmup cancels the teleport.
warp.particles Boolean true Play a particle effect at the destination on warp.
warp.sounds Boolean true Play a sound effect at the destination on warp.
warp.group-by-category Boolean true Group warps by their category in the warp list.
warp.max-name-length Integer 16 Maximum characters for a warp name.
warp.blocked-worlds List world_nether, world_the_end Worlds where warps cannot be used.
warp.limit-per-player.enabled Boolean true Whether per-player warp creation limits are active.
warp.limit-per-player.max Integer 5 Maximum warps a player can create before requiring setwarp.unlimited.

Warp Admin

The /warpadmin command provides full management of warp properties after creation.

Subcommand Description
/warpadmin setperm <warp> <permission> Set the permission required to use a warp. Use none to remove the requirement.
/warpadmin setcost <warp> <amount> Set an economy cost to use this warp.
/warpadmin setdesc <warp> <description> Set the description shown next to the warp in the /warps list.
/warpadmin setcategory <warp> <category> Assign the warp to a category for list grouping.
/warpadmin hide <warp> Hide the warp from the /warps list. It can still be used by name with /warp.
/warpadmin unhide <warp> Make a hidden warp visible again in the /warps list.
/warpadmin move <warp> Move the warp to your current location.
/warpadmin info <warp> Show all properties of a warp.
/warpadmin reload Reload warp data from disk.

Permissions

Permission Description Default
essentialsc.warp Use the /warp command and the warp list. Everyone
essentialsc.warp.<name> Require a permission to use a specific warp, assigned per-warp with /warpadmin setperm. Nobody
essentialsc.warps Open the warp list with /warps. Everyone
essentialsc.setwarp Create new warps. Operators
essentialsc.setwarp.1 / .2 / .3 / .5 / .10 / .25 Sets a fixed warp creation limit at that number. Nobody
essentialsc.setwarp.overwrite Overwrite an existing warp's location with /setwarp. Operators
essentialsc.delwarp Delete warps. Operators
essentialsc.delwarp.own Delete warps starting with your name prefix. Operators
essentialsc.delwarp.others Delete other players' warps. Operators
essentialsc.delwarp.all Delete any warp. Operators
essentialsc.warpadmin Full warp management via /warpadmin. Operators
essentialsc.warp.free Use warps for free regardless of set cost. Operators
essentialsc.warp.others Warp other players. Operators
essentialsc.warp.bypass Bypass per-warp permission requirements. Operators
essentialsc.warp.bypass.cooldown Bypass the warp cooldown. Operators
essentialsc.warp.bypass.warmup Bypass the warp warmup. Operators
essentialsc.setwarp.unlimited Remove the per-player warp creation limit. Operators