Skip to content


Repository files navigation

Wiki Code-Validation GitHub-Pages Build
Python Version License AUR version
Total Lines of Code Open Issues Open pull requests commit activity commits since last release GitHub contributors

Pokete -- Grey Edition


See more example pics

What is it?

Pokete is a small terminal based game in the style of a very popular and old game by Gamefreak.


For Linux, BSD etc. just do this:

# pip install scrap_engine
$ git clone
$ ./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 OSX:

# pip install scrap_engine
$ git clone
$ ./pokete/

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!

git clone
pip install scrap_engine

To run just execute

If you have problems with your ARCH you maybe need to rebuild the audio module, see here.


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 the 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
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 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


  • 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


  • 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


Pokete depends on python3 and the scrap_engine module. On Windows pynput has to be installed too.



For release information see Changelog.


Feel free to contribute whatever you want to this game. New Pokete contributions are especially welcome, those are located in /pokete_data/

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

$ ./

to regenerate the wiki and adding them to it.




If you're experiencing problems on Japanese systems take a look at this.