The following projects are being maintained, which provide the same functionality, and are much more extensible: a server for fetching data by a string similarity, a twitch interface for it, and a data populator for Pokemon
Provides all the necessary Pokemon Info (about Pokemon, Items, Moves, Abilities and more). It responds to commands given by the users at a specific chat room. It has a typing prediction feature so it will respond even if the user mistyped. For example, a user can type !data cherzard and the Bot will respond with Charizard's Base Stats, Abilities, Weaknesses/Resistance etc. It also provides a Serebii and Smogon link for the requested object.
It uses Pokemon Showdown's database. This Bot will be able to provide info about the new games' database as soon as it's available on PS.
Download this file and extract it. Make sure the 3 files are located in the same directory. Double click IRCPokemonBot.jar to run it (if it doesn't run, open it with JRE). You need to have Java Runtime Environment installed ([download here] (http://www.oracle.com/technetwork/java/javase/downloads/jre8-downloads-2133155.html)).
Note: If you get an Exception when you start the Bot or the fields in the configuration screen are empty (instead of having their default values), try one of the following:
- Place both files in a directory that does not contain any special character (such as C:\PokeBot or OS equivalent).
- Run the .jar by opening a command prompt/terminal in the directory where the files are located and run the following:
java -jar IRCPokemonBot_Runnable.jar
I may be hosting the Bot on a cloud service. To check out the current info, click here.
Use a separate Twitch account for your Bot. Press "Configure Bot" at the Main Menu.
| Field | Description |
|---|---|
| Channel Name | The channel to which your Bot will connect. Must begin with a # and be in lowercase |
| Bot name | The username of the Bot account, also in lowercase |
| Server Hostname | Leave as is for Twitch |
| Server Port | Leave as is for Twitch |
| Server Password | The oauth token of your Bot account. Get yours here |
| Commands | How a Twitch chat message should start for the Bot to respond to it. See more info below |
| Cooldown Millis | A time period in milliseconds in which the the Bot will not respond to the same data commands |
| Whitelisted Users | The bot will respond to these users even if they're not mods and the Bot runs in mod-only. Seperate them with comma (,) |
| Default Generation | A Pokemon Generation the Bot will consider as default for the learn commands |
| Generation Letters | The letters for the target generation, as they are used by serebii and smogon (i.e. xy or sm) |
| Mod Only | If ticked, the Bot will only respond to commands by Mods |
| Whispers Enabled | If ticked, the Bot will respond to whispers. Since it's still experimental, disable if it gives you trouble |
| Command | Description | Syntax |
|---|---|---|
| Data | Provides info about a Pokemon, Move, Item or Ability | !data name |
| Egg | Provides info about the similar Egg Groups between 2 Pokemon | !egg pokeName1, pokeName2 |
| Learn | Provides info about whether a Pokemon can learn a Move in the Default Generation | !learn pokeName, moveName |
| Learn | Provides info about whether a Pokemon can learn a Move in the Given Generation | !learn pokeName, moveName, generation |
| Commands | Provides info about the available commands and their syntax | !commands |
| Info | Provides info about the Bot (creator, github link). | !info |
By pressing the "Refresh Database" on the Main Menu, the application will download the latest Pokemon Showdown's files and update its database. You need to use it only when PS has modified its database.
Twitch Chat channel mods can modify the bot configuration by sending the appropriate commands to the chat. The format is:
!pbconfig FIELD VALUE. The space between them is important. The field must be one of the following (with the correct upper and lower case) and the value must be in a range or free text.
| Field | Value | Explanation | Example |
|---|---|---|---|
| modOnly | t OR f | t for Mod Only enabled, f for disabled |
!pbconfig modOnly f |
| whitelist | users seperated by comma (,) |
WARNING this will replace all whitelisted users with those specified. If you want to add/remove a user, see the documentation below | !dbconfig whitelist themetalfleece, shofu |
| cooldownMillis | number | Time (in milliseconds) the bot will wait before responding to the same !data command | !pbconfig cooldownMillis 15000 |
| defaultGen | number | The default generation for the !learn command | !pbconfig defaultGen 6 |
| whispersEnabled | t OR f | When enabled, the bot will respond to commands sent to it via whisper. t for enabled, f for disabled |
!pbconfig whispersEnabled t |
| data OR learn OR egg OR commands OR info | !text | Commands the bot will respond to | !pbconfig egg eggmove |
Whitelisted Users The bot will respond to these users even if they're not mods and the Bot runs in mod-only. Whitelist-specific commands (you still need the !pbconfig prefix):
| Field | Value | Explanation | Example |
|---|---|---|---|
| add | username | The user specified will be added to the whitelist | !pbconfig add themetalfleece |
| remove | username | The user specified will be removed from the whitelist | !pbconfig remove themetalfleece |
By following command line arguments can be specified:
| Argument | Description |
|---|---|
| -noui | UI will not be displayed |
| -autostart | The bot will run as soon as the application loads |
| -path /path/config.ini | The specified file will be used for the configuration |
| -refresh | A database refresh will be performed |