Skip to content

timparenti/puzzlehunt_server

 
 

Repository files navigation

Build Status Coverage Status

puzzlehunt_server

Server for Puzzlehunt CMU's bi-annual puzzlehunt. Includes basic features such as per-puzzle pages, automatic answer response, teams, customizable unlocking structure, and admin pages to manange submissions, teams, as well as hunt progress. It also includes automatic team creation from registration, privacy settings for hunts, cool charts, a built in chat, and automatic file fetching and hosting.

Documentation can be found at http://docs.puzzlehunt.club

While there is fairly large amount of configuration making this specific to Puzzlehunt CMU, if you are interested in getting this running elsewhere, let me know. I'd be happy to help anyone who wants to get this up and running for their needs.

Please submit issues for any bugs reports or feature requests.

Super simple setup

If you just want to get started developing or want to stand up a simple test server and don't care about security, you can follow the following steps:

  1. Install Virtualbox.
  2. Install Vagrant.
  3. Make a folder for the VM.
  4. Clone this repository into that folder. (such that the folder you made now contains only one folder named "puzzlehunt_server")
  5. Copy the Vagrantfile from the config folder within the puzzlehunt_server folder out into the folder that you made.
  6. Run "vagrant up" from the folder you made and wait for it to complete.
  7. You should now have the server running on a newly created VM, accessible via http://localhost:8080. The repository you cloned has been linked into the VM by vagrant, so any changes made to the repository on the host system should show up automatically. (A "vagrant reload" may be needed for some changes to take effect)

About

Server for Puzzlehunt CMU's bi-annual puzzlehunt.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 64.5%
  • HTML 22.9%
  • JavaScript 9.0%
  • CSS 2.0%
  • Shell 1.3%
  • Ruby 0.3%