Dicebot logoDicebot

Commands

Setup and utility commands. Examples use the default ! prefix - substitute your server's if you've changed it. Command names are case-insensitive.

Server & channel setup

These need the Discord Manage Server permission (except channelinfo, which anyone can use). They work in any channel, active or not - otherwise you couldn't turn a channel on!

!setchannel <property> [value]

Aliases: channel, sc. Sets a per-channel option. The value defaults to on if omitted; accepted values are on/true/yes and off/false/no.

PropertyEffect
active The master switch. Dice rolling, choose, coin, and the character generator only work in channels where this is on. Off by default - a freshly invited Dicebot does nothing until you run !setchannel active on.
bang Every roll in this channel explodes, as if it ended in !. About exploding dice →
sorted Every roll in this channel is sorted, as if it ended in s.
shortoutput Compact one-line results instead of the full write-up. Output styles →
!setchannel active on
!sc shortoutput yes
!sc sorted off

!clearchannel <property>

Aliases: cchannel, cc. Shorthand for turning one of the properties above off: !cc bang.

!channelinfo

Alias: ci. Anyone can use it. Replies with an embed showing the current channel's settings: Active, Default Bang, Default Sorted, and Short Output.

!setprefix <character>

Aliases: prefix, sp. Changes the server's command prefix - a single character. !setprefix ; makes it ;2d6 from then on.

!setDiceMode <mode>

Aliases: dicemode, sdm, dm. Controls how eagerly messages are scanned for dice, server-wide. The four modes - OnlyPrefixed (default), PrefixOptional, OffsetOptional, and CatchAll - are explained on the dice page.

Utility

These require the channel to be active.

!choose <options>

Alias: pick. Picks one option for you. If your list contains a comma it's split on commas, otherwise on spaces:

!choose pizza, fish and chips, curry
!pick red blue green

Reply: I choose curry!

!coin [count]

Aliases: flip, toss. Flips one coin, or several: !coin 7. For more than five flips you get a heads/tails tally up front. Like dice, an absurd count that would overflow Discord's message limit is politely refused.

!help

Alias: website. Links you right back here. Works in any channel, active or not.