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 displayed in a GUI organised by category.
Commands
| Command | Description |
|---|---|
/warp [name] |
Teleport to a warp. Without arguments, opens the warp GUI. |
/setwarp <name> |
Create a warp at your current location. |
/delwarp <name> |
Delete an existing warp. |
/warps |
List all available warps in a GUI grouped by category. |
/warpadmin ... |
Admin warp management - see Warp Admin section below. |
Configuration
Warp settings live under the warps section in config.yml.
| Key | Type | Default | Description |
|---|---|---|---|
warps.cooldown |
Seconds | 5 |
Cooldown between warp uses. |
warps.warmup |
Seconds | 0 |
Delay before the warp teleport executes. |
warps.cancel-on-move |
Boolean | true |
Whether movement during warmup cancels the teleport. |
warps.group-by-category |
Boolean | true |
Group warps by their category in the warp list GUI. |
warps.max-name-length |
Integer | 32 |
Maximum characters for a warp name. |
warps.per-warp-limit |
Integer | 0 |
Maximum warps a player can create (0 = unlimited for admins). |
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. Empty string removes the requirement. |
/warpadmin setcost <warp> <amount> |
Set an economy cost to use this warp. |
/warpadmin setdesc <warp> <description> |
Set the description shown in the warp GUI. |
/warpadmin setcategory <warp> <category> |
Assign the warp to a category for GUI grouping. |
/warpadmin hide <warp> |
Hide the warp from the warp list GUI. It can still be used by name with /warp. |
/warpadmin unhide <warp> |
Make a hidden warp visible again in the GUI. |
/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.<name> |
Use a specific warp. | Everyone |
essentialsc.warps.list |
Open the warp list GUI. | Everyone |
essentialsc.setwarp |
Create new warps. | Operators |
essentialsc.delwarp |
Delete warps. | Operators |
essentialsc.warpadmin |
Full warp management via /warpadmin. |
Operators |
essentialsc.warp.cost.bypass |
Use warps for free regardless of set cost. | Operators |