This is the complete command reference for OpenWarp. Commands are categorized by function. Each command has a particular permission associated with it; users must have this permission in order to use the command. Required arguments in a command are enclosed in {curly braces}, while optional arguments use [square brackets].

Warping

List warps

Show all warps visible to you. To list only public or private warps, add arguments public or private, respectively.

Command: /warp list [public] [private]

Permission: openwarp.warp.list

Warp

Move to the warp called NAME. Public warps take priority over private: if you have a private warp called mywarp, and there is a public warp of the same name, running /warp mywarp will move you to the public warp. Shared warps take third priority, and are only searched if the given NAME contains a colon.

Command: /warp {NAME}

Permission: openwarp.warp.use

This command supports location permissions with the node openwarp.warp.access.

Create warp

Make a new warp called NAME. By default, this command creates a private warp; for a public warp, append the public option. Fails if you are over your warp quota for the given warp type.

Command: /warp set {NAME} [public]

Permission: openwarp.warp.set

Alias: /setwarp {NAME} [public]

Get warp info

Give details about the warp called NAME. Like warping, this will prioritize public warps over private warps when warp names are identical.

Command: /warp detail {NAME}

Permission: openwarp.warp.detail

Remove warp

Delete the warp called NAME. Like warping, this will prioritize public warps over private warps when warp names are identical.

Command: /warp delete {NAME}

Permission: openwarp.warp.delete.use

This command has extra permissions to support servers that want to restrict warp deletion. The three important nodes are:

• openwarp.warp.delete.public.self - Ability to delete your own public warps (those which you created)
• openwarp.warp.delete.public.other - Ability to delete others' public warps (those which you did not create)
• openwarp.warp.delete.private - Ability to delete your own private warps

Note that you cannot delete private warps owned by others, and so there is no permission for that ability. This feature was implemented in build 127, and all of these permissions are granted by default (emulating the old behavior). No specific changes should be necessary to keep OpenWarp working how it was before this feature was added (build 126 or older).

Share warp

Provide another player access to a private warp. See warp sharing for more info.

Command: /warp share {PLAYER} {WARP}

Permission: openwarp.warp.share

Unshare warp

Remove access to a private warp from another player. See warp sharing for more info.

Command: /warp unshare {PLAYER} {WARP}

Permission: openwarp.warp.unshare

Homes

Homes are a special warp tracked outside the normal public/private and quota systems. They are accessible on a per-player basis, and cannot be shared.

Homes are either set on a server-wide or per-world basis, depending on the multiworld_homes key in the core OpenWarp config.yml file. If homes are set per-world, players also have a "default home," which is accessed from worlds without a specific home set. If homes are server-wide, players have only a default home.

Go home

Move immediately to your home. You must have set a home using the /home set command before this command will function. You may only have one home.

Command: /home

Permission: openwarp.home.use

This command supports location permissions with the node openwarp.home.access.

Make a home

Set your current location, including eye position (pitch and yaw), as your home. You may only set one home at a time.

Command: /home set

Permission: openwarp.home.set

Alias: /sethome

Local teleportation

Jump

Move immediately to the block under your reticle. The block must be reasonably close (generally within 100 blocks). If you cannot stand on the block, move to the next highest block in the same column that has two open air blocks above it.

Command: /jump

Permission: openwarp.jump

Alias: /j

Top

Move immediately to the highest non-air block in your current column. Keeps your (x,z) coordinates constant, as well as your pitch and yaw. This command searches upwards from your current position, so it cannot be used to avert a long fall.

Command: /top

Permission: openwarp.top

History

Back

Move to the location immediately before your last teleport. This command is not limited to handling OpenWarp-managed teleports; instant movements from other sources, including standard (vanilla) Nether portals or Multiverse-managed cross-world movements, can be reverted by this command.

Command: /back

Permission: openwarp.back

Stack push

Push your current location onto your personal history stack; or, if the name of a warp is specified, teleport to that warp and push your new location onto the stack. The size of the stack is limited only by Java heap space.

Command: /warp stack push [NAME]

Permission: openwarp.warp.stack.push

Stack pop

Pop the topmost location off your personal history stack and teleport to it. In contrast to the peek command below, this location will no longer be on your stack.

Command: /warp stack pop

Permission: openwarp.warp.stack.pop

Stack peek

Teleport to the topmost location on your personal history stack. In contrast to the pop command above, your history stack will be unchanged after this command.

Command: /warp stack peek

Permission: openwarp.warp.stack.peek

Show stack

Print out all the locations on your current stack. If a location matches a warp visible to you, the name of that warp will be shown; otherwise, the location is given as an (x,y,z) coordinate and a world name. The stack is printed in inverse order (i.e. the topmost location on your history stack will be printed last).

Command: /warp stack print

Permission: openwarp.warp.stack.print

Quotas

For more info, see Quotas.

Current use

Display your current effective warp quotas and number of warps you've created. If no quota is in effect, it will be shown as "unlimited."

Command: /warp quota [usage]

Permission: openwarp.warp.quota.usage

Effective values

Display the number of warps allowed to you.

Command: /warp quota show

Permission: openwarp.warp.quota.show

Alter quotas

Set the quota for warps to VALUE. You may specify a number (including 0) for the new quota, or the special string "unlimited." If the optional argument USER is specified, the quota takes effect for that user; otherwise, the global quota is set.

Command: /warp quota set {public|private} {VALUE} [USER]

Permission: openwarp.warp.quota.set