Pinobot

This is a NetHack monster information IRC bot.

Bot commands

NetHack:            @?monster
NetHack:            @v?monster   (alias for just @?)
UnNetHack:          @u?monster
NetHack 3.4.3:      @V?monster
UnNetHackPlus:      @u+?monster
SporkHack:          @s?monster
GruntHack:          @g?monster
Slash'EM:           @l?monster
Slash'EM Extended:  @le?monster
SlashTHEM:          @lt?monster
NetHack Brass:      @b?monster
dNetHack:           @d?monster
notdNethack:        @n?monster
notnotdNethack:     @nn?monster
EvilHack:           @e?monster
XNetHack:           @x?monster
SpliceHack:         @sp?monster
Hack'EM:            @h?monster

How to run

Pinobot is made up of two components:

• pinobot-frontend : This part connects to IRC network.
• pinobot-monsterdb : This part connects to pinobot-frontend.

This design allows you to independently upgrade pinobot-monsterdb, without needing to disconnect Pinobot from IRC.

There is a file called pinobot_config.toml in the root of this repository. When you run pinobot, it will look for this file to figure out where it should connect, what nickname it should use, etc.

# Assuming cabal and ghc are installed.

# Terminal 1
$ cabal new-run pinobot-frontend

# Terminal 2, after `pinobot-frontend` has launched
$ cabal new-run pinobot-monsterdb

How to make Pinobot join and leave channels

cabal new-run pinobot-join '#foobar'

cabal new-run pinobot-part '#foobar'

How to make Pinobot monsterdb less flashy at start-up

Set NO_PINOBOT_POMPOUSNESS environment variable to any value. If it is defined, Pinobot will assume standard output does not understand colors, unicode and will not assume any terminal size.

The "pompousness" is only used to make the launch of monsterdb executable very flashy and pompous. It does not do anything else. Normally Pinobot will try to determine from its environment if it is in a Unicode-locale enabled terminal.

See lib/Terminal.hs for the implementation.

Patch

The NetHack code that was used in the generation of monster data is given as a patch in patch/unixmain.patch. You need to patch the file sys/unix/unixmain.c with that patch file.

You don't need to mess with the patch file unless you are a developer and want to hack with the data for some reason.