Prestige System

What Is Enchant Prestiging?

When an enchant reaches its maximum level, a player can Prestige it. Prestiging resets the enchant level back to starting-level (defined in progression) and increments a separate Prestige counter stored.

Each prestige tier makes the enchant stronger (higher proc chance and amount multiplier) and more expensive (higher upgrade cost), letting you scale enchants beyond their raw level cap.

---

The configuration needed

Add a prestige section to any enchant file:

prestige:
  enabled: true # This is automatically FALSE, as you need to manually enable it.
  max-prestige: 10
  cost-multiplier: 0.5
  chance-multiplier: 0.06

If the prestige section is missing entirely, prestige is treated as disabled with maxPrestige = 0.

---

How the Multipliers Work

Upgrade Cost

finalCost = baseCost * (1.0 + (prestige × cost-multiplier))

Prestige	cost-multiplier: 0.5	Effective multiplier
0	1.0 + (0 × 0.5)	1.0× (no change)
1	1.0 + (1 × 0.5)	1.5×
2	1.0 + (2 × 0.5)	2.0×
5	1.0 + (5 × 0.5)	3.5×
10	1.0 + (10 × 0.5)	6.0×

The base cost itself comes from the upgrade section and its cost-scaling type (LINEAR / EXPONENTIAL). Prestige is applied on top of whatever that scaling produces.

Proc Chance

baseChance = base-chance + (chance-per-level × level)
finalChance = baseChance * (1.0 + (prestige × chance-multiplier))

Prestige	chance-multiplier: 0.2	Effect on a 10% base
0	1.0 + (0 × 0.2)	10.0%
1	1.0 + (1 × 0.2)	12.0%
5	1.0 + (5 × 0.2)	20.0%
10	1.0 + (10 × 0.2)	30.0%

---

---

Execution Context Variables

If an enchant's base prestige is higher than 0, it will add a new context type called {prestige}. This will let you make enchants with multiplied outputs or whatever your mind likes.

Scaling Damage With Prestige

actions:
  1:
    type: "set-variable"
    variable-name: "scaled_damage"
    value: "{damage} * 2 * (1 + {prestige})"   # Doubles, then adds 100% per prestige

  2:
    type: "damage-area"
    position: "{target_pos}"
    radius: 1.0
    damage: "{scaled_damage}"

At prestige 0 this deals damage × 2. At prestige 3 it deals damage × 2 × 4 = damage × 8.

---

Placeholder-API Placeholders

These placeholders resolve on the player's currently equipped sword:

Placeholder	Description
%phantomdungeons_enchant_{id}_prestige%	Player's current prestige tier for this enchant.
%phantomdungeons_enchant_{id}_maxprestige%	Configured max prestige from the enchant file.

---

Admin Commands

Command	Description
/dungeonsadmin enchants set-prestige <enchant> <player> [prestige]	Force-set a player's prestige tier (bypasses all checks). Defaults to 1.
/dungeonsadmin enchants info <player>	Lists all enchants on the player's sword including their current prestige.

Permission node for set-prestige: phantom.admin.enchants.set-prestige

---

Complete Example — Critical Enchant with Prestige

enchant-id: "critical"
display-name: "&c&lCritical"
menu-material: NETHER_STAR

progression:
  starting-level: 0
  max-level: 1000

activation:
  trigger: "HIT_MOB"
  base-chance: 10.0
  chance-per-level: 0.0
  cooldown-seconds: 0

upgrade:
  currency: "souls"
  base-cost: 100
  cost-scaling:
    type: "linear"
    increase-per-level: 500

prestige:
  enabled: true
  max-prestige: 10
  cost-multiplier: 0.5    # Each prestige adds 50% to upgrade costs
  chance-multiplier: 0.2  # Each prestige adds 20% to proc chance

actions:
  # Scale damage by prestige: base × 2, then +50% per prestige tier
  1:
    type: "set-variable"
    variable-name: "crit_damage"
    value: "{damage} * (2 + ({prestige} * 0.5))"

  2:
    type: "damage-area"
    position: "{target_pos}"
    radius: 1.0
    damage: "{crit_damage}"

  3:
    type: "hologram"
    position: "{target_pos}"
    text: "&bCritical! &c-{crit_damage} &8[P{prestige}]"
    style: "damage"
    duration: 30

Proc chance at level 1000:

Prestige	Chance
0	10.0%
5	20.0%
10	30.0%

Upgrade cost at level 500, prestige 5:

baseCost = 100 + (500 × 500) = 250,100
finalCost = 250,100 × (1 + 5 × 0.5) = 250,100 × 3.5 = 875,350 souls