Skip to content

Player warps

Warps players make for other players.

A shop front, a build worth showing off, a farm to share: somewhere its owner wants people to come. So everything here is about being found. /pwarp opens a browsable list with ratings and visit counts, sorted however the viewer likes, with categories, search, favourites and a record of where they have been. Owners decide who may come, and can charge for it.

For players

/pwarp                    browse them all
/pwarp <name>             go to one (owner.name if two people share a name)
/pwarp set <name>         make one where you stand, or move yours
/pwarp desc <name> <text | more text>   describe it; | starts a new line
/pwarp icon <name>        use the item in your hand as its picture
/pwarp category <name> <text>
/pwarp access <name> public|whitelist|private
/pwarp allow <name> <player>            /pwarp deny <name> <player>
/pwarp fee <name> <amount> [currency]   charge visitors
/pwarp collect <name>     take what it has earned
/pwarp rate <name> 1-5    /pwarp fav <name>    /pwarp info <name>
/pwarp delete <name>

In the menu, left-click travels, right-click favourites, and shift-right-click rates. The bottom row switches the sort order (most visited, best rated, newest, oldest, by name, by owner, favourites first, cheapest, recently visited, shuffled), opens search, and shows favourites, recents and your own warps. Your own warps open a management screen where every setting is a button.

Before a paid or unsafe-looking warp the plugin asks first. A fee is not something to take because somebody clicked once, and neither is a drop into lava.

Fees and the bank

A fee goes into the warp's bank, not straight to the owner. A visitor pays while the owner is asleep; the money has to land somewhere that is still there in the morning, and a balance the owner has to collect is also one they can see. /pwarp collect moves it to their balance. Fees can be in any configured currency, and owners never pay to visit their own warps.

Limits and permissions

Node Grants
emberessentials.pwarp Browse, visit, make and manage your own
emberessentials.pwarp.limit.<n> Up to n warps; the highest node wins
emberessentials.pwarp.unlimited No limit
emberessentials.pwarp.fee May charge visitors
emberessentials.pwarp.admin May enter, edit and delete anybody's
player-warps:
  enabled: true
  default-limit: 1        # without a limit node
  create-price: 0         # charged once, when first made
  max-fee: 100000         # the most an owner may charge per visit
  require-claim: false    # only inside the owner's own claim

On a network

With shared storage, player warps are one list across every server. A warp on another server shows that server's name in place of a world, and visiting it sends you across and finishes the teleport when you land. Visits are counted on the server the warp is on, so the number means "people who arrived", not "people who tried".

Why /back works

Every trip goes through the same warmup and teleport as /home and /warp, so /back returns you afterwards and damage or movement cancels the warmup the same way. That sounds like nothing until you have used a player-warp plugin where it is not true.

In pictures