QuickConnect | Utility

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

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"] ```

| 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