Monarch Of The Hill - base infrastructure for computer-based puzzle contests
Go to file
Neale Pickett 4112c04c87 Document some stuff 2015-04-12 11:33:53 -06:00
bin Document some stuff 2015-04-12 11:33:53 -06:00
doc Installation script 2015-04-09 17:40:03 -06:00
html Document some stuff 2015-04-12 11:33:53 -06:00
src And with that, I think it is working again 2015-04-12 11:11:15 -06:00
.gitignore tweak scoreboard 2012-02-02 16:51:19 -07:00
README Document some stuff 2015-04-12 11:33:53 -06:00
install And with that, I think it is working again 2015-04-12 11:11:15 -06:00

README

Dirtbags King Of The Hill Server
=====================

This is a set of thingies to run our KOTH-style contest.
Contests we've run in the past have been called
"Tracer FIRE" and "Project 2".

It serves up puzzles in a manner similar to Jeopardy.
It also track scores,
and comes with a JavaScript-based scoreboard to display team rankings.


How Everything Works
----------------------------

I should fill this in, but I don't feel like anybody would read it.
Send an email to <neale@woozle.org> asking me how it works,
and I'll write this part up and email it back to you :)


How to set it up
--------------------

It's made to be virtualized,
so you can run multiple contests at once if you want.
If you were to want to run it out of `/opt/koth`,
do the following:

	$ mkdir -p /opt/hack/mycontest
	$ ./install /opt/hack/mycontest
	$ cp kothd /opt/hack
	
Yay, you've got it set up.


Installing Puzzle Categories
------------------------------------

Puzzle categories are distributed in a different way than the server.
If you have one,
just run

	$ /opt/koth/hack/bin/install-category /path/to/my/category
	

Running It
-------------

Get your web server to serve up files from
`/opt/koth/hack/www`.

Then run `/opt/koth/kothd`.

It's up to you not to be a bonehead about permissions.