HyperRogue

A puzzle roguelike in the hyperbolic plane. See the HyperRogue website for detailed and most up-to-date information. Compiled executables can be downloaded from itch.io and from the HyperRogue website.

Released under GNU General Public License, version 2. As such, it comes without any warranty.

If you would like to thank me for HyperRogue, you can support the development by buying paid versions (with more up-to-date content and some social and competitive features), or in other ways. You can contact me at zeno@attnam.com, or at my blog, or via Twitter.

The game

You are a lone outsider in a strange, non-Euclidean world. You can move with the numpad, vi keys (hjklyubn), or mouse. You can also skip turns by pressing ".".

As a Rogue, your goal is to collect as many treasures as possible. However, collecting treasures attracts dangerous monsters (on the other hand, killing the monsters allows more treasures to be generated).

You can kill most monsters by moving into them. Similarly, if the monster was next to you at the end of your turn, it would kill you. The game protects you from getting yourself killed accidentally by ignoring moves which lead to instant death (similar to the check rule from Chess).

Ultimately, you will probably run into a situation where monsters surround you. That means that your adventure is over, and you will have to teleport back to the Euclidean world to survive by pressing Escape (quit).

Collecting enough treasure also allows you to find rare magical orbs, which grant you one-time or time-limited special abilities.

The world is a combination of over 60 types of lands. Each land type has specific style (monsters, treasure, magical orbs, terrain features). Collecting treasures only attracts more monsters in lands of the same type, so you can try to collect lots of treasure in several different lands!

Some of these lands are available from the beginning, others can be found only if you have proven yourself (press ESC to know what you should do to access more lands). Ultimately, you will be able to access Hell, and look for the fabulous Orbs of Yendor which are hidden there. Get at least one of them to prove that you are a true winner! Only the best players will be able to face the challenges of Hell, but both the monsters and the challenges associated with the Orbs of Yendor are different than in the rest of the game, so it should be worth it.

You can see tooltips by placing the mouse over stuff. You can also right click to get more information about game objects.

Press v to configure the game. You can also rotate the world by pressing arrow keys, PageUp and PageDn (not numpad). You can center on the PC by pressing Home.

Your scores and other stats about your games are recorded to file hyperrogue.log (in Linux, ~/.hyperrogue.log). You can save your configuration to file hyperrogue.ini (in Linux, ~/.hyperrogue.ini).

The surface the game is played on is called a hyperbolic plane. It seems there is just a very small amount of games and other works of art which use hyperbolic geometry (the most well known are some works of M.C. Escher).

The game dynamically generates new parts of the world as you move. Due to nature of the hyperbolic plane, the chances that you get back to a place where you have been before are very low (unless you go back exactly the same way). See more information about the geometry used on the blog.

You can aim for the Orb of Yendor, or you can simply aim for as high score as possible.

Modifications

OK, now lots of the above can be changed. You can change the geometry and topology (to Euclidean, spherical, or even to nonisotropic 3D geometries). You can play challenges based on various in-game quests, and even try some other game genres in non-Euclidean spaces (roguelite aka shmup, racing, peaceful puzzles).

RogueViz

HyperRogue uses RogueViz, which is our engine for non-Euclidean games, computations and visualizations. This repo includes the source code of RogueViz demos in subdirectory rogueviz, but not the data, which is available on itch.io. RogueViz is funded by the National Science Centre, Poland, grant UMO-2019/35/B/ST6/04456.

Development

Build prerequisites

On Linux with apt-get:

sudo apt-get install make g++ libsdl1.2-dev libsdl-ttf2.0-dev libsdl-gfx1.2-dev libsdl-mixer1.2-dev libglew-dev

On macOS with Homebrew:

brew install sdl sdl_ttf sdl_gfx sdl_mixer glew libpng

Building HyperRogue from source

git clone https://github.com/zenorogue/hyperrogue.git hyperrogue
cd hyperrogue
HYPERROGUE_USE_GLEW=1 HYPERROGUE_USE_PNG=1 make

The mymake program builds HyperRogue in parts. It takes longer than the method shown above, but it uses significantly less memory during compilation, and when you change something, mymake will only recompile the changed file. Additionally, it can be easily configured, e.g., to produce an optimized build, or to include addons (see mymake.cpp for some example invocations, and devmods for some example addons). Most useful parameters include -O3 (optimized build), -rv (include the RogueViz demos), -vr (build the VR version). Compiler flags like -Werror (treat warnings as errors) and -march=native work too.

