tpcost

tpcost

Teleport to your friends, but pay for it with XP levels. Requests must be accepted, prices grow with distance, and admins can tune every number live.

Built for Paper 26.3 / Java 25. No other plugins are needed.

In game: type /help tpcost for a full guide with every command. Admins also see the admin settings. It ends with clickable links to this page and to the issue tracker.

Contents

• Quick start
• How much does it cost?
• Commands
• Permissions
• Privacy: closing requests and hiding prices
• Admin settings
• Install
• Links and support

Quick start

1. Ask: /tpa Alex sends Alex a request. It expires after 60 seconds.
2. Approve: Alex clicks [Accept] in chat or types /tpaccept. [Deny] or /tpdeny refuses it.
3. Pay on arrival: the cost is recalculated from where you both stand right now. You are teleported and only then lose the levels. If the teleport fails or is cancelled, nothing is charged.

The [Accept] and [Deny] buttons behave exactly like typing the command. Clicking an old message after the request has expired or been cancelled does nothing.

How much does it cost?

By default, every 1,000 blocks costs 3 levels, rounded up. The price never drops below 3 and the distance part stops growing at 25. Teleporting between different worlds adds +3 on top of the cap.

base cost  = min(maximum-cost, max(minimum-cost, ceil(distance × levels-per-1000-blocks ÷ 1000)))
total cost = base cost + (different worlds ? cross-world-surcharge : 0)

• Distance is the straight-line 3D distance between both players' X/Y/Z.
• Across worlds, raw coordinates are compared as if both players were in the same world, without Nether scaling, and then the surcharge is added.
• Only the requesting player pays. Payment is whole levels, so partial progress toward your next level is kept.
• Creative and spectator players pay too; there is no free operator bypass.

Commands

• If several requests are waiting for you, name the player in /tpaccept or /tpdeny.
• Player names are case-insensitive and tab-complete.
• If another plugin also uses these command names, use the namespaced form, for example /tpcost:tpa Alex.

Requests are cancelled when:

Permissions

Privacy: closing requests and hiding prices

Do not disturb. /tpclose refuses every incoming request. Pending requests are cancelled and their senders are told. You can still send your own requests. /tpopen turns requests back on. The choice is saved by player UUID in plugins/tpcost/request-preferences.yml and survives disconnects and restarts.

Price lookup is off by default, including for operators. An exact price reveals roughly how far away someone is, so repeated quotes could be used to triangulate their position. While lookup is off:

• /tpcost <player> returns no price and does not suggest player names.
• /tpa does not show the price before acceptance, even in "not enough XP" messages. Affordability is checked when the target accepts.
• Teleports still cost the configured levels, and the price is shown on success.

This blocks quotes nobody approved. It does not hide distance from someone whose request you accept. An admin can turn lookups back on with /tpcostadmin cost-command-enabled true.

Admin settings

Operators, the console, and anyone with tpcost.admin can change prices without a restart. Changes are saved to plugins/tpcost/config.yml and apply right away to quotes, new requests, and pending requests when they are accepted.

/tpcostadmin                              show every setting
/tpcostadmin maximum-cost                 show one setting
/tpcostadmin maximum-cost 30              change and save it
/tpcostadmin cost-command-enabled true    allow price lookups

Rules:

• Prices are whole numbers from 0 to 2,147,483,647.
• minimum-cost cannot be higher than maximum-cost. Raise the maximum first, or lower the minimum first.
• maximum-cost + cross-world-surcharge must also fit within 2,147,483,647.
• Setting the minimum, rate and surcharge all to 0 makes teleports free.
• If saving fails, the command reports an error and nothing changes.
• After editing config.yml by hand, restart the server. Invalid values stop the plugin from starting rather than silently changing prices.

minimum-cost: 3
levels-per-1000-blocks: 3
maximum-cost: 25
cross-world-surcharge: 3
cost-command-enabled: false

Install

1. Download the latest jar from Hangar.
2. Put it in your server's plugins/ folder and restart. The server must run Java 25.
3. Optional: adjust prices with /tpcostadmin.

./gradlew build          # jar in build/libs/, runs the test suite

./gradlew build publishPluginPublicationToHangar syncAllPluginPublicationPagesToHangar \
  -PhangarChangelog="What changed"

Links and support

• Source and full guide: github.com/rewrite123/papermc-plugins/tree/main/tpcost
• Download: hangar.papermc.io/rewrite123/tpcost
• Report a bug or request a feature: GitHub issues