Pay To Teleport

# PayTp Mod Documentation (v2)

> - Updated on 2026-08-28 > - Let's (https://github.com/FLwolfy/Pay-To-Teleport/issues/11) PayTp together! > - 中文文档请看[这里](https://github.com/FLwolfy/Pay-To-Teleport/blob/main/README.cn.md)

To be noted, due to huge API changes and the fact that Minecraft is no longer using obfuscation for source codes, patches later than v1. 2. 0 will NOT support versions below 26. 1*. For data migration, please check (https://github.com/FLwolfy/Pay-To-Teleport/blob/latest/docs/MIGRATION.md).*

## Overview

PayTp is a lightweight Fabric mod for Minecraft that allows players to teleport by paying a certain amount of in-game currency (items). It supports flexible teleportation modes, multi-language localization, and fully customizable cost rules.

## Features

• Editable command names
• Cross-dimension teleport to a specified location
• Player teleport request system
• Home and Back
• Beacon waypoint (Warp) feature
• Fully customizable JEXL teleportation price and distance algorithm
• Ender Chest / Shulker Box payment support
• Cloth Config API support (client-side)
• Can be used as a server-side only mod

Most features can be disabled by setting their corresponding command names to an empty string. For example, changing `teleport.coordinateCommand` in the config file from `ptp` to empty* will disable the coordinate teleport function. The in-game help guide will automatically adapt.

## Commands

All displays show the default command names, where <> indicates required parameters and () indicates optional parameters*

Every `` argument accepts and suggests online player names only; entity selectors such as `@a`, `@p`, and `@s` are not supported. The `/ptp` ` ` text is a non-selectable format hint rather than a current-coordinate suggestion; `~` and `^` relative coordinates remain supported.

| Command | Description | |----------------------------------------------------------|------------------------------------------------------------------------------| | `/ptphelp` | Get command guide for PayTp | | `/ptp (dimension) ` | Teleport to specified coordinates (in a specific dimension) | | `/ptpto ` | Send request to teleport to a player | | `/ptphere ` | Send request to a player to teleport to you | | `/ptpaccept (player)` | Accept a teleport request (from a specific player) | | `/ptpdeny (player)` | Deny a teleport request (from a specific player) | | `/ptpcancel (player)` | Cancel a pending teleport request (to a specific player) | | `/ptpback` | Return to the previous location | | `/ptphome` | Teleport to your home (if configured) | | `/ptphome set` | Set your home to your current position | | `/ptpwarp ` | Teleport to the specified waypoint | | `/ptpwarp create (public/private/server)` | Create a waypoint; defaults to `private`; `server` is permission-controlled. | | `/ptpwarp delete (forced)` | Delete your waypoint; `forced` is permission-controlled. | | `/ptpwarp rename ` | Rename a waypoint you created. | | `/ptpwarp invite ` | Invite a player to one of your private waypoints. | | `/ptpwarp exclude ` | Remove an invited player from a private waypoint. | | `/ptpwarp list (all/public/owned/invited/server) (page)` | Filter and page through server waypoints. |

## Configuration

### Configuration File Location:

``` ~/config/paytp.json ```

### Example Structure:

```json { "general": { "language": "en_us", "helpCommand": "ptphelp", "safeTeleport": false, "safeTeleportRange": 5, "effect": { "particleEffect": true, "soundEffect": true } }, "teleport": { "coordinateCommand": "ptp", "allowCros