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 |