Slot-expander orbs

A slot-expander orb is dragged onto gear to raise its enchant-slot count, up to a universal ceiling. It is the lever players use to fit more enchants onto a single item. See Slots for the concept.

The orb — items/slot-orb.yml

type: slot-orb
orb-material: ENDER_EYE
orb-name: "&5Slot Expander &7(+{AMOUNT})"
# {KINDS} expands to the grammatically-joined applies-to label.
orb-lore:
  - "&7Drag onto gear to add &f{AMOUNT}&7 enchant slots."
  - ""
  - "&eApplies to: &r&f&n{KINDS}"
# Item-group kinds this orb may expand: e.g. ARMOR, WEAPON, TOOL, ALL (any item).
applies-to: [ARMOR, WEAPON, TOOL]
orb-amount: 3                    # +slots this orb grants
# Universal ceiling on an item's TOTAL slots (base + purchased). Base default is 9 (config.yml).
hard-cap: 15
# Each minted orb rolls an apply-success % in [min-success, max-success]. On a failed roll the orb is
# consumed with no slots added (it never destroys the gear). 100/100 = always succeeds (the default).
min-success: 100
max-success: 100

Token	Renders
{AMOUNT}	the +N slots the orb adds
{MAX}	the hard-cap — the maximum total slots any item may reach
{KINDS}	the applies-to kinds, grammatically joined
{SUCCESS}	this orb's rolled apply chance
{FAILURE}	100 - {SUCCESS}

:::warning Two ceilings to remember slots.base in config.yml sets where items start (default 9); hard-cap here sets the absolute maximum total (default 15). An orb that would push past the cap is rejected, and the player gets the at-cap message (slot.at-cap in lang.yml). :::

Minting & giving

/se orb                          # mint a slot expander to yourself
/se give orb <player>