PokéAssistant
Amazing Pokétwo Assistant Bot that pings you if legendary or mythical spawns, and other features Eg. SH Ping, Quest Ping, Anti-Snipe and more! It's a forked and improved version of Chamburr's unmaintained/dead PokéAssistant made for Pokécord.
This bot is not against Discord TOS.
| Cleverbot | ❤️ Sponsor |
|---|---|
 |
Machine-Learning AI contextual chatbot (Toxic & Swears) that talks like a humans! Click here to invite it from top.gg. |
License
There is no license for PokéAssistant. This ensures you are not allowed to redistribute or change the code and this ReadMe. I maintain all rights to the source code since there is no license, and no one can copy, distribute, or develop derivative works from it 😠.
Get Premium
Boost the support server...
Developer
TrashUwU#8019
Issues?!
Facing issues with the bot? Please create a Github Issue.
Questions?
Code-Safety questions? Scroll down to questions section or join support server.
Bot Repl
https://replit.com/@ButterTaurus/PokeAssistant
Support Server Invite Link
Features
Read this if your bot is working and you want to install more features.
- Harmless and Beginner-Friendly
- Works on your own bot
- Anti-Sniper
- Fast and light
- Can be hosted 24/7 on cloud or on PC
- Auto-updates code
- Uses AI to identify Pokémons
- 85% Accuracy because of small dataset, how much do you expect from free REPLIT?
- Returns 1-3 Pokémons as prediction
- Pins good spawns
- DMs you, if your Shiny Hunt Pokémon spawns
- Pings other members in your server, if their Shiny Hunt Pokémon spawns
- Pings a specific role when rare Pokémons spawn
- Returns prediction containing 3 Pokémon images and names, if there are many results
- Faster Prediction (Premium)
- Decreased Rate Limit (Premium)
- Automated Who's-That-Pokémon feature (Premium)
- Pings for Quest (If one spawns from given Region) (Premium)
- Remove
prefix!joinmessage and reaction (Premium) - Custom Embed Design (Exotic)
Bot Installation Guide
You surely want a private bot for your server, now that you have got the source code, you wonder: how do I keep the bot up 24/7? So here the guide exists to teach you how.
| Video Tutorials |
|---|
| https://drive.google.com/file/d/1-dtNyLJxo73Ls9nArb20AESOLx3yuCXv/view?usp=sharing |
Step 1: Create a Github Account
Visit https://github.com/join and create a Github Account.
Step 1.5: Star the repository
Visit https://github.com/TrashUwU/PokeAssistant/stargazers and click the star button
Sadly majority of the Pokétwo users don't know what's Github :cry:
Step 1.7: Enable Developer Mode
In The Discord application go to Settings > Appearance > Turn on Developer Mode.
Step 1.9: Creating a bot account
Don't worry, it's super simple.
Creating the application
To create the application, head to https://discord.com/developers/applications/. Log in, and you'll reach a page that may look like this:
Click on Create an application. This brings you to the following page, in which you should simply enter a name for the application. After clicking Create, you can also add an avatar. Click Save Changes afterwards.
Creating the bot account
After creating the application, we need to create the Bot User. Go to the Bot section on the left, then click on Add Bot, then Yes, Do it.
There's a few things you can change here.
- Username: Change your bot's username on Discord
- Icon: Change the bot's avatar
- Public bot: Toggles the ability for other users to add your bot to their server.
- Require Oauth2 Code Grant: Don't check this. Just, don't.
After doing these, scroll down.
Enabling Intents
Enable the intents shown in Pic-
- Presence Intent
- Server Members Intent
- Message Intent
- Click
Save Changes
Adding to your server
To generate the invite link, click on Oauth2 >> URL Generator in the app page, and scroll down to Scopes. Check the Bot scope to generate a link. You can also add additional permissions for the bot.
Copy the link and open it, select your server and click on Authorize. Cheers, it has been added to your server.
Getting the token
Go back to the Bot page and click Reset Token and then copy the token. Save it somewhere, you will need that later.
Step 2: Hosting the bot
The bot will be hosted on Replit, so you need to create a Replit account first: https://replit.com/login.
Getting the code
The code has already been setup, you only need to go to https://replit.com/@ButterTaurus/PokeAssistant and click fork. Wait 10-60 seconds after forking.
Configuration
PC Users: Click on Secrets (Environment Variables), it's a Lock Icon
Mobile Users: Click Commands >> Tab at bottom right corner, Click Secrets (Environment Variables). If you don't see this option, click the arrow facing downward at top right.
First Secret
- Click
Secrets (Environment Variables) - Type
TOKENin Key Section - Paste Bot Token in Value Section
- Click
Add new Secret
Second Secret
- Type
CHANNELin Key Section - Paste the Channel IDs (Separate with
,without space if there are more than one) of Pokémon Spawning Channels in Value Section - Click
Add new Secret
Third Secret
- Type
OWNERin Key Section - Paste your Account ID in Value Section
- Click
Add new Secret
(Mobile users will click green play button to run)
(PC users will click Green Run Button.)
The bot should be online now!
Step 3: Keeping the bot online 24/7
Your bot will shutdown if you close the replit window. We will be using UptimeRobot to keep the bot online 24/7. Create an account first: https://uptimerobot.com/signUp.
After signing up, login and go to the Dashboard, click on Create New Monitor, the configurations are as follows:
- Monitor Type: Choose HTTP(s)
- Friendly Name: Literally anything
- URL (or IP): Put
your repl's link. If you are on mobile, click onWebtab in your replit project (the site where you put bot token, channel ID), it's in bottom right; then you'll see a URL at the top that ends withrepl.co. Paste that link in Uptimerobot. If you are on PC click here to see where the link can be found. - Monitoring Interval: 5 minutes
Finally click Create Monitor and you're done! Done with everything!
Keep in Mind
- The bot will identify 1 Pokémon every 10 seconds; if there are multiple spawns in 10 seconds, the bot will get rate limited (5 seconds for premium)
- Reduce the number of channels in
Secrets (Environment Variables)if the bot gets rate limited too many times - The bot must have permissions to send embeds
- Make sure the
KeysinSecrets (Environment Variables)areUPPERCASE. - Make sure the bot can DM the owner
- Do not show the bot token to others
- Do not edit the code, because it will break the whole bot :/
- You can only have 2 PokéAssistants.
Extra Features
These features are disabled/enabled by default. Follow the setup-instructions to toggle them.
| Name | Description | Setup |
|---|---|---|
| 🔍 Quick Find | The bot will identify the Pokémon if it finds a spawn in any Channel or Server. | From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) open CHANNEL secret. Now clear the channel ID(s) in value section and paste 000. Click Save. Wait for it to restart after 30 minutes. |
| 🏓 Role Ping | The bot will ping a specific role if an Ultra Beast, Alolan, Galarian, Legendary or Mythical Pokémon Spawns. Quick Find feature should be enabled for better performance. |
From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key ROLE and Value will be the Role name or ID which will be pinged if a rare pokémon spawns. Click Save. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| ⭐ SH Ping | Made for Mass Shiny Hunt Tag. People who have Sh POKEMONNAME in server-nickname will get pinged if any POKEMONNAME spawns. Quick Find feature should be enabled for better performance. |
From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key PING and Value will be True. To restrict SH Ping to SH only channels, create a Secret with Key SCH and Value will be the Channel ID(s) of SH channels (Separate with ,). To disable, delete the secret called PING or set the value to False. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| ❌ Non Explicit | The bot will not ping for Mass Ping, Role Ping and Quest Ping feature if it's confidence is low. |
From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key EXPLICIT and Value will be False. To disable, delete the secret called EXPLICIT or set the value to True. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| 🏹 Pokédex Hunt | The bot will DM the owner if a given Pokémon Spawns. Quick Find feature should be enabled for better performance. |
From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key HUNT and Value will be some Pokémon names. Example: Timburr,Cacnea,Pikachu. Owner will get pinged if that Pokémon spawns, useful for Shiny Hunt. Click Save. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| 🚫 Anti Snipe | The bot will warn snipers if they are caught. (Snipers catch Pokémons but do not help Pokémons spawn by sending messages) Quick Find feature should be enabled for better performance. |
From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key SNIPE and Value will be True. Click Save. To disable, delete the secret called SNIPE or set the value to False. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| 📌 Auto Pin | The bot will pin Ultra Beast, Alolan, Galarian, Legendary or Mythical spawns. Quick Find feature should be enabled for better performance. |
From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key PIN and Value will be True. Click Save. To disable, delete the secret called PIN or set the value to False. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| 🎈 Custom Prefix | The prefix of the bot will be changed. | From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key PREFIX and Value will be two letters. Example: pk, commands will look like pk!join. Click Save. To disable, delete the secret called PIN or set the value to False. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| 🧠 Hint Identifier | The bot will retrieve the Pokémon name from Hint. Type hint command in Pokétwo and the bot will respond. | From https://replit.com/repls, open your bot Repl, go to Secrets (Environment Variables) create a Secret with Key HINT and Value will be True. Click Save. To disable, delete the secret called HINT or set the value to False. Stop the code and run agian or wait for it to automatically restart after 1-12 hours. |
| 🔪 Anti SH/Quest Steal | Mutes the user if they are caught stealing SH/Quest. And unmutes after 60 minutes + Restores all roles. | Mention your bot for help, and use the <prefix>punish command. |
| 🧩 Quest Ping | Premium Feature, the name describes everything. | Mention your bot for help, and use the <prefix>quest command. |
| ❓ Who's-That-Pokémon | Premium Feature, send a spawn image in a given channel, the bot will say the name. | Mention your bot for help, and use the <prefix>who command. |
Questions
Why is the source code messed up?
It's encrypted/obfuscated. I don't want Pokétwo mods to read and patch against it and also don't want other coders to make an auto-catcher with the help of PokeAssistant. But you can run it without problem.
Why can't I invite the bot instead of hosting it?
Discord does not verify these kind of bots, verified bots must be unique. Server limit for unverified bots is 100 and bots in 1K+ servers need too much ram. That means you can't invite it to your server, if it's in 100 servers already 😵. With the help of this guide, you can make your own bot and customize it without coding!
Want to help?
Star the repository, refer your friends to this Github repository! Join the support server to request faster results, no ads and decreased rate limit! You must create a support ticket to contact the moderators.
Is it harmful?
The bot is not against Discord TOS. But do not show your bot token to others.
How do I restart the bot?
Type prefix!reboot to reboot your bot! Ping your bot to see the prefix.
How do I update the code?
Updating is optional. If the bot asks you to update, that means it's a push-over (not optional) you need to update the code or the bot will not work.
For updating, copy this code. Go to https://replit.com/repls and click your PokéAssistant REPL. After the editor has loaded, select all codes and press backspace to clear everything from the file. Now paste the copied code. Now delete json.sqlite(Mobile: Click files button and click ••• beside json.sqlite), now press Run/Play Button. Make sure Run/Play button now looks like a square. (Not a triangle)
Troubleshooting
Moved to TROUBLESHOOT.md.