NexusEnchantments

Overview

NexusEnchantments adds a complete custom enchantment layer on top of vanilla Minecraft. Every enchantment is registered internally, has a configurable maximum level, a trigger chance, an optional cooldown and (where relevant) a per-level power value — so you can rebalance the entire set from config.yml without touching code.

Players upgrade enchantments through an in-game GUI that spends vanilla XP levels using a configurable cost formula, and levels render as Roman numerals in item lore. It suits SMP, survival, skyblock and prison servers that want deeper gear progression, and it is designed to be balance-safe: chances and cooldowns keep the strong effects in check.

Features

• 25 custom enchantments across five groups — combat weapons, ranged combat, mining & tools, armor & passive defense, and universal.
• GUI leveling system — upgrade enchantments by spending vanilla XP levels; cost scales with currentLevel * level-cost-multiplier.
• Per-enchant cooldowns — millisecond cooldowns per effect, managed by a dedicated cooldown manager.
• Trigger chances — each proc-based enchantment rolls against a configurable chance value.
• Scaling power values — enchantments like Sharpness+, Execute and XP Boost use power-per-level for linear scaling.
• Roman-numeral level display in item lore.
• Target-aware enchanting — combat, mining and armor targets are handled separately so effects apply to the right gear.
• Particle feedback on ability procs.
• PlaceholderAPI support for showing enchant data on scoreboards / tab.
• Live reload — /enchant reload re-reads the configuration with no restart.

Included enchantments: Sharpness+, Life Steal, Venom, Frost, Lightning, Fire Aspect+, Execute, Deep Wounds, Explosive, Telekinesis, Auto Smelt, Vein Miner, Lumberjack, XP Boost, Harden, Molten, Haste, Speed, Jump Boost, Night Vision, Water Breathing, Oxygen, Regeneration, Magnet, Soulbound.

Commands

Permissions

Configuration

config.yml (excerpt):

settings:
  # Base XP level multiplier for GUI upgrades: currentLevel * level-cost-multiplier
  level-cost-multiplier: 5

enchantments:
  sharpness_plus:
    display-name: "<red><bold>Sharpness+</bold></red>"
    max-level: 10
    chance: 100.0
    cooldown: 0
    power-per-level: 0.07

  life_steal:
    display-name: "<light_purple><bold>Life Steal</bold></light_purple>"
    max-level: 5
    chance: 35.0
    cooldown: 2000
    power-per-level: 0.05

  vein_miner:
    display-name: "<dark_purple><bold>Vein Miner</bold></dark_purple>"
    max-level: 3
    chance: 100.0
    cooldown: 500

  soulbound:
    display-name: "<blue><bold>Soulbound</bold></blue>"
    max-level: 1
    chance: 100.0
    cooldown: 0

Every enchantment accepts display-name (MiniMessage), max-level, chance, cooldown (ms) and an optional power-per-level.

Compatibility

• Server software: Paper 1.21.11 (api-version 1.21)
• Java: 21
• Soft dependencies: PlaceholderAPI (optional — used only if installed)

Support

• GitHub: https://github.com/toprakeker/NexusEnchantments
• Discord: provided with your purchase for setup help and bug reports
• Issues and feature requests are handled through the GitHub issue tracker.