noobhack helps you ascend at nethack
# nethack is hard
[NetHack](http://www.nethack.org/) is hard. noobhack makes it easier. It remembers stuff about the Mazes of Menace that would otherwise be tedious for you.
# how does noobhack help me?
# awesome! how do i get started?
Installing noobhack is easy for the gentleman adventurer who uses pip.
$ pip install noobhack
Or for those old buggers amongst us, easy_install works just as well.
$ easy_install noobhack
Start noobhack by typing
This will start a normal game of nethack. You can play nethack without ever consulting noobhack, but if you want to consult the helper console simply press tab. To dismiss it press tab again.
You can also open the map mode by typing the backtick key ‘`’ and dismiss it again by pressing the same. When in map mode, you can scroll the map with the ‘h’, ‘j’, ‘k’, and ‘l’ keys (just like walking in the game)
# but explanations are boring, show me screenshots!
![Map](http://samfoo.github.com/noobhack/images/screenshots/map.png) ![Map 2](http://samfoo.github.com/noobhack/images/screenshots/map-2.png) ![DEC Graphics](http://samfoo.github.com/noobhack/images/screenshots/dec-graphics.png) ![Price ID 2](http://samfoo.github.com/noobhack/images/screenshots/price-id-2.png) ![Price ID Selling](http://samfoo.github.com/noobhack/images/screenshots/price-id-sell.png) ![Price ID](http://samfoo.github.com/noobhack/images/screenshots/price-id.png)
# does noobhack work on public servers like nethack.alt.org (NAO)?
Yup, you can start a remote game by doing something like:
% noobhack -h nethack.alt.org
# but, noobhack doesn’t do (pudding farming | automatically solve sokoban | ascend for me)!
Fret not, noobhack allows you to write your own plugins!
more plugin documentation coming soon
# isn’t this cheating?
Some people might (and I suspect will) consider noobhack cheating. However, before you start chuggin’ a gallon of haterade, consider this: