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