A terminal based Pokemon like game
pip install pokete
Pokete -- Grey Edition
What is it?
Pokete is a small terminal based game in the style of a very popular and old game by Gamefreak.
Installation
pip install pokete
You can also install it from the AUR:
$ buildaur -S pokete-git
Or you can just run the AppImage from the release page.
NOTE: In that case you first have to create the ~/.cache/pokete/ folder.
For Windows:
Some windows antivirus may flag the libplaysound.dll as malicious. If pokete crashes, please make sure that the .dll
exists and is not in quarantine!
To build a contained executable
pyinstaller --onefile src/pokete/__main__.py --name pokete --add-binary="src/pokete/playsound/libplaysound.x86_64.so:." --add-data="src/pokete/assets:pokete/assets"
If you have problems with your ARCH you maybe need to rebuild the audio module, see here.
Running locally
pip install scrap_engine
git clone https://github.com/lxgr-linux/pokete.git
cd pokete/src
python -m pokete
Usage
The game can be run normally without supplying any options.
For non gameplay related usage, use --help.
Try it out online.
How to play
Imagine that you're a Pokete Trainer and you travel around the world to catch/train as many Poketes as possible with the ultimate goal of becoming the best trainer.
First of all you get a starter Pokete (Steini), that you can use to fight battles with other Poketes. Use W, A, S and D to move around.
When entering the high grass (;), you may be attacked by a wild Pokete. By pressing 1 you can choose between the
attacks your Pokete has (as long their AP is over 0). By pressing the according number, or navigating with the *
cursor to the attack and pressing Enter you can use the attack selected. The wild Pokete will fight back, but you can
kill it and gain XP to level up your Pokete. If you would like to catch a wild Pokete, you must first weaken it and then
throw a Poketeball. With a bit of luck, you can catch it and have it fight for you.
By pressing the 1 key, you can take a look at your current deck. You can see detailed information of your Pokete and
your attacks, or rearrange them.
Changes will only be saved by quitting the game using the exit function.
Since you're a Pokete Trainer, you can also fight against other trainers (they appear as an 'a'). He will start a fight with you when you get close enough to him. You can not run from a trainer fight; you either have to win, or lose. These trainer fights give double the XP.
When one of your Poketes is too weak or dies, you can heal it by going into the Pokete Center (the house), talk to the
person there and choose the healing option.
Here you can also take a look at all of your Poketes, and not just the six in your team. The ones marked with an o are
the ones in your deck.
By pressing e, a menu will appear where player name, and later other settings, can be changed.
The red balls all over the map are Poketeballs. You'll need these to catch Poketes. Stepping on such a ball will add it to your inventory.
See How to play.
Game depth
Not only are there Poketes that are stronger than others, but also Poketes with different types, which are effective against some types and ineffective against others.
| Type | Effective against | Ineffective against |
|---|---|---|
| Normal | ||
| Stone | Flying, Fire | Plant |
| Plant | Stone, Ground, Water | Fire, Ice |
| Water | Stone, Flying, Fire | Plant, Ice |
| Fire | Flying, Plant, Undead, Ice | Stone, Water |
| Ground | Normal | Flying |
| Electro | Stone, Flying | Ground |
| Flying | Plant | Stone |
| Undead | Normal, Ground, Plant, Water | Fire |
| Ice | Water, Plant | Fire |
For additional information you can see wiki or the multi-page wiki.
Mods
Mods can be written to extend Pokete. To load a mod, the mod has to be placed in mods and mods have to be enabled in
the menu.
For an example mod see example.py.
Tips
- When you want to see the next part of a conversation, press any key
- Don't play on full-screen; the game will not run properly
- Don't be offended by the other trainers; they may swear at you
TODO
- A wizard at the start to set name and starter Pokete
- More maps
- Types for attacks and Poketes
- Evolving
- More than one Pokete for trainers
- Coloured Poketes
- A store to buy Poketeballs
- Potions
- Intro
- Trading
- Poketedex
- Effects
- Colour codes for types
Dependencies
Pokete depends on python3 and the scrap_engine module.
On Windows pynput has to be installed too.
Documentation
- Documentation for pokete_classes
- Documentation for pokete_data
- Documentation for the util file
- Documentation for the pokete_general_use_fns
- Documentation for the main file "pokete.py"
Releases
For release information see Changelog.
Contributing
Feel free to contribute whatever you want to this game. New Pokete contributions are especially welcome, those are located in /pokete_data/poketes.py
To learn how to add more poketes/types/attacks to the game, see the development guide
After adding new Poketes and/or attacks you may want to run
$ ./util.py wiki
to regenerate the wiki and adding them to it.
Migrating to flatpak
If you're migrating to the flatpak release, move your ~/.local/share/pokete/pokete.json
to ~/.var/app/com.github.lxgr_linux.pokete/data/pokete/pokete.json.
Credits
Music:
- Eric Skiff - Resistor Anthems - Available at http://EricSkiff.com/music
- Marllon Silva (xDeviruchi) - 8-bit-fantasy-adventure-music-pack - Available at itch.io
- SketchyLogic - Map - Available at opengameart.org
Troubleshooting
If you're experiencing problems on Japanese systems take a look at this.