Sapphics Enchantments

Sapphic’s Enchantments

A content mod for Minecraft 1.21.1 (Fabric & NeoForge) that adds 35 new enchantments spanning combat, utility, movement, and defense — all fully data-driven and tweakable through server-side config files.

⚔️ Weapon Enchantments

| Enchantment | Max Level | Effect |
|—|—|—|
| Berserker | V | Deals bonus melee damage scaling with your missing health. Each missing heart adds level × 4% extra damage. No bonus at full health. |
| Behead | I | Guarantees a head drop when killing players or supported mobs. Player heads include the victim’s skin. |
| Blight | III | Melee hits apply Wither I to the target for level × 3 seconds. Wither damage bypasses armor. |
| Earthshatter | III | On melee hit, nearby mobs within 2 + level blocks receive 30% of the final damage as splash. Re-entrancy guard prevents cascade chains. |
| Executioner | III | When the target is at or below 25% max health, applies a large damage multiplier of 1 + level × 0.5. |
| Fatal Blow | III | Each level adds a flat 20% chance to score a critical hit independent of vanilla crit conditions (level 1 = 20%, level 3 = 60%). |
| Frostbite | III | Melee hits apply Slowness I and Mining Fatigue I to the target for level × 3 seconds. |
| Heavy Weapon | I | While held, grants the player Strength V and Slowness I. Effects expire ~1 second after swapping away. |
| Lifesteal | V | Each successful melee hit heals you for level × 0.5 hearts (max 2.5 hearts/hit at level V). |
| Plague | III | Hits apply Poison (duration and strength scale with level). When a Poisoned mob dies, the infection spreads to all living mobs within 5 blocks. |
| Thunderstrike | III | Killing a mob summons a lightning bolt at the kill site. Level 2 chains to the nearest mob within 6 blocks; level 3 chains to the two nearest within 8 blocks. |
| Vengeance | III | Stores damage received and converts it to bonus melee damage on your next counter-attack within 5 seconds. |
| Void Strike | III | Deals bonus damage equal to level × 3% of the target’s maximum health. Naturally scales against high-health bosses. |
| Volatile | III | Grants a chance on hit to deal AoE burst damage to nearby enemies. |

🏹 Ranged Enchantments

| Enchantment | Max Level | Effect |
|—|—|—|
| Poison Tip | III | Arrows inflict Wither I on the struck entity for level × 3 seconds. Wither bypasses armor. |
| Ricochet | III | When an arrow hits a mob it chains to the nearest level other mobs within 8 blocks. |

🛡️ Armor Enchantments

| Enchantment | Max Level | Effect |
|—|—|—|
| Battle Hardened | III | Reduces incoming knockback strength by level × 25%. |
| Deflection | III | Grants a per-level chance (10% × level) to completely negate an incoming hit. Only the highest worn level counts. |
| Iron Will | IV | Reduces final damage taken by a flat level × 0.5 per hit. |
| Magic Protection | V | Reduces magic-type damage (magic, wither, dragon breath, etc.) by 10% per level (max 50% at level V). Goes on any armor piece. |
| Second Wind | III | Once per life, a killing blow is negated and you survive on level × 2 HP with Regeneration II and Absorption I. Resets on respawn. |
| Soulbound | I | Prevents the enchanted item from being dropped on death. Incompatible with Curse of Binding. |
| Tempered | III | Reduces armor-bypassing damage (magic, wither, fire, fall, void, etc.) by level × 10%. |
| Warding | III | Passively grants Resistance while worn. Amplifier scales with enchantment level. |

👟 Boot Enchantments

| Enchantment | Max Level | Effect |
|—|—|—|
| Gale Force | III | Sprint-jumping launches a forward dash. Landing after a dash grants Speed (duration and level scale with enchantment level). 2 second cooldown. |
| Phantom Step | III | After sprinting for 3 continuous seconds, you turn invisible for a level-scaled duration (3 / 6 / 10 s). Cooldown equals the invisibility duration. |
| Swiftness | III | Passively applies Speed (amplifier = level − 1) while worn. Expires ~1 second after removal. |

⛏️ Tool Enchantments

