Pokebot

Join my discord server: https://discord.gg/NnujtZ4

This bot requires intermediate knowledge of discord and bots. This is not for a beginner user.

This project is in Beta. So you will see errors at some point.

Installation:

1: git clone https://github.com/RussellG89/Pokebot.git to desired location or download the zip and unzip.

2: cd to the new Pokebot folder

3: Type node -v in your terminal to determine if node is installed on your machine.

• If not or version is less than 10.14, upate or download node.js from here: https://nodejs.org/en/
• Type node -v again in your terminal post install to confirm installation.

4: Install npm package requirements.

• Run npm install in your cloned directory.

5: Edit the Config files and save them without the .example on them.

• Emotes.ini You have the option of setting your own custom emotes. If "Custom_Emotes" is set to false in your config, you will need to join then add your bots to these servers: https://discord.gg/zqVCfPy - WEATHER, TEAMS, GYMS, TYPES https://discord.gg/AnECN8U - Legendary boss emojis If you choose true for custom emotes, you will need to edit the emotes.json.example like below:
  • This will be the emotes the bot uses for the embed posts (team emblems and Ex Icon. Images you can upload to your discord server are in the files folder under emotes. To get the emote IDs in you server, type :youremotename: in discord. This will output something like <:instinct:499334776189091871>. Paste those into the emotes.json.example and save as emotes.json.
• Discords.json
  • Each item in this array is a discord that you want your bot to report to. The "geofence" is a geojson format array. Please see example file.
• Geojson.json
  • Geofences of areas to label your pokemon/raid/quest posts with and for users to subscribe to alerts with.
  • Go to http://geojson.io/ and draw your geofences. You MUST add a "name" field to each geofence. If you want to use sub areas (smaller detailed geofences within larger geofences), you must add a sub_area field and then true or false as the value.
• config.ini
  • Contains the meat and potato configs. Main token will be the main bot to respond in the subscription channel. The array of other bot tokens are for channel posts and DMs to avoid rate limits. Up to 15 bot tokens can be used at this time. If you have less than 15, delete the other example numbers or you will get invalid credential errors when starting the script. YOU MUST PROVIDE A MAIN TOKEN AND AT LEAST ONE DIFFERENT TOKEN FOR BOT_TOKENS. The Main token handles users, while the other tokens are the workers that perform DMs and channel posts. One Bot_Token is fine if you just have channel feeds, but you will need to add at least one more for DMs.
• discords.json
  • You need to add each Discord you plan on serving. Pokebot is multi-discord capable.

6: Channels

• Fill out each channels.ini file with the channels, chosen filter, and areas. If you do not want to filter by area, use the name that you gave your discord in discords.json.
  • channels_pokemon.ini
  • channels_raids.ini
  • channels_quests.ini

7: Filters

In /filters you will find examples of pokemon, quest, and raid feeds. These files can be named whatever you want, there is no more name requirement. These are pokemon filters based on PA type, also with a min_iv and max_iv override. If you do not include a Channel_ID, the bot will ignore the filter.

Quests

• The "Type" field must be "quest".
• Quest feeds can be filtered by reward and/or encounter. Add each reward our encounter to the "Rewards" array.
• They are case sensitive, so please see examples. Refer to /static/en.json for all rewards.

Raids

• The "Type field must be "raid".
• Raids can be filtered by type, levels, and ex eligibility.
• If you DO NOT want to filter by Ex Eligibility, REMOVE the "Ex_Eligible" field completely from the filter.
• You can add as many or as few levels to the filter as you with 1-5 as the examples show.
• The "Egg_Or_Boss" field must be set to either "boss" or "egg".

Pokemon

• This Pokebot uses PA type filters with some overrides in the config.
• The "Type" field must be "pokemon".
• You must set the min_iv and max_iv for the filter. Defaults 0 and 100.
• You must set the min_level and max_level for the filter. Defaults 0 and 35.
• More specific IVs can be set for each pokemon (replace True/False with {"min_iv":"80"}), but that value must be within the min_iv and max_iv you set.
• You can set the bot to post without IVs using the "Post_Without_IV" field. Set this to true or false.

8: Start the bot. pm2 start Pokebot.js

• If you get errors that are not because of missing configs, Contact me via discord.
• PM2 Docs http://pm2.keymetrics.io/docs/usage/cluster-mode/

(This is a work in progress guide. This bot is still technically in Beta as well)

Join my discord server: https://discord.gg/NnujtZ4

Subscriptions

• Subscription commands can only be used in the command channel set in the pokebot_config.json.
• Type .help (or whatever prefix you set) for command instructions.
• Rewards that users can subscribe to are set in quest_config.json in the configs folder. These are case sensitive and the Encounter rewards must state "Encounter" after the pokemon name just as the example shows.