LastLocation

# LastLocation

**LastLocation** is a lightweight, RAM-efficient **Paper** plugin that allows players to safely return to their **last logout location** — never their death location — with advanced safety, performance caps, and flexible storage options.

Built for **modern Paper servers (1.20+)** using **Java 21**.

---

## ✨ Features

### 📍 Logout Location Tracking
- Saves **only the player’s logout location**
- **Death locations are never saved**
- Extra safeguard: if a player logs out while dead, no location is stored

---

### 🚀 `/lastlocation` Command
- Teleports the player to their last saved logout location
- Optional reload command for admins
- Permission-based access

---

### 🛡️ Advanced Safe Teleport System
- Prevents teleporting:
  - Inside solid blocks (anti-suffocation)
  - Into liquids
  - Onto or into dangerous blocks
- Automatically centers the player in the block to avoid edge clipping

---

### ☠️ Hazard Protection (Fully Configurable)

#### Hard Hazards
Blocks that are **never allowed** at feet, head, or ground:
- Lava, fire, cactus, magma blocks, campfires
- Sweet berry bushes, wither roses, powder snow
- Nether / End portals and gateways
- Fully configurable via `config.yml`

#### Nearby Hazards (Buffer Zone)
- Prevents teleporting **too close** to hazards
- Configurable buffer radius (3×3, 5×5, etc.)
- Optional avoidance of nearby liquids (water / lava)
- Separate material list for fine-grained control

---

### 🛟 Automatic Anti-Suffocation Rescue
- If a player starts **suffocating after teleport**:
  - Damage is cancelled
  - Player is automatically teleported to a safe nearby spot
- Rescue search is centered around the original logout location
- Additional post-teleport safety checks handle edge cases

---

### ⚡ Performance-Safe by Design
- Hard performance caps prevent excessive block scanning
- Limits on:
  - Safe location candidates
  - Nearby hazard block checks
  - Rescue search attempts
- Safe for large servers and aggressive configurations

---

### 🧠 Extremely RAM Efficient
- No player locations cached in memory
- Locations are loaded only when needed
- Rescue data exists only briefly after `/lastlocation`
- Scales cleanly with player count

---

### 💾 Flexible Storage Options
Choose what fits your server best:

- **FILE** – One small file per player (simple & efficient)
- **SQLite** – Single local database file
- **MySQL / MariaDB** – Ideal for multi-server networks

Storage type can be changed via config.

---

### 🔁 Reload Support
- `/lastlocation reload`
- Reloads config, hazard lists, and performance settings
- No server restart required

---

## 📜 Commands

| Command | Description |
|------|-------------|
| `/lastlocation` | Teleport to last logout location |
| `/lastlocation reload` | Reload configuration |

---

## 🔐 Permissions

| Permission | Description | Default |
|---------|-------------|---------|
| `lastlocation.use` | Use `/lastlocation` | `true` |
| `lastlocation.admin` | Reload config | `op` |

---

## ⚙️ Configuration Explanation

### 🗄️ Storage

yml storage: type: "FILE" FILE – Per-player files (default) SQLITE – Single local database MYSQL – Remote database for networks Teleport Safety teleport: safe-teleport: true Enables all safety logic. Highly recommended. Safe Location Search teleport: safe-search: max-radius: 6 max-up: 6 max-down: 6 Controls how far the plugin searches for a safe teleport spot. Auto-Rescue teleport: rescue: enabled: true window-seconds: 8 rescue-radius: 10 rescue-max-up: 10 rescue-max-down: 10 Automatically rescues players if suffocation occurs shortly after teleport. Hazard Control Hard Hazards teleport: hazards: override-defaults: false materials: - LAVA - FIRE - CACTUS Blocks that are never allowed at feet, head, or ground. Nearby Hazards (Buffer Zone) teleport: hazards: nearby: buffer-radius: 1 avoid-liquids-nearby: false override-defaults: false materials: - WATER - LAVA Prevents teleporting too close to dangerous blocks. Performance Limits teleport: performance: max-candidates: 900 max-nearby-block-checks: 300 rescue-max-candidates: 1600 Hard caps that protect server performance. Messages messages: teleported: "&aTeleported to your last logout location." no-location: "&cNo saved logout location found." Supports color codes using &. Compatibility Platform: Paper Minecraft: 1.20+ Java: 21 ```