Sapphics Enchantments

Sapphic's Enchantments

A content mod for 35 new enchantments (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 | |---|---|---| | Volatile | V | Deals bonus melee damage scaling with your missing health. Each missing heart adds `level × 4%` extra damage. No bonus at full health. | | Volatile | I | Guarantees a head drop when killing players or supported mobs. Player heads include the victim's skin. | | Volatile | III | Melee hits apply Wither I to the target for `level × 3` seconds. Wither damage bypasses armor. | | Volatile | III | On melee hit, nearby mobs within `2 + level` blocks receive 30% of the final damage as splash. Re-entrancy guard prevents cascade chains. | | Volatile | III | When the target is at or below 25% max health, applies a large damage multiplier of `1 + level × 0.5`. | | Volatile | III | Each level adds a flat 20% chance to score a critical hit independent of vanilla crit conditions (level 1 = 20%, level 3 = 60%). | | Volatile | III | Melee hits apply Slowness I and Mining Fatigue I to the target for `level × 3` seconds. | | Volatile | I | While held, grants the player Strength V and Slowness I. Effects expire ~1 second after swapping away. | | Volatile | V | Each successful melee hit heals you for `level × 0.5` hearts (max 2.5 hearts/hit at level V). | | Volatile | 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. | | Volatile | 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. | | Volatile | III | Stores damage received and converts it to bonus melee damage on your next counter-attack within 5 seconds. | | Volatile | 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 | |---|---|---| | Ricochet | 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 | |---|---|---| | Warding | III | Reduces incoming knockback strength by `level × 25%`. | | Warding | III | Grants a per-level chance (`10% × level`) to completely negate an incoming hit. Only the highest worn level counts. | | Warding | IV | Reduces final damage taken by a flat `level × 0.5` per hit. | | Warding | V | Reduces magic-type damage (magic, wither, dragon breath, etc.) by 10% per level (max 50% at level V). Goes on any armor piece. | | Warding | 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. | | Warding | I | Prevents the enchanted item from being dropped on death. Incompatible with Curse of Binding. | | Warding | 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 | |---|---|---| | Swiftness | III | Sprint-jumping launches a forward dash. Landing after a dash grants Speed (duration and level scale with enchantment level). 2 second cooldown. | | Swiftness | 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 | |---|---|---| | Wisdom | III | Passively applies Haste (amplifier = level − 1) while the tool is held. Expires ~1 second after swapping away. | | Wisdom | I | Item drops from broken blocks are instantly pulled into your inventory. Excess items remain as entities if your inventory is full. | | Wisdom | 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%). | | Wisdom | I | Auto-smelts block drops when mining with a pickaxe. Compatible with Fortune (Fortune multiplies first, then Smelting converts). Also works with VeinMiner. | | Wisdom | 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 | |---|---|---| | Curse of Dullness | 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.

```jsonc { "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

- Fabric API 1.21.1 - Fabric API 0.19.2+ Fabric API Fabric API 21.1.215+ - Fabric API 13.0.8+ - Fabric API (Fabric only)