HoopTeleport Plugin

Every Minecraft server has /sethome. It works, sure, but it also makes the world feel smaller than it is. Teleport anywhere, anytime, for free. No cost, no risk, no effort. It removes one of the core challenges of survival: actually getting back to where you were.

Hoop was built as an answer to that. A teleport system that feels fair. One that gives players the convenience of a home point, but asks something in return.

Hoop is a lightweight teleport plugin for Paper 1.21.1 that replaces the classic /sethome with a simple, progression-based system. Players earn their teleports by spending XP levels, choose where to place them, and upgrade them over time to increase their range. It's approachable, but it's not free.

---

How It Works

Type /hoop to open your personal teleport GUI. You'll see 3 empty slots (Hoppers) and a delete button (Barrier Block).

Buying a Teleport

Right-click an empty slot to purchase a teleport at your current location. This costs 20 XP levels and creates an Iron Teleport which is tied to the exact coordinates where you were standing.

Teleport Tiers

There are 3 tiers, each with a different maximum range:

Tier	Block	Range	Cost
I	Iron Block	500 blocks	20 XP levels
II	Gold Block	1000 blocks	+20 XP levels (upgrade from Iron)
III	Diamond Block	2000 blocks	+30 XP levels (upgrade from Gold)

To upgrade, right-click an existing teleport in the GUI. A confirmation screen will appear — click Yes (Green Wool) to confirm or No (Red Wool) to cancel.

Using a Teleport

Left-click a purchased teleport in the GUI to initiate teleportation. A 10-second countdown will begin — if you move during this time, the teleport is cancelled. Upon arrival, you receive Resistance III for 3 seconds.

Removing a Teleport

Click the Barrier Block in the GUI to enter delete mode — it will turn into a Skeleton Skull. Click any teleport to remove it. Note: no XP is refunded upon deletion.

Dimension Support

Teleports are bound to the dimension they were created in (Overworld, Nether, The End). You cannot teleport across dimensions.

---

Commands

Command	Description	Permission
/hoop	Open your teleport GUI	hoop.use
/hoop <player>	Open another player's GUI (admin)	hoop.admin

---

Permissions (LuckPerms compatible)

Permission	Description	Default
hoop.use	Access to /hoop	true
hoop.admin	Manage other players' hoops via /hoop <player>	op

Example LuckPerms setup:

lp group member permission set hoop.use true
lp group admin permission set hoop.use true
lp group admin permission set hoop.admin true

---

Additional Info

• Language: 100% English - all in-game messages are in English
• No dependencies: No external libraries required, works out of the box
• Paper 1.21.1 - built and tested on Paper
• Spigot compatible - should work on Spigot as well
• Data persistence - all teleport data is saved to plugins/Hoop/hoops.yml and survives server restarts

---

Planned for Future Updates

• Greater configuration options (costs, ranges, cooldown duration)
• More quality of life improvements

---

Part of the nodirection6130 plugin collection.