make mymake && ./mymake

The source code is not documented very well. You can see the current state of the documentation, as generated by Doxygen, here.

Name		Name	Last commit message	Last commit date
Latest commit History 10,463 Commits
.github/workflows		.github/workflows
contrib		contrib
devmods		devmods
dll		dll
generators		generators
honeycombs		honeycombs
hyperroid		hyperroid
music		music
rogueviz		rogueviz
sounds		sounds
tessellations		tessellations
.gitignore		.gitignore
.travis.yml		.travis.yml
3d-models.cpp		3d-models.cpp
CITATION.cff		CITATION.cff
COPYING		COPYING
DejaVuSans-Bold.ttf		DejaVuSans-Bold.ttf
Doxyfile		Doxyfile
FUNDING.yml		FUNDING.yml
Makefile		Makefile
Makefile.rv		Makefile.rv
README.md		README.md
achievement.cpp		achievement.cpp
aperiodic-hat.cpp		aperiodic-hat.cpp
arbitrile.cpp		arbitrile.cpp
archimedean.cpp		archimedean.cpp
asonov.cpp		asonov.cpp
attack.cpp		attack.cpp
barriers.cpp		barriers.cpp
basegraph.cpp		basegraph.cpp
bigstuff.cpp		bigstuff.cpp
binary-tiling.cpp		binary-tiling.cpp
blizzard.cpp		blizzard.cpp
cell.cpp		cell.cpp
celldrawer.cpp		celldrawer.cpp
changelog.txt		changelog.txt
checkmove.cpp		checkmove.cpp
classes.cpp		classes.cpp
colors.cpp		colors.cpp
commandline.cpp		commandline.cpp
complex.cpp		complex.cpp
complex2.cpp		complex2.cpp
config.cpp		config.cpp
content.cpp		content.cpp
control.cpp		control.cpp
crossbow.cpp		crossbow.cpp
crystal.cpp		crystal.cpp
debug.cpp		debug.cpp
dialogs.cpp		dialogs.cpp
direntx.h		direntx.h
drawing.cpp		drawing.cpp
earcut.hpp		earcut.hpp
embeddings.cpp		embeddings.cpp
embuild.sh		embuild.sh
environment.cpp		environment.cpp
euclid.cpp		euclid.cpp
expansion.cpp		expansion.cpp
fake-mobile.cpp		fake-mobile.cpp
fake.cpp		fake.cpp
fieldpattern.cpp		fieldpattern.cpp
flags.cpp		flags.cpp
floorshapes.cpp		floorshapes.cpp
game.cpp		game.cpp
geom-exp.cpp		geom-exp.cpp
geometry.cpp		geometry.cpp
geometry2.cpp		geometry2.cpp
glhr.cpp		glhr.cpp
goldberg.cpp		goldberg.cpp
graph.cpp		graph.cpp
help.cpp		help.cpp
heptagon.cpp		heptagon.cpp
history.cpp		history.cpp
hprint.cpp		hprint.cpp
hr-icon.ico		hr-icon.ico
hud.cpp		hud.cpp
hyper-main.cpp		hyper-main.cpp
hyper.cpp		hyper.cpp
hyper.h		hyper.h
hyper.rc		hyper.rc
hyper_function.h		hyper_function.h
hyperpoint.cpp		hyperpoint.cpp
hyperrogue-music.txt		hyperrogue-music.txt
hyperweb.cpp		hyperweb.cpp
hypgraph.cpp		hypgraph.cpp
inforder.cpp		inforder.cpp
intra.cpp		intra.cpp
inventory.cpp		inventory.cpp
irregular.cpp		irregular.cpp
items.cpp		items.cpp
kite.cpp		kite.cpp
landgen.cpp		landgen.cpp
landlock.cpp		landlock.cpp
langen.cpp		langen.cpp
language-cz.cpp		language-cz.cpp
language-de.cpp		language-de.cpp
language-fr.cpp		language-fr.cpp
language-pl.cpp		language-pl.cpp
language-ptbr.cpp		language-ptbr.cpp
language-ru.cpp		language-ru.cpp
language-tr.cpp		language-tr.cpp

License

zenorogue/hyperrogue

Folders and files

Latest commit

History