# 🔍 Placeholders

These are [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) placeholders, so they work anywhere PlaceholderAPI is read, including the [scoreboard](../../modules/scoreboard.md), the [tablist](../../modules/tablist.md) and holograms.

Every one of them takes a backend's name, the same name the proxy **config.yml** lists under `servers`.

> **Info:**
PhoenixLobby has to be installed on the proxy as well. Without it the lobby is never told about the other servers, and every placeholder here answers with its empty value.

## Player count

| Placeholder                          | Returns                    |
| ------------------------------------ | -------------------------- |
| `%phoenixlobby_proxy_total%`         | Everyone on the network    |
| `%phoenixlobby_proxy_<server>%`      | Players on that backend    |
| `%phoenixlobby_proxy_max_<server>%`  | Slot count of that backend |

Both counts leave vanished staff out. The proxy works them out itself and hands the same figure to every backend, so two lobbies never disagree about how busy the network is.

> **Warning:**
A backend without PhoenixLobby on it cannot report who is vanished there, so staff vanished on that server are still counted.

## Is it up

| Placeholder                             | Returns                                  |
| --------------------------------------- | ---------------------------------------- |
| `%phoenixlobby_proxy_online_<server>%`  | Online or Offline |

Both words come from your translations file under `proxy`, so they follow whatever language you have set, colours included.

## MOTD and version

| Placeholder                                  | Example result       |
| -------------------------------------------- | -------------------- |
| `%phoenixlobby_proxy_motd_<server>%`         | `A Minecraft Server` |
| `%phoenixlobby_proxy_gameversion_<server>%`  | `1.21.4`             |
| `%phoenixlobby_proxy_pingversion_<server>%`  | `769`                |

The MOTD arrives with its colours intact and with the line break the server put in it, so a two-line MOTD needs somewhere that can hold two lines. `gameversion` is the version name the backend reports, which it may have rewritten to something like `Paper 1.21.4`, while `pingversion` is the protocol number behind it.

## When there is no answer

A server the proxy has not reported yet, one that is offline, or a name that does not exist at all, answers with an empty value rather than the placeholder text.

| Placeholder   | Empty value                              |
| ------------- | ---------------------------------------- |
| `motd`        | Nothing at all                           |
| `gameversion` | Nothing at all                           |
| `max`         | `0`                                      |
| `pingversion` | `-1`                                     |
| `online`      | Offline |

The two player counts are the exception. Until the first report arrives they fall back to the proxy's plain number, the same one any BungeeCord player count gives, which still has vanished staff in it, and to `0` when even that is missing.

## How fresh the numbers are

The proxy already checks each backend on the [Server Discovery](../setup-with-proxy.md#server-discovery) interval, and the report rides along with it. Everything on this page is therefore at most `server-discovery-seconds` old, three seconds by default. Lowering that makes the placeholders react faster at the cost of pinging every backend more often.

A lobby with nobody on it is not sent the report, since the message travels with a player. The first player to join fills it in within one interval.

> **Warning:**
The server name starts after the first underscore, so `%phoenixlobby_proxy_max_survival_1%` is the slot count of `survival_1`. A backend whose own name begins with one of the words above, such as a server literally named `max_1`, cannot be counted with the plain `%phoenixlobby_proxy_max_1%`, because that reads as the slot count of `1`.

Source: https://www.phoenixplugins.com/docs/phoenix-lobby/set-up/setup-with-proxy/placeholders