Break Out Of Hareka's Underground, a roguelike game (secondary repos)
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
assets use mouse motion with the web tiles version Jul 22, 2018
img update screenshot to show more recent features Oct 29, 2017
.gitignore update gitignore Jul 23, 2018
Changes update Changes Sep 23, 2018
LICENSE First public commit Sep 10, 2017
README.md fix typos Jun 9, 2018
ansi.go add targeting help to menu, and some renamings Jul 24, 2018
aptitude.go Another bout of grammar and wording fixes. Aug 15, 2018
astar.go add special rooms in eight maps May 26, 2018
autoexplore.go remove some useless pointer indirection May 18, 2018
boohu.6 fix .Bl -width in the manpage Aug 5, 2018
combat.go change color of some statuses when they're about to expire Sep 19, 2018
credits.txt add mention in credits.txt for magical stones Sep 19, 2018
dijkstra.go variable renaming (dijkstra map) May 6, 2018
draw.go Do not require refreshing the page to play again in the browser version Sep 21, 2018
drawterminal.go add an interact button for descend and equip Jul 24, 2018
dump.go Do not require refreshing the page to play again in the browser version Sep 21, 2018
dungeon.go rename some shadowing variables Sep 18, 2018
dungeon_test.go some improvements to deserted town generation Jul 22, 2018
encoding.go implement toggle normal/compact layout in settings Jul 23, 2018
events.go update monster current path when no longer confused Sep 23, 2018
explorestep.go implement auto-exploration interruption in ansi backend May 21, 2018
game.go update Changes Sep 23, 2018
game_test.go add test for level initialization Oct 16, 2017
images.go add tile for stones Aug 30, 2018
items.go remove boring plain chain mail Sep 23, 2018
js.go Do not require refreshing the page to play again in the browser version Sep 21, 2018
jscanvas.go add tile for stones Aug 30, 2018
jsdom.go mention that the js dom version is no longer up to date Jul 23, 2018
log.go merge consecutive duplicates in logs May 20, 2018
los.go rename some shadowing variables Sep 18, 2018
main.go implement toggle normal/compact layout in settings Jul 23, 2018
monster.go do not target a cell if there's already a monster Sep 23, 2018
neighbors.go add sometimes fungus in ruins and tree-like cave maps Apr 25, 2018
path.go fix auto-explore information leak when unknown temporal wall blocks t… Sep 9, 2018
player.go remove boring plain chain mail Sep 23, 2018
pos.go reworked shields: bashing, confusing and earth shields Jun 9, 2018
pos_test.go First public commit Sep 10, 2017
rods.go mention explicitly “it can burn foliage and doors” in some descriptions Sep 19, 2018
save.go add setting to toggle between ascii and tiles display Jul 23, 2018
stairs.go Add 3 optional levels (until Depth:15) with more unique monster bands Jun 6, 2018
stats.go add story information about stone usage Sep 9, 2018
status.go new weapon: defender flail, that moves foes to you and hits harder as… Jul 15, 2018
stones.go add story information about stone usage Sep 9, 2018
target.go allow player to move in excluded areas with the mouse May 29, 2018
tcell.go make numpad work without NumLock (#18) Aug 15, 2018
termbox.go make numpad work without NumLock (#18) Aug 15, 2018
utils.go fix correctly singular/plural stuff Jul 16, 2018
writedump.go remove ebiten stuff (using now the simple js backend) Nov 14, 2017

README.md

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, magical stairs 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...

Boohu introduction screen

Screenshot and Website

Introduction Screeshot

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

You can build from source by following these steps:

  • Install the go compiler.
  • Set $GOPATH variable (for example export GOPATH=$HOME/go).
  • Add $GOPATH/bin to your $PATH (for example export PATH="$PATH:$GOPATH/bin").
  • Use the command go get -u git.tuxfamily.org/boohu/boohu.git.

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 lightweight curses-like library termbox-go, which is installed automatically by the previous go get command.

Portability note. If you happen to experience input problems, try adding option --tags tcell or --tags ansi to the go get command. The first will use tcell instead of termbox-go, and requires cgo on some platforms, but is more portable. The second will work on POSIX systems with a stty command.

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.