Skip to main content

​
Overview

The server connection plugin handles the connection logic for players in your network. This plugin is essential for any Minecraft network that uses SimpleCloud. It acts as the central connection manager for your servers.
This plugin internally uses the server API to track online cloud servers and provides interfaces for custom implementations.

​
Features

The server connection plugin provides:
  • Automatic Fallback: When a server crashes or shuts down, players are automatically moved to a fallback server
  • Connection Queue: Manages player connections to prevent overwhelming servers during mass reconnects
  • Server State Awareness: Only connects players to servers in an appropriate state
  • Customizable Behavior: Configure fallback priorities and connection rules

​
Supported Software

SoftwarePlugin SupportServer API Support
Velocity✅ Full✅ Yes
Bungeecord✅ Full✅ Yes
Gate🔄 Planned✅ Yes

​
Quick Setup

  1. Download the plugin from GitHub
  2. Place it in your proxy template’s plugins folder
  3. Start your proxy server
  4. Configure using config.yml

​
Configuration

The plugin’s configuration file (config.yml) supports the following options: 
version: "1"

connections:
  - name: "lobby"
    server-name-matcher:
      operation: "STARTS_WITH"
      value: "lobby"

network-join-targets:
  enabled: true
  no-target-connection-found-message: "<color:#dc2626>No lobby server is currently available."
  target-connections:
    - name: "lobby"
      priority: 0

fallback-connections-config:
  enabled: true
  no-target-connection-found-message: "<color:#dc2626>You were disconnected because no fallback lobby is available."
  target-connections:
    - name: "lobby"
      priority: 0

commands:
  - name: "lobby"
    aliases:
      - "l"
      - "hub"
      - "leave"
      - "quit"
    already-connected-message: "<color:#fbbf24>You are already connected to the lobby."
    no-target-connection-found: "<color:#dc2626>No lobby server is available."
    target-connections:
      - name: "lobby"
        priority: 0

​
How It Works

When a player needs to be moved (server shutdown, kick, etc.):
  1. The plugin checks for available fallback servers
  2. Servers are prioritized by the configured group order
  3. The player is connected to the first available server
  4. If no server is available, the configured kick message is shown