Scrolls

The scroll family is a set of single-purpose tools players drag onto gear (or books) to protect, rework, or reroll it. Each is one file under items/. Result messages for every scroll live in lang.yml.

White Scroll

items/white-scroll.yml · type: white-scroll

Drag onto gear to protect it from enchant destruction: it stamps a one-shot guard so the next failed enchant apply spares the item instead of shattering it.

type: white-scroll
material: PAPER
name: "&fWhite Scroll"
# {KINDS} expands to the grammatically-joined applies-to label.
lore:
  - "&7Protects an item — a failed"
  - "&7enchant will spare it once."
  - ""
  - "&eApplies to: &r&f&n{KINDS}"
# Item-group kinds this scroll may protect: e.g. ARMOR, WEAPON, TOOL, ALL (any item).
applies-to: [ARMOR, WEAPON, TOOL]
# Each minted scroll rolls an apply-success % in [min-success, max-success]. On a failed roll the scroll
# is consumed WITHOUT protecting (it never destroys the gear). 100/100 = always succeeds (the default).
min-success: 100
max-success: 100
# Stamped onto guarded gear, rendered from state, removed when the guard is spent.
protected-line: "&f&lPROTECTED"

:::note Only matters with destroy-on-fail A White Scroll only does anything when a sub-100% book could shatter your gear. If destroy-on-fail is false, it has nothing to guard against. :::

Holy White Scroll

items/holy-white-scroll.yml · type: holy-white-scroll

Drag it onto one piece of gear to stamp a one-shot keep-on-death marker on that item. When you die, the marked item is kept — with its enchants and their levels intact on it — while the rest of your inventory drops as normal, and the marker is consumed. Marked items aren't exclusive: a holy white scroll may sit alongside a white scroll and any trak gems.

type: holy-white-scroll
material: TOTEM_OF_UNDYING
name: "&fHoly White Scroll"
# {KINDS} expands to the grammatically-joined applies-to label.
lore:
  - "&7Drag onto an item to keep"
  - "&7it when you die (one use)."
  - ""
  - "&eApplies to: &r&f&n{KINDS}"
# Item-group kinds this scroll may protect: ALL (any item) by default; e.g. ARMOR, WEAPON, TOOL.
applies-to: [ALL]
# Each apply rolls a success in [min-success, max-success]. On a failed roll the scroll is spent without
# protecting (it never destroys gear). 100/100 = always succeeds (the default).
min-success: 100
max-success: 100
# Stamped onto the holy-protected item while the keep marker is present; removed when it is consumed.
protected-line: "&e&l*&f&lHOLY&e&l* &f&lPROTECTED"

# Corruption — how many holy scrolls this item may ever SPEND. 0 = unlimited.
max-protections: 7
corrupt-lines:
  semi: "&c&lSEMI CORRUPT (&r&f&n{AMOUNT}&r&7 / {MAX} Holy Protections&r&c&l)"
  very: "&c&lVERY CORRUPT (&r&f&n{AMOUNT}&r&7 / {MAX} Holy Protections&r&c&l)"
  full: "&c&lCORRUPTED (&r&f&n{AMOUNT}&r&7 / {MAX} Holy Protections&r&c&l)"

Corruption

An item can only be saved so many times. Every holy white scroll that actually does its job — the marker cashed in by a death — spends one of the item's max-protections (7 by default) and stamps a corruption line directly below the PROTECTED line.

Applying a scroll costs the item nothing. Only the death that uses it counts, so a scroll you never cash in is free.

Spent	Line
1–49% of the allowance	SEMI CORRUPT (3 / 7 Holy Protections)
50–99%	VERY CORRUPT (4 / 7 Holy Protections)
100%	CORRUPTED (7 / 7 Holy Protections)

The stage is a percentage, so these read the same whatever allowance you configure. Unlike the PROTECTED line — which vanishes with its marker — the corruption line is permanent once earned.

At CORRUPTED the item takes no further holy white scrolls, and a scroll dragged onto it is not consumed. Set max-protections: 0 to switch corruption off entirely.

:::note The totem look is cosmetic TOTEM_OF_UNDYING is display only — the vanilla totem pop is suppressed, so the scroll keeps one marked item through death rather than preventing the death. The shipped signature pack overrides the material to MAP. On 1.8.9 there is no totem item or pop to suppress. :::

:::tip Three different "keeps" The White Scroll protects one item from enchant destruction. The Holy White Scroll keeps one marked item on death. Keeping your whole inventory is the separate KEEP_ON_DEATH enchant — not this scroll. :::

Black Scroll

items/black-scroll.yml · type: black-scroll

Drag onto enchanted gear to extract one random enchant into a book. The extraction always succeeds — what varies is the drawn book's conversion rate, rolled in [min-convert, max-convert] when the scroll is minted, clamped to the global books.max-success ceiling, and stamped on the scroll.

type: black-scroll
material: INK_SAC
name: "&8Black Scroll"
# {KINDS} expands to the grammatically-joined applies-to label.
lore:
  - "&7Drag onto enchanted gear to"
  - "&7extract one enchant into a book."
  - ""
  - "&eApplies to: &r&f&n{KINDS}"
# Item-group kinds this scroll may extract from: e.g. ARMOR, WEAPON, TOOL, ALL (any item).
applies-to: [ARMOR, WEAPON, TOOL]
# The drawn book's success rate rolls in [min-convert, max-convert] (each 0–100) at mint, then clamps
# to config.yml books.max-success. {SUCCESS} = that rate, {FAILURE} = its complement.
min-convert: 50
max-convert: 100

/se give blackscroll <player> <percent> mints one at a fixed conversion rate instead of a rolled one.

Transmog Scroll

items/transmog-scroll.yml · type: transmog-scroll

Drag onto enchanted gear to sort its enchant lore by rarity — highest tier first (cosmetic only; combat is order-independent) — and stamp the item's enchant count into its name. Real Minecraft enchants are rendered above the lore by the client, so they sit above the custom block.

type: transmog-scroll
material: PAPER
name: "&c&lTransmog Scroll"
# Authored lore lines auto-wrap at config lore.item-wrap.
lore:
  - "&eOrganizes enchants by &f&nrarity&r&e on your item and adds the &denchant &bcount &eto the name."
  - "&7Drag n' Drop on an item to apply."
# Appended to the gear's display name when transmogged; {COUNT} = the item's total enchant count.
name-suffix: "&r &d[&b&l&n{COUNT}&r&d]"

It is re-applicable: a second apply re-sorts the lore and replaces the count suffix rather than stacking a second one, so the count never duplicates. For a hand-picked order instead of the rarity sort, use the Godly Transmog tool below.

Godly Transmog

items/godly-transmog.yml · type: godly-transmog

A reusable tool (not a one-shot scroll): drag onto enchanted gear to open a GUI where you arrange the enchant display order by hand. Where the Transmog Scroll sorts by rarity, this lets you pick.

type: godly-transmog
material: NETHER_STAR
name: "&5Godly Transmog"
lore:
  - "&7Drag onto enchanted gear to"
  - "&7reorder its enchants by hand."

Randomizer Scroll

items/randomizer-scroll.yml · type: randomizer-scroll

Drag onto an enchant book to reroll its success chance to a random value in [min-percent, max-percent].

type: randomizer-scroll
material: SUGAR
name: "&eRandomizer Scroll"
lore:
  - "&7Drag onto an enchant book to"
  - "&7reroll its success chance."
min-percent: 25                # the new chance rolls uniformly in [min, max], each 0–100
max-percent: 100

Minting & giving

/se whitescroll        /se give whitescroll <player>
/se holy               /se give holy <player>
/se blackscroll        /se give blackscroll <player> [percent]
/se transmog           /se give transmog <player>
/se godlytransmog      /se give godlytransmog <player>
/se randomizer         /se give randomizer <player>