SyTP - Better Teleport Plugin

A feature-rich and easy-to-use Minecraft Paper/Purpur server teleport plugin with support for economy systems, teleport delay, particle effects, and more.

Features

• Multiple Teleport Methods

  • /tpa - Request to teleport to another player
  • /tpc - Request another player to teleport to you
  • /tpw - Invite all players on the server to teleport to you
  • /tpt <x y z> - Teleport to specific coordinates (with confirmation prompt)

• Instant Teleport on Accept

  • When a player accepts a teleport request, the teleport happens immediately
  • No more waiting for the delay timer after accepting

• Economy System Support

  • Supports Vault economy system
  • Configurable teleport costs (tpa/tpc/tpw/tpt)
  • Admin bypass for costs

• Teleport Delay

  • Configurable teleport wait time (only applied to direct teleport commands, not accept actions)
  • Movement cancels teleport
  • Cooldown system

• GUI Interface

  • Visual teleport request management
  • Click to accept/reject

• Particle Effects

  • Particle effects on teleport completion
  • Multiple particle types available

• Highly Configurable

  • All messages are customizable
  • Toggle features on/off
  • Flexible cost and delay settings

Requirements

• Server: Paper / Purpur 1.21.x
• Java: 21 or higher
• Optional Dependency: Vault + Economy plugin (e.g., EssentialsX)

Installation

1. Download the latest version SyTP-1.2.0.jar
2. Place the JAR file in your server's plugins folder
3. Restart the server or load the plugin
4. Edit plugins/SyTP/config.yml to customize settings
5. Execute /sytp reload to reload configuration

Commands

Command	Description	Permission
/sytp reload	Reload plugin configuration	sytp.admin
/tpa <player>	Request to teleport to a player	sytp.tpa
/tpc <player>	Request a player to teleport to you	sytp.tpc
/tpw	Invite all players to teleport to you	sytp.tpw
/tpt <x y z>	Teleport to specific coordinates (with confirmation)	sytp.tpt
/tpt confirm	Confirm a pending coordinate teleport	sytp.tpt
/tpt cancel	Cancel a pending coordinate teleport	sytp.tpt
/tpaccept	Accept teleport request	sytp.accept
/tpdeny	Deny teleport request	sytp.deny

Permissions

Permission	Description	Default
sytp.admin	Plugin admin permission	OP
sytp.tpa	Use /tpa command	Everyone
sytp.tpc	Use /tpc command	Everyone
sytp.tpw	Use /tpw command	OP
sytp.tpt	Use /tpt command (teleport to coordinates)	Everyone
sytp.accept	Accept teleport requests	Everyone
sytp.deny	Deny teleport requests	Everyone
sytp.bypass.cost	Bypass teleport costs	OP
sytp.bypass.delay	Bypass teleport delay	OP

Configuration

# Feature Toggles
enable-teleport-cost: true        # Enable teleport cost
enable-teleport-delay: true       # Enable teleport delay
enable-particle-effect: true      # Enable particle effects
enable-tpt: true                  # Enable /tpt command
enable-tpt-cost: true             # Enable /tpt teleport cost

# Cost Settings
teleport-cost: 100.0              # TPA cost
teleport-here-cost: 100.0         # TPC cost
tpw-cost: 500.0                   # TPW cost
tpt-cost: 100.0                   # TPT (coordinate teleport) cost

# Teleport Settings
teleport-delay-seconds: 3         # Teleport delay (seconds)
request-timeout-seconds: 30       # Request timeout (seconds)
teleport-cooldown-seconds: 10     # Cooldown time (seconds)

# Particle Effects
particle-type: PORTAL             # Particle type
particle-count: 50                # Particle count

How /tpt Works

1. Player runs /tpt <x> <y> <z> (e.g., /tpt 100 64 -200)
2. Plugin validates coordinates and checks balance
3. A confirmation message is sent with the cost and click buttons:
   • 请确认是否传送到 100.0 64.0 -200.0？将花费 100.0 金币
   • [确认传送] (click to confirm) | [取消] (click to cancel)
4. Clicking confirm teleports the player immediately and deducts the cost
5. Clicking cancel aborts the teleport

Notes:

• The currency unit is automatically fetched from the Vault economy plugin
• Admins with sytp.bypass.cost permission teleport for free
• The teleport is instant (no delay) since the player has explicitly confirmed
• Pending requests expire after request-timeout-seconds

Changelog

v1.2.0

• New Feature: Added /tpt <x y z> command to teleport to specific coordinates
  • Admins can enable/disable the command in config.yml (enable-tpt)
  • Admins can configure the teleport cost (tpt-cost) and toggle cost (enable-tpt-cost)
  • Players receive a confirmation prompt showing the cost before teleporting
  • Click-to-confirm / click-to-cancel interface
• Change: Teleport requests are now executed immediately upon acceptance (no delay)
  • Previously, accepting a teleport request would still trigger the configured delay
  • Now the teleport happens instantly when a player accepts

v1.1.0

• Initial release with tpa/tpc/tpw commands, GUI, economy support

Building

# Build with Maven
mvn clean package

# Or use the included Maven Wrapper
./mvnw clean package

The compiled JAR file will be located at target/SyTP-1.2.0.jar

Project Structure

SyTP/
├── src/main/java/com/shiyuan/sytp/
│   ├── SyTP.java                 # Main class
│   ├── commands/                 # Command handlers
│   │   ├── SyTPCommand.java
│   │   ├── TPACommand.java
│   │   ├── TPCCommand.java
│   │   ├── TPWCommand.java
│   │   ├── TPTCommand.java       # Coordinate teleport command
│   │   ├── TPAcceptCommand.java
│   │   └── TPDenyCommand.java
│   ├── managers/                 # Managers
│   │   ├── ConfigManager.java
│   │   ├── CooldownManager.java
│   │   ├── MessageManager.java
│   │   ├── ParticleManager.java
│   │   ├── RequestManager.java
│   │   └── TeleportManager.java
│   ├── gui/
│   │   └── GUIListener.java      # GUI listener
│   ├── requests/
│   │   ├── TeleportRequest.java
│   │   └── RequestType.java
│   └── utils/
│       └── TeleportListener.java
├── src/main/resources/
│   ├── plugin.yml               # Plugin config
│   └── config.yml               # Default config
└── pom.xml                      # Maven config