TeleportationPlugin

TheAmuletPlugin

A lightweight and powerful teleportation plugin inspired by TheLegendOfZeldasTears of the kingdom teleportation amulet that allows players to set, manage, and teleport to multiple custom locations called amulets — with cooldowns, movement restrictions, particle effects, and full admin control.

---

Multiple Amulets per Player

Players can create and manage multiple teleport locations:

* `/setamulet <name>` → Save your current position as an amulet * `/tpamulet <name>` → Teleport to a saved amulet * `/delamulet <name>` → Remove an amulet * `/listamulets` → View all your saved amulets

Each player can store multiple named locations (configurable limit).

📂 Persistent Data Storage

All amulets are saved and loaded automatically:

* Stored in `stored_amulets.yml` * Data persists across server restarts * Clean separation from `config.yml`

---

⚙️ Configurable Settings

If you first load the plugin a new folder named Amulet Plugin will apear In this folder you can find `config.yml`

Here you can change the settings

default: Amulet Cooldown: 5 - how many secounds does it need to teleport Max possible Amulets: 3 - how many amulets can be set by a player Particles: true - if particles should be shown by the teleportation

🎮 Commands

| Command | Description | | -------------------- | --------------------- | | `/setamulet <name>` | Save current location | | `/tpamulet <name>` | Teleport (with delay) | | `/delamulet <name>` | Delete an amulet | | `/listamulets` | List all amulets |

---

⚡ Performance

* Uses efficient in-memory storage (HashMaps) * Scheduler-based timing (no constant checks) * Minimal performance impact

---

🧩 Compatibility

* ✔ Bukkit * ✔ Spigot * ✔ Paper (recommended)

---

💡 Future Ideas

* GUI menu for amulets * Teleport countdown titles/actionbar * Sounds & advanced effects * Per-player permissions * Async saving system

---

Perfect for survival servers, RPG setups, or any server that needs controlled teleportation.

---

Thank you for downloading this plugin

This is my very first project and I used a lot of ChatGPT in it but I'll try to not use it so much in future ;D

Please check out my other creations to,if I even have some yet