Pokémon Battle Engine is a C# library that can emulate Pokémon battles. This repository includes the engine library, a Windows/Linux/MacOS/Android/iOS client, a server, a Discord bot, and some extra code to rip data from the official games. The engine only emulates Pokémon B2W2 versions, so nothing introduced after generation 5 is included and neither are generation 1/2 exclusive items, event Pokémon, and move compatibility.
The engine does not send information a player should not know; information only gets sent to each player/spectator when it is revealed. For example, a client has no way of knowing if the opponent has sent out a Pokémon with Illusion, the opponent's nature, stats, Hidden Power damage/type, unused item/moves, etc. Therefore, a custom/modified client cannot do anything more than an ordinary player unless it is hosting the battle. A lot of work has been done to prevent any cheating.
Join our Discord server to talk or try out the battle bot!
If you are going to self-host the bot after downloading the code, you will need to have your bot join these two servers for the emotes:
- There are settings that you can change, such as having more moves, a higher maximum level, or weaker poison.
- There are helper classes to build legal Pokémon, as well as require legality for a battle.
- Alternatively, you can represent the Pokémon in any way you wish, as long as you have the basic info to start the battle. This works well with custom games like PokemonGameEngine.
- You can save battle replays to watch them back in the client or to train a neural network.
- There is a work-in-progress random team generator inspired by Pokémon Showdown's which aims to work well with custom settings and moves.
- The library has classes which automatically use the correct language from the games, meaning you can see the Pokémon's names, items, etc in your language, as long as your language was one supported by Pokémon B2W2.
- Multi-Battles exist, and they can be customized to work in 2v1, 2v2, 3v1, or 3v3 battles.
- Wild-Battles exist, and a wild Pokémon can appear disguised from the start, and have statuses etc.
- EXP & Level up work, but not currently with remote battles. It can be added though.
- Triple-battle shifting, Rotation-battles
- Add the remaining vanilla abilities, items, and moves
- Finish adding all event Pokémon
- Add previews of the Android/iOS apps