Server status placeholder

ServerStatus

Shows the status of your BungeeCord servers through placeholders.

ServerStatus is split into two parts:

• BungeeCord module : pings every server you list in the config, checks whether it's in maintenance, and pushes the result to your backend servers.
• Spigot module : receives those statuses and exposes them through PlaceholderAPI.

If you run a scoreboard, tablist, chat or any other plugin that supports PlaceholderAPI, you can drop these in:

%srvstatus_lobby%
%srvstatus_survival%

Each returns one of three values (all customizable in the config):

• Online
• Offline
• Maintenance

Setup

1. Put the BungeeCord jar in your proxy's plugins folder.
2. Put the Spigot jar in the plugins folder of every server you want placeholders on.
3. Restart everything.
4. Done. The srvstatus expansion registers by itself.

Configuration

The Bungee side has a config.yml with the basics:

# Servers to track (must match your BungeeCord names)
servers:
  - lobby
  - survival
  - dev

# How often to check (seconds)
update-interval: 5

# Status text and colors
messages:
  online: "&aOnline"
  offline: "&cOffline"
  maintenance: "&6Maintenance"

Statuses refresh on the interval you set, and again whenever a player joins the proxy.

Requirements

• BungeeCord or Waterfall with the Maintenance plugin (for maintenance detection)
• Spigot/Paper 1.20.4+ with PlaceholderAPI

Building

mvn clean package

Java 17+.