Role-Based Rewards System
Configure Discord roles to provide loyalty bonuses to your community members.
Effect Types
| Effect | Description | Example |
|---|---|---|
| Multiplier | Multiply base rewards | 1.5x = 50% bonus LTZ |
| Flat Bonus | Add fixed amount to rewards | +10 LTZ per claim |
| Cooldown Reduction | Reduce wait times | 25% faster daily reset |
| Event Access | Unlock exclusive events | VIP-only drops |
| One-Time Bonus | Grant bonus on role assignment | 100 LTZ welcome gift |
Configuration Commands
View Role Bonuses
/config role-bonus
Set Multiplier
/config role-bonus role:@VIP multiplier:1.5
Range: 1.0 to 5.0
- 1.0 = No bonus (100%)
- 1.5 = 50% bonus (150%)
- 2.0 = Double rewards (200%)
Set Flat Bonus
/config role-bonus role:@Whale flat-bonus:25
Range: 0 to 1,000 LTZ
Adds fixed amount to every reward claim.
Set Both Effects
/config role-bonus role:@Booster multiplier:2.0 flat-bonus:10
Remove Role Bonus
/config role-bonus clear:@OldRole
Stacking Modes
When users have multiple roles with bonuses, effects combine based on stacking mode.
Configure Stacking
/config stacking MODE
Available Modes
| Mode | How It Works | Example |
|---|---|---|
| Multiplicative | Effects multiply together | 1.5x × 1.2x = 1.8x |
| Additive | Effects add together | +50% + 20% = +70% |
| Highest Only | Only best effect applies | 1.5x wins over 1.2x |
Calculation Examples
User has @VIP (1.5x) and @Booster (1.2x), base reward 100 LTZ:
| Mode | Calculation | Result |
|---|---|---|
| Multiplicative | 100 × 1.5 × 1.2 | 180 LTZ |
| Additive | 100 × (1 + 0.5 + 0.2) | 170 LTZ |
| Highest | 100 × 1.5 | 150 LTZ |
Partner Portal Configuration
Access
Integrations → Channels → Discord → Role Configuration
Settings Per Role
- Effect Type: Multiplier, flat bonus, cooldown reduction, etc.
- Effect Value: The bonus amount
- Priority: Higher = applied first
- Assignment Method:
- Manual (admin assigns)
- Balance threshold (auto-assign at LTZ amount)
- Purchase (user buys with LTZ)
Common Role Configurations
Tiered Membership
| Role | Requirement | Effect |
|---|---|---|
| Bronze | 500 LTZ earned | 1.1x multiplier |
| Silver | 2,500 LTZ earned | 1.25x multiplier |
| Gold | 10,000 LTZ earned | 1.5x multiplier |
| Platinum | 50,000 LTZ earned | 2.0x multiplier |
Server Booster Rewards
/config role-bonus role:@Server Booster multiplier:2.0 flat-bonus:10
Boosters get double rewards plus 10 LTZ on every claim.
VIP Perks
/config role-bonus role:@VIP multiplier:1.5
VIP members get 50% bonus on all rewards.
Auto-Assignment
Roles can be automatically assigned based on LTZ balance.
Configure in Partner Portal
Integrations → Discord → Role Configuration → Assignment Method
Set "Balance Threshold" and specify the LTZ amount.
Example Thresholds
| Role | Threshold |
|---|---|
| Active Member | 100 LTZ |
| Regular | 1,000 LTZ |
| Veteran | 5,000 LTZ |
| Whale | 25,000 LTZ |
Role Purchase
Allow users to purchase roles with their LTZ.
Setup
- Create a perk linked to the role in Partner Portal
- Set the price in LTZ
- Users purchase via
/buy-role
Example
/perk create name:"VIP Access" price:5000 category:access
Users can then:
/buy-role role:@VIP
Best Practices
Balance Your Bonuses
- Don't go too high: 5x multiplier makes other activities meaningless
- Gradual progression: 1.1x → 1.25x → 1.5x → 2.0x
- Mix effects: Combine multipliers with flat bonuses for variety
Consider Your Community
| Community Type | Recommended Approach |
|---|---|
| Casual | Lower multipliers (1.1x-1.25x) |
| Competitive | Higher multipliers (1.5x-2.0x) |
| E-commerce | Flat bonuses work well |
| Gaming | Tiered progression |
Stacking Mode Selection
- Multiplicative: For whale-friendly programs
- Additive: For balanced progression
- Highest: For simpler programs
Troubleshooting
"Role bonus isn't applying"
- Check role is configured:
/config role-bonus - Verify user has the role
- Check stacking mode settings
- Ensure bot role is higher than configured roles
"Bot can't manage roles"
- Verify "Manage Roles" permission
- Ensure bot role is above target roles in the hierarchy
- Run
/config sync-rolesto refresh
"Auto-assignment not working"
- Verify threshold is set correctly in Partner Portal
- Check bot has "Manage Roles" permission
- Confirm balance threshold is set (not manual assignment)