🌟 SmartTPA (Java & Bedrock Teleportation)

SmartTPA is a modern, highly optimized, and feature-rich teleportation plugin designed specifically for multi-platform Minecraft servers. It seamlessly bridges Java Edition and Bedrock Edition players using Floodgate, offering smooth cross-play teleportation experiences.

---

✨ Key Features

• 🌐 Cross-Platform Support: Full native support for Java and Bedrock Edition (via Floodgate GUI).
• 🕹️ Bedrock GUI System: Interactive forms featuring online player dropdowns, manual input fields, request managers, and staff admin menus.
• 👥 Multi-TPA System: Handle multiple incoming teleport requests simultaneously with permission-based rank limits.
• 🗄️ Multi-Storage Support: Flexible data handling supporting YAML, JSON, SQLite, and MySQL.
• ⚙️ Customizable Timers & Displays: Configurable cooldowns and warmups displayed cleanly via ActionBar notifications.
• ⚡ Folia & PaperMC Compatible: Optimized for high-performance servers, including full Folia scheduler support (v1.20.x up to v1.26.3).
• 📊 PlaceholderAPI Integration: Real-time placeholders for request counts, cooldowns, and toggle statuses.

---

📦 Installation & Dependencies

Dependencies (Required & Optional):

1. Floodgate (Required for Bedrock Edition support / cross-play GUI).
2. Vault (Optional - required if you want to enable in-game economy costs for teleportation).
3. PlaceholderAPI (Optional - required if you want to use SmartTPA placeholders in chat or scoreboards).

How to Install:

1. Download the SmartTPA-1.0.2-7.jar file from the releases.
2. Drop the .jar file into your server's plugins folder.
3. Restart or reload your server to generate the default configuration files.
4. Configure your settings in config.yml as needed, and enjoy!

---

📌 Commands & Permissions

Player Commands & Permissions:

• /tpa <player> — Send a teleport request. (Permission: smarttpa.command.tpa)
• /tpahere <player> — Request a player to teleport to you. (Permission: smarttpa.command.tpahere)
• /tpaccept [player] — Accept an incoming request. (Permission: smarttpa.command.tpaccept)
• /tpdeny [player] — Deny an incoming request. (Permission: smarttpa.command.tpdeny)
• /tpacancel — Cancel your outgoing request. (Permission: smarttpa.command.tpacancel)
• /tpatoggle — Toggle incoming TPA status. (Permission: smarttpa.command.tpatoggle)
• /smarttpa — Open main GUI or help menu. (Permission: smarttpa.command.smarttpa)

Admin Commands & Permissions:

• /tp <player> — Instantly teleport to an online player. (Permission: smarttpa.command.tp)
• /tphere <player> — Pull an online player to you. (Permission: smarttpa.command.tphere)
• /tphereall — Pull all online players to you. (Permission: smarttpa.command.tphereall)
• /tpo <player> — Teleport to an offline player. (Permission: smarttpa.command.tpo)
• /tpreload — Reload plugin configuration. (Permission: smarttpa.reload)

Bypass & Multi-TPA Limit Permissions:

• smarttpa.bypass.cooldown — Bypass request cooldown timer.
• smarttpa.bypass.cost — Bypass economy costs for teleportation.
• smarttpa.bypass.toggle — Bypass disabled TPA toggles.
• smarttpa.multiple.default — Default multi-TPA queue limit.
• smarttpa.multiple.vip — VIP rank multi-TPA queue limit.
• smarttpa.multiple.mvp — MVP rank multi-TPA queue limit.
• smarttpa.multiple.unlimited — Unlimited multi-TPA queue limit.

---

📊 PlaceholderAPI Placeholders

If you have PlaceholderAPI installed, you can use these placeholders anywhere across your server:

• %smarttpa_status% — Returns ON or OFF.
• %smarttpa_status_color% — Returns colored status (Enabled / Disabled).
• %smarttpa_requests% — Returns the number of pending incoming requests.
• %smarttpa_cooldown% — Returns the remaining cooldown time in seconds.

---

💬 Support & Bug Reports

Found a bug, have a suggestion, or want to request a new feature? Join our community Discord server to get help and share your feedback! 👉 Join our Discord Server Here!

---

Developed with ❤️ by RayaFebrian, Mr_G, and KusStore.