Commands — The Donut Butler

Giveaways

/gcreate

Create a standard giveaway. A modal opens asking for prize, sponsor, description, number of winners, and duration. Supports timed endings (e.g. 10m, 2h, 1d) or manual end via /gend.

Example: /gcreate → fill modal

/gcreatesos

Create a Split or Steal giveaway. Two winners are selected, then each secretly chooses to Split (share the prize equally) or Steal (take it all). If both steal, nobody wins.

Example: /gcreatesos → fill modal

/gcreatenumbergame

Create a number guessing giveaway. Set a range (e.g. 1–100) and the first person to type the correct number in chat wins. The channel locks once someone guesses correctly.

Example: /gcreatenumbergame → fill modal

/gcreatedork

Create a Double or Keep giveaway. Each round a winner is picked — they can double the prize and risk it again, or keep it and end the giveaway. Configure max doubles and prechoose mode.

Example: /gcreatedork → fill modal

/gend

Instantly end an active giveaway and declare winners. Shows a dropdown of all currently active giveaways to select from. Works on all giveaway types.

Example: /gend → select giveaway

/greroll <message_id>

Reroll winners for an already-ended giveaway. For Double or Keep giveaways, this restarts all rounds from scratch with the original entry pool. SoS giveaways cannot be rerolled.

Example: /greroll message_id:1234567890

DonutSMP

/d-baltop

Show the DonutSMP money leaderboard. Displays 10 players per page with Back and Next buttons to navigate. Values shown in shorthand (1M, 2.5B etc).

Example: /d-baltop

/d-leaderboard <type>

Show any DonutSMP leaderboard. Choose from: Money, Kills, Deaths, Mobs Killed, Blocks Broken, Blocks Placed, Playtime, Shards, Sell Earnings, or Shop Spending.

Example: /d-leaderboard type:kills

/d-stats <ign>

Show a DonutSMP player's full stats: money, shards, playtime, kills, deaths, mobs killed, blocks broken and placed, /sell earnings, and /shop spending.

Example: /d-stats ign:Notch

/d-ah <item>

Search the DonutSMP Auction House by item name. Supports partial matching (e.g. "ely" finds elytra). Optional sort: Lowest Price, Highest Price, Recently Listed, Last Listed. Shows 8 listings per page.

Example: /d-ah item:elytra sort:Lowest Price

/d-findplayer <ign>

Look up a DonutSMP player's current rank and in-game location.

Example: /d-findplayer ign:Notch

/d-spawnercalc <spawners> <bone_price>

Calculate income from skeleton spawners. Enter the number of spawners and the price per bone (supports shorthand: 5k, 200). Shows bones/min, income per minute, per hour, and per 24 hours.

Example: /d-spawnercalc total_spawners:100 bone_price:5k

Spawner Market

/spawnermarketcreate

Post the spawner price embed in a specified channel. The embed auto-updates whenever prices or the ticket link change.

Example: /spawnermarketcreate channel:#spawner-prices

/setspawnerprices

Update the spawner buy and sell prices. Supports shorthand amounts (3m, 500k, 1.5b). Automatically refreshes the live embed.

Example: /setspawnerprices sell_price:3m buy_price:5m

/setspawnerticket

Set the ticket channel link displayed at the bottom of the spawner market embed. Updates the embed immediately.

Example: /setspawnerticket channel:#tickets

/spawnercalc

Opens a modal calculator. Enter a spawner count and whether you're buying or selling, and get the total cost broken down by full stack (64) and half stack (32).

Example: /spawnercalc → fill modal

Sponsors

/sponsorlb

Display the top-10 sponsor leaderboard. If a leaderboard message already exists in the channel it will be refreshed rather than posting a new one.

Example: /sponsorlb

/sponsorlbadd <user> <amount>

Add sponsor points to a user. Supports shorthand amounts (50k, 10m, 1.5b). Requires administrator permission or the configured sponsor role.

Example: /sponsorlbadd user:@Fudgedy amount:50m

/sponsorlbremove <user> <amount>

Remove sponsor points from a user. Points cannot go below zero. Requires administrator or the configured sponsor role.

Example: /sponsorlbremove user:@Fudgedy amount:10m

/sponsorrole <role>

Set which role can manage sponsor points. Admins can always manage regardless. Leave blank to restrict to admins only.

Example: /sponsorrole role:@Staff

Moderation

/lock

Lock the current channel — removes @everyone's ability to send messages. Records that the channel has been locked so /unlock works correctly.

Example: /lock

/unlock

Unlock the current channel and restore @everyone's send permissions. Only works if /lock has been used in this channel before.

Example: /unlock

/pingrule add

Create a protected ping rule. Specify a source role or user that is not allowed to ping a specific target role or user. Violations result in message deletion and escalating timeouts.

Example: /pingrule add source_role:@Members target_role:@Staff

/pingrule remove <rule_id>

Remove a ping protection rule by its ID. Use /pingrule list to view rule IDs.

Example: /pingrule remove rule_id:a1b2c3d4

/pingrule list

List all active ping protection rules for this server, showing rule IDs, sources, and targets.

Example: /pingrule list

/pinglogchannel <channel>

Set the channel where ping violations are logged. Each log shows who pinged, who was pinged, the original message content, and the timeout applied.

Example: /pinglogchannel channel:#mod-logs

/pingwarnings

Toggle the public warning message sent in channel when someone is timed out for a protected ping. Timeouts are still applied regardless of this setting.

Example: /pingwarnings

Utility

/embedcreate

Create and send a custom embed message in the current channel. Opens a modal with fields for title, description, footer, image URL, and hex colour.

Example: /embedcreate → fill modal

/rng <a> <b>

Generate a random number between a and b. Both values support shorthand (10k, 50m, 2b). Maximum value is 10 billion.

Example: /rng a:1 b:100

/help

Show all bot commands with descriptions and examples, organised by category. Use the search parameter to filter by command name or category keyword.

Example: /help search:giveaway