Recipes

Working custom command examples you can copy, run, and adapt.

Every recipe below is a single ;cc set line. Paste it, then run ;cc preview (name) before letting the server loose on it.

1. Greeting with a fallback

Create it

;cc set greet (member) [message...] -- Hello {member}! {message|Welcome to the server.}

With a message

;greet @wanderer how is it going?

Hello @wanderer! how is it going?

Without one

;greet @wanderer

Hello @wanderer! Welcome to the server.

2. Coin flip

;cc set coinflip -- {choose:heads|tails}

;coinflip

tails

3. Reusing a random result

Save the roll under a name so the conditional sees the same value the text shows.

;cc set flip -- You flipped **{choice:result:heads|tails}**! That's {if:{result}==heads}lucky{else}unlucky{endif}.

;flip

You flipped heads! That’s lucky.

4. Dice with fixed sizes

{range} needs literal numbers, so branch on the argument instead of interpolating it.

;cc set roll (sides) -- {if:{sides}==6}You rolled a {range:1-6}.{elseif:{sides}==20}You rolled a {range:1-20}.{else}Only d6 and d20 are supported.{endif}

;roll 20

You rolled a 14.

5. Balance check

;cc set bal -- {user.mention} — wallet {econ.wallet}, bank {econ.bank}, net worth {econ.networth}.

;bal

@you — wallet 1,200 coins, bank 300 coins, net worth 1,500 coins.

Add a threshold with the raw number:

;cc set rich -- {if:{econ.raw_bal}>=10000}You're loaded.{else}Keep grinding.{endif}

6. Staff warn with the case number

Requires Manage Messages to create and to run.

;cc set staffwarn (target) [reason...] -- {mod:warn {target} && {reason|No reason given}}Warned {punishment.user.mention} — case #{punishment.case_id}.

;staffwarn @wanderer being spammy

Warned @wanderer — case #104.

Lock it to your mod role so the free-form reason can only be abused by people you trust:

;cc allow staffwarn @Moderator

7. Notes that read back what you saved

Inline {db.*} tags run in order, so the read sees the write from the same response.

Save a note

;cc set note (text...) -- {db.set:notes:{user.id}:{text}}Saved. Your note is now: {db.get:notes:{user.id}}

;note buy some milk

Saved. Your note is now: buy some milk

Read it later

;cc set mynote -- Your note: {db.get:notes:{user.id}}

A key that was never set prints nothing, so keep the surrounding wording forgiving. Database tags resolve after conditionals, so they cannot be tested inside an {if:...}.

Clear it

;cc set clearnote -- {db.delete:notes:{user.id}}Note cleared.

8. A counter

;cc set strike (member) -- {target.mention} now has {db.inc:strikes:{target.id}} strike(s).

;strike @wanderer

@wanderer now has 3 strike(s).

9. Role-gated text in one command

;cc set secret -- {if:user has role @Staff}Door code is 4821.{else}Nothing to see here.{endif}

10. Embed panel with link buttons

;cc set links -- {title: Useful links}{description: Everything in one place.}{color: #7B68EE}{button: Website && link && https://example.com}{button: Support && link && https://example.com/support}

11. Self-serve role buttons

;cc set roles -- {title: Pick your roles}{description: Click to toggle.}{button: Gamer && primary && action=role{id: 123456789012345678}}{button: Artist && primary && action=role{id: 234567890123456789}}

Replace the IDs with your own role IDs.

12. Anonymous confession

Deletes the trigger, says nothing in the current channel, and posts the text somewhere else.

;cc set confess (text...) -- {delete}{silent}{respond: #confessions}Anonymous: {text}

;confess I actually like pineapple pizza

The invoking message disappears; #confessions gets Anonymous: I actually like pineapple pizza.

13. Rate-limited daily tip

;cc set tip -- {cooldown: 24h}Today's tip: {choose:read #rules|say hi in #general|check #events}

Running it twice replies with the seconds remaining instead.

14. Quick poll

;cc set poll (question...) -- **{question}**{react: 👍}{react: 👎}

raze posts the question and reacts to its own message with both options.

15. Self-serve role, no buttons needed

;cc set pings -- {add_role: 123456789012345678}You'll now get event pings.

Anyone who can run this gets the role. Restrict it if that isn’t intended.

16. Private reply

;cc set code -- {delete}{dm}The current door code is 4821.

The request vanishes from the channel and the answer arrives in DMs.

17. A multi-page guide

;cc set guide -- {title: 1. Read the rules}{description: Start in #rules.}{page}{title: 2. Get roles}{description: Head to #roles.}{page}{title: 3. Say hi}{description: Introduce yourself in #general.}

Navigation buttons appear automatically and stay live for 48 hours.

Get Started

Security

Server Configuration

Economy

Miscellaneous

Integrations

Resources

Recipes

Recipes

1. Greeting with a fallback

2. Coin flip

3. Reusing a random result

4. Dice with fixed sizes

5. Balance check

6. Staff warn with the case number

7. Notes that read back what you saved

8. A counter

9. Role-gated text in one command

10. Embed panel with link buttons

11. Self-serve role buttons

12. Anonymous confession

13. Rate-limited daily tip

14. Quick poll

15. Self-serve role, no buttons needed

16. Private reply

17. A multi-page guide

​Recipes

​1. Greeting with a fallback

​2. Coin flip

​3. Reusing a random result

​4. Dice with fixed sizes

​5. Balance check

​6. Staff warn with the case number

​7. Notes that read back what you saved

​8. A counter

​9. Role-gated text in one command

​10. Embed panel with link buttons

​11. Self-serve role buttons

​12. Anonymous confession

​13. Rate-limited daily tip

​14. Quick poll

​15. Self-serve role, no buttons needed

​16. Private reply

​17. A multi-page guide

Recipes

1. Greeting with a fallback

2. Coin flip

3. Reusing a random result

4. Dice with fixed sizes

5. Balance check

6. Staff warn with the case number

7. Notes that read back what you saved

8. A counter

9. Role-gated text in one command

10. Embed panel with link buttons

11. Self-serve role buttons

12. Anonymous confession

13. Rate-limited daily tip

14. Quick poll

15. Self-serve role, no buttons needed

16. Private reply

17. A multi-page guide