LastLocation

**LastLocation** is a lightweight, safe, and modern **Paper plugin** that stores a player’s **last logout location** and allows them to teleport back to it using `/lastlocation`. Designed for **Paper 1.20.10+ / 1.21+**, built with **JDK 21**, and focused on **performance, safety, and data integrity**. --- ## ✨ Core Features ### 🚪 Last Logout Location - Stores **only the logout location** - ❌ **Does NOT store death locations** - Supports **server restart / shutdown** - Default **FILE storage** (one `.yml` per player) - Ready for **SQLite / MySQL** --- ### ⏱️ Save After X Seconds Online - Logout location is saved **only after a player has been online for X seconds** - Fully configurable - Player receives an **in-game message** once saving becomes active - Supports **Essentials-style color codes (`&`)** Example: ```yml save: min-online-seconds: 10 ready-message: "&aYour logout location is now being saved." ``` ### 🧠 Safe Teleport System Never teleports players into dangerous blocks such as: Lava 🔥 Cactus 🌵 Powder Snow ❄️ Portal blocks 🌀 Other configured hazards Checks: Feet & head are passable Solid ground below the player No dangerous blocks nearby Performance capped (max checks per teleport) ### 🛟 Rescue / Anti-Suffocation System If a player somehow still ends up in danger: The plugin automatically searches for a safe location within ±10 blocks Rescue triggers on suffocation damage Rescue is active for a short time after using /lastlocation ### ⚔️ PvP / PvE Combat Cooldown /lastlocation is blocked while the player is in combat Combat includes: PvP PvE Projectiles Damage events that are cancelled by other plugins Cooldown behavior: Resets every time the player hits or gets hit No spam messages while in combat Message is shown only when the command is used Example: ```yml combat: cooldown-seconds: 15 ``` ### 🔁 Automatic Data Migration (No Data Loss) Automatically migrates data from: Old locations.yml Old plugins/LastLocation/Data/*.yml Also supports data/ (lowercase) Creates automatic backups Migration runs only once Clear console summary: Successfully migrated players Skipped entries (missing world, invalid UUID, missing data) ### 🧩 Automatic Config Rebuild on Updates Detects when a new plugin version is installed Automatically: Backs up the old config Rebuilds the config using new defaults Preserves all existing values No manual config reset required ### 💾 Storage & Performance FILE storage (default): One .yml file per player Lazy loading Very low RAM usage Ready for: SQLite MySQL Async IO where possible Hard performance caps to prevent lag ### 🧾 Commands Command Description /lastlocation Teleport to your last logout location /lastlocation reload Reload the config (admin only) ### 🔐 Permissions ```yml lastlocation.use: default: true lastlocation.admin: default: op ``` ### ⚙️ Compatibility ✅ Paper 1.20.10+ ✅ Paper 1.21.x ✅ Java / JDK 21 ❌ Not tested on Spigot / Bukkit ### 📦 Installation Place LastLocation-x.x.x.jar into your /plugins folder Start or restart the server Done! 🎉 ❤️ Design Philosophy Safety first Never unexpected teleports Minimal RAM usage No data loss on updates Production-ready defaults