---

🌀 hTeleport

A lightweight, high-performance, and feature-rich teleportation plugin built for modern Paper/Purpur Minecraft servers.

---

🌐 Language Note: By default, the configuration and message files are set to Vietnamese (Tiếng Việt). However, 100% of the text, messages, GUI titles, and lore are fully customizable in messages.yml and gui.yml to support English or any language of your choice!

---

✨ Features

• ⚡ Async Random Teleport (RTP)

• Zero TPS Drops: Powered by Paper's Async Chunk Loading API to prevent server lag during heavy chunk generation.

• Per-World Configuration: Set unique min/max radii and center coordinates for every world separately (world, world_nether, world_the_end).

• Smart Safety Checks: Automatically avoids lava, water, cacti, fire, and void blocks.

• 🏡 Advanced Home System with GUI

• Fully customizable GUI configured via a dedicated gui.yml.

• Configurable rows, slots, and decorative border items (fillers).

• Left-click to teleport or set a home, Right-click to open an intuitive Confirmation Delete Menu.

• Rank-based maximum home limits.

• 🤝 Complete TPA System

• Express teleport requests (/tpa) and pull requests (/tphere).

• Includes expiration timers, request canceling (/tpcancel), accept (/tpaccept), and deny (/tpdeny) functionality with sound effects.

• 📍 Warps, Spawn & Death Back

• Instant /spawn and /warp navigation with tab-completion support.

• /back command to return players to their previous location or last death point.

• ⏱️ Flexible Cooldowns & Delay Bypass

• Global or per-feature teleport countdown delays and cooldown timers.

• Fine-grained permission nodes to bypass delays or cooldowns per feature.

• Server OPs and Admins automatically bypass all wait times.

---

📜 Commands & Permissions

Command	Description	Default Permission
/rtp [world]	Randomly teleport within current or target world	hteleport.use
/home [id]	Open the Home GUI or teleport to a home	hteleport.use
/sethome [id]	Set a home location	hteleport.use
/delhome [id]	Delete a specific home	hteleport.use
/tpa <player>	Request to teleport to another player	hteleport.use
/tphere <player>	Request a player to teleport to you	hteleport.use
/tpaccept	Accept a pending TPA request	hteleport.use
/tpdeny	Deny a pending TPA request	hteleport.use
/tpcancel	Cancel a sent TPA request	hteleport.use
/spawn	Teleport to the server spawn	hteleport.use
/setspawn	Set the server spawn point	hteleport.admin
/warp <name>	Teleport to a warp location	hteleport.use
/back	Return to previous location / death point	hteleport.use
/htlp reload	Reload plugin configuration files	hteleport.admin

---

🔓 Bypass Permissions

• hteleport.bypass.cooldown — Bypass cooldowns for all features.
• hteleport.bypass.cooldown.<feature> — Bypass cooldown for a specific feature (e.g., rtp, home, tpa, spawn, warp).
• hteleport.bypass.delay — Bypass teleport countdown delays for all features.
• hteleport.bypass.delay.<feature> — Bypass delay for a specific feature.

Note: Players with hteleport.admin or Server Operators (OPs) bypass all delays and cooldowns by default.

---

⚙️ Configuration Files

hTeleport keeps settings clean and organized across multiple configuration files:

• config.yml — Core behavior, feature toggles, delays, cooldowns, and per-world RTP settings.
• messages.yml — All player-facing messages, actionbar countdowns, and help lists.
• gui.yml — Separate GUI layout setup for Home menus, slot assignments, and custom items.

---

📌 Requirements

• Server Software: Paper, Purpur, or any high-performance Paper fork (Minecraft 1.21.4+ recommended).
• Java Version: Java 21 or higher.