Ribbons

Ribbons are achievement markers awarded for placing in contests. They serve as both trophies and progression gates — higher-ranked contests require ribbons from lower ranks.

Ribbon Tiers

Tier	Name	Placement	Coin Reward	XP Reward
1	Normal	4th place	100	50
2	Super	3rd place	250	100
3	Hyper	2nd place	500	250
4	Master	1st place	1000	500

Ribbons are awarded per contest category. A “Cool Normal Ribbon” is different from a “Beauty Normal Ribbon.”

Ribbon Progression

To enter higher-ranked contests, a Pokemon needs the ribbon from the previous rank in that category:

Normal Contest (no requirement)
  ↓ Earn Normal Ribbon
Super Contest (requires Normal Ribbon)
  ↓ Earn Super Ribbon
Hyper Contest (requires Super Ribbon)
  ↓ Earn Hyper Ribbon
Master Contest (requires Hyper Ribbon)
  ↓ Earn Master Ribbon

How Ribbons Are Stored

Ribbons are stored using Cobblemon’s Marks system on each Pokemon. This means:

Ribbons persist with the Pokemon across sessions
Trading a Pokemon transfers its ribbons
Each ribbon records: category, rank, contest ID, score, date, and location

Auto-Tier Rewards

When rewards are configured with tier = "auto", the ribbon tier is automatically determined by placement:

Placement	Ribbon Tier
1st	Master
2nd	Hyper
3rd	Super
4th	Normal

Ribbon Case

The Basic Ribbon Case (appears as a Chest) stores contest ribbons for viewing and collection.

Capacity: 25 ribbons (expandable)
Sortable by tier or category
Shows stats: count by tier and type
Right-click to open

Players can also view their ribbon collection with /reverie debug ribbons.

Configuration

Ribbon rewards are configured per-hall or per-contest-type:

rewards {
  ribbonRewards {
    normal = ["ribbon:normal"]
    super = ["ribbon:super"]
    hyper = ["ribbon:hyper"]
    master = ["ribbon:master"]
  }
}

Admin Commands

/reverie debug giveribbon <category> <tier>   # Award a ribbon (tier 1-4)
/reverie debug ribbons                         # View current Pokemon's ribbons

Next Steps

Contests — How ribbon requirements affect contest entry
Seals — Unlock seals through ribbon achievements
Items Reference — Ribbon case item details