Skip to main content

Discord Troubleshooting

Solutions to common Discord bot issues.

Bot Not Responding​

Symptoms​

  • Bot doesn't respond to commands
  • Commands show "Application did not respond"
  • Bot appears offline

Solutions​

  1. Check bot status

  2. Run permission audit

    /setup check

  3. Verify bot role hierarchy

    • Bot role must be above managed roles
    • Check Server Settings → Roles

  4. Check channel permissions

    • Bot needs Send Messages, Read Messages
    • Check channel-specific overrides

  5. Re-run setup if needed

    /setup connect brand_id:YOUR_BRAND_ID security_key:YOUR_SECURITY_KEY

Rewards Not Processing​

Symptoms​

  • Users run commands but don't receive LTZ
  • Events fire but balance doesn't change
  • "Reward failed" messages

Solutions​

  1. Check event is enabled

    /config events

    Look for the event - is it enabled?

  2. Check user status

    /config user status:@user

    User might be disabled

  3. Check test mode

    /config test-mode

    Test mode only rewards testers/admins

  4. Check channel exclusions

    /config channels

    Channel might be excluded

  5. Check cooldown

    • User might need to wait
    • Check event's cooldown setting

  6. Check claim limits

    • User might have hit max claims
    • Check max-claims setting

  7. Review audit log

    /audit user:@user

  8. Verify brand has LTZ balance

    • Check Partner Portal for brand balance
    • Fund your brand wallet if empty

Role Effects Not Applying​

Symptoms​

  • Role bonuses not added to rewards
  • Multipliers not working
  • Users with roles getting base rewards

Solutions​

  1. Verify Manage Roles permission

    • Bot needs this permission
    • Run /setup check

  2. Check role hierarchy

    • Bot role must be ABOVE target roles
    • Adjust in Server Settings → Roles

  3. Refresh role sync

    /config sync-roles

  4. Verify role configuration

    /config role-bonus

  5. Check stacking mode

    /config stacking

Stats Not Updating​

Symptoms​

  • /stats shows old data
  • Leaderboards not current
  • Export shows missing data

Solutions​

  1. Allow time for aggregation

    • Stats may take a few minutes to update
    • KPI snapshots run at midnight UTC

  2. Check test mode filtering

    • Test mode activities don't count toward stats
    /config test-mode

  3. Verify audit logging

    /audit
    • If recent activity shows, logging is working

Third-Party Bots Not Detecting​

Symptoms​

  • Mee6/Arcane level-ups not rewarding
  • Integration shows enabled but not working

Solutions​

  1. Verify integration is enabled

    /config third-party

  2. Check channel permissions

    • Loyalteez must see third-party bot messages
    • Check channel permissions

  3. Verify correct bot

    • Some bots have multiple versions
    • Ensure you enabled the right one

  4. Check event exists

    /config events
    • Look for mee6_level_up or similar

Server Not Showing in Partner Portal​

Symptoms​

  • Connected server not appearing in Partner Portal
  • Can't configure from web interface

Solutions​

  1. Verify setup completed

    /setup check

  2. Check Brand ID and Security Key were correct

    • Brand ID: 42 characters, starts with 0x
    • Security Key: 64 character hex string
    • Run /setup connect brand_id:... security_key:... again if needed

  3. Check Supabase

    • Look in discord_server_configs table
    • Verify server_id and brand_id match

  4. Verify RLS policies

    • Brand must have permission to read data
    • Check Supabase RLS configuration

Drops Not Working​

Symptoms​

  • Users can't claim drops
  • Reaction drops not detecting reactions
  • "Drop not found" errors

Solutions​

  1. Check drop hasn't expired

    • Review lifespan setting
    • Create new drop if expired

  2. Check max claims

    • Drop might have hit claim limit

  3. Verify event is enabled

    /config events

  4. Check correct emoji (for reaction drops)

    • Must use exact emoji specified

  5. Verify message exists (for reaction drops)

    • Message might have been deleted

Setup Failed​

Symptoms​

  • /setup connect errors
  • "Brand not found" messages
  • Connection failures

Solutions​

  1. Verify Brand ID format

    • Must be 42 characters
    • Must start with 0x
    • Find in Partner Portal → Settings → Account

  2. Check Partner Portal subscription

    • Ensure you have an active subscription

  3. Verify brand has LTZ balance

    • Brand wallet needs funds for rewards

  4. Check bot permissions

    • Run /setup check for permission audit

Diagnostic Commands​

Use these to troubleshoot:

/test all            # Full diagnostic suite
/test connectivity   # Service connection test
/test permissions    # Bot permission check
/test config         # Configuration validation
/test reward event:EVENT  # Dry-run reward test
/test report         # Generate shareable report

Getting Help​

  1. Run diagnostics first

    /test report

  2. Export relevant data

    /audit export:true
    /export type:config

  3. Contact support

Last updated on