Welcome to hunter2’s documentation!

hunter2 is a web-application for running puzzle hunts. It provides a platform to host and view author-created puzzles, monitor progression of teams, define automatic hints and unlockable clues and display statistics and graphs after the hunt is over.

The app is written in python using the Django framework and set up to be quickly deployable with docker-compose.

Contents:

• Setup
  • Development Environment
  • Production Environment
• Creating your first Hunt
  • Adding an Event
  • Creating an Admin Team
  • Team Sizes
  • Adding an Episode
  • Adding a Puzzle
  • Adding Static Media
  • Answers and Clues
  • Try it out
  • Regexes and Other Advanced Options
  • Discord Integration
• Running a Hunt
  • Create/Edit
  • Progress
  • Teams
  • Guesses
  • Stats
• Other Tasks
  • Testing
  • Deleting Objects
  • Anonymisation
• Configuration
  • Environment Variable Settings
  • Admin site settings
• Customisation
  • Trophies
  • Notification Sound
• Upgrading
  • Versions Requiring Manual Intervention
• Glossary
• Getting Started with Development
  • Overview
  • Manual Intervention
  • Setting up PyCharm
  • Common Tasks
  • MR Checklist