Skip to content
Lucent
Esc
↑↓navigate↵open
On this page

Enhancements

Apply enhancements and equip matching gear from scripts.

api.shop.enhanceItem() applies or upgrades an enhancement. api.inventory.equipByEnhancement() equips an inventory item that already has a matching enhancement.

How enhancement selectors work

Pass the first enhancement label as enhancement and the second, if present, as special.

// Lucky
{ enhancement: "lucky" }

// Fighter, Dauntless
{
  enhancement: "fighter", // or forge
  special: "dauntless",
}

Unique names can be used on their own:

  • dauntless, vim, and vainglory work on their own.
  • For Grimskull, Hearty, use hearty on its own or pass both labels.
  • Awe traits need a pattern; spiral carve does not work on its own.

Names are case-insensitive. Extra spaces and straight or curly apostrophes do not matter. Shortcuts such as dtl, ely, and abso are also accepted.

Apply an enhancement

yield* api.shop.enhanceItem("ArchPaladin", {
  enhancement: "lucky",
});

Lucent opens the corresponding shop and applies the highest matching level your character can use and buy. Add special when the enhancement has a trait:

yield* api.shop.enhanceItem("My Weapon", {
  enhancement: "lucky",
  special: "spiral carve",
});

Equip by enhancement

yield* api.inventory.equipByEnhancement({
  enhancement: "vim",
});

Lucent searches every equipment slot and equips the highest-level match. Add slot when the equipment type matters:

yield* api.inventory.equipByEnhancement({
  enhancement: "forge",
  slot: "helm",
});

A plain forge selector requires either slot or special. slot accepts "weapon", "class", "helm", or "cape"; "class" means a Class item, not cosmetic armor.

Supported enhancements

Basic enhancements

Available for every equipment slot.

  • Fighter
  • Thief
  • Hybrid
  • Wizard
  • Healer
  • Spellbreaker
  • Lucky

Awe weapon patterns

  • Fighter
  • Thief
  • Hybrid
  • Wizard
  • Healer
  • Lucky

Awe weapon traits

  • Spiral Carve
  • Awe Blast
  • Health Vamp
  • Mana Vamp
  • Powerword DIE

Forge weapons

  • Forge
  • Forge, Lacerate
  • Forge, Smite
  • Forge, Valiance
  • Forge, Arcana's Concerto
  • Depths, Acheron
  • Wizard, Elysium
  • Forge, Praxis
  • Fighter, Dauntless
  • Forge, Ravenous

Forge helms

  • Forge
  • Vim, Ether
  • Examen, Ether
  • Pneuma, Clairvoyance
  • Anima, Clairvoyance
  • Grimskull, Hearty

Forge capes

  • Forge
  • Forge, Absolution
  • Forge, Avarice
  • Forge, Vainglory
  • Forge, Penitence
  • Forge, Lament
Type preview
Open page

Last updated on September 26, 2026

Was this page helpful?