Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/onesoft-sudo/sudobot/llms.txt

Use this file to discover all available pages before exploring further.

SudoBot ships with a handful of lighthearted commands to keep your server lively. Most fun commands work out of the box, but a few require free third-party API keys that you configure in your .env file.

Available commands

CommandDescriptionAPI key required
/catFetches a random cat imageYes — thecatapi.com
/dogFetches a random dog imageYes — thedogapi.com
/httpcat <code>Shows an HTTP status cat for a given status codeNo
/httpdog <code>Shows an HTTP status dog for a given status codeNo
/jokeTells a random joke (dad jokes require an API key)Optional — api-ninjas.com
/pixabay <query>Searches Pixabay for images or videosYes — pixabay.com
/mixemoji <emoji1> <emoji2>Mixes two standard emojis into a mashupNo

Commands that need API keys

Cat and Dog images

The /cat and /dog commands fetch random animal images from external APIs. To enable them, get free API keys and add them to your .env file:
.env
CAT_API_TOKEN=your-cat-api-key
DOG_API_TOKEN=your-dog-api-key
The /pixabay <query> command searches Pixabay for royalty-free images and videos. Get a free API key from pixabay.com/api/docs.
.env
PIXABAY_TOKEN=your-pixabay-api-key

Commands that work without API keys

HTTP status images

/httpcat <code> and /httpdog <code> display a cat or dog image themed around an HTTP status code — no API key needed.
/httpcat 404
/httpdog 500

Jokes

/joke returns a random joke. Standard jokes work without any API key. The /joke command also supports a “dad joke” subtype — to use it, get a free key from api-ninjas.com and set:
.env
API_NINJAS_JOKE_API_KEY=your-api-ninjas-key

Emoji mixing

/mixemoji <emoji1> <emoji2> combines two standard Unicode emojis into a creative mashup using Google’s Emoji Kitchen. Use standard emoji characters — custom server emojis are not supported.
/mixemoji 😄 🐱
Fun commands are enabled by default. If you want to restrict them to specific channels or roles, use SudoBot’s permission system or channel overrides in your guild config.

Build docs developers (and LLMs) love