Commands

Managing Raffles

Commands for managing active raffles

/close

Manually close a raffle to stop accepting new claims.

Syntax

/close

Run this command inside the raffle thread.

What Happens

Raffle is marked as closed
No more ticket claims are accepted
Ping service stops
Thread remains open for host operations
Can be reopened with /reopen

Notes

Does NOT select a winner (use ProBot for that)
Does NOT lock or archive the thread
Host can still manage tickets after closing
Requires Unity Host or Staff role

/reopen

Reopen a closed raffle to accept claims again.

Syntax

/reopen

Run this command inside the closed raffle thread.

What Happens

Raffle is marked as active
Users can claim tickets again
Ping service restarts (if applicable)

Error Messages

Error	Cause
"This raffle is not closed"	Raffle is already open
"Cannot reopen a completed and archived raffle"	Raffle has been finalized

/addtickets

Add more tickets to an existing raffle.

Syntax

/addtickets count:<number>

Parameters

Parameter	Required	Description
`count`	Yes	Number of tickets to add (1-100)

Examples

/addtickets count:5

Result: If raffle had tickets #1-#10, it now has #1-#15.

What Happens

New tickets are added sequentially after existing ones
Raffle embed updates to show new tickets
New tickets are immediately available for claiming

Limits

Minimum per command: 1 ticket
Maximum per command: 100 tickets
Maximum total tickets per raffle: 500

Error Messages

Error	Cause
"This command can only be used in threads"	Not in a raffle thread
"This thread is not a tracked raffle"	Thread is not a valid raffle
"Cannot add tickets to an archived raffle"	Use `/reopen` first
"Cannot exceed 500 total tickets"	At maximum capacity
"Between 1 and 100 tickets"	Invalid count

/changeprice

Change the ticket price for an existing raffle.

Syntax

/changeprice new_price:<number>

Parameters

Parameter	Required	Description
`new_price`	Yes	New price per ticket (0 for free)

Examples

Change to higher price:

/changeprice new_price:100

Make raffle free:

/changeprice new_price:0

What Happens

Ticket price is updated
Raffle embed refreshes with new price
Display changes between "Payment to" and "Sponsored by" as appropriate

Important Notes

Price change affects all unclaimed tickets
Does NOT change what already-claimed users owe
Changing to 0 displays "FREE" instead of "0c"
Cannot be used on archived raffles

Error Messages

Error	Cause
"Price must be greater than or equal to 0"	Negative price
"Cannot change price of an archived raffle"	Use `/reopen` first

/cancelmini

Cancel a mini raffle and release its reservations in the main raffle.

Syntax

/cancelmini

Run this command inside the mini raffle thread.

What Happens

Mini raffle is cancelled
Reserved tickets are released back to the main raffle
Mini thread is closed and archived
Message posted in main raffle if reservations were released

Use Cases

Created mini by mistake
Main raffle filling faster than expected
Need to free up slots for regular users

/clean

Remove completed raffles from bot memory.

Syntax

/clean

What Happens

Scans all raffles in memory
Identifies completed and archived raffles
Removes them from active tracking
Reports count of cleaned raffles

When to Use

Bot memory usage is high
Many old raffles accumulating
Regular maintenance (weekly/monthly)

Note

This does NOT delete Discord threads—it only removes raffles from the bot's active memory.

Creating Raffles

Commands for creating main and mini raffles

Ticket Management

Commands for managing ticket ownership and payments