¶ Info
Cat Bot is a Discord bot that keeps your server alive with fun activities related to cats. The bot is made by Lia Milenakos.
With the bot, your main objective is to catch cats that randomly appear in a selected text channel. Users can also trade, collect, and showcase their cats to others. The bot includes various commands that allow players to view their cat collections, in-server leaderboards, and participate in special limited-time events.
With its features, Cat Bot is not only entertaining but also keeps members engaged and active, creating a friendly sense of competition and interaction within the community. Its balance of simplicity and fun mechanics makes it one of the most beloved activity bots for cat lovers and Discord communities alike.
Cat Bot is free to use, with optional purchases (Cat Rains and cosmetics).
To understand how to set up channels to spawn cats, visit the Setting up and Configuring Cat Bot in your server section of this article.
To view more useful commands associated with Cat Bot, check the commands and achievements pages.
¶ How Cat Bot works
Every so often, Cat Bot spawns a cat in a text channel. Typing "cat" while that message is there makes you catch the cat.
Another cat will not spawn while a cat is already there (For example, having a cat in the text channel for a day will not spawn a new cat). There are 22 different cat types that hold different values which you will discover later on.
The catching message and appearing messages look like this:
All cat type values (including custom cats) are 32-bit signed integers, meaning that they go from -2,147,483,648 to 2,147,483,647.
If Cat Bot is missing any required perms, it will fail to setup the channel and will send an error stating which permissions it needs.
The error looks like this:
¶ Inviting Cat Bot to your server
¶ Adding through Cat Bot's Profile
-
Click onto Cat Bot's profile and press
+ Add App(or click this link).
-
Press the
Select a serverbutton and click the server you want to add it to, then pressAuthorize.
¶ Adding through App Directory
-
Click onto your server and press
App Directory.
-
Search Up "Cat Bot" and press
Add App.
-
Press the
Select a serverbutton and click the server you want to add it to. Then pressAuthorize.
¶ Adding App via Web Directory
-
Open the website Top.gg - a website containing a wide variety of Discord bots.
Once you open, you should see a website like this:
-
Type
"Cat Bot"in the search bar.
The bot may show up before you enter the search (as shown below). Click it and it will redirect you to Cat Bot's Top.gg page. Otherwise, enter the following search and find the specific Bot.
-
You will find yourself in a page like the image below. Click the
invitebutton.
-
Choose which server you would like Cat Bot to be in.
Afterwards, invite it to the chosen server andAuthorize. Make sure you scroll down and find the bar which you can click and choose the server Cat Bot promotes the official Cat Bot discord server 'Cat Stand' so it will send an invite link once set up.
¶ Adding App via Other Means
Go to the invite page or run /invite in another server with Cat Bot.
The image below is what it looks like after you run /invite:
Choose which server you would like Cat Bot to be in, invite it to the chosen server, and Authorize. Make sure you scroll down and find the bar which you click, and choose the server you want to put the bot in.
¶ What if I still can't add Cat Bot?
Please join our discord server and ask for assistance using a support ticket for help with adding Cat Bot.
If you have been banned from the server, well... you're out of luck.
(What it should look like when Cat Bot joins)
¶ Setting up and Configuring Cat Bot in your server
We recommend that you create a new channel for Cat Bot, as it tends to push old messages back with its cat spawns.
¶ Setup & Forget
When Cat Bot joins your server, run the /setup command in the channel where you wish Cat Bot to spawn cats in (Cat Bot will DM you telling you to do it if you invited it). Cat Bot should then immediately start to spawn cats in that channel.
You can use the /forget command to make Cat Bot stop spawning cats in the channel in which you set it up.
¶ Configuring Cat Bot
¶ Change Timings
You can change the timing in which Cat Bot spawns cats. The default is 1-10 minutes apart, but you can use the command /changetimings to make it shorter or longer. Run the command, then change each value to be your desired times in seconds.
Leaving these values blank and running the command resets the times to default.
¶ Change Message
You can also change the spawn and catch messages that Cat Bot sends by using the /changemessage command.
After running the command, it will prompt you with a message explaining the steps.
When creating your new custom message you have to include each respective placeholder. Examples are shown below:
-
Appear message example
-
Cought message example
If you want to include a ping in the messages, use the /getid command, and it will tell you how to write that ping in the /changemessage command.
¶ Toggle Settings
You can enable (and disable) certain settings that you may need in your server. This includes:
- reactions and responses only in specific channels
- mute/auto-delete achievement messages
- enable/disable cat rains or catnip
- anti-double catch settings
¶ Caring for your Cat Bot
THIS SECTION IS PURELY A GUIDELINE. YOU ARE NOT REQUIRED TO FOLLOW THESE RULES. ALL OF THE FOLLOWING COMMANDS ARE ONLY USABLE BY SERVER ADMINS.
¶ Positive Commands
The following commands are useful for rewarding users who have one cats (i.e.: from a challenge or giveaway), or just giving cats to people you like:
-
/givecatGives the specified user free cats. Useful for giving out rewards. -
/giveachievementGives the specified user an achievement. Useful for helping someone stuck on a certain achievement.
¶ Negative Commands
The following commands are useful for managing people who aren't being nice or fair when using Cat Bot:
-
/preventcatch- Prevents the specified user from catching cats (for a specific amount of time). Useful for punishing users. -
/reset- Completely resets Cat Bot data for the specified user. Useful for cheaters of Cat Bot. -
/givecat- Removes cats from the specified user by giving negative cats. (Type a negative value in theamountpart to do this.) -
/giveachievement- Removes an achievement from the specified user (if they have the achievement). -
/nuke- REMOVES ALL CAT BOT DATA FROM THE WHOLE SERVER. This command is destructive and should only be used as a last resort.
¶ Cat Bot Issues
You can check Cat Bot's status at https://status.minkos.lol/ and you can check Discord and Cloudflare's statuses at https://discordstatus.com/ and https://www.cloudflarestatus.com/ respectively.
You can also join our support server, Cat Stand, to see the status update of Cat Bot or ask a question.
¶ Why are some emojis 🔳?
Sometimes while Cat Bot is starting (for a few seconds), Discord doesn't allow the bot to use custom emojis. Cat Bot uses 🔳 as a placeholder so the bot will respond with something instead of erroring everything with "Emoji not found".
¶ Bot Issues
¶ Usability Issues
If the bot is down, it will be offline.
- Being offline causes Cat Bot to error everything with "The application did not respond" or "This interaction failed".
- Fixing the bot might require a restart.
If the bot is starting up, it will be online, but with no status. In this state, Cat Bot might not respond in some servers or some specific parts might not work.
While most bot restarts are seemless, some require a full bot restart. Other reasons include server/database maintenance or issues with hosting provider.
Keep in mind that sometimes Discord or Cloudflare undergo maintenance/degradation/errors instead of Cat Bot.
¶ Voting Issues
Sometimes, your vote can get voided if you vote while Top.gg is having trouble with voting, although you can wait for it to fix itself.
¶ Trivia
-
Cat Bot's timezone is in GMT+0 for the
catchapp and GMT+4 for the Cattlepass, which causes stuff like season switches to happen sooner or later in the day depending on your timezone. -
Every month, Lia takes hidden Cat Bot stats (like new servers/profiles/cats and achievements/quests completed) and makes a "wrapped" out of them.
-
Cat Rains used to be in Cat Bot before but they got deleted on March 20th, 2023 and then added back on August 6th, 2024.
-
Cat Bot and Cat Stand added a rainbow background for their icons for 2024's Pride Month, but the icon was so stylish that it was decided to keep them permanently. The only time it was ever changed back to the original was during the* 2025 April Fools event*. Cat Stand's Pride invite banner, on the other hand, was not permanent.
-
If Cat Bot has to send a reminder in a server it's not online in, then Cat Bot will say "a server" instead of the server name.
-
On June 22nd, 2025, Cat Bot's banner changed to an automated banner with a white background and black text saying "wow! i sure do wish i had
Current # of Servers + 1servers!!!! 😞". This was rolled back later that day.
-
The default spawn time was changed from 2-20 minutes to 1-10 minutes on October 23rd, 2025 for the upcoming Catnip Update.
-
After you DM Cat Bot 14 times, each reply will be a Fanhalo quote. There are 462 of them in total.
-
On May 27th 2026, the newcomer experience was revamped.
- Inviting the bot now doesn't lead off-app.
- Cat Bot will now DM the user who invited it, telling them to run
/setup. - New
/tutorialflow is added to tour people around the bot. - 2 free rain minutes were moved to be a reward for completing the tutorial from being there once you joined the server.