EnchantForge

EnchantForge is a native Paper plugin that intercepts combat events and applies configurable damage multipliers based on enchantments present on the attacker's weapon. Each enchantment can be independently buffed, nerfed, or banned entirely through a single YAML configuration file, with no external dependencies.

---

How it works

When a player attacks, EnchantForge reads every enchantment on the weapon in hand and computes a compound damage multiplier from the configured values. The multiplier scales linearly with the enchantment level. If any enchantment on the weapon is marked as banned, the attack is cancelled and the player is notified. No damage is applied.

---

Features

• Per-enchantment damage multiplier scaled by enchantment level
• Enchantment ban system with configurable player notification
• Hot reload via /ef reload, no server restart required
• Full coverage of all Java Edition enchantments including 1.21 additions
• Zero external dependencies, pure Paper API
• Configurable messages with legacy color code support

---

Configuration

Each enchantment entry in config.yml exposes three fields:

SHARPNESS:
  enabled: true
  damage_multiplier: 1.10
  banned: false

Field	Type	Description
enabled	boolean	Whether EnchantForge processes this enchantment at all
damage_multiplier	double	Damage multiplier applied per enchantment level
banned	boolean	Cancels the attack if this enchantment is on the weapon

How multipliers stack with levels: A damage_multiplier of 1.10 means +10% per level. Sharpness V with a multiplier of 1.10 results in a final multiplier of 1.50x on top of vanilla damage. A value below 1.0 reduces damage. A value of 1.0 is equivalent to vanilla behavior and is ignored by the engine.

Example setups:

# Buff Sharpness by 10% per level
SHARPNESS:
  enabled: true
  damage_multiplier: 1.10
  banned: false

# Nerf Fire Aspect damage by 3% per level
FIRE_ASPECT:
  enabled: true
  damage_multiplier: 0.97
  banned: false

# Completely ban Breach
BREACH:
  enabled: true
  damage_multiplier: 1.00
  banned: true

---

Commands

Command	Description	Permission
/ef reload	Reloads config.yml without restarting	enchantforge.admin
/ef info	Shows all active multipliers and bans	enchantforge.admin
/ef list	Lists every registered enchantment and its current status	enchantforge.admin

All commands are also accessible via the /enchantforge alias.

---

Permissions

Node	Default	Description
enchantforge.admin	op	Access to all EnchantForge commands