| Enchantment | Max Level | Effect |
|—|—|—|
| Haste | III | Passively applies Haste (amplifier = level − 1) while the tool is held. Expires ~1 second after swapping away. |
| Magnetic | I | Item drops from broken blocks are instantly pulled into your inventory. Excess items remain as entities if your inventory is full. |
| Midas Touch | VII | When mining an ore block there is a level × 10% chance to also drop a bonus gold ingot (level 1 = 10%, level 7 = 70%). |
| Smelting | I | Auto-smelts block drops when mining with a pickaxe. Compatible with Fortune (Fortune multiplies first, then Smelting converts). Also works with VeinMiner. |
| VeinMiner | I | Mines all connected ore blocks of the same type in one swing. The block list is auto-populated from the registry and is fully configurable. |
| Wisdom | V | Multiplies all incoming XP by 1 + level × 0.3 (level I = ×1.30, level V = ×2.50). Applies to ore XP and mob kill XP alike. |

🐺 Wolf Armor Enchantments

| Enchantment | Max Level | Effect |
|—|—|—|
| Sentry | I | While worn by a wolf, grants the wolf Strength II and Health Boost V. Effects are refreshed every second. |

💀 Curses

| Enchantment | Max Level | Effect |
|—|—|—|
| Brittle | III | Each level adds +1 extra durability damage per use, accelerating item wear (level I = 2× wear, level III = 4× wear). Goes on any durable item. |
| Curse of Dullness | V | Reduces melee damage by 1.0 + 0.5 × (level − 1) per level (level I = −1.0 dmg, level V = −3.0 dmg). Incompatible with Sharpness, Smite, Bane of Arthropods, and Impaling. |

🔧 Utility Enchantments

| Enchantment | Max Level | Effect |
|—|—|—|
| Runes of Repair | I | Repairs the held item using XP gain — identical mechanic to Mending. See the note below. |

Why does Runes of Repair exist?

Some mods break vanilla Mending — either through patches, overrides, or incompatible event hooks. Runes of Repair is our standalone reimplementation of the same repair mechanic, giving you a reliable fallback that works regardless of what other mods do to Mending. If Mending works fine in your pack, the two are interchangeable.

⚙️ Configuration

Sapphic’s Enchantments ships two JSON config files placed in your platform’s config folder on first launch. Both are auto-generated with sensible defaults and updated automatically if new entries are added in a future version.

se_enchantment_levels.json

Controls the maximum level of every SE enchantment. Server operators can raise or lower any cap freely.

{
  "max_levels": {
    "se:berserker":        5,
    "se:brittle":          3,
    "se:fatal_blow":       3,
    "se:curse_of_dullness": 5,
    "se:earthshatter":     3,
    "se:frostbite":        3,
    "se:gale_force":       3,
    "se:lifesteal":        5,
    "se:magic_protection": 5,
    "se:midas_touch":      7,
    "se:phantom_step":     3,
    "se:plague":           3,
    "se:rebound":          3,
    "se:ricochet":         3,
    "se:second_wind":      3,
    "se:thunderstrike":    3,
    "se:wisdom":           5,
    "se:blight":           3,
    "se:deflection":       3,
    "se:executioner":      3,
    "se:haste":            3,
    "se:swiftness":        3,
    "se:void_strike":      3,
    "se:poison_tip":       3,
    "se:iron_will":        4,
    "se:battle_hardened":  3,
    "se:warding":          3,
    "se:vengeance":        3,
    "se:volatile":         3,
    "se:tempered":         3,
    "se:behead":           1
  }
}

• Raise a value to allow higher enchantment levels via the enchanting table, anvil, or /enchant.
• Lower a value to restrict players below the default.
• Set a value to 0 or remove the entry to fall back to the built-in default.
• Changes are synced to clients on join so the creative tab reflects the server’s settings.

se_veinminer.json

Controls the behaviour of the VeinMiner enchantment.

| Key | Default | Description |
|—|—|—|
| enabled | true | Globally enables or disables VeinMiner. |
| max_blocks | 64 | Maximum number of blocks mined in a single trigger. |
| cancel_on_sneak | false | If true, VeinMiner does nothing while the player is sneaking. |
| ores | (auto-populated) | List of block IDs eligible for vein mining. On first launch (and whenever auto_add_new_ores is enabled), every block whose registry path contains _ore is added automatically — including blocks from other mods. |

📦 Requirements

• Minecraft 1.21.1
• Fabric Loader 0.19.2+ or NeoForge 21.1.215+
• Architectury API 13.0.8+
• Fabric API (Fabric only)