Items & economy

Beyond enchants, sets, and crystals, StarEnchants mints a family of physical items that drive the player economy — books to apply enchants, scrolls to protect or rework gear, dust and orbs to upgrade, and soul gems to bank a currency. Each is one file under items/, tagged by type:, carrying its material / name / lore plus a few type-specific knobs.

These item files describe each item's look and its economy settings. They never compile to an ability and never touch the combat hot path. An item's identity and counters live in its persistent data and render back into lore automatically.

The item family

Page	Item	What it does
Enchant books	book, unopened (mystery) book	apply an enchant to gear
Scrolls	white, holy-white, black, transmog, godly transmog, randomizer	protect, extract, rework, reroll
Success dust	dust	raise a book's success chance
Soul gems	soul gem	bank and spend souls
Slot orbs	slot expander	add enchant slots
Nametags	item nametag	rename gear
Crystals	crystal, extractor	socket a levelless bonus
Masks	mask	wear a re-skinning ability head on your helmet
Pets	pet, pet food	a levelling companion head in your hotbar
Weapon reforges	weapon reforge	socket one signature active ability into a weapon
Use-items	use-item	a right-click consumable or tool
Heroic upgrade	heroic	a one-shot power-up (see below)

Every item file

Each row above maps to one file under items/. The complete, generated list — every item's file key, type:, default material, and default name (shown with raw & colour codes) — is:

Item key	Type	Material	Name
black-scroll	black-scroll	INK_SAC	&8Black Scroll
blocktrak	blocktrak	SLIME_BALL	{#84c874}&lBlockTrak Gem
crystal	crystal	AMETHYST_SHARD	&d{CRYSTAL} &7Crystal
dust	dust	GLOWSTONE_DUST	&aSuccess Dust
enchant-book	enchant-book	ENCHANTED_BOOK	{TIER_COLOR}&l{ENCHANT} {LEVEL}
fishtrak	fishtrak	CLAY_BALL	{#b0b9d5}&lFishTrak Gem
godly-transmog	godly-transmog	NETHER_STAR	&5Godly Transmog
heroic	heroic	NETHERITE_SCRAP	&6&lHeroic Upgrade
holy-white-scroll	holy-white-scroll	TOTEM_OF_UNDYING	&fHoly White Scroll
mask	mask	—	{COLOR}&l{NAME} Mask
mobtrak	mobtrak	MAGMA_CREAM	{#e6cb2f}&lMobTrak Gem
nametag	nametag	NAME_TAG	&bItem Nametag
pet-food	pet-food	GOLDEN_CARROT	&e&lPet Food [&r&a&n+{AMOUNT}&r&e&l]
pet	pet	—	{COLOR}&l{NAME} Pet &7[Lvl. &f&n{LEVEL}&r&7]&r
randomizer-scroll	randomizer-scroll	SUGAR	&eRandomizer Scroll
reforge	reforge	—	&6&lWeapon Reforge ({COLOR}&l{NAME}&r&6&l)
slot-orb	slot-orb	—	—
soul-gem	soul-gem	EMERALD	&aSoul Gem
soultrak	soultrak	FIRE_CHARGE	{#e54f00}&lSoulTrak Gem
transmog-scroll	transmog-scroll	PAPER	&c&lTransmog Scroll
unopened-book	unopened-book	BOOK	&b{TIER} Mystery Book
white-scroll	white-scroll	PAPER	&fWhite Scroll

Minting and giving

Two command families produce items:

• /se <item> mints one to yourself — /se book <enchant> [level], /se gem [souls], /se orb, /se heroic, /se dust [percent], /se nametag, /se whitescroll, /se holy, /se blackscroll, /se randomizer, /se transmog, /se godlytransmog, /se crystal <key>, /se reforge <key>, /se unopened <tier>.
• /se give <type> <player> … gives one to someone else — books, scrolls, dust, gems, orbs, crystals, extractors, sets, heroics, and unopened books, plus the content-carrying families: /se give mask <player> <key>, /se give pet <player> <key> [level], /se give petfood <player> [amount], /se give reforge <player> <key>, and /se give useitem <player> <key> [amount].

See the commands page for the exact argument shapes.

The heroic upgrade item

The heroic upgrade (items/heroic.yml, type: heroic) is a one-shot power-up dragged onto any armor piece or weapon. It has a small randomized success chance, is consumed either way, and on success stamps percent stats and optionally swaps the material:

type: heroic
material: NETHERITE_SCRAP
name: "&6&lHeroic Upgrade"
lore:
  - "&7Drag onto armour or a weapon to attempt a heroic upgrade."
  - "&7Small success chance — consumed on use."
success-min: 5                 # per-attempt success chance is drawn from [min, max] percent
success-max: 15
percent-damage: 0.10           # +10% outgoing damage (weapons)
percent-reduction: 0.10        # -10% incoming damage (armor)
durability: 0.25               # 25% chance to cancel item damage
reduction-scope: ENTITY        # ENTITY = PvP/entity only; ALL = every damage cause
material-upgrades:             # optional within-category material swap on success
  DIAMOND_HELMET: NETHERITE_HELMET
  DIAMOND_CHESTPLATE: NETHERITE_CHESTPLATE
  DIAMOND_SWORD: NETHERITE_SWORD

Mint with /se heroic, or give with /se give heroic <player>. Heroic percents feed the ordinary additive damage fold — there is no separate multiplier stage or ceiling knob. See Heroic upgrades.