Skip to main content

Watch out for squirrel's knives!

Project description

pipeline status coverage report Documentation Status Supported Python versions PyPI PYPI downloads AUR version License: GPL v3

Squirrel Battle

Squirrel Battle is an infinite rogue-like game with randomly generated levels, in which the player controls a squirrel in its quest down in a dungeon, using diverse items to defeat monsters, and trying not to die.

##Installation

####Via PyPI :

``` to install

``` pip install --user --upgrade squirrel-battle
``` to upgrade

####Via ArchLinux package : 
Download one of these two packages on the AUR :

* python-squirrel-battle
* python-squirrel-battle-git

####Via Debian package :
Available on our git repository, has a dependency on fonts-noto-color-emoji (to be found in the official Debian repositories).

Run ```
    dpkg -i python3-squirrelbattle_23.14_all.deb
``` after downloading

In all cases, execute via command line : ```squirrel-battle```

##For first-time players

The game is played in a terminal only, preferably one that supports color, markdown and emojis, but it can be played with only grey levels and relatively classic unicode characters.

Upon starting, the game will display the main menu. To navigate in menus, use zqsd or the keyboard arrows. To validate one of the options, use the Enter key. Mouse click is also supported in most menus, **but not in game**.

The game in itself can have two types of display : using ascii and simple unicode characters, or using emojis. To activate emoji mode, go to the settings menu and select the squirrel texture pack. Emojis will not work if the terminal does not support them, so do tests before to ensure the terminal can display them.

The game is translated (almost entirely) in English, French, German and Spanish. To change the language, go to the settings menu.

Controls in-game are pretty basic : use zqsd or the keyboard arrows to move. To hit an ennemy, simply go in its direction if it is in an adjacent tile.

There are several special control keys, they can be changed in the settings menu :

* To close a store menu or go back to the main menu, use Space
* To open/close the inventory, use i
* To use an object in the inventory, use u
* To equip an object in the inventory, use e
* To use a long range weapon after it has been equipped, use l and then select the direction to shoot in
* To drop an object from the inventory, use r (to pick up an object, simply go on its tile, its automatic)
* To talk to certains entities (or open a chest), use t and then select the direction of the entity
* To wait a turn (rather than moving), use w
* To dance and confuse the ennemies, use y
* To use a ladder, use <

The dungeon consists in empty tiles (you can not go there), walls (which you can not cross) and floor ( :) ). Entities that move are usually monsters, but if you see a trumpet (or a '/'), do not kill it ! It is a familiar that will help you defeat monsters. Entities that do not move are either entities to which you can talk, like merchants and ... chests for some reason, or objects. Differentiating the two is not difficult, trying to go on the same tile as a living entity (or a chest) is impossible. Objects have pretty clear names, so it should not be too difficult determining what they do (if you still don't know, you can either read the docs, or test for yourself (beware of surprises though))

And that is all you need to get started! You can now start your adventure and don't worry, floors are randomly generated, so it won't always be the same boring level.

## Documentation

The documentation for the project cen be found at [squirrel-battle.readthedocs.io](https://squirrel-battle.readthedocs.io). It is unfortunately only written in French.

Anyone interested in understanding how the code works can find a few explanations in the documentation.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

squirrel-battle-23.14.tar.gz (52.1 kB view details)

Uploaded Source

Built Distribution

squirrel_battle-23.14-py3-none-any.whl (90.0 kB view details)

Uploaded Python 3

File details

Details for the file squirrel-battle-23.14.tar.gz.

File metadata

  • Download URL: squirrel-battle-23.14.tar.gz
  • Upload date:
  • Size: 52.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.55.2 CPython/3.9.1

File hashes

Hashes for squirrel-battle-23.14.tar.gz
Algorithm Hash digest
SHA256 1923cf750add761b44621d6810c5d5d1ce6c9d6953fbf2ba2952d09ac2f5814f
MD5 73037d66e79e33453a6009c9515b2c38
BLAKE2b-256 e2f4b43e911e1e7d70b431d51d98be77c074483df4aadcf36e919ea4fc2a7b97

See more details on using hashes here.

File details

Details for the file squirrel_battle-23.14-py3-none-any.whl.

File metadata

  • Download URL: squirrel_battle-23.14-py3-none-any.whl
  • Upload date:
  • Size: 90.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.3.0 pkginfo/1.6.1 requests/2.25.1 setuptools/50.3.2 requests-toolbelt/0.9.1 tqdm/4.55.2 CPython/3.9.1

File hashes

Hashes for squirrel_battle-23.14-py3-none-any.whl
Algorithm Hash digest
SHA256 05a9fc84c0c900d2cec4e5ccbc32a17bc125940185e9385094d1dcae03802587
MD5 df7d7c219893789bb6e2d648c678e733
BLAKE2b-256 329cf8d7d0657adf68070c636d1aa646e9a357eea6e9b303335eca77f1727a33

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page