Commands & permissions

Operator work lives under one root command — /se (alias /star). Tab-completion guides every argument, so you can explore the surface in-game by pressing Tab after /se, or run /se help for the same list in chat. Players never touch /se: they get their own short commands, one per bench or browser — see Player commands.

Every command

Every /se command requires the starenchants.admin permission (default: op) — see Permissions below. The table is generated from the plugin surface (SeCommand.COMMANDS), so it is always complete and never drifts from the in-game /se help:

Command	What it does
/se reload [--dry-run]	Rebuild the content library off-thread and hot-swap it in (or just validate).
/se problems	Show the errors and warnings from the last content load.
/se why <player> [key]	Explain a player's recent activation attempts — which gate stopped each one and why.
/se damagedebug	Toggle a per-hit damage-fold readout (base, percents, flats, scale, result) for yourself.
/se bless [player]	Lift the first matching debuff from yourself or another player (admin; no cooldown or cost).
/se modules	Show every feature module — toggle state and depth, wired listeners, commands, mint types, stores.
/se give <type> <player> [args]	Give any mintable item (book, scroll, dust, gem, orb, crystal, set piece, heroic…) to a player.
/se item dump	Print the decoded StarEnchants state of the held item.
/se enchant <key> [level]	Apply an enchant to the held item (admin; bypasses apply rules).
/se removeenchant <key>	Strip an enchant from the held item.
/se unenchant	alias of /se removeenchant
/se crystal <key>	Mint a socketable crystal to yourself.
/se reforge <key>	Mint a weapon reforge to yourself.
/se heroic	Mint a Heroic upgrade item to yourself.
/se orb	Mint a slot-expander orb to yourself.
/se gem [amount]	Mint a soul gem to yourself (optionally pre-loaded with that many souls).
/se book <key> [level]	Mint an enchant book to yourself.
/se blackscroll	Mint a black scroll (extracts a random enchant from gear to a book).
/se randomizer	Mint a randomizer scroll (rerolls a book's success chance).
/se transmog	Mint a transmog scroll (re-skins an item's appearance).
/se godlytransmog	Mint a godly transmog tool (reorder an item's enchant lore).
/se holy	Mint a holy scroll (keeps items + levels on death).
/se nametag	Mint an item nametag.
/se dust [percent]	Mint success dust (a fixed percent, or a random roll).
/se whitescroll	Mint a white scroll (protects an item from a black scroll).
/se unopened <tier>	Mint an unopened book of a rarity tier.
/se soulmode	Toggle your active soul gem's soul mode.
/se split <amount>	Split souls off your active gem into a new gem.
/se migrate <ee|ea|ae> <path>	Import EliteEnchantments / EliteArmor / AdvancedEnchantments configs into the unified schema.
/se import <code>	Import an enchant from an SE1 code (e.g. from the web Enchant Creator) and reload.
/se pack <list|info|apply|export> [name] [--force]	Manage config-pack ZIP snapshots of your whole setup.
/se menu [name]	Open an operator GUI (no name = the console; or mint, admin, sets, crystals, apply, browsers).
/se effects	Browse the effect reference in chat.
/se selectors	Browse the selector reference in chat.
/se triggers	Browse the trigger reference in chat.
/se conditions	Browse the conditions reference in chat.
/se variables	Browse the condition variables in chat.
/se list	List every enchant, set, and crystal.
/se docs [vocabulary]	Umbrella for the DSL reference: no arg lists the vocabularies; an arg opens one.

Player commands

Nine short commands open one bench or browser directly, so a player never needs the admin surface. Each is gated by starenchants.use (default: true):

Command	Opens
/enchants, /enchanter	the Enchanter bench — buy a mystery book of a tier for XP levels; the white and black scroll tiles live here too
/alchemist	combine two identical books into one of the next level
/tinkerer	trade books back for XP
/sets	the armour-set browser
/crystals	the crystal browser
/catalogue	the Enchant Codex — the read-only enchant catalogue
/pets	the pet browser
/masks	the mask browser

The browsers are read-only for players; an operator opening the same browser can mint from it.

Three more commands are player-facing:

• /cast — the COMMAND trigger command (name set by command-trigger.name in config.yml), registered at boot so every player can invoke their own COMMAND-trigger enchants.
• /splitsouls <amount> — splits souls off your active soul gem into a new gem. Player-only, and it requires no permission.
• /bless — strips every debuff an opponent has landed on you. See below.

A weapon reforge needs no command at all: hold the reforged weapon and shift + right-click to fire its signature ability.

Permissions

:::warning Two nodes, two surfaces /se is gated by starenchants.admin (default: op) — the whole admin surface, nothing else. The player menu commands above are not under /se; they carry starenchants.use (default: true). Individual in-game GUIs can declare their own permission node on top. :::

/cast and /splitsouls are gated by neither node — they are meant for every player. /bless carries its own starenchants.bless (default: true), with starenchants.bless.bypass (default: op) to skip its cooldown and cost.

Cleansing debuffs with /bless

/bless is one application of the Clarity set's Bless — the exact same cleanse, on demand, for any player. It is not a separate mechanic with its own rules; whatever a cleanse does in this plugin, /bless does once.

A cleanse:

• removes harmful potion effects
• puts out fire
• leaves buffs and neutral effects completely alone

What it will not touch is a permanent debuff you are carrying by choice — a helmet that grants permanent mining fatigue stays exactly where it is. Nor does it break a freeze: a freeze is confinement, not a debuff, and only Turnkey's TRAP_BREAK thaws one.

Tune it in config.yml:

bless:
  cooldown-seconds: 60  # seconds between one player's blesses (0 = no cooldown); survives a relog
  cost: 0.0             # charged per bless via the economy bridge (0 = free)

Both knobs are read live on /se reload. If you set a cost but have no economy plugin installed the command refuses rather than running free — a missing Vault is a misconfiguration, not a discount. A refused bless never charges you and never burns your cooldown.

Admins can run the same cleanse with no cooldown and no cost via /se bless [player], on themselves or on someone else.

:::note One cleanse, three ways to reach it The Clarity set's Bless Passive Ability, the Cow Pet's right-click, and /bless all run the identical sweep — they differ only in what triggers it. Clarity re-runs it several times a second while you wear the full set (so you effectively cannot hold a debuff, or burn); the Cow Pet fires it on a cooldown; /bless fires it once on command. Change the cleanse and all three change together. :::

Reloading

/se reload rebuilds config.yml, lang.yml, content/, items/, and menus/ together in one transaction, off-thread, and only swaps if it compiles clean; --dry-run validates and reports without swapping. Warnings never block the swap, so a reload that loaded but degraded still surfaces them — and /se problems re-prints the errors and warnings from the last load at any time. See reloading.

Inspecting a held item

/se item dump prints the decoded StarEnchants state of the item in your main hand — its enchants and levels, slot accounting, applied crystals, set membership, heroic stats, and which versioned se:* PDC keys it carries. Useful when an item misbehaves and you want to see exactly what it stores.

When something does not fire

/se why <player> [key] replays that player's recent activation attempts and names the gate that stopped each one, so "my enchant does nothing" becomes a specific answer — wrong trigger, cooldown, suppression, missing slot. /se damagedebug toggles a per-hit readout of how a hit's damage was folded together, which is the honest way to calibrate numbers against real combat. /se modules prints the module fold — which feature modules loaded and what each one registered.

Menus

/se menu [name] opens an in-game GUI — with no name it opens the operator console. Available menus include enchanter, alchemist, tinkerer, transmog, apply, and the browsers enchants, sets, crystals, masks, pets, reforges, and reference (the live DSL reference). The player hub survives at /se menu hub, with tiles for the Pets, Masks, and Weapon Reforges browsers among the rest. Layouts are operator-tweakable under menus/ — now including masks.yml, pets.yml, and reforges.yml (see configuring). Operators can mint straight from a browser, or skip the GUI entirely: /se reforge <key> mints a weapon reforge to yourself.

Config packs

/se pack <list|info|apply|export> manages config packs — a pack snapshots config.yml, lang.yml, content/, items/, and menus/ into a portable ZIP, making a setup easy to share, version, or roll back. apply backs up the current config before swapping the pack in and reloading transactionally.

Two packs ship in the jar and land in packs/ on first boot, so /se pack list is never empty:

Pack	What it is
signature-pack	the default — StarEnchants' own flagship library, already live when you first start the server. Modern-only: it declares min-server: "1.17.1" and is refused on the 1.8.9 build
cosmic-pack	the classic Cosmic experience, ported number-exact: its enchant library, armour sets, socketable crystals, masks, pets, and the Heroic gear tier. Runs on the whole supported range, 1.8.9 included

cosmic-pack is a preset you opt into, not the default. Apply it with:

/se pack apply cosmic-pack

Applying swaps the whole config surface — config.yml, lang.yml, content/, items/, and menus/ are all replaced by the pack's, not merged with yours. Your current surface is snapshotted into a timestamped backup pack first, so /se pack apply backup-<stamp> puts everything back.

cosmic-pack does not carry every item: it ships content/ in full plus thirteen item likenesses, so nine item likenesses and all menus stay at the engine defaults after you apply it. Those nine — the soul gem, the four trak gems, the item nametag, the holy white scroll, the godly transmog and weapon reforges — have no counterpart to port. Nothing breaks; they just look like stock StarEnchants. See Configuring for the full note.

Migrating

/se migrate <ee|ea|ae> <path> imports EliteEnchantments (ee), EliteArmor (ea), or AdvancedEnchantments (ae) configs into the unified schema. See the migrating section.

Browsing the DSL reference in chat

/se docs lists the five reference vocabularies; /se docs <name> (or the shorthands /se effects, /se triggers, /se selectors, /se conditions, /se variables, and /se list) prints the live, always-current vocabulary in chat. For the same content as a navigable web page, see the DSL reference.

The Enchant Creator and /se import

Build and edit enchants visually in the Enchant Creator, then either copy the YAML straight into content/enchants/ or export an import code and paste it with /se import <code> to drop the enchant into your live content.