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