Skip to content

PlaceholderAPI

Once PlaceholderAPI is detected, FunnyGuilds registers its own funnyguilds expansion — nothing needs to be downloaded via /papi ecloud. It makes FunnyGuilds data available to other plugins: chat formatters, GUIs and scoreboards.

The expansion accepts any placeholder from the built-in placeholder list — write its name in lowercase after funnyguilds_:

%funnyguilds_<name>% → {NAME}

Anything that works as {X} in the FunnyGuilds tablist or chat also works as %funnyguilds_x% in other plugins — the expansion has no separate placeholder list.

Example Equivalent Returns
%funnyguilds_player% {PLAYER} The player’s nickname
%funnyguilds_points% {POINTS} The player’s ranking points
%funnyguilds_g-tag% {G-TAG} The player’s guild tag
%funnyguilds_g-members-online% {G-MEMBERS-ONLINE} The number of guild members online
%funnyguilds_position-kills% {POSITION-KILLS} The player’s position in the kills top list
%funnyguilds_gtop-avg_points-1% {GTOP-AVG_POINTS-1} The first guild in the average-points top list

The expansion also provides one relational placeholder, which depends on who is looking at whom:

Placeholder Returns
%rel_funnyguilds_tag% The observed player’s guild tag, coloured by their relation to the observer (ally, enemy, same guild)

The same value-formatting rules apply to %funnyguilds_points-format%, %funnyguilds_ping-format% and %funnyguilds_g-avg-points-format%. Results include colors for chat plugins, GUIs and scoreboards. The expansion requires an existing FG user; a missing player or unknown user returns an empty string. A missing guild returns neutral 0/0.00.