Break Out Of Hareka's Underground (Boohu) is a roguelike game mainly inspired from DCSS and its tavern, with some ideas from Brogue, but aiming for very short games, almost no character building, and a simplified inventory.

Every year, the elders send someone to collect medicinal simella plants in the Underground. This year, the honor fell upon you, and so here you are. According to the elders, deep in the Underground, a magical monolith will lead you back to your village. Along the way, you will collect simellas, as well as various items that will help you deal with monsters, which you may fight or flee...

Screenshot and Website

You can visit the game's website for more informations, tips, screenshots and asciicasts. You will also be able to play in the browser and download pre-built binaries for the latest release.

Install from Sources

In all cases, you need first to perform the following preliminaries:

• Install the go compiler.
• Add $(go env GOPATH)/bin to your $PATH (for example export PATH="$PATH:$(go env GOPATH)/bin").

ASCII

You can build a native ASCII version from source by using this command:

go install

Alternatively, you may use the go build -o /path/to/bin/boohu to put the resulting binary in a particular place.

The boohu command should now be available (you may have to rename it to remove the .git suffix).

The only dependency outside of the go standard library is the curses-like library tcell, which is installed automatically by the previous go install command.

Portability note. If you want to avoid a dependency, try adding --tags ansi to the go install command. It will work on POSIX systems with a stty command, but has more limited functionality.

Tiles

You can build a graphical version depending on Tcl/Tk (8.6) using this command:

go install --tags tk

This will install the gothic Go bindings for Tcl/Tk. You need to install Tcl/Tk first.

Browser (Tiles or ASCII)

You can also build a WebAssembly version with:

GOOS=js GOARCH=wasm go build --tags js -o boohu.wasm

You can then play by serving a directory containing the wasm file via http. The directory should contain some other files that you can find in the main website instance.

Colors

If the default colors do not display nicely on your terminal emulator, you can use the -s option: boohu -s to use the 16-color palette, which will display nicely if the solarized palette is used. Configurations are available for most terminal emulators, otherwise, colors may have to be configured manually to one's liking in the terminal emulator options.

Documentation

See the man page boohu(6) for more information on command line options and use of the replay file. For example:

boohu -r _

launches an auto-replay of your last game.