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

Permission	Description	Default
quickconnect.reload	Allows /qcreload	OP
quickconnect.server.<server>	Restricts access to joining specific servers if defined	None

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:.

1. Compass Distribution

compass-enabled-servers:
  - hub
  - survival

Only servers listed here will give and restore the compass.

1. GUI Title

gui:
  title: "&b&lServer Selector"

Supports standard Minecraft color codes.

1. Lore for GUI Items

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

Placeholders:

{server} = Display name`

{players} = Live player count

1. 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"] 

Field	Description
Name	Display name in GUI
bungee	Server name as defined in BungeeCord/Waterfall
icon	Material used in the GUI
slot	Inventory slot (0–26)
permission	Optional permission to join
aliases	Commands that connect to this server

---

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