/PokeAssistant

Amazing Free Pokétwo Assistant that identifies Pokémons from Pokétwo spawns, pings a role if a legendary spawns and pins them, pings you if your Shiny Hunt Pokémon spawns and other features like Quest Ping! Every features are automated.

Primary LanguageRuby

Version Forks Premium Discord

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.

Skip to Installation/Setup Guide

Cleverbot ❤️ Sponsor
Sponsor-Image 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

Skip to Installation

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

https://discord.gg/CtXvFj9yPq

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!join message 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 😢

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 TOKEN in Key Section
  • Paste Bot Token in Value Section
  • Click Add new Secret

Second Secret

  • Type CHANNEL in 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 OWNER in 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 on Web tab 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 with repl.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 Keys in Secrets (Environment Variables) are UPPERCASE.
  • 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.

Made by TrashUwU#8019