# Placeholders ## Placeholders in config.yml Supports PlaceholderAPI placeholders ## Placeholders in messages.yml Supports PlaceholderAPI placeholders based on the viewer ## Command-linked placeholders | Placeholder | Description | | -------------------- | ------------------------------- | | %command% | The command used | | %commandDescription% | Description of the (sub)command | | %commandPermission% | Permission of the (sub)command | | %subcommand% | The subcommand used | | %subcommand+args% | Syntax of (sub)command | ## Contextual Placeholders The placeholders below are created gradually which means not every single one is available at all times. ### Menu Placeholders {% hint style="info" %} Valid for: * /leaderboardmenu * /leaderboardmenuadmin open * /leaderboardmenuadmin openpage {% endhint %}
PlaceholderDescription
%currentPage%The current page in the menu
%maxPages%The max pages in the menu
%target%The menu viewer name
%refreshFrequency%The specified refresh frequency
%boardName%The board name
%boardDisplayName%The board display name
%aliasCommand%The alias command for the board
%type%The board type
%scorePrefix%The score prefix of the board
%scoreSuffix%The score suffix of the board
%includeZero%Whether to include score of 0 (true/false)
%hasCustomItems%Whether the board has custom items (true/false)
%hasOverriddenLeaderboardPlayerItem%Whether the board has overridden the leaderboard player item (true/false)
%totalEntries%Total leaderboard players in the menu
%totalScore%
%totalScorePretty%
%totalScoreFormatted%
%totalScoreFormattedUppercase%		Total score of the board

%topPlayerName%
%topPlayerScore%
%topPlayerPosition%
%topPlayerUuid%
%topPlayerScorePretty%
%topPlayerScoreFormatted%
%topPlayerScoreFormattedUppercase%

%topPlayerScoreFormattedTicks%

%topPlayerScoreFormattedMillis%
%topPlayerScoreFormattedSeconds%
%topPlayerScoreFormattedMinutes%
%topPlayerScoreFormattedHours%
%topPlayerScoreFormattedDays%

Placeholders for the top player. If doesn't exist, "N/A"

%bottomPlayerName%
%bottomPlayerScore%
%bottomPlayerPosition%
%bottomPlayerUuid%
%bottomPlayerScorePretty%
%bottomPlayerScoreFormatted%
%bottomPlayerScoreFormattedUppercase%

%bottomPlayerScoreFormattedTicks%

%bottomPlayerScoreFormattedMillis%
%bottomPlayerScoreFormattedSeconds%
%bottomPlayerScoreFormattedMinutes%
%bottomPlayerScoreFormattedHours%
%bottomPlayerScoreFormattedDays%

Placeholders for the bottom player. If doesn't exist, "N/A"

%viewerName%
%viewerScore%
%viewerPosition%
%viewerUuid%
%viewerScorePretty%
%viewerScoreFormatted%
%viewerScoreFormattedUppercase%
%viewerScoreFormattedTicks%

%viewerScoreFormattedMillis%
%viewerScoreFormattedSeconds%
%viewerScoreFormattedMinutes%
%viewerScoreFormattedHours%
%viewerScoreFormattedDays%

Placeholders for the viewer player. If doesn't exist, "N/A"
{% hint style="success" %} These placeholders are pretty much usable anywhere. {% endhint %} ### Leaderboard Player Specific Placeholders | Placeholder | Description | | ------------------------- | --------------------------------------------------------- | | %position% | Position of the player in the leaderboard | | %playerName% | Name of the player | | %uuid% | UUID of the player | | %score% | Score format: 19288.0 | | %scorePretty% | Score format: 19288 | | %scoreFormatted% | Score format: 19,29k | | %scoreFormattedUppercase% | Score format: 19,29K | | %scoreFormattedTicks% | Score (in ticks) converted into y, mo, d, h, s, ms | | %scoreFormattedMillis% | Score (in milliseconds) converted into y, mo, d, h, s, ms | | %scoreFormattedSeconds% | Score (in seconds) converted into y, mo, d, h, s, ms | | %scoreFormattedMinutes% | Score (in minutes) converted into y, mo, d, h, s, ms | | %scoreFormattedHours% | Score (in hours) converted into y, mo, d, h, s, ms | | %scoreFormattedDays% | Score (in days) converted into y, mo, d, h, s, ms | The placeholders from [#menu-placeholders](#menu-placeholders "mention") are usable here as well. ### Update Checker Placeholders The placeholders you can use in **messages.yml** | Placeholder | Description | | --------------- | ------------------------------ | | %oldVersion% | The old plugin version | | %newVersion% | The new plugin version | | %checkDuration% | Time taken to check for update | --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.aeonxd.xyz/plugins/leaderboardmenus/placeholders.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.