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