Troubleshooting

Common Error Messages

Raffle Creation Errors

Mini Raffle Errors

Ticket Management Errors

Raffle State Errors

Permission Issues

"You don't have permission to use this command"

Check your roles:

• Most commands require Manage Channels permission
• /close, /afk, /back require Unity Host or Staff role

"Command not found"

If commands don't appear in Discord:

1. Ask an admin to run python sync_commands.py
2. Wait 5-10 minutes for Discord to sync
3. Try restarting your Discord client

Mini Raffle Issues

Winners Not Claiming

If a mini winner is AFK and not claiming their tickets:

1. Wait for the timer to expire (2 min individual, 3 min final)
2. Frank will auto-assign random tickets
3. Or manually assign using:

/assign member:@Winner ticket_number:X mini_win:Y

Mini Won't Link to Main

Check that:

• Main raffle name matches exactly (use autocomplete)
• Main raffle is active (not closed)
• Main has enough free slots for reservations
• Main is not already in final mini mode

Reservations Not Releasing

If you cancelled a mini but slots aren't freed:

1. The /cancelmini command should release them automatically
2. Check the main raffle embed for updated availability
3. If stuck, contact an admin to check bot logs

Timer Issues

Mini Winner Timer Expired Too Fast

• Individual timers are 2 minutes
• Final mini mode timer is 3 minutes
• Timers start when the winner is announced
• Use /assign mini_win:Y to manually assign if needed

Timer Didn't Start

This can happen if:

• The bot restarted during the timer
• There was a connection issue

Solution: Manually assign the tickets:

/assign member:@Winner ticket_number:X ticket_number2:Y mini_win:Y

Display Issues

Embed Not Updating

If the raffle embed seems stuck:

1. Wait a few seconds—Discord can be slow
2. Scroll up/down to force a refresh
3. Check if the bot is online
4. The changes are saved even if display is delayed

Payment Not Showing

If you marked a ticket as paid but 💰 isn't showing:

1. Verify you used the correct ticket number
2. Confirm the user owns that ticket
3. Check for typos in the username
4. Try scrolling the embed to refresh

Best Practices Checklist

Before Creating Raffles

• Verify you have the required permissions
• Plan the number of slots appropriately
• Have an image URL ready (optional but recommended)
• Know who will receive payments

During Active Raffles

• Monitor the thread for user claims
• Mark payments promptly when received
• Keep track of split ticket payments
• Be available for mini winner claiming windows

For Mini Raffles

• Calculate required slots before creating
• Verify main raffle has enough availability
• Monitor winner timers
• Be ready to manually assign if winners are AFK

Raffle Completion

• Review the payment summary for accuracy
• Follow up with users who haven't paid
• Announce the winner clearly
• Close the raffle when complete

Regular Maintenance

• Run /clean periodically to free memory
• Use /afk when stepping away
• Use /back when returning

Getting More Help

If you encounter an issue not covered here:

1. Check the other documentation pages
2. Look for the specific error message in this guide
3. Ask other hosts in your server
4. Contact server administrators

Information to Provide When Asking for Help

• The exact error message
• What command you were trying to use
• What you expected to happen
• Screenshots of the raffle embed if relevant