ALOL-TPA

# ALOL-TPA # 🌀 tpaplugin A clean, all-in-one teleportation plugin for Paper/Spigot servers. Handles player-to-player teleport requests, home points, and death-location recall --- ## ✨ Features - **`/tpa`** — Request to teleport to another player - **`/tpahere`** — Request another player to teleport to you - **60-second request timer** — Requests auto-expire if ignored - **`/sethome` / `/home`** — Save and return to a personal home location - **`/back`** — Return to your last death location, even after rejoin or server restart - **Smart safety checks** — `/back` never drops you into lava, fire, water, solid blocks, the Nether roof, or a mob swarm - **Nearest safe fallback** — If your death spot is dangerous, the plugin automatically finds the closest safe position nearby --- ## 📋 Commands | Command | Description | |---|---| | `/tpa ` | Request to teleport to a player | | `/tpahere ` | Request a player to teleport to you | | `/tpaccept` | Accept an incoming teleport request | | `/tpacancel` | Cancel or decline a teleport request | | `/sethome` | Save your current location as home | | `/home` | Teleport to your saved home | | `/back` | Teleport to your last death location | --- ## 🛡️ Safety System The `/back` command runs a full safety check before teleporting you to your death location. **Dangers detected:** | Danger | Check | |---|---| | Suffocation | Solid block at feet or head level | | Fall / void | No solid ground directly below | | Lava | Lava at ground, feet, or head | | Fire / Soul Fire | Fire at feet or head | | Magma Block | Standing surface is magma | | Water | Water at feet or head (drowning) | | Cactus / Berry Bush / Wither Rose | Contact damage blocks | | Powder Snow | Freezing damage | | Too many monsters | 3+ hostile mobs within 5 blocks (configurable) | If any danger is detected, the plugin searches outward (up to 64 blocks by default) for the **nearest safe position** and teleports you there instead. > **Nether support** — The plugin never uses `getHighestBlockYAt()` in the Nether (which returns the bedrock roof). All Nether teleports are kept strictly within the playable Y range defined in your config. --- ## 📦 Installation 1. Download the `.jar` file 2. Drop it into your server's `plugins/` folder 3. Start or reload the server 4. A `config.yml` will be generated automatically in `plugins/tpaplugin/` 5. Edit any values and use `/tpaplugin reload` to apply changes without restarting **Requires:** Paper or Spigot **1.20+** --- ## 🗂️ Data Storage Player homes and death locations are saved to YAML files inside the plugin folder: ``` plugins/tpaplugin/ homes.yml ← one home per player (persists across restarts) back.yml ← last death location per player (persists across restarts) ``` No database setup required. --- ## 🐛 Issues & Source Found a bug or want to contribute? Open an issue or pull request on [GitHub](https://github.com/Gautam192005/ALOL-TPA). --- *Made with ❤️ by pSyChO*