# 🔍 Placeholders

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

They all need the [Alt Protection](../alts.md) module enabled. Set **Max Accounts Per Address** to 0 if you want the numbers without anyone ever being denied.

## The player

Every placeholder in this section reports on the player it is rendered for.

| Placeholder                              | Returns                                                          |
| ---------------------------------------- | ---------------------------------------------------------------- |
| `%phoenixlobby_alts_has_alts%`           | `true` / `false`, whether any other account is linked            |
| `%phoenixlobby_alts_count%`              | How many other accounts are linked to this player                |
| `%phoenixlobby_alts_online_count%`       | How many of them are connected right now                         |
| `%phoenixlobby_alts_slots_left%`         | How many more accounts may join from that address                |
| `%phoenixlobby_alts_names%`              | The linked account names, up to three                            |
| `%phoenixlobby_alts_addresses_count%`    | How many addresses this player has been seen on                  |
| `%phoenixlobby_alts_first_seen%`         | When this player was first seen, as `2026-08-20 21:15`           |
| `%phoenixlobby_alts_last_seen%`          | When this player was last seen                                   |
| `%phoenixlobby_alts_bypass%`             | `true` / `false`, whether this player is exempt from the limit   |
| `%phoenixlobby_alts_address_masked%`     | The address with its last two blocks hidden, as `87.213.x.x`     |

`has_alts` is the one to branch on when you want a marker next to a suspected alt in the tablist, since most plugins can switch on a `true` / `false` value.

Over three linked accounts, `names` ends with **and 4 more**, taken from your translations file. `slots_left` returns -1 when the limit is off, so check that before showing it as a number.

Adding a name reports on somebody else instead, which is what an admin menu or a hologram about another player needs.

| Placeholder                            | Returns                                            |
| -------------------------------------- | -------------------------------------------------- |
| `%phoenixlobby_alts_count_Notch%`      | How many accounts are linked to that player        |
| `%phoenixlobby_alts_last_seen_Notch%`  | When that player was last seen                     |

Any of the placeholders above accepts a name this way. A player that has never been seen returns nothing.

## The server

| Placeholder                              | Returns                                                        |
| ---------------------------------------- | -------------------------------------------------------------- |
| `%phoenixlobby_alts_enabled%`            | `true` / `false`, whether the protection is running            |
| `%phoenixlobby_alts_managed_by%`         | `lobby` or `proxy`, which side is in charge                    |
| `%phoenixlobby_alts_limit%`              | The configured accounts per address                            |
| `%phoenixlobby_alts_tracked_players%`    | How many players the history holds                             |
| `%phoenixlobby_alts_tracked_addresses%`  | How many addresses the history holds                           |
| `%phoenixlobby_alts_blocked_total%`      | How many joins were denied since the last restart              |
| `%phoenixlobby_alts_accounts_on_<address>%` | How many accounts have been seen on one address             |

## Geolocation

These report where an address is, using the same service and the same **Geolocation** options the `/alts geo` command uses. The field names match the ones the [Geolocation expansion](https://ecloud.placeholderapi.com/expansions/geolocation/) uses, so an existing setup can be moved over by renaming the prefix.

| Placeholder                          | Example result       |
| ------------------------------------ | -------------------- |
| `%phoenixlobby_geo_country%`         | United States        |
| `%phoenixlobby_geo_countrycode%`     | US                   |
| `%phoenixlobby_geo_regionname%`      | Virginia             |
| `%phoenixlobby_geo_region%`          | VA                   |
| `%phoenixlobby_geo_city%`            | Chantilly            |
| `%phoenixlobby_geo_zip%`             | 20151                |
| `%phoenixlobby_geo_lat%`             | 38.9036              |
| `%phoenixlobby_geo_lon%`             | -77.4512             |
| `%phoenixlobby_geo_timezone%`        | America/New\_York    |
| `%phoenixlobby_geo_isp%`             | Example ISP          |

Each one also takes a name or an address, so `%phoenixlobby_geo_country_Notch%` and `%phoenixlobby_geo_country_1.2.3.4%` both work.

> **Warning:**
A location is never looked up while a placeholder is being rendered, because that would freeze the server for as long as the service takes to answer. The first request returns nothing and starts the lookup in the background, so the value appears a moment later and is then reused for as long as **Geolocation Cache Minutes** allows. Put these where a short delay on the first render is fine, not in a message a player reads once.

> **Info:**
The default lookup asks for every field above. A server that was set up before these placeholders existed still has the shorter list in its **Geolocation Api Url**, and the fields missing from it come back empty until they are added.

## Behind a proxy

The proxy is the one counting accounts on a network, so the numbers come from there and cover every server at once rather than only this one. The lobby is sent them as they change, which means a lobby that has just started reports zeroes until the first update arrives.

Two things stay on the lobby side. The geolocation placeholders are answered by the lobby from the address it sees, which needs ip forwarding turned on in your proxy, and `%phoenixlobby_alts_accounts_on_<address>%` only reads the lobby's own history.

A player on another backend server cannot be looked up by name, since the lobby is only told about the players it is hosting.

Source: https://www.phoenixplugins.com/docs/phoenix-lobby/modules/alts/placeholders