> For the complete documentation index, see [llms.txt](https://docs.mantic.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.mantic.dev/manticswords/placeholders.md).

# Placeholders

ManticSwords PlaceholderAPI placeholders

## Player and leaderboard

```
%manticswords_mobs% shows the amount of mobs killed by a user
%manticswords_crystals% shows the amount of crystals that a user has
%manticswords_mobtop_POSITIONHERE% - returns the placeholder-format in messages.yml
%manticswords_mobtop_POSITIONHERE_name% - returns the name of the user in that position
%manticswords_mobtop_POSITIONHERE_amount% - returns the amount of the user in that position
%manticswords_crystaltop_POSITIONHERE% - returns the placeholder-format in messages.yml
%manticswords_crystaltop_POSITIONHERE_name% - returns the name of the user in that position
%manticswords_crystaltop_POSITIONHERE_amount% - returns the amount of the user in that position
%manticswords_mobs_pos% shows the leaderboard position of the user for mobs
%manticswords_crystals_pos% shows the leaderboard position of the user for crystals
```

Replace `POSITIONHERE` with the number of the position, for example `%manticswords_mobtop_1%`.

Add `_raw` at the end for an unformatted number (i.e. 172123).\
Add `_short` at the end for a shortened number (i.e. 172.12k).\
By default the numbers use a comma format (i.e. 172,123).

## Prestige

```
%manticswords_prestige_level% - the player's current prestige level
%manticswords_prestige_killed% - the player's total tracked kills
%manticswords_prestige_required_xp% - XP required for the next prestige
%manticswords_prestige_required_money% - money required for the next prestige
%manticswords_prestige_required_currency% - crystal amount required for the next prestige
%manticswords_prestige_required_any% - kills required for the next prestige, any mob
%manticswords_prestige_required_<mob>% - kills required for that mob (e.g. zombie, skeleton)
%manticswords_prestige_next_level% - the next prestige level, or the configured "already max" text
%manticswords_prestige_can_prestige% - the configured can/cannot prestige message
```

Bonus values are available for the next and current prestige, in three categories — `money`, `xp` and `currency`:

```
%manticswords_prestige_next_money_multiplier%    %manticswords_prestige_next_money_percent%
%manticswords_prestige_next_xp_multiplier%       %manticswords_prestige_next_xp_percent%
%manticswords_prestige_next_currency_multiplier% %manticswords_prestige_next_currency_percent%
%manticswords_prestige_current_money_multiplier% %manticswords_prestige_current_money_percent%
%manticswords_prestige_current_xp_multiplier%    %manticswords_prestige_current_xp_percent%
%manticswords_prestige_current_currency_multiplier% %manticswords_prestige_current_currency_percent%
```

`_multiplier` returns the multiplier itself (e.g. `1.25`); `_percent` returns the same bonus as a percentage (e.g. `25`).

## Custom drops

Placeholders for Nexo, Oraxen and ItemsAdder drops use the same ID as the drop:

```
%manticswords_ruby_collected% - how many of that item the player has collected
%manticswords_ruby_sell% - the configured sell price of one item
%manticswords_prestige_required_custom_ruby% - how many are required for the next prestige
```

For Oraxen use the `oraxen:ruby` form (`%manticswords_oraxen_ruby_collected%`), and for ItemsAdder the `itemsadder:myitems:ruby` form (`%manticswords_itemsadder_myitems_ruby_collected%`). Values show `0` before the first drop and while the item is still locked by prestige. Unknown placeholders belonging to other plugins are left alone.

Inside Mantic menus and messages, use braces instead of percent signs — `{ruby_collected}`, `{ruby_sell}`, `{prestige_required_custom_ruby}` — and replace `ruby` with the drop ID.