Skip to main content

StarEnchants

StarEnchants adds custom enchantments, armor sets, socketable crystals, and an item economy to your server. Enchants, set bonuses, and crystals are configured in plain YAML and run through one effect engine. It runs on Paper 1.8, 1.17.1-26.1.2 and Folia.

If you have run a Cosmic Enchants–style enchantment plugin before, everything here will feel familiar — books, scrolls, dust, soul gems, slot orbs — but it is all configured the same way, in plain YAML, and reloaded live with one command.

What ships in the box:

  • An effect engine — 88 effects, 25 triggers, 18 selectors, and a conditions DSL over 49 live variables. Enchants, armor-set bonuses, crystals, masks, pets, and weapon reforges all feed the same engine.
  • Armor sets with a completion bonus, an optional matched weapon, and Heroic upgrades.
  • Masks, pets, and weapon reforges — textured-head masks that re-skin your helmet and grant passive abilities, leveling pet companions carried in the hotbar, and one socketable signature ability per weapon, fired with shift + right-click.
  • An item & souls economy — enchant books, scrolls (white, holy-white, black, transmog, godly transmog, randomizer), success dust, soul gems, slot-expander orbs, nametags, and right-click use-items.
  • A built-in migrator to bring existing EliteEnchantments, EliteArmor, and AdvancedEnchantments configs into the unified schema.
  • Optional integrations — WorldGuard, Towny, Lands, SuperiorSkyblock, Factions, Vault, PlaceholderAPI, GrimAC, mcMMO, MythicMobs, ItemsAdder, Oraxen, and more. All bundled, all optional, none required.

Requirements​

NeedDetail
Java17 or newer on Paper/Folia; Java 8 on Minecraft 1.8.x
ServerPaper 1.17.1-26.1.2 or Folia, or Minecraft 1.8.x (Spigot/CraftBukkit/Paper)
Everything elseoptional

The download is one jar that works across this whole range. For what differs on 1.8.x, see Running on Minecraft 1.8.x below.

Install​

  1. Download the latest StarEnchants.jar from the Releases page.
  2. Drop it into your server's plugins/ folder.
  3. (Optional) Drop in any supported plugin — Vault, PlaceholderAPI, WorldGuard, GrimAC, MythicMobs, ItemsAdder, … — and StarEnchants wires up to it automatically. None is required.
  4. Restart the server. StarEnchants writes its default config into plugins/StarEnchants/.
  5. Edit the configs, then run /se reload — no restart needed.

:::tip First boot StarEnchants ships a complete, playable default content library (113 enchants, 15 armor sets, 10 crystals, 14 masks, 21 pets, 10 weapon reforges, every item type). You can start handing items out immediately and customize later. :::

Your first enchant in 60 seconds​

Every enchant is one file under content/enchants/. The file's path is the enchant's key — a file at content/enchants/lifesteal.yml has the key lifesteal. Create plugins/StarEnchants/content/enchants/zephyr.yml:

# content/enchants/zephyr.yml — heal a little every time you land a hit
tier: uncommon
display: "&bZephyr"
description: "Catch a second wind when you strike."
trigger: ATTACK
applies-to: [SWORD, AXE]
group: combat
levels:
  1: { chance: 30, effects: [ { MODIFY_HEALTH: { amount: 2 } } ] }
  2: { chance: 40, effects: [ { MODIFY_HEALTH: { amount: 3 } } ] }
  3: { chance: 50, effects: [ { MODIFY_HEALTH: { amount: 4 } } ] }

Then, in-game:

/se reload
/se book zephyr 3      # mint a level-III Zephyr book to yourself

Drag the book onto a sword, hit something, and watch yourself heal. That is the whole loop: edit a file → /se reload → mint and test.

:::note /se reload never takes the server down A reload rebuilds the entire content library off-thread and only swaps it in if it compiles clean. A broken edit keeps your running config live and prints diagnostics instead. Use /se reload --dry-run to validate without swapping. :::

Running on Minecraft 1.8.x​

The same jar runs on Minecraft 1.8.x (Spigot/CraftBukkit/Paper) under Java 8 — drop it in plugins/ exactly as above. Your content/ configs, commands, items, and economy are identical to the modern range. A few things differ on 1.8, automatically, with no config change:

  • Newer materials fall back to their closest 1.8 equivalent — a piece minted as NETHERITE_HELMET becomes DIAMOND_HELMET; a handful of renamed sounds and particles map to their 1.8 names.
  • Off-hand-only effects do nothing — 1.8 has no off-hand slot. Main-hand and armor work normally.
  • A few event-driven features run on a per-tick poll instead, since 1.8 lacks the events for them: the ITEM_DAMAGE trigger, Heroic durability saves, and instant armour-swap detection.
  • Knockback control applies at the server's knockback-resistance level — cancelling and reducing are exact; amplifying above 1× is best-effort.

Everything else — books, scrolls, dust, rendered lore, the combat engine, armor sets, crystals, souls, slots, and the GUIs — behaves the same as on Paper.

Where to go next​

  • Concepts — what enchants, sets, crystals, heroic, souls, slots, tiers, and groups actually are, in plain language.
  • Configuring content — the data-folder layout and a fully annotated walk-through of every field.
  • Items & economy — books, scrolls, dust, soul gems, orbs, nametags, and how to mint or give each.
  • Masks, pets & reforges — masks, pets, weapon reforges, and right-click use-items.
  • Commands — the full /se surface and permissions.
  • Cookbook — complete, copy-paste enchant recipes.
  • Enchant Creator — build and edit enchants visually, then export the YAML or an import code: open the Enchant Creator.

For the exact catalog of effects, triggers, selectors, and conditions, see the DSL reference.