Placeholders

Placeholders

The full reference of every placeholder MoreSparkles resolves in messages, boss bars, check-rate messages and Discord embeds. This page exists so you don't have to hunt through each config file individually.

Tip

There are two ways to use a MoreSparkles placeholder:

• Internal form: %boost_multiplier%, %player_shiny_rate%, etc. Works everywhere MoreSparkles itself parses text: Messages.json, boss bars, check-rate messages and Discord embed content. No extra setup required.
• PlaceholderAPI form: %moresparkles:player_shiny_rate% (the same ID, prefixed with moresparkles:). Works anywhere PlaceholderAPI placeholders are supported by another mod (holograms, scoreboards, tab lists, chat mods, etc.). Requires PlaceholderAPI to be installed; MoreSparkles registers these automatically when it is.

Only the Server and Player groups are registered with PlaceholderAPI. The Boost and Boost Area groups only exist in the internal form, because they need a specific boost or area to read from.

Arguments

Some placeholders take an argument, written after the ID and separated by a space:

%player_bucket_chance rare%
%moresparkles:player_bucket_chance rare%

Number Formats

Kind	Example	Notes
Multiplier	2.0	Add x yourself in your message, e.g. %boost_multiplier%x.
Percentage	12.50	Two decimal places, without the % sign.
Shiny rate	4096.0	The "N" in "1 in N".
Time	59:07, 1:05:00, 2d 03:00:00	m:ss, h:mm:ss, or Nd hh:mm:ss depending on length.

General

Placeholder	Description
%prefix%	The prefix value from Messages.json.

Server

These don't depend on a player.

Placeholder	Description
%base_shiny_rate%	Cobblemon's configured shiny rate, before any boosts.
%base_bucket_chance <bucket>%	The chance of a spawn using the given bucket, before any boosts. <bucket> is a bucket name from Cobblemon's spawning config, such as common, uncommon, rare or ultra-rare.
%base_alpha_bucket_chance%	The chance of a spawn using a bucket that contains Alphas, before any boosts.

Player

These read from a specific player: the player the message is about, or the player viewing it when used through PlaceholderAPI. Every value includes all boost sources combined (player boosts, global boosts, boost areas and charms).

Placeholder	Description
%player_name%	The player's name.
%player_uuid%	The player's UUID.
%player_shiny_rate%	The player's shiny rate after all boosts.
%player_hidden_ability_chance%	The chance that a Pokémon spawning near the player has its Hidden Ability. 0.00 with no boost. See Boost-Types.
%player_iv_strength%	How far the IV boost moves each IV toward 31. See Boost-Types.
%player_bucket_chance <bucket>%	The chance of a spawn near the player using the given bucket, after Alpha and Spawn Bucket boosts.
%player_alpha_bucket_chance%	The chance of a spawn near the player using a bucket that contains Alphas.
%player_<type>_multiplier%	The player's total multiplier for a boost type. 1.0 with no boost. See the list below.

Multiplier placeholders, one per boost type:

• %player_shiny_multiplier%
• %player_experience_multiplier%
• %player_hidden_ability_multiplier%
• %player_ev_multiplier%
• %player_iv_multiplier%
• %player_berry_multiplier%
• %player_catch_rate_multiplier%
• %player_mark_multiplier%
• %player_alpha_multiplier%
• %player_spawn_bucket_multiplier%

Boost

Internal form only. Available in messages about a specific boost: the boost messages in Messages.json, boss bars and Discord embeds.

Placeholder	Description
%boost_type%	The boost's type display name, e.g. Hidden Ability.
%boost_multiplier%	The boost's multiplier.
%boost_duration%	The boost's full duration.
%boost_time_remaining%	Time left on the boost. Stays frozen while the boost is paused.

Boost Area

Internal form only. Available in the area_info message in Messages.json.

Placeholder	Description
%boost_area_name%	The area's display_name.
%boost_area_type%	The area's boost type ID, e.g. SHINY.
%boost_area_multiplier%	The area's multiplier.

Where Each Group Works

Location	Server	Player	Boost	Boost Area
Boost command messages (*_boost_started, *_boost_information, etc.)	✅	✅ (player boosts only)	✅	❌
*_queue_cleared	✅	✅ (player queues only)	%boost_type% only	❌
area_info	✅	✅	❌	✅
check_rate_messages	✅	✅	❌	❌
Boss bars	✅	❌	✅	❌
Discord webhooks	✅	❌	✅	❌
Other mods (PlaceholderAPI)	✅	✅	❌	❌

See Also

• Messages.json: where the internal placeholders are used.
• Boost-Types: what each rate and multiplier means.