TeleportSystem

TeleportSystem

TeleportSystem is a lightweight, configurable teleport plugin for Paper 1.21+ that bundles the most common survival teleport features into one clean package: Spawn, a full TPA system, Homes, and Random Teleport (/rtp).

It is designed to be simple to use for players, easy to manage for admins, and fully customizable through config.yml (messages, delays, cooldowns, sounds, and more).
An OP-only command /teleportsystem reload is included to reload the configuration without restarting the server.

Features

Spawn System

• /spawn teleports a player to the server spawn (with configurable delay)
• Admin controls:
  • /spawn set (OP) — set the spawn to your current position
  • /spawn remove (OP) — remove the stored spawn
  • /spawn respawn true|false (OP) — toggle respawning at spawn after death
• Customizable messages and prefix

TPA System

• /tpa request <player> — send a teleport request
• /tpa here <player> — request the target to teleport to you
• /tpa accept [player] — accept a request
• /tpa deny [player] — deny a request
• /tpa toggelrequest — toggle whether you can receive TPA requests
• Configurable:
  • request timeout
  • request cooldown
  • cross-world teleport allowance
  • sounds and messages

Homes System

• /home create <name> — create/set a home
• /home tp <name> — teleport to a home (with configurable delay)
• /home remove <name> — delete a home
• /home list — list all your homes
• Configurable:
  • max homes per player (default value)
  • teleport delay
  • sounds and messages

Random Teleport (RTP)

• /rtp teleports a player to a random location after 5 seconds (configurable)
• Configurable:
  • delay
  • range (X/Z)
  • number of attempts to find a safe location
  • messages

Quality of Life

• All commands include tab completion
• Teleports can be configured to cancel on move
• Clean, survival-friendly defaults out of the box

Commands

Spawn

• /spawn
• /spawn set
• /spawn remove
• /spawn respawn <true|false>

TPA

• /tpa request <player>
• /tpa here <player>
• /tpa accept [player]
• /tpa deny [player]
• /tpa toggelrequest

Homes

• /home create <name>
• /home tp <name>
• /home remove <name>
• /home list

Admin

• /teleportsystem reload (OP only)

Permissions

Spawn

• teleportsystem.spawn.use (default: true)
• teleportsystem.spawn.set (default: op)
• teleportsystem.spawn.remove (default: op)
• teleportsystem.spawn.respawn (default: op)

TPA

• teleportsystem.tpa.use (default: true)

Homes

• teleportsystem.home.use (default: true)

Configuration

All features are controlled via plugins/TeleportSystem/config.yml, including:

• prefix + messages
• teleport delays
• cancel-on-move
• TPA cooldown/timeout + sounds
• max homes + home teleport delay
• RTP delay/range/attempts

After editing the config, run:

• /teleportsystem reload (OP only)

Compatibility

• Server: Paper 1.21+
• Java: 21 recommended

Notes / Roadmap

• MySQL is prepared in the config format. If you want full MySQL support (and migration from YAML), open a request and I can add it.