Plugin support
PlaceholderAPI
PlaceholderAPI lets scoreboards, chat formats, holograms and menu plugins print live values. It works both ways with RP Engine:
- RP Engine adds
%rpengine_...%placeholders, listed below, for what a player is holding, which bundle they have, how much content the server has, and more. There is nothing to enable and no expansion to download. - RP Engine's own HUDs and Dialogs show any PlaceholderAPI placeholder, from any plugin. See Other plugins' placeholders.
Yes/no answers are true or false.
About the server#
| Placeholder | What it answers |
|---|---|
%rpengine_version% | The plugin version |
%rpengine_content% | Everything loaded, counted |
%rpengine_namespaces% | How many packs |
%rpengine_items% | How many items |
%rpengine_models% | How many models |
%rpengine_sounds% | How many sounds |
%rpengine_screens% · %rpengine_huds% | Screens and overlays |
%rpengine_entities% · %rpengine_recipes% | Entities and recipes |
%rpengine_emotes% | How many emotes |
These work for the console and offline players too.
About a player#
| Placeholder | What it answers |
|---|---|
%rpengine_bundle% | The bundle they are seeing (the top one, if they hold several) |
%rpengine_bundles% | How many they hold |
%rpengine_holding% | The content ID in their hand, or empty |
%rpengine_holding_name% | The same without the namespace |
%rpengine_emoting% | Whether they are mid-emote |
%rpengine_can_emote% | Whether they have a rig to emote with |
%rpengine_seated% | Whether they are sitting on a model |
%rpengine_synced% | Whether they are paired with Studio |
%rpengine_sync_code% · %rpengine_sync_owner% · %rpengine_sync_size% | Which pairing, whose, and how many are on it |
%rpengine_var_<name>% | A dialog setting the player chose with a switch or slider. Empty until they choose |
%rpengine_tag% | The rank tag they wear, as the character to print: of the tags whose permission they have, the highest priority. Empty for none |
%rpengine_tag_id% | Which tag that is, as its content ID |
%rpengine_tag_<slot>% · %rpengine_tag_id_<slot>% | The same for a tag slot |
%rpengine_tags% | Every rank tag they wear, one per slot, highest priority first, spaces between |
For an offline player these are empty.
Asking a question#
These take an argument:
| Placeholder | What it answers |
|---|---|
%rpengine_holds_<bundle>% | Whether this player holds that bundle |
%rpengine_has_<namespace>:<id>% | Whether this server has that content (asked about an online player) |
%rpengine_icon_<namespace>:<id>% | That icon, as the character to print. An animated one is the frame showing now |
%rpengine_holds_dungeon%
%rpengine_has_mypack:ruby%
%rpengine_icon_mypack:dance%Animated icons animate through the icon placeholder. A scoreboard, tab list or hologram asks again each time it redraws, and each answer is the next frame, so the icon moves as fast as that plugin refreshes. It works for the console and offline players too. See Animated icons.
Other plugins' placeholders#
With PlaceholderAPI installed, a HUD or Dialog can print any placeholder it
knows, written either way: {vault_eco_balance} or %vault_eco_balance%.
Placeholders with arguments work too, such as %server_time_HH:mm% or
%statistic_{player_name}%, as long as there is no space in them. They are
filled in for the player looking at the screen. Arguments need RP Engine
0.2.48 or newer.
Good to know#
- Every placeholder is a quick lookup, so it is safe on a scoreboard that refreshes every tick.
- A placeholder name RP Engine does not know (a typo, or an icon that does not exist) is printed as you typed it, so you can see the mistake.