LastServerAndLobby

# 🧭 LastServer & Lobby <!-- PLACEHOLDER PARA TU BANNER --> <div align="center"> !(https://img.shields.io/badge/Proxy-Velocity_3.x-blue?style=for-the-badge&logo=serverless&color=0984e3) !(https://img.shields.io/badge/Java-17%2B-orange?style=for-the-badge&logo=java) !(https://img.shields.io/badge/License-MIT-lightgrey?style=for-the-badge) !(https://img.shields.io/badge/Size-Lightweight-green?style=for-the-badge) **The essential navigation utility for Velocity networks.** <br> Seamlessly manage player movement between Backend servers, Lobbies, and their last known position. </div> --- ## 📑 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: ```log JOIN | name=Steve | uuid=... SWITCH | name=Steve | from=JOIN | to=auth SWITCH | name=Steve | from=auth | to=lobby QUIT | name=Steve | from=lobby | to=DISCONNECT ``` Configurable: You can toggle logging to Disk (file) and Console independently. ⚙️ Configuration <details> <summary>📄 <b>Click to view config.yml structure</b></summary> ```yaml # 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 ``` </details> ## ✅ 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**.