¶ 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 the 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 doesn't have 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 Cat 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.
¶ 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 USEABLE 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:
-
/givecatThis command gives users cats for free. Useful for giving out rewards. -
/giveachievementThis command rewards the user with an achievement, useful if someone is stuck on a certain achievement and you want to help them out.
¶ Negative Commands
The following commands are useful for managing people who aren't being nice or fair when using Cat Bot:
-
/preventcatch- This command prevents someone for catching cats for a specific amount of time, useful for people who are using scripts to catch cats or who you want to punish. -
/reset- This command completely resets a user's catbot data, useful for someone who cheated their way to the top. -
/givecat- This command can also be used to give users negative cats, which in effect will just remove it from their inventory. -
/giveachievement- This command can also be used to take users achievements, which in effect will just remove it from their profile. -
/nuke- This command is very destructive as it REMOVES ALL CAT BOT DATA FROM THE WHOLE SERVER, this command is dangerous and should only be used as a last resort.
¶ Supporting Cat Bot
There are 2 ways to support Cat Bot and the work that Lia Milenakos does for it. If you want to support the Cat Bot, you can either vote or purchase rains here.
¶ 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. Also you can join our support server, Cat Stand, and see the status update there or ask a question.
¶ Why are some emojis 🔳?
Sometimes while Cat Bot is starting (for a few seconds), Discord for god knows what reason 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
¶ Useability Issues
If the bot is down it will be offline. If the bot is starting or degraded it will be online, but with no status, this is caused by a high ping, the shard in which your server is in (shards are multiple connections to Discord which is approximately (but less than) 1,000 servers) may be dead or zombied, not just the entire bot. Fixing the bot might require a soft restart or a hard restart (the latter one currently has a limit of 5 seconds/shard). Being offline causes Cat Bot to error everything with "The application did not respond" or "This interaction failed". But updates can happen after a restart as well. This can happen during maintenance with server movings or a reason such as database problems/movings, hosting issues, discord.py updates, and Discord resetting the token. Keep in mind that rarely, Discord or Cloudflare undergoes maintenance/degrades/errors/dies instead of Cat Bot. Cat Bot runs off of https://github.com/Gelbpunkt/gateway-proxy/, so any problems with that may affect the bot as well.
¶ Voting Issues
There are some times where your vote can get voided if you vote while Top.gg's 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 year, Lia takes hidden Cat Bot stats (like new servers/profiles/cats and achievements/quests completed) and makes a wrapped out of them.
-
On November 23rd, 2025, the default spawn timings were changed from 2-20 minutes to 1-10 minutes.
-
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 changed their icons to have a rainbow background for 2024's Pride Month, however, it was so stylish that the dev stuck with it even after June, the only time it was ever changed back to the original was on the 2025 April Fools event. But Cat Stand's Pride invite banner never stuck though.
-
Webhooks were added in Cat Bot on June 26th 2024 to fix catching mechanic errors but since the dev found the actual issue, it was removed on July 10th 2025.
-
On November 23rd 2024, buying Cat Rains were merged with Cat Bot Supporter.
-
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.
-
Balanced spawns were added on January 12th 2026, if there are more than 5 normal spawns, it will shift -11 to 11 seconds to prevent global ratelimits.
-
After you DM Cat Bot 14 times, each reply will be a Fanhalo quote. There are 464 of them in total.
-
On May 27th 2026, the newcomer experience got revamped
- Inviting the bot now doesnt lead off-app.
- Cat Bot will now dm the user who invited it telling them to run
/setup. - New
/tutorialflow touring 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.