🧭 LastServer & Lobby

The essential navigation utility for Velocity networks.
Seamlessly manage player movement between Backend servers, Lobbies, and their last known position.

---

📑 Table of Contents

• ✨ Features
• 🚀 Installation
• 📜 Commands & Permissions
• 💾 Storage & Persistence
• 📝 Movement Logging
• ⚙️ Configuration

---

✨ Features

Feature	Description
🏰 Lobby Command	Instantly send players to your main Hub/Lobby with configurable aliases (e.g., /hub, /spawn).
🔙 Last Server	Allow players to return to their previous backend server with /last. Perfect for Auth lobbies.
💾 Persistence	Remembers player positions even after proxy restarts via data.yml.
📝 Smart Logging	Tracks player movement (Switch/Join/Quit) in organized log files per session.
⚡ Lightweight	Optimized for Velocity 3.x. Zero lag, instant execution.

---

🚀 Installation

1. Download: Get the latest .jar file.
2. Upload: Place it into your proxy's plugins folder: Velocity/plugins/.
3. Restart: Reboot your Velocity proxy.
4. Enjoy: The config files will generate automatically.

---

📜 Commands & Permissions

Manage who can use the navigation features.

Command	Aliases (Configurable)	Permission	Description
/lobby	/hub, /exit, /leave	lastserverandlobby.lobby	Connect to the configured Lobby server.
/last	/return, /back	lastserverandlobby.last	Connect to the last server visited.
/lastserver reload	-	lastserverandlobby.admin	Reloads config.yml.
/lastserver dump	-	lastserverandlobby.admin	Prints memory stats (Debug).

💡 Tip: You can define multiple aliases for commands in the config.yml to fit your server's language.

---

💾 Storage & Persistence

The plugin intelligently saves where players have been. You can configure when to save data to disk to balance performance and safety.

Save Modes:

• TIME: Saves data every X seconds.
• MOVES: Saves data after X server switches.
• BOTH: Uses both criteria (recommended for busy servers).

Data is stored in: plugins/lastserverandlobby/data.yml

---

📝 Movement Logging

Keep track of your players' journey through your network. The plugin creates a new log file every time the proxy starts.

Location: plugins/lastserverandlobby/logs/

Example Output:

[2026-01-15 23:15:05] JOIN   | name=Steve | uuid=...
[2026-01-15 23:15:06] SWITCH | name=Steve | from=JOIN | to=auth
[2026-01-15 23:15:11] SWITCH | name=Steve | from=auth | to=lobby
[2026-01-15 23:16:53] QUIT   | name=Steve | from=lobby | to=DISCONNECT

Configurable: You can toggle logging to Disk (file) and Console independently.

⚙️ Configuration

📄 Click to view config.yml structure

# LastServerAndLobby Configuration

# Target server for /lobby command
lobby-server: "lobby"

# Command Aliases
commands:
lobby-aliases:
- "hub"
- "spawn"
last-aliases:
- "back"
- "return"

# Persistence Settings
storage:
save-mode: "BOTH" # TIME, MOVES, or BOTH
save-interval: 300 # Seconds
moves-interval: 10 # Server switches

# Logging Settings
logging:
log-to-file: true
log-to-console: false

✅ Compatibility

• Velocity: 3.x (Tested on 3.4.0+ snapshots).
• Permissions: Fully compatible with LuckPerms Velocity.

---

⚖️ License

This project is licensed under the MIT License.