Aaron Friesen's website


GeneriCrawl

August 7, 2018

pip install genericrawl git clone https://frie.dev/genericrawl.git

A simple roguelike made in Python with tcod as part of the 2018 r/roguelikedev Does The Complete Roguelike Tutorial event. Can you reach the bottom floor of the dungeon in one piece?

Features

Installation

pip install genericrawl

Usage

genericrawl

GeneriCrawl accepts no command line arguments.

Options

Game options are saved to genericrawl/options.json in your system's default config location ($XDG_CONFIG_HOME, ~/.config, or %APPDATA%). Controls and colors can be changed in-game and automatically written back to this file. However, if you want to change the screen size, you will need to manually edit this file with a text editor and set the values of screen_width and screen_height. Each tile is 10 pixels, so the values 72 and 128 would produce a 720x1280 resolution, for instance. Alternatively, you can enter fullscreen by pressing F11 in-game, which will automatically rescale the game to your screen size.

Controls

GeneriCrawl comes with multiple common roguelike control schemes, as well as a less common left-handed control scheme.

All Control Schemes

The following bindings work in all of the following control schemes.

Also note that, for all movement schemes, you can press the center key to wait a turn.

Number Pad

Recommended for players with a number pad.

7 8 9
 \|/
4-5-6
 /|\
1 2 3

vi

Recommended for vi users.

Y K U
 \|/
H-.-L
 /|\
N J N

Left-hand

Recommended if you don't have a number pad, aren't experienced with vi, or want to use the mouse more.

Q W E
 \|/
A-S-D
 /|\
Z X C

Credits

GeneriCrawl was created by Aaron Friesen with the help of the tcod Roguelike Tutorial.

Contributing

GeneriCrawl is no longer in development, and I do not intend to accept patches for new features. However, GeneriCrawl is permissively licensed, so if you want to add your own features, feel free to fork the repo or just borrow parts of the code (subject to the license terms in LICENSE.txt).