This document explains every configurable part of WYG (What’d Ya Got!) and lists all placeholders with examples. It is organized with headings and compact tables for quick scanning.

• ✅ Formatting engine: MiniMessage (supports colors, gradients, click events, etc.)
• ✅ Sprites: Fully supports 1.21+ sprites and custom icons

Formatting

WYG uses MiniMessage everywhere text is configured. You can use MiniMessage tags anywhere a format string is accepted, including share-message.format, item-display.format, hover-text.layout, hover-text.enchantment-format, hover-text.stack-format, hover-text.durability-format, hover-text.item-name.format, and attribute formats.

Sprites and icons

You can embed Minecraft sprites anywhere MiniMessage is parsed by WYG.

Supported tags:

- `<sprite:path>`
- `<sprite:atlas/path>`
- `<sprite:namespace:path>`
- `<sprite:namespace:atlas/path>`
- `<item_sprite>` # the current item’s icon (tooltip contexts)
- `<player_head>` # the current player’s head (share messages)
- `<player_head:PlayerName>` # head for any named player

gui, blocks, items, particles, mob_effects, paintings, map_decorations

Configuration Optionns

Share message

Path: share-message.format

What it controls: The chat line sent when a player shares an item (e.g., via /wyg).

Placeholders

Examples

<player> shared <item>
<player_head> <player> <gray>→</gray> <item>
<gradient:yellow:gold><player_head> <player></gradient> <gray>→</gray> <item>

Item display

Path: item-display.format

What it controls: The inline, clickable item component that appears in chat.

Placeholders

Examples

[<sprite> <item>]
<aqua><u>[<sprite> <item>]</u></aqua>
<gradient:green:blue><sprite> <item></gradient>

Hover tooltip

Path: hover-text.*

• hover-text.enabled: true|false — Master switch for hover tooltips on the item component.

Layout

Path: hover-text.layout

Each entry in layout is one tooltip line. Some placeholders expand to multiple lines and must be used on their own line.

Single-line placeholders (can be combined on the same line)

Multi-line placeholders (must be on their own line)

Rules and tips

• Multi-line placeholders must be alone on the line or they will render literally.
• Single-line placeholders can be combined freely, e.g.:

<attributes:attack_damage> <attributes:attack_speed> <sprite:gui/statistics/item_crafted> <gray><durability></gray>

• Unknown <attributes:...> keys resolve to empty safely.
• Empty strings ("") create spacing; they are skipped automatically when adjacent content is skipped to prevent dangling blanks.
• Lines that resolve to no visible text are skipped automatically when their placeholders render nothing (prevents stray blank rows).

Enchantment format

Path: hover-text.enchantment-format

Placeholders

Example

<gray><enchantment><level></gray>

Stack size format

Path: hover-text.stack-format

Placeholders

Example

<gray>Stack Size: <amount></gray>

Durability format

Path: hover-text.durability-format

Placeholders

Example

<sprite:gui/hud/heart/full> <gray>Durability: <current>/<max></gray>

Item name (base) secondary line

Path: hover-text.item-name.*

Controls rendering of the <item_name> placeholder in your tooltip. Useful for showing the base material name on a second line when the item has a custom display name.

• format — MiniMessage format used to render the base name. Inside this string, <item_name> is the translatable material name you can wrap with colors/effects/sprites.
• render-if-same-as-name — If false (default), any layout line containing <item_name> is skipped when the item is not renamed (i.e., its display name equals the base item name). Set to true to always show it.

Examples

# In hover-text.layout
- "<name>"
- "<item_name>"  # will be skipped for unrenamed items when render-if-same-as-name: false

# Settings
hover-text:
  item-name:
    format: "<gray><item_name></gray>"
    render-if-same-as-name: false

Attributes

Path: hover-text.attributes.*

Slot header

• slot-header-format — Header line shown before a slot's attributes (used by <attributes> and <attributes_header:...>)
• Default: "<gray><slot></gray>"

Placeholders

Per-attribute formats

• formats.attack_damage — Total attack damage
• formats.attack_speed — Total attack speed
• formats.armor — Total armor
• formats.armor_toughness — Total armor toughness
• formats.knockback_resistance — Total knockback resistance as percentage; <value> is already 0–100

Shared placeholders in formats

Example values

<sprite:gui/hud/heart/full> <white><value></white>
<blue>+<value> <attribute></blue>

How attribute values are computed

• Sender-based: values are based on the SENDER (invoker), not the viewer.
• Base values: start from the player's base value; modifiers are applied by operation:
• ADD_NUMBER — added directly
• ADD_SCALAR, MULTIPLY_SCALAR_1 — add base * amount
• Slot filtering: only modifiers for the relevant EquipmentSlot count for that slot.
• Knockback resistance: displayed as a percentage (total * 100).
• Vanilla-like behavior: Attack Damage lines are hidden if total <= base.

Chat usage (FYI)

Players can type bracketed slot names (e.g., [hand], [offhand], [head], [chest], [legs], [feet]) to inject their equipped item using the configured Item Display and Tooltip. The inserted component respects all formatting described above.