🌟Reward Display

The reward_display section defines how the currently winning reward is visualized above the wheel and how its tooltip (hover info) is rendered.

Syntax

reward_display:
  use: <true/false>
  model:
    offset: <decimal>
    scale: <decimal>
  tooltip:
    use: <true/false>
    format:
      - <text>
      - ...
    lore_lines: <number>
    and_more: <text>
    offset:
      x: <decimal>
      z: <decimal>
    chat_preview: <text>

---

use

Default: true

Turns the reward display on or off. If set to false, no model or tooltip will be shown during/after spins.

---

model

offset

Default: 0.0

Shifts the icon toward/away from the wheel center along the radius.

• Base radius is 2 from the wheel center.

• Positive values move the icon toward the center; negative values move it away (or vice versa depending on your orientation).

• Use small increments (e.g., 0.1) for fine positioning.

---

scale

Default: 1.0

Sets the visual scale of the displayed reward icon.

• Values > 1.0 make the icon larger; values < 1.0 make it smaller.

---

tooltip

use

Default: true

Enables a hover tooltip with reward details. Disable to hide all tooltip content.

---

format

Defines the tooltip line-by-line.

• Each entry is a separate line.

• Color codes and hex/gradient formats are supported (see color formatting page).

• When the engine hits %lore%, it injects up to lore_lines from the item’s lore, then continues with the next lines in format.

Available placeholders

• %name% — Reward name.

• %item_amount% — Count of items in the reward.

• %base_chance% — Base (unmanipulated) chance of the reward.

• %manipulated_chance% — Final chance after all adjustments (useful for transparent display of actual outcome probability).

• %lore% — When this token is encountered in format, it will expand into a defined number of item lore lines (see lore_lines).

Example behavior (conceptual):

• &f(%item_amount%) %name% (%manipulated_chance%) → header line with name, amount, and final chance.

• %lore% → inject up to lore_lines of item lore.

• '' → blank spacing line.

• &e(Left click) Show whole item... → hint to view more details.

lore_lines

Default: 3

Maximum number of lore lines from the item to display at %lore%.

• If the item has more lore than this, the extra lines are summarized via and_more.

and_more

Default: &7...and %amount% more

Shown when the item has more lore lines than lore_lines.

• %amount% is replaced with the number of omitted lines.

offset (tooltip)

Default: x: 0.0, z: 0.4

Horizon ual placement of the tooltip relative to the wheel center, in world units (blocks).

• Adjust to prevent overlap with the model or other UI elements.

• Positive/negative x and z move the tooltip sideways/forward-back relative to the wheel.

chat_preview

Default: &eHover your mouse over the item to see reward details

Short helper text presented in chat to inform players how to reveal the tooltip (e.g., hover to preview).

• Customize to your server’s language/style.