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.