Common Workflows

This page covers common workflows you'll encounter as a raffle host.

Running a Complete Main Raffle

Step 1: Create the Raffle

/startmain item:Karambit Fade price:100 slots:50 payment_recipient:@YourName

Frank creates the thread and pings users.

Step 2: Monitor Claims

Users claim tickets by typing numbers in the thread. The embed updates automatically.

Step 3: Track Payments

As users pay you:

p @Alice 5
p @Bob 1 2 3

Step 4: Raffle Fills

When all tickets are claimed:

1. Frank posts the payment summary
2. Frank posts the listing embed
3. Use ProBot to pick a winner
4. Winner is announced

Step 5: Close and Clean Up

After the winner is announced:

/close

Later, clean up old raffles:

/clean

Setting Up Linked Mini Raffles

Step 1: Create the Main Raffle First

/startmain item:Karambit Fade price:100 slots:50 payment_recipient:@Host

Step 2: Calculate Available Slots

Check the main raffle embed:

• Total slots: 50
• Claimed: 20
• Already reserved: 0
• Available for mini: 30

Step 3: Create the Mini

/startmini item:Karambit Fade price:0 slots:20 winner_count:2 tickets_to_reserve:3 linked_main_raffle:Karambit Fade

This reserves 6 tickets (2 winners × 3 each).

Step 4: Mini Completes

When the mini fills:

1. Winner(s) selected
2. They're pinged in the main raffle
3. They have 2 minutes to choose tickets

Step 5: Monitor Winner Claims

If winner is active:

🎵 Mini winner has claimed their tickets.

If winner is AFK, manually assign:

/assign member:@Winner ticket_number:5 ticket_number2:10 ticket_number3:15 mini_win:Y

Handling Mistakes

User Claimed Wrong Tickets

1. Clear the mistaken tickets:

/clear ticket_number:5 ticket_number2:10

2. Tell the user to claim the correct tickets

3. If needed, manually assign:

/assign member:@User ticket_number:12

Wrong Winner Selected in Mini

1. Clear the wrongly assigned tickets:

/clear ticket_number:5 ticket_number2:10 ticket_number3:15

2. Assign to the correct winner as mini-win:

/assign member:@CorrectWinner ticket_number:5 ticket_number2:10 ticket_number3:15 mini_win:Y

3. Explain the situation to users in the thread

Created Wrong Mini

1. Cancel the mini immediately:

/cancelmini

2. Reservations are released back to main

3. Create the correct mini:

/startmini item:... (correct parameters)

Set Wrong Price

1. Change the price:

/changeprice new_price:100

2. Announce the correction in the thread

Need More Tickets

1. Add more tickets:

/addtickets count:10

2. New tickets are immediately available

Reopening and Modifying Raffles

Closed by Mistake

1. Reopen the raffle:

/reopen

2. Announce that claiming is available again

Need to Add Tickets to Closed Raffle

1. First reopen:

/reopen

2. Then add tickets:

/addtickets count:5

Changing Price on Closed Raffle

1. First reopen:

/reopen

2. Then change price:

/changeprice new_price:75

Managing AFK Status

Going AFK

Before you step away:

/afk

You'll stop receiving raffle pings. If a raffle completes while you're AFK, Frank posts a special message listing all winners.

Coming Back

When you return:

/back

Normal pings resume.

End-of-Day Cleanup

Close Active Raffles

For each unfinished raffle you want to pause:

/close

Clean Up Completed Raffles

Remove old raffles from bot memory:

/clean

This keeps the bot running efficiently.

Manual Intervention for Final Mini

When a raffle enters final mini mode and winners need help:

Step 1: Check Who Needs Tickets

Look at the timer embed to see remaining winners and their allocations.

Step 2: Manually Assign

For each AFK winner:

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

Assign the number of tickets they were allocated.

Step 3: Verify Completion

Once all mini winners have their tickets, the raffle should complete normally.

Quick Reference