Rewards UI

Rewards UI

The Rewards UI allows players to view and collect pending rewards from achievements.

Command: /rewards or /belohnungen

Overview

When an achievement grants a lootbag or other pending reward, it’s stored until the player collects it. The Rewards UI provides a dedicated interface for managing these rewards.

Features:

• View all pending rewards
• Collect individual rewards
• Collect all rewards at once
• See reward source (which achievement)
• Lootbag contents shown in chat

---

Accessing Rewards

Commands

Command	Description
/rewards	Open the Rewards UI
/belohnungen	German alias

From Achievement Toast

When an achievement with a lootbag reward is unlocked, the toast shows “Lootbag” in the rewards line, indicating the reward can be collected via /rewards.

---

Interface Elements

Reward List

The main view shows all pending rewards:

• Icon - Item icon or lootbag icon
• Name - Reward name
• Description - Reward details
• Source - “From: {Achievement Name}”
• Action Button - “Collect” or “Open”

Pagination

If you have more than 4 pending rewards:

• Previous - Go to previous page
• Next - Go to next page
• Page indicator - Shows current page

Collect All Button

Located at the top right - collects all pending rewards at once.

---

Reward Types

Item Rewards

Element	Display
Icon	Actual item icon
Button	”Collect”
Action	Item added to inventory

Lootbag Rewards

Element	Display
Icon	Lootbag icon
Button	”Open”
Action	Opens lootbag, contents shown in chat

Command Rewards

Element	Display
Icon	Scroll/parchment icon
Button	”Collect”
Action	Command executed

---

Collecting Rewards

Single Reward

1. Open /rewards
2. Find the reward you want
3. Click Collect or Open
4. Reward is processed

All Rewards

1. Open /rewards
2. Click Collect All (top right)
3. All rewards are processed
4. Summary shown in chat

---

Chat Messages

Opening a Lootbag

When you open a lootbag, the contents are displayed in chat:

Lootbag opened: Gold Loyalty Reward
Received: 25x Gold Ore, 1x Ruby, 1x Emerald

Collection Summary

When collecting all rewards:

3 rewards collected!

Error Messages

Message	Cause
”Inventory full!”	No space for items
”Some items could not be collected”	Partial collection due to space
”Reward could not be collected”	General collection error

---

Localization Keys

All UI text is localizable. Add these keys to your language file:

Header

rewards.ui.title=Pending Rewards
rewards.ui.pending_count={0} rewards pending

Buttons

rewards.ui.collect_all=Collect All
rewards.ui.collect=Collect
rewards.ui.open=Open

Information

rewards.ui.from=From: {0}
rewards.ui.type.command=Command Reward
rewards.ui.type.lootbag=Lootbag
rewards.ui.type.reward=Reward
rewards.ui.executes=Executes: {0}
rewards.ui.open_to_reveal=Open to reveal contents

Feedback

rewards.ui.collect_failed=Reward could not be collected. Inventory full?
rewards.ui.open_failed=Lootbag could not be opened
rewards.ui.inventory_full=Inventory full!
rewards.ui.some_not_collected=Some items could not be collected
rewards.ui.collected_count={0} rewards collected!
rewards.ui.lootbag_collected=Lootbag collected!
rewards.ui.lootbag_opened=Lootbag opened: {0}
rewards.ui.lootbag_contents=Received: {0}
rewards.ui.all_collected=All rewards collected!
rewards.ui.no_rewards=No pending rewards

---

Tips

1. Check regularly - Rewards don’t expire but clutter the list
2. Free up inventory space - Before collecting item rewards
3. Use Collect All - Faster for many rewards
4. Read lootbag contents - Check chat after opening

---

Troubleshooting

Rewards Not Appearing

1. Achievement may not have completed
2. Check if reward type is supported
3. Restart client if UI is stuck

Cannot Collect Items

1. Check inventory space
2. Try collecting one at a time
3. Check server logs for errors

Lootbag Shows Empty

1. Verify lootbag ID in achievement
2. Check lootbags.json configuration
3. Ensure lootbag has items or pool defined