Skip to main content

Common Questions

Answers to frequently asked questions from Discord community admins.

Rewards & Earning​

"Why didn't my user get rewarded?"​

Check these common causes:

  1. Event is disabled

    /config events

    Look for your event - is it enabled?

  2. User is disabled

    /config user status:@user

  3. Cooldown hasn't passed

    • Check the event's cooldown setting
    • User may need to wait

  4. Max claims reached

    • Check if user hit their claim limit
    • Check if event hit total claim limit

  5. Channel is excluded

    /config channels

    Is the channel in the exclude list?

  6. Test mode is on

    /config test-mode

    Only testers get rewards in test mode

  7. Brand out of LTZ

    • Check Partner Portal for balance

"How do I change reward amounts?"​

Quick method:

/config reward daily_checkin 25

Full method:

/config events action:edit name:daily_checkin reward:25

"Can users earn in DMs?"​

Only these commands work in DMs:

  • /balance
  • /link
  • /help

All earning requires server context.

Configuration​

"How do I enable/disable an event?"​

/config events action:toggle name:event_name

Or explicitly:

/config events action:toggle name:event_name enabled:false

"How do I create a new event?"​

/config events action:create name:my_event reward:50 cooldown:24 max-claims:1

"How do I let moderators use admin commands?"​

/config admin-roles role:@Moderator level:event_manager

Permission levels:

  • viewer - View only
  • perk_manager - Manage perks
  • event_manager - Manage events and drops
  • full_admin - Everything

"How do I set up notifications for rewards?"​

/config admin-channel channel:#admin-logs

Drops​

"How do I create a drop?"​

Button drop:

/drop event_id:my_event label:"Claim!"

Reaction drop on existing message:

/drop event_id:my_event type:reaction message_id:123456789 emoji:🎉

"Why can't users claim my drop?"​

  1. Drop expired - Check the lifespan
  2. Max claims reached - First N users got it
  3. Event disabled - Enable the event
  4. User already claimed - Each user can only claim once

"How do I make a drop permanent?"​

/drop event_id:my_event lifespan:permanent

Streaks​

"How do streaks work?"​

  1. User does /daily each day
  2. Consecutive days build streak counter
  3. Higher streaks = higher multipliers
  4. Missing a day resets streak (unless grace period applies)

"Can I change the grace period?"​

/config streaks grace-period:48   # 48 hours instead of 24

Range: 1-72 hours

"What are the streak multipliers?"​

Streak DaysMultiplier
3+ days1.1x
7+ days1.25x
14+ days1.5x
30+ days2.0x

Roles & Multipliers​

"How do role bonuses work?"​

Users with configured roles get bonus LTZ on all rewards:

/config role-bonus role:@VIP multiplier:1.5   # 50% bonus
/config role-bonus role:@Whale flat-bonus:25  # +25 LTZ per reward

"What if a user has multiple bonus roles?"​

Depends on stacking mode:

  • Multiplicative: Bonuses multiply (1.5 × 1.2 = 1.8x)
  • Additive: Bonuses add (+50% + 20% = +70%)
  • Highest: Only best bonus applies

Set with:

/config stacking multiplicative

Third-Party Bots​

"How do I reward Mee6 level-ups?"​

/config third-party enable:mee6

Then optionally adjust reward:

/config third-party reward:mee6 amount:50

"Which bots are supported?"​

Mee6, Arcane, Tatsu, Carl-bot, Lurkr, Dyno, AmariBot, ProBot, UnbelievaBoat, Zira, YAGPDB, and more.

View all:

/config third-party

Troubleshooting​

"Bot isn't responding to commands"​

  1. Check bot is online (green status)
  2. Run /setup check for permission audit
  3. Verify bot role is high enough in role list
  4. Check channel permissions

"Stats aren't updating"​

  1. Allow time for data aggregation
  2. Check if test mode is filtering data
  3. Verify audit logging works: /audit

"/setup failed"​

  1. Verify Brand ID is correct (42 chars, starts with 0x)
  2. Check you have Partner Portal subscription
  3. Ensure brand has LTZ balance

"Third-party bot rewards not working"​

  1. Verify integration is enabled: /config third-party
  2. Check Loyalteez bot can see the third-party bot's messages
  3. Ensure channel isn't excluded

Analytics​

"How do I see who's most active?"​

/leaderboard metric:ltz_earned period:weekly

"How do I find inactive users?"​

/segments view segment:at_risk      # Inactive 7+ days
/segments view segment:dormant      # Inactive 30+ days

"How do I export data?"​

/export type:rewards period:month
/export type:users
/audit export:true

Still Need Help?​

  • Run /test all for diagnostics
  • Check /audit for recent activity
  • Review the Troubleshooting Guide
  • Contact support via Partner Portal
Last updated on