A SDL roguelike in a non-euclidean world.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
Zeno Rogue 2486937720 10.2s 1 week ago
.github/workflows Move `Makefile.simple` to just `Makefile`. 1 year ago
devmods rulegen:: tests improvements 5 months ago
dll Add cross-compile support 7 years ago
generators removed BUILDZEBRA from drawcell 3 years ago
hyperroid 12.0f 11 months ago
music fixed the new music 1 year ago
rogueviz rogueviz:: added dpgen and antidesitter to rogueviz-all 1 week ago
sounds sound credits updated 2 years ago
tessellations 12.0o 2 months ago
.gitignore Eliminate autotools/automake/configure. 1 year ago
.travis.yml Move `Makefile.simple` to just `Makefile`. 1 year ago
3d-models.cpp shadows supported in Euclidean 3D 2 years ago
CITATION.cff improved citation metadata 10 months ago
COPYING Initialization with hyperrogue-66 7 years ago
DejaVuSans-Bold.ttf Initialization with hyperrogue-66 7 years ago
Doxyfile Doxygen files added 3 years ago
FUNDING.yml GitHub sponsor added 3 years ago
Makefile intra:: first version 10 months ago
Makefile.rv fixed arg shifting 3 years ago
README.md README now explains what RogueViz is 4 months ago
achievement.cpp moved dual geometry puzzle to RogueViz 2 weeks ago
arbitrile.cpp fixup -- stars also do not have_valence 1 week ago
archimedean.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
asonov.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
attack.cpp Orb of the Sword can now kill yourself through mirror or topology 2 weeks ago
barriers.cpp arb:: tes files with tree data provided work again 1 week ago
basegraph.cpp fixed SDL2 (with GLEW) on Windows 3 weeks ago
bigstuff.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
binary-tiling.cpp ray:: now works with Binary4 product 9 months ago
blizzard.cpp MAJOR CHANGE: replaced (transmatrix,band_shift) pair with shiftmatrix 2 years ago
cell.cpp fixed adj_minefield_cells_full 4 weeks ago
celldrawer.cpp fixed numerical_minefield display to darken numbers correctly 4 weeks ago
changelog.txt 10.2s 1 week ago
checkmove.cpp Orb of the Sword can now kill yourself through mirror or topology 2 weeks ago
classes.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
colors.cpp refer to color by HTML name in commandline arguments 9 months ago
commandline.cpp CLI option -cview 1 week ago
complex.cpp sword attacks reflect in mirrors 2 weeks ago
complex2.cpp unified the Quest screen and Main menu. 2 weeks ago
config.cpp clearer comment on minimize_on_convert 1 week ago
content.cpp fixed the displayed unlock rule for Crossroads III in Casual 3 months ago
control.cpp all cheat keys are now displayed in the cheat menu -- also removed some outdated ones 1 week ago
crystal.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
debug.cpp all cheat keys are now displayed in the cheat menu -- also removed some outdated ones 1 week ago
dialogs.cpp custom dialog items 3 months ago
direntx.h Add "inline" to silence GCC's -Wunused-function warnings in direntx.h. 4 years ago
drawing.cpp fixed write_in_space to use poly_outline 4 weeks ago
earcut.hpp Remove extra semis in struct defs 1 year ago
embuild.sh emscripten uses ZLIB 2 years ago
environment.cpp slime spill is now predictable when multiple colors hit the same cell at once 2 months ago
euclid.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
expansion.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
fake-mobile.cpp XGD: filled circles and start with clearscreen 1 year ago
fake.cpp more guard fixes 2 months ago
fieldpattern.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
flags.cpp added flags for Dice 1 year ago
floorshapes.cpp fixed some CAP guards 2 months ago
game.cpp show treasure bubbles in Dice Reserve 1 week ago
geom-exp.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
geometry.cpp added CAP_RAY guard to intra stuff 2 months ago
geometry2.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
glhr.cpp fixed SDL2 (with GLEW) on Windows 3 weeks ago
goldberg.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
graph.cpp swords in mirrors are now displayed correctly 2 weeks ago
help.cpp fixed help for life Orbs in the shmup mode 2 weeks ago
heptagon.cpp init_heptagon fixup 1 year ago
history.cpp in history::progress, progress_each is now configurable 4 weeks ago
honeycomb-rules-344.dat reg3:: included tree rules for most hyperbolic honeycombs 1 year ago
honeycomb-rules-353.dat optimized the honeycomb rules by using the 'quotient' fieldpatterns 1 year ago
honeycomb-rules-354.dat reg3:: included tree rules for most hyperbolic honeycombs 1 year ago
honeycomb-rules-355.dat reg3:: included tree rules for most hyperbolic honeycombs 1 year ago
honeycomb-rules-435.dat optimized the honeycomb rules by using the 'quotient' fieldpatterns 1 year ago
honeycomb-rules-436.dat reg3:: included tree rules for most hyperbolic honeycombs 1 year ago
honeycomb-rules-534.dat optimized the honeycomb rules by using the 'quotient' fieldpatterns 1 year ago
honeycomb-rules-535.dat optimized the honeycomb rules by using the 'quotient' fieldpatterns 1 year ago
honeycomb-rules-536.dat reg3:: included tree rules for most hyperbolic honeycombs 1 year ago
hprint.cpp mapstreams:: now work with sstream too 2 weeks ago
hr-icon.ico Initialization with hyperrogue-66 7 years ago
hud.cpp expansion_analyzer is now in cgi 7 months ago
hyper-main.cpp hyper-main:: convenience functions for the shared library 7 months ago
hyper.cpp moved dual geometry puzzle to RogueViz 2 weeks ago
hyper.h 10.2s 1 week ago
hyper.rc 10.0n 5 years ago
hyper_function.h Add `explicit` and `override` consistently everywhere else. NFCI. 12 months ago
hyperpoint.cpp ultra-ideal vertices should work now 2 months ago
hyperrogue-music.txt fixed the new music 1 year ago
hyperweb.cpp emscripten: specify event targets to fix a JS error 11 months ago
hypgraph.cpp optimize_shift function for shiftpoint 2 weeks ago
inforder.cpp Add `explicit` and `override` consistently everywhere else. NFCI. 12 months ago
intra.cpp walking:: switch_walking function 3 weeks ago
inventory.cpp cleaned up where summoned creature appears for Orb of Life and Orb of Friendship 11 months ago
irregular.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
items.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
kite.cpp Eliminate -Woverloaded-virtual warnings from Clang. NFCI. 12 months ago
landgen.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
landlock.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
langen.cpp marked Hell as no-the 2 months ago
language-cz.cpp run away from the lava 2 months ago
language-de.cpp fixed message about 9 types 9 months ago
language-pl.cpp run away from the lava 2 months ago
language-ptbr.cpp fixed 'Orb of the Love' 7 months ago
language-ru.cpp run away from the lava 2 months ago
language-tr.cpp fixed message about 9 types 9 months ago
language.cpp Fix wrong Russian adjective ending. 12 months ago
legacy.cpp fixed extra semicolon 4 months ago
locations.cpp increased the value of special-move constants to >100 so that the limit on sides is indeed 120 2 months ago
makeh.cpp one more update for older compilers 3 years ago
mapeditor.cpp shift+A now exits the map editor 1 week ago
mapeffects.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
menus.cpp fixed Minesweeper in the highlights menu 2 weeks ago
mingw.condition_variable.h fixed the thread locking 2 years ago
mingw.invoke.h threads in MinGW 2 years ago
mingw.mutex.h threads in MinGW 2 years ago
mingw.shared_mutex.h fixed the thread locking 2 years ago
mingw.thread.h threads in MinGW 2 years ago
mobile.cpp mobile:: fixed lmouseover_distant 1 year ago
models.cpp new projections mostly for Solv: Lie perspective and Lie orthogonal 2 months ago
monstergen.cpp moved dual geometry puzzle to RogueViz 2 weeks ago
monstermove.cpp ghosts prioritize attacking players over attacking allies 2 weeks ago
multi.cpp unified the Quest screen and Main menu. 2 weeks ago
multigame.cpp moved dual geometry puzzle to RogueViz 2 weeks ago
mymake.cpp mymake:: SDL2 with mingw-cross 3 weeks ago
netgen.cpp fixed buggy resizing 2 months ago
nofont.cpp mymake now works with Emscripten 2 years ago
nonisotropic.cpp hybrid:: new value of 'next' for get_corner 1 week ago
orbgen.cpp Orb of Chaos is now forbidden in the Dungeon 5 months ago
orbs.cpp fixed Orbs not affecting slime 2 weeks ago
papermodeldata-help.txt papermodeldata files added 3 years ago
papermodeldata.txt papermodeldata files added 3 years ago
passable.cpp fixed slime movement on nonorientable 2 months ago
pattern2.cpp replaced std::sort in pattern2 with manual sort to avoid spurious warning in gcc 12.1.0 1 month ago
patterns.cpp exporting necessary stuff all over (in progress) 3 years ago
pcmove.cpp Orb of the Sword can now kill yourself through mirror or topology 2 weeks ago
polygons.cpp clear ext in prepare_shapes 2 months ago
quit.cpp removed the extra 'racing menu' option from the pause menu 1 week ago
quotient.cpp new geometry gHalfBring 9 months ago
racing.cpp fixed race reset 2 weeks ago
radar.cpp multi:: radar works correctly in split_screen 3 months ago
raycaster.cpp ray:: renamed deparabolic13 and enparabolic13 adding 'i' to signify that they reorder the coordinates 2 months ago
reg3.cpp more guard fixes 2 months ago
renderbuffer.cpp fixed renderbuffer from SDL 2 months ago
rug.cpp An option to play on a disk (and use bounded space rules). Also renamed 'bounded' flag to 'closed' or similar, and improved Halloween 1 month ago
rulegen.cpp tes:: convert:: an option to produce minimal representation 1 week ago
savemem.cpp Eliminate some use of CAP_FOO and ISFOO outside of the preprocessor. 2 years ago
savepng.cpp fixup to mymake/savepng 1 year ago
savepng.h Updated to 8.3j 6 years ago
scores.cpp choice of the land structure 1 year ago
screenshot.cpp fixed some CAP guards 2 months ago
shaders.cpp added comments for sl:: parameters, set them as param_, renamed steps to shader_iterations 1 month ago
shmup.cpp fixed race reset 2 weeks ago
shyp-geodesics.dat updated geodesic tables 2 years ago
sky.cpp multi:: radar works correctly in split_screen 3 months ago
solv-geodesics.dat updated geodesic tables 2 years ago
sound.cpp hooks_sync_music 1 month ago
source-doc.md Doxygen files added 3 years ago
sphere.cpp Eliminate -Woverloaded-virtual warnings from Clang. NFCI. 12 months ago
ssol-geodesics.dat updated geodesic tables 2 years ago
surface.cpp fix hyperroid builds 2 years ago
sysconfig.h display a hint when player hidden 3 months ago
system.cpp moved dual geometry puzzle to RogueViz 2 weeks ago
textures.cpp fixed some CAP guards 2 months ago
tour.cpp tour:: slide_action function 4 months ago
usershapes.cpp fixed some guards (in progress) 2 years ago
util.cpp fixed some CAP guards 2 months ago
vr.cpp vr:: fixed buttons 2 months ago
wfcgen.cpp Consistently name every hookset with prefix `hooks_`. NFC. 2 years ago
yendor.cpp peace:: cleanup 2 weeks ago

README.md

HyperRogue

TravisCI badge TravisCI badge TravisCI badge

Current version: 11.3f

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

macOS users might also have to edit /usr/local/include/SDL/SDL_gfxPrimitives.h at line 38 to use quote include.

Building HyperRogue from source

git clone https://github.com/zenorogue/hyperrogue.git hyperrogue
cd hyperrogue
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).

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.