Placeholders
All available placeholders for the EdDungeons plugin. These can be used in messages, GUIs, and other plugin integrations.
Currency Placeholders
%eddungeons_currency_balance_{currency}%
Returns the player's balance for the specified currency
%eddungeons_currency_name_{currency}%
Returns the display name of the specified currency
Leveling Placeholders
%eddungeons_leveling_level_{levelid}%
Returns the player's current level in the specified leveling track
%eddungeons_leveling_bar_{levelid}%
Returns the progress bar for the specified leveling track
%eddungeons_leveling_progress_{levelid}%
Returns the progress percentage (0-100) for the next level
%eddungeons_leveling_currencyrequired_{levelid}%
Returns the currency amount needed to level up once
Enchant Placeholders
%eddungeons_enchant_level_{enchant}%
Returns the player's current level in the specified enchant
%eddungeons_enchant_name_{enchant}%
Returns the display name of the specified enchant
%eddungeons_enchant_material_{enchant}%
Returns the material/item type of the specified enchant
%eddungeons_enchant_chance_{enchant}%
Returns the current chance/probability for the enchant to trigger
%eddungeons_enchant_maxlevel_{enchant}%
Returns the maximum level available for the specified enchant
%eddungeons_enchant_cost_{enchant}_{levels}%
Returns the cost to upgrade the enchant by the specified number of levels
%eddungeons_enchant_maxlevels_{enchant}%
Returns the maximum number of levels the player can afford to buy
%eddungeons_enchant_maxcost_{enchant}%
Returns the cost to buy all affordable levels for the enchant
%eddungeons_enchant_status_{enchant}%
Returns the status/state of the enchant (unlocked, locked, etc.)
%eddungeons_enchant_currencyname_{enchant}%
Returns the display name of the currency used for this enchant
Sword System Placeholders
%eddungeons_damage%
Returns the player's current sword damage
%eddungeons_sword_skin%
Returns the player's currently selected sword skin ID
%eddungeons_sword_skintolevel%
Returns the player's currently selected sword skin as an integer level. wooden-sword -> 1, stone-sword-> 2 etc...
%eddungeons_sword_skin_selected_{skinid}%
Returns true/false if the specified skin is currently selected
%eddungeons_sword_ishigher_{skinid}%
Returns true/false if player's current sword is higher tier than specified skin
%eddungeons_sword_islower_{skinid}%
Returns true/false if player's current sword is lower tier than specified skin
%eddungeons_sword_canupgrade_{skinid}%
Returns true/false if the player can upgrade to the specified sword skin
%eddungeons_sword_tier_selected_{tier}%
Returns true/false if the specified tier is currently selected
%eddungeons_sword_tier_isselected_{skinid}_{tier}%
Returns true/false if the specified skin and tier combination is selected
%eddungeons_sword_material_{skinid}%
Returns the material type of the specified sword skin
%eddungeons_sword_name_{skinid}%
Returns the display name of the specified sword skin
%eddungeons_sword_modeldata_{skinid}%
Returns the custom model data value for the specified sword skin
%eddungeons_sword_tier%
Returns the player's current sword tier
%eddungeons_sword_damage_{skinid}%
Returns the damage value for the specified sword skin
%eddungeons_sword_price_{skinid}%
Returns the price to purchase/upgrade the specified sword skin
%eddungeons_sword_nextprice_{skinid}%
Returns the price for the next upgrade of the specified sword skin
%eddungeons_sword_tier_damage_{skinid}_{tier}%
Returns the damage value for a specific sword skin and tier combination
%eddungeons_sword_tier_price_{skinid}_{tier}%
Returns the price for a specific sword skin and tier combination
%eddungeons_sword_tier_{skinid}%
Returns the current tier for the specified sword skin
%eddungeons_sword_maxtier_{skinid}%
Returns the maximum tier available for the specified sword skin
%eddungeons_sword_stars_{skinid}%
Returns the number of stars/upgrades for the specified sword skin
%eddungeons_sword_leftstars_{skinid}%
Returns the remaining stars/upgrades available for the specified sword skin
Number Formatting Placeholders
%eddungeons_notation_{value}%
Formats the number using the default notation system
%eddungeons_parse_{value}%
Parses and returns the numeric value as a BigDecimal
%eddungeons_singlenotation_{value}%
Formats the number using single number notation (commas)
%eddungeons_abbrevnotation_{value}%
Formats the number using abbreviated notation (k, M, B, etc.)
%eddungeons_calc_{expression}%
Calculates and returns the result of a mathematical expression
Random Generation Placeholders
%eddungeons_random_{min}|{max}%
Generates a random integer between min and max values
%eddungeons_randompos_{anchor}|{offset}%
Generates a random position vector based on anchor point and offset
%eddungeons_randomwithdecimals_{decimals}_{min}|{max}%
Generates a random number with specified decimal places between min and max
Zone System Placeholders
%eddungeons_zone_stage_{zoneid}%
Returns the player's current stage in the specified zone
%eddungeons_zone_in%
Returns the ID of the zone the player is currently in
%eddungeons_zone_in_name%
Returns the display name of the zone the player is currently in
%eddungeons_zone_unlocked%
Returns the ID of the zone the player has latest unlocked
%eddungeons_zone_unlocked_name%
Returns the display name of the zone the player has latest unlocked
%eddungeons_zone_unlocked_stage%
Returns the stage ID of the player latest unlocked zone
%eddungeons_zone_unlocked_{zoneid}_{stageid}%
Returns true/false if the specified zone stage is unlocked for the player
Booster System Placeholders
%eddungeons_boosters_global_enchants%
Returns the current global enchant boost multiplier
%eddungeons_boosters_global_{currency}%
Returns the current global boost multiplier for the specified currency
%eddungeons_boosters_names_enchants%
Returns the names of active global enchant boosters
%eddungeons_boosters_names_{currency}%
Returns the names of active boosters for the specified currency
%eddungeons_boosters_multiplier_{booster-id}%
Returns the specific multiplier of a booster ID. Returns "0" if the booster doesn't exist
%eddungeons_boosters_boost_{booster-id}%
Returns the id of the boosted currency from a booster ID. Returns "none" if the booster doesn't exist.
Summary System Placeholders
%eddungeons_summary_{currency}%
Returns the sell summary total for the specified currency
Utility Placeholders
%eddungeons_pluginenabled_{pluginname}%
Returns true/false if the specified plugin is enabled
%eddungeons_haspermission_{permission}%
Returns true/false if the player has the specified permission
Automatic Formatting
All numeric placeholders support automatic formatting by adding suffixes:
_{placeholder}_formatted
Applies default number formatting to the result
_{placeholder}_formatted_single
Applies single number formatting (commas) to the result
_{placeholder}_formatted_abbrev
Applies abbreviated formatting (k, M, B, etc.) to the result
Usage Examples
Currency with formatting:
%eddungeons_currency_balance_money_formatted%%eddungeons_currency_balance_gems_formatted_abbrev%
Random values in mob rewards:
%eddungeons_random_1|1000%- Random 1 to 1000%eddungeons_randomwithdecimals_2_0.5|5.0%- Random 0.50 to 5.00
Conditional rewards:
%eddungeons_random_0|100% < 50- 50% chance condition
Zone progression:
%eddungeons_zone_unlocked_barn-zone_5%- Check if stage 5 is unlocked
Last updated
Was this helpful?