QuickConnect

QuickConnect

QuickConnect is a lightweight, multi-use server selector for BungeeCord/Waterfall networks. It provides a customizable GUI, compass selector, dynamic aliases, and live player counts. Designed for ease of use, clarity, and compatibility with all major Spigot/Paper versions.

Features

• GUI Server Selector
Fully customizable title, icons, slots, and descriptions.

• Optional Compass Selector
Automatically given to players on defined servers. Undroppable, unmovable, and auto-restores if lost.

• Live Player Counts
Pulls player counts directly from BungeeCord and displays them in the GUI.

• Dynamic Aliases
Automatically supports commands such as: /hub, /h, /lobby, /survival, /s, /creative, etc.

• Per-Server Permissions
You can restrict access to certain servers if desired.

• Multi-Version Compatible
Supports 1.13 through the latest version.

• Clean Configuration
Simple, readable, and flexible config.yml suitable for all network sizes.

Commands
/server <name>
Connects a player to a server defined in the config. Supports tab completion and all aliases.

/qcreload
Reloads the configuration file.

Permission required: quickconnect.reload

Permissions

If a server has this in the config: permission: "quickconnect.server.survival"

Then only players with that permission may join via the GUI or aliases.

Configuration Overview

Only one value is required per backend server:

1. Server Identity this-server: "hub"

This tells the plugin which backend server it is running on. It must match a key under servers:.

2. Compass Distribution

compass-enabled-servers:
  - hub
  - survival

Only servers listed here will give and restore the compass.

3. GUI Title

gui:
  title: "&b&lServer Selector"

Supports standard Minecraft color codes.

4. Lore for GUI Items

gui-lore:
  - "&7Welcome to {server}!" 
  - "&a{players} players online."
  - "&eClick to join!"

Placeholders:

{server} = Display name`

{players} = Live player count

5. Server Definitions

servers:

  hub:  
    name: "Hub"  
    bungee: "lobby"  
    icon: NETHER_STAR  
    slot: 11  
    permission: ""  
    aliases: ["hub", "lobby", "h"]  

  survival:  
    name: "Survival"  
    bungee: "survival"  
    icon: GRASS_BLOCK  
    slot: 15  
    permission: ""  
    aliases: ["survival", "s", "sm"]  

  creative:  
    name: "Creative"  
    bungee: "creative"  
    icon: PAINTING  
    slot: 13  
    permission: ""  
    aliases: ["creative", "cr"] 

Installation

1. Install the plugin on every backend server (not the proxy).

2. Set the correct value for this-server: on each backend server.

3. Edit the servers: section to match your network.

4. Restart the backend server(s).

5. Players can now use the GUI selector and commands.

Compatible with:

• Spigot

• Paper

• All BungeeCord/Waterfall networks

Contact me on discord with any bugs and questions
https://discord.gg/nTzuMa5bEq