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)