Placeholders

Placeholders

Requires PlaceholderAPI. The expansion registers itself automatically at start-up — nothing to download from eCloud.

Confirm it loaded:

[Hooks] Registered PlaceholderAPI expansion 'uvs'.

or in game:

/papi parse me %uvs_total%

Server-wide

Placeholder	Value
%uvs_total%	Managed spawners server-wide
%uvs_types%	Number of configured spawner types

These work without a player context, so they are safe in console output, MOTDs and holograms.

Money

Placeholder	Example
%uvs_balance%	12480.00 — raw, two decimals, no symbol
%uvs_balance_formatted%	$12,480 — with symbol and grouping
%uvs_balance_short%	$12.5K — compact

Formatting follows ECONOMY.CURRENCY_SYMBOL, SYMBOL_BEFORE_AMOUNT and COMPACT_FORMAT in config.yml. These read whichever provider is active, so they work with an external Vault economy too.

Use %uvs_balance% for sorting and comparisons, the other two for display.

Per player

Placeholder	Value
%uvs_owned%	Spawner blocks the player owns
%uvs_owned_stack%	Total stack size across all their spawners
%uvs_owned_stored%	Total stored items across all their spawners
%uvs_owned_xp%	Total stored XP across all their spawners
%uvs_world%	Managed spawners in the player's current world

%uvs_owned% counts blocks; %uvs_owned_stack% counts spawners. A player with two blocks holding 100 each gets 2 and 200.

%uvs_world% counts every spawner in the world, not only the player's own, and requires them to be online.

The spawner being looked at

Resolved against the block within 6 blocks of the player's crosshair. All return an empty string when the player is not looking at a managed spawner.

Placeholder	Value
%uvs_looking_type%	Type display name, colour codes stripped
%uvs_looking_owner%	Owner name as recorded at placement
%uvs_looking_stack%	Stack size
%uvs_looking_stored%	Total stored items
%uvs_looking_xp%	Stored XP, one decimal
%uvs_looking_access%	OWNER_ONLY, OWNER_AND_TEAM or PUBLIC

Ideal for a scoreboard or action bar that updates as a player looks around their farm.

Examples

Scoreboard

lines:
  - '&7Balance: &a%uvs_balance_short%'
  - '&7Spawners: &f%uvs_owned% &7(&f%uvs_owned_stack%&7)'
  - '&7Stored: &f%uvs_owned_stored%'

Action bar while aiming at a spawner

format: '&d%uvs_looking_type% &7x%uvs_looking_stack% &8| &f%uvs_looking_stored% &7stored'

Tab list header

header:
  - '&dMyServer'
  - '&7%uvs_total% spawners across the server'

Inside this plugin's own messages

PlaceholderAPI placeholders resolve in messages.yml and menus.yml too:

SPAWNER:
  PLACE_SUCCESS: '&aPlaced &f{amount}x {type}&a. You now own %uvs_owned% spawners.'

Notes

• Unknown placeholders return null, which PlaceholderAPI renders as the literal placeholder text. A visible %uvs_something% means a typo.
• %uvs_looking_*% and %uvs_world% need an online player. In an offline context they return nothing.
• %uvs_owned_*% iterate every spawner the player owns each time they are resolved. On a scoreboard refreshing several times per second, for a player with thousands of spawners, that adds up — prefer a 1–2 second refresh interval.

See also

• Economy — currency formatting
• messages.yml — where placeholders can be used