Shop System

Each currency in XenoTokens can expose its own GUI shop through currencies/<id>/gui.yml.

What the shop can do

• open a dedicated GUI title per currency
• use multiple pages
• define navigation buttons, filler items, and close buttons
• play open, success, failure, and click sounds
• reward direct Bukkit items
• run console commands or player commands as rewards

Entry structure

Each shop item usually defines:

• price
• slot or slots
• display item
• reward item or reward commands
• optional reason
• optional sounds

The display item and the reward item can be different. That makes it possible to show a polished icon while giving something else behind the scenes.

Supported item customization

The loader supports a broad item surface, including:

• enchantments
• custom model data
• potion data and custom effects
• leather armor color
• player heads with owner or texture
• glow, unbreakable, and item flags
• books and basic meta fields

Useful runtime placeholders

The shop service can inject values such as:

• {player}
• {currency_id}
• {currency_name}
• {currency_symbol}
• {balance}
• {price}
• {token_system}
• {token_range}

These are especially useful in lore, reward reasons, and shop reward commands.