Harbour

Harbour

``` ██╗ ██╗ █████╗ ██████╗ ██████╗ ██████╗ ██╗ ██╗ ██████╗ ██║ ██║ ██╔══██╗ ██╔══██╗ ██╔══██╗ ██╔═══██╗ ██║ ██║ ██╔══██╗ ███████║ ███████║ ██████╔╝ ██████╔╝ ██║ ██║ ██║ ██║ ██████╔╝ ██╔══██║ ██╔══██║ ██╔══██╗ ██╔══██╗ ██║ ██║ ██║ ██║ ██╔══██╗ ██║ ██║ ██║ ██║ ██║ ██║ ██████╔╝ ╚██████╔╝ ╚██████╔╝ ██║ ██║ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═╝ ╚═════╝ ╚═════╝ ╚═════╝ ╚═╝ ╚═╝ ```

Made with ❤ by Dronzer Studios

🌊 What is Harbour?

Harbour is a powerful Velocity proxy plugin that seamlessly redirects players between servers during maintenance, updates, or server downtime. Keep your players connected to a limbo/waiting server while you work on your main server, then automatically bring them back when you're done!

✨ Key Features

- 🎮 Status Monitoring - Instantly move all players from main server to limbo - ⏰ Status Monitoring - Set automatic return timers (e.g., 10 minutes) - 🔄 Status Monitoring - Automatically redirect players when main server goes offline - ↩️ Status Monitoring - Bring players back when main server is online again - 🛡️ Status Monitoring - Multiple server fallback chain - ⚙️ Status Monitoring - Custom commands, messages, and server names - 📊 Status Monitoring - Track redirected players and system status

🚀 Quick Start

1. Install on your Velocity proxy (not on backend servers) 2. Configure server names in `config.yml` 3. Run `/updatemode enable` to redirect players 4. Run `/updatemode disable` to bring them back

📋 Commands

- `/updatemode enable [seconds]` - Enable update mode (optional timer) - `/updatemode disable` - Disable update mode and return players - `/updatemode status` - Show current status - `/updatemode reload` - Reload configuration

Permission: `harbour.admin`

🎯 Use Cases

Planned Maintenance

```bash /updatemode enable 600 # 10 minutes ``` Players moved to limbo for 10 minutes, then automatically returned.

Automatic Failover

Enable auto-redirect in config - players automatically move to limbo when main server crashes!

⚙️ Configuration

```yaml servers: main-server: "survival" # Your main game server limbo-server: "limbo" # Waiting/update server fallback-server: "lobby" # Backup server

redirection: auto-redirect-on-offline: true auto-return-on-online: true check-interval: 30 ```

🔧 Requirements

- Java 17+ - Java 17+ - At least 2 backend servers (main + limbo)

💡 Pro Tips

- Permissions: Keep this lightweight and always online - Permissions: Must match exactly with your `velocity.toml` - Permissions: Give admins `harbour.admin` permission

🐛 Support

Found a bug or have a feature request? Email me at: [email protected]

---

Made with ❤ by Dronzer Studios