Monarch Of The Hill - base infrastructure for computer-based puzzle contests

Go to file

Paul Ferrell 2acd145d0a Minor bug fix, documentation added.		2016-10-18 11:24:46 -06:00
bin	Merge branch 'master' of https://github.com/dirtbags/moth	2016-09-21 19:23:18 -06:00
doc	devel-server: start to serve puzzles	2016-10-16 03:47:50 +00:00
www	Add preview background	2016-10-16 21:22:02 -06:00
.gitignore	Reworked some basics of how the Puzzle class works. Shouldn't look to different from the outside.	2016-10-17 13:24:54 -06:00
LICENSE.md	Initial work on new format puzzles, new development server	2016-10-14 22:26:47 -06:00
README.md	Move overview into its own file	2016-01-31 20:45:35 -07:00
TODO.md	Fill in "How It Works" a bit	2016-01-31 20:41:22 -07:00
answer_words.txt	Files now come with a file handle to the original file.	2016-10-17 19:58:51 -06:00
build-puzzles	Initial work on new format puzzles, new development server	2016-10-14 22:26:47 -06:00
devel-server.py	Files now come with a file handle to the original file.	2016-10-17 19:58:51 -06:00
install	Changed points restore output to Neale's stupid space delimited format. Added url param 'snapshot' to specify a points snapshot to restore (0-19). Changed points log storage to an array of the 20 most recent points logs.	2015-05-28 14:15:05 -06:00
kothd	I actually tried running kothd this time	2015-04-13 13:23:10 -06:00
mistune.py	Initial work on new format puzzles, new development server	2016-10-14 22:26:47 -06:00
mothd	sorted font issues	2016-09-22 09:53:03 -06:00
puzzles.py	Minor bug fix, documentation added.	2016-10-18 11:24:46 -06:00

README.md

Dirtbags Monarch Of The Hill Server

This is a set of thingies to run our Monarch-Of-The-Hill contest, which in the past has been called "Tracer FIRE", "Project 2", "HACK", "Queen Of The Hill", and "Cyber FIRE".

Information about these events is at http://dirtbags.net/contest/

This software 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

This section wound up being pretty long. Please check out the overview for details.

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/koth/mycontest
$ ./install /opt/koth/mycontest
$ cp kothd /opt/koth

Yay, you've got it set up.

Installing Puzzle Categories

Puzzle categories are distributed in a different way than the server. After setting up (see above), just run

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

Running It

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

Then run /opt/koth/kothd.

Permissions

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

Install sets it so the web user on your system can write to the files it needs to, but if you're using Apache, it plays games with user IDs when running CGI. You're going to have to figure out how to configure your preferred web server.