Skip to content

utoxin/TimTheWordWarBot

Repository files navigation

Timmy - The NaNoWriMo Wordwar Bot

Timmy is an IRC bot created for use in NaNoWriMo chatrooms. He has commands to
run short wordwars (contests to write as many words as possible in a set period
of time), timers, writing challenges, and possibly other useful commands.

He also has a plethora of silly commands and abilities that serve to help
entertain the writers in the chatroom. These abilities can be disabled in any
given channel, if the people in that channel would prefer to only use the useful
commands.

Timmy was originally created in PHP in 2008 by MysteriousAges, and ported to
Java in 2009. Utoxin started helping in 2010, and has done significant work in
cleaning up the codebase and adding new advanced functionality such as the
Markov Chain chatter code.

If you wish to run your own instance of Timmy, there's a few things you'll need
to do. The most difficult part will be setting up your own Twitter Account and
API connection for him to use. You will also need a database, which you can
pre-fill with the 001-schema.sql file from this repository.

Finally, you'll need to rename the example config file and fill in the DB
connection values. If you have any questions, you're welcome to ask, and I'll
try to answer as quickly as I can.

GitHub Repository: https://github.com/utoxin/TimTheWordWarBot
NaNoWriMo Profile: http://www.nanowrimo.org/en/participants/timmybot
Twitter Account: @BotTimmy