Bonus Items

How to add Bonus Items for an Item.

---

This feature allows you to set up Bonus Items for any item, not just Poké Balls (like the default in Essentials).
Bonus Items apply to all shops where that item is sold.
They are only granted if the purchased item is found in the BonusItems setting.

---

Example 1 — Basic

A simple structure where you define a required amount to receive a bonus item.

• :POKEBALL — The item you need to buy in quantity.
  • :amount => 10 — For every 10 Poké Balls purchased...
  • :item => :PREMIERBALL — ...you get 1 Premier Ball.

Exactly like the default in Essentials.

Hint

Only for Ball Items: If the bought item is a Ball (like Great Ball), this rule will apply unless you define a specific entry for that item.

---

Example 2 — Randomized Multiple Items

An expanded version that allows random bonus selection, optionally with specific chances.

• For every 10 Great Balls bought:
  • 20% chance of getting another Great Ball
  • 80% chance of getting a Premier Ball

If no chances are given, the items are equally weighted.

Hint

If only some items have defined chances, the remaining percentage is split evenly among the rest.

---

Example 3 — Advanced: Amount + Chances

The most flexible setup: different item amounts and chances.

• For every 5 Ultra Balls bought:
  • 0.1% chance to get a Master Ball
  • 5% chance to get 2 Ultra Balls
  • Remaining chance to get a Premier Ball

Attention

When using this format, each bonus item must have at least :amount or :chance defined.
If not, use the format shown in Example 2 instead.