Crystals (item)

This page covers the physical crystal item — applying, merging, and extracting. For what a crystal is (a levelless socket bonus) and how to define one in content/crystals/, see the crystals concept and defining a crystal.

The shared crystal item — items/crystal.yml

There is one global crystal likeness. A crystal in content/crystals/ declares only its styled display name, its description block, and its effects — it has no material, name, or lore of its own. The material/name/lore below are shared by every minted crystal, single or merged:

type: crystal
material: AMETHYST_SHARD
name: "&d{CRYSTAL} &7Crystal"
name-multi: "&d{CRYSTAL} &7Multi-Crystal"
lore:
  - "&7Imbues a piece of gear with crystal magic. Merge with other crystals to combine their effects."
  - ""
  - "{DESCRIPTION}"
  - ""
  - "&7Applies to: &f&n{KINDS}"
  - "&7Drag n' Drop on an item to apply."
# The line shown on crystal-bearing gear (below the orb-slots line, above the heroic line).
lore-while-on-item: "&d{CRYSTAL} &7Crystal"
lore-while-on-item-multi: "&d{CRYSTAL} &7Multi-Crystal"
# Apply/merge and extract gesture sounds. `apply`/`remove` also accept the bracket form
# { sound: NAME, volume: V, pitch: P }; a bare string plays at volume/pitch 1.0.
sounds:
  enabled: true
  apply: "block.amethyst_block.chime"
  remove: "block.amethyst_cluster.break"
# The ITEM EXTRACTOR — pops a reforge or a crystal back off gear, or splits a multi-crystal.
extractor:
  material: AMETHYST_CLUSTER
  name: "&dItem Extractor"
  lore:
    - "&7Drag onto gear to pop its reforge or crystal"
    - "&7off whole, or onto a multi-crystal to split it."

Token	Renders
{CRYSTAL}	the component crystal name(s), comma-joined — a merge reads each name in its own colour
{DESCRIPTION}	each component's authored description block, stacked with a blank line between blocks
{KINDS}	the item kinds the crystal applies to (the intersection for a merge)

A merged crystal (2+ components) takes name-multi / lore-while-on-item-multi instead. Each defaults to its single-crystal form, so a pack that doesn't distinguish the two keeps one uniform name.

Applying, merging, extracting

• Apply. Drag a crystal onto gear. Applying always succeeds — there is no roll, and nothing is ever lost to a failed apply.
• Merge. Drag one crystal onto another to combine them into a multi-crystal whose effects stack, up to crystals.max-merge. The merged item takes the multi name and stacks each component's description block.
• Extract. The Item Extractor pops things back off, whole. On gear it takes a weapon reforge first if one is present; otherwise it pops the whole last crystal entry intact — a merged multi comes back as one multi-crystal. Use the extractor again on that popped multi-crystal to split its topmost single off.

:::note Sockets are separate from enchant slots How many crystal entries a piece can hold is crystals.slots (default 1) in config.yml, and how many crystals may fuse into one entry is crystals.max-merge (default 2) — a different ledger from enchant slots. :::

Minting & giving

/se crystal <key>                # mint a specific crystal to yourself (key from content/crystals/)
/se give crystal <player> <key>
/se give extractor <player>      # give an Item Extractor