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

• Smooth Player Redirection - Instantly move all players from main server to limbo
• Timed Updates - Set automatic return timers (e.g., 10 minutes)
• Auto-Failover - Automatically redirect players when main server goes offline
• Auto-Return - Bring players back when main server is online again
• Fallback Protection - Multiple server fallback chain
• Fully Configurable - 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

/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

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

• Velocity 3.3.0+
• Java 17+
• At least 2 backend servers (main + limbo)

💡 Pro Tips

• Pico Limbo: Keep this lightweight and always online
• Server Names: 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