Admin Guide

Commands & API

All commands, permissions, PlaceholderAPI placeholders, and developer API.

Commands

Base command: /sle — all subcommands require slenchant.admin unless noted.

/sle reloadReload all configs & enchantsslenchant.admin
/sle give <player> <enchant> <level>Give enchant book to playerslenchant.admin
/sle giveitem <player> <item_id>Give custom item (dust, scroll, stone, etc.)slenchant.admin
/sle giverandom <player> <rarity>Give random enchant book of rarityslenchant.admin
/sle addenchant <enchant> <level>Force-add enchant to held item (bypass checks)slenchant.admin
/sle removeenchant <enchant>Remove specific enchant from held itemslenchant.admin
/sle extract [enchant]Extract enchant from held item into bookslenchant.extract
/sle shopOpen Tier Shop GUIslenchant.shop
/sle browserOpen Enchant Browser GUI (v3.0.0)slenchant.browser
/sle dustOpen Dust Crafting GUIslenchant.dust
/sle fusionOpen Fusion GUIslenchant.fusion
/sle info [enchant]View enchant details in chatslenchant.info
/sle listList all loaded enchantsslenchant.info
/sle debugToggle debug modeslenchant.admin
/sle versionShow plugin version and dependency infoslenchant.admin

Permissions

PermissionDescriptionDefault
slenchant.*All OmniEnchant permissionsOP
slenchant.adminAdmin commands (reload, give, add/remove)OP
slenchant.extractUse extractionALL
slenchant.shopAccess Tier ShopALL
slenchant.browserAccess Enchant BrowserALL
slenchant.dustAccess Dust CraftingALL
slenchant.fusionAccess Fusion GUIALL
slenchant.infoView enchant info & listALL
slenchant.enchantPermission to enchant via drag-dropALL
slenchant.bypass.conflictsBypass enchant conflictsOP
slenchant.bypass.maxenchantBypass max enchant limitOP

PlaceholderAPI Placeholders

Requires PlaceholderAPI (optional dependency). Prefix: %slenchant_.

PlaceholderOutput
%slenchant_total_enchants%Total custom enchants on held item
%slenchant_max_enchants%Max enchant slots on held item
%slenchant_extra_slots%Extra enchant slots from Slot Increaser
%slenchant_soul_pvp%PvP soul points on held item
%slenchant_soul_pve%PvE soul points on held item
%slenchant_soul%Total soul points

Developer API

OmniEnchant exposes an API for other plugins to interact with the enchant system.

EnchantManager

  • getAll() — List all loaded enchants
  • getById(id) — Get enchant by ID
  • getByRarity(rarity) — Filter by rarity
  • getRandom(rarity) — Random from rarity

EnchantDataUtil

  • getEnchants(ItemStack) — Get map of enchants on item
  • addEnchant(ItemStack, id, level) — Add enchant to item
  • removeEnchant(ItemStack, id) — Remove enchant from item
  • hasEnchant(ItemStack, id) — Check if item has enchant

LoreOrchestrator

  • render(lore, sections) — Non-destructive lore sync
  • LoreSectionParser.extract(lore) — Parse section boundaries

Events

  • EnchantApplyEvent — Before enchant applied
  • EnchantFailEvent — After failure roll
  • EnchantActivateEvent — When enchant activates
  • EnchantRemoveEvent — Before enchant removed

OmniEnchant v3.0.0 — by SalyVn