📰 Reward Config Editing

#Edit Rewards

You can also edit the rewards through the configuration file if you prefer to manage everything manually.

#Format:

The following option is the method you can use for vanilla items.
Note: This option cannot be configured through the in-game editor, as the editor uses the bukkit format to also support custom properties and modded Items.

display-item:
  material: PAPER
win-items:
  '0':
    material: PAPER

#Material:

Allows you to set a material on your item.

material: TEXT

Supported material values:

• Vanilla (DIAMOND).
• HeadDatabase (hdb:id)
• ItemsAdder (itemsadder:namespace:id)
• Nexo (nexo:id)
• Mythic Items (mythicitem:id)
• MMOItems (mmoitem:type:id )
• ExecutableItems (executableitem:id)
• CraftEngine (craftengine:id)

• Materials Link

#Hooked Materials

A hooked material is the hook name, a colon, then the id the other plugin knows the item by. Only the first colon separates the two, so everything after it reaches that plugin exactly as written.

Hook	Value	Example
ItemsAdder	itemsadder:namespace:id	itemsadder:medieval_crates:crate_key
MMOItems	mmoitem:type:id	mmoitem:SWORD:cutlass
Nexo	nexo:id	nexo:ruby_sword
CraftEngine	craftengine:id	craftengine:default:ruby_sword
Mythic Items	mythicitem:id	mythicitem:excalibur
ExecutableItems	executableitem:id	executableitem:magic_wand
HeadDatabase	hdb:id	hdb:1234

ItemsAdder and MMOItems ids are built from two parts of their own, so those values have three parts in total. itemsadder:crate_key sends only crate_key to ItemsAdder and resolves to nothing, and an MMOItems value with no type is rejected. For the rest, pass the id exactly as the plugin registers it, namespace included where it has one.

material: itemsadder:medieval_crates:crate_key

The same values work in every material field of the plugin, the menus included.

#Display Name

Allows you to set a display name on your item.

display-name: '&eExample Reward'

#Lore:

Allows you to set a custom lore on your item.

lore:
- '&cLine 1'
- '&eLine 2'
- '&aLine 3'

#Model Data:

Allows you to set custom model data on your item.

model-data: 1000

#Item Model:

Allows you to set a custom Item Model (the modern resource-pack item model component) on your item.

item-model: 'minecraft:custom_paper'

#Amount:

Allows you to set a fixed stack size on your item.

amount: 1

#Enchants:

Allows you to set enchants on your item.

enchants:
- 'PROTECTION:1'
- 'UNBREAKING:1'

• Enchantsments Link

#Item Flags:

Allows you to set item flags on your item, to hide certain tooltip sections (enchants, attributes, "unbreakable", etc).

flags:
- 'HIDE_ENCHANTS'

• Item Flags Link

#Tooltip Style:

Allows you to set a custom tooltip style/texture (resource-pack defined) for the item's tooltip box.

tooltip-style: 'minecraft:gui/sprites/widget/inventory_tooltip'

#Enchantment Glint Override:

Allows you to force the enchantment glint (the shimmering/glowing effect) on or off, independently of whether the item is actually enchanted.

enchantment-glint-override: true # Boolean (`true`/`false`)

#Banner Meta:

Allows you to add banner patterns to your item. Works on banners, and on shields (and other blocks that carry banner data).

banner-meta:
- 'RED;STRIPE_BOTTOM'
- 'WHITE;CROSS'

• Each entry follows the format <DyeColor>;<PatternType>.
• DyeColor Link / PatternType Link

#Armor Trim (Material & Pattern):

Allows you to apply an armor trim to your item, by setting both the trim material and the trim pattern.

trim-material: IRON
trim-pattern: DUNE

• Both options must be set together.
• Armor Trim Materials / Armor Trim Patterns

#Potion Effects:

Allows you to add custom potion effects to a potion item.

potion-effects:
- 'speed;1200;1'
- 'regeneration;600;0'

• Each entry follows the format <PotionEffectType>;<duration in ticks>;<amplifier>.
• Potion Effect Types Link

#RGB:

Allows you to set a custom color on your item, using raw RGB values.

rgb: '38, 192, 210'

• Format: R, G, B (each 0-255). Applies to leather armor, potions, maps and firework effects.

#Item Config Example

The following is an example of a reward with its display item and the actual reward.

  '2':
    identifier: reward_1759509999284
    display-item:
      material: PAPER
      # Legacy colors support
      display-name: '&#C00BD6Paper'
      lore: 
      - '&cCustom Paper Item'
      model-data: 1000
      enchants:
      - 'PROTECTION:1'
      flags:
      - 'HIDE_ENCHANTS'
    win-items:
      '0':
        material: PAPER
        # Mini Message Support
        display-name: '<gradient:#C00BD6:#FD2177>Paper</gradient>'
        lore: 
        - '<gradient:#C00BD6:#FD2177>Custom Paper Item</gradient>'
        model-data: 1000
        enchants:
        - 'PROTECTION:1'
        flags:
        - 'HIDE_ENCHANTS'