EasyTPA: The Complete Teleportation Solution for Minecraft Servers
Managing player movement on a Minecraft server can quickly become chaotic without the right tools. Whether you are running a small community server or a large network, players expect seamless ways to travel, share locations, and return to key points. EasyTPA delivers all of this in one lightweight, highly configurable package. Designed specifically for Paper, this plugin bundles essential teleportation commands like TPA, homes, warps, spawn, back, and RTP into a single, easy-to-manage add-on. With support for MiniMessage formatting and an optional permissions system, EasyTPA gives you full control over how players navigate your world.
Why Choose EasyTPA for Your Server?
Many server admins juggle multiple plugins just to cover basic teleportation needs. EasyTPA eliminates that hassle by combining everything into one cohesive tool. You get a familiar command set that players already know, but with modern features like async chunk loading for random teleports and a fully customizable messages file. The plugin is built for Paper 1.21.4 and above, ensuring compatibility with the latest Minecraft updates and performance optimizations. Java 21 or higher is required, so your server stays current with modern runtime improvements.
Core Features at a Glance
- TPA System: Send and receive teleport requests with /tpa, /tpahere, /tpaccept, /tpdeny, and /tpcancel. Players can toggle incoming requests with /tptoggle to avoid interruptions.
- Home Management: Allow players to set, teleport to, and delete personal homes. Limit the number of homes per player or grant extra slots via permissions.
- Warps: Create public or private warp points with /setwarp and /warp. The warp list is clickable for easy navigation.
- Spawn and Back: Instantly return to the server spawn or your previous location, including the spot where you last died.
- Random Teleportation (RTP): The /rtp command (aliased as /wild) finds a safe location using async chunk loading to prevent lag, with configurable radius and safety checks.
- MiniMessage Support: All messages are formatted using MiniMessage, allowing gradients, hover text, and clickable components without legacy color codes.
- Optional Permissions: By default, all player commands are accessible without permissions. Enable the permissions system in the config to restrict commands and grant bypasses for cooldowns or home limits.
How to Install EasyTPA on Your Server
Installing EasyTPA is straightforward. First, ensure your server runs Paper 1.21.4 or newer and uses Java 21+. Then, simply drop the EasyTPA jar file into your server's plugins folder and restart. The plugin will generate a default configuration. You can tweak settings in config.yml and customize all messages in messages.yml. To apply changes without a full server restart, use the /tpreload command—this instantly reloads the configuration, saving you time during setup.
If you use a launcher like foxygame.net, adding EasyTPA is even simpler. The launcher's built-in add-on catalog often includes EasyTPA, allowing a one-click install that automatically handles version compatibility and keeps the plugin updated. This means less manual file management and more time enjoying the game.
Configuration Deep Dive
The config.yml file is designed to be intuitive. You can enable or disable the permissions system entirely. If set to false, all player commands work out of the box, and only admin commands require OP. When enabled, you can integrate with LuckPerms or any permission plugin to fine-tune access. Key settings include:
- teleport-delay: Seconds before a teleport executes (set to 0 for instant).
- tpa-timeout: How long a TPA request remains pending.
- teleport-cooldown: Global cooldown between teleports to prevent spam.
- back-on-death: When true, /back returns players to their death location.
- max-homes and max-warps: Default limits per player, extendable with permissions like teleport.home.multiple.10.
- rtp-radius and rtp-min-radius: Define the random teleport area, keeping players away from spawn.
Commands and Permissions Overview
EasyTPA uses a clean command structure that players will recognize immediately. Here is a quick reference:
- /tpa
— Request to teleport to a player (permission: teleport.tpa) - /tpahere
— Request a player to teleport to you (teleport.tpahere) - /tpaccept, /tpdeny, /tpcancel — Manage requests (teleport.tp*)
- /tptoggle — Block or allow incoming requests (teleport.tptoggle)
- /home [name], /sethome, /delhome — Home management (teleport.home*)
- /warp
, /setwarp, /delwarp, /warps — Warp management (teleport.warp*) - /spawn, /setspawn — Spawn control (teleport.spawn, teleport.admin for setspawn)
- /back — Return to previous location (teleport.back)
- /rtp or /wild — Random teleport (teleport.rtp)
- /tpreload — Reload configuration (teleport.admin)
Special permissions like teleport.cooldown.bypass let trusted players ignore cooldowns, while teleport.home.multiple.
Safety and Performance
EasyTPA includes built-in safeguards to prevent abuse. The anti-movement delay cancels teleports if a player moves, and the global cooldown stops rapid teleport spamming. For RTP, async chunk loading ensures the server doesn't freeze while finding a safe spot, and the plugin verifies the location is on solid ground with enough space. These features keep your server stable even with many players using teleports simultaneously.
Customizing Messages with MiniMessage
Every message in EasyTPA is stored in messages.yml and uses the MiniMessage format. This means you can add color gradients, hover tooltips, clickable commands, and even custom fonts. For example, you can make a teleport request message display a gradient name and a clickable [Accept] button. The possibilities are vast, and the default messages provide a great starting point for further personalization.
Licensing and Community
EasyTPA is released under the Fair Core License (FCL). It is completely free for personal use. If you run a commercial server or generate revenue, you must contact the developer, ZO3N, for authorization. This model supports ongoing development while keeping the plugin accessible to hobbyists and small communities. The plugin is actively maintained, and you can find the source code and documentation on its GitHub repository.
Whether you are setting up a new server or replacing a collection of outdated teleport plugins, EasyTPA offers a modern, unified solution. Its combination of essential features, performance-minded design, and deep configurability makes it a top choice for Paper servers. Download EasyTPA today and give your players the smooth travel experience they deserve.