The Hidden Trail

An immersive, browser-based puzzle game where you play as a Digital Recovery Agent racing against time to recover encrypted data from a missing whistleblower's fragmented server.

Overview

You have 60 minutes to bypass five levels of security, solve cryptic puzzles, and download "The Truth" before the government's Wipe Command destroys everything. Can you navigate the digital labyrinth and help The Archivist?

The Hidden Trail combines storytelling, puzzle-solving, and hacker aesthetics into an engaging interactive experience.

Features

• 🎮 5 Progressive Levels - Each with increasingly complex puzzles and challenges
• ⏱️ Real-time Timer - 60-minute countdown to maintain tension
• 🎯 Score Tracking - Earn points for puzzle solutions and efficient gameplay
• 🔒 Security Systems - Incorrect answers trigger system locks and penalties
• 🎨 Immersive UI - Terminal-style interface with typewriter effects and audio feedback
• 📖 Story-Driven - Narrative elements throughout the experience
• 🔊 Audio Cues - Sound effects enhance immersion and feedback

Getting Started

Prerequisites

• Any modern web browser (Chrome, Firefox, Safari, Edge)
• No server required - runs entirely in the browser

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/the-hidden-trail.git
   cd the-hidden-trail

2. Open index.html in your browser:

   open index.html

   Or simply drag index.html into your browser window.

How to Play

1. Start - Open the game and read the prologue to understand your mission
2. Progress - Complete puzzles at each level to advance
3. Solve - Enter the access key/solution when you figure out each puzzle
4. Win - Successfully complete all 5 levels before time runs out

Game States

• Victory - Reach the end and download The Truth
• Failure - Time runs out or security lockdown occurs
• System Lock - Incorrect answers trigger temporary system locks

File Structure

├── index.html           # Game prologue and entry point
├── level1.html          # Level 1: The Ghost in the Machine
├── level2.html          # Level 2
├── level3.html          # Level 3
├── level4.html          # Level 4
├── level5.html          # Level 5
├── level1.js            # Level 1 puzzle logic
├── level2.js            # Level 2 puzzle logic
├── level3.js            # Level 3 puzzle logic
├── level4.js            # Level 4 puzzle logic
├── level5.js            # Level 5 puzzle logic
├── shared.js            # Shared utilities (timer, scoring, audio, UI)
├── shared.css           # Styling for all levels
├── victory.html         # Victory screen
├── failure.html         # Failure screen
└── README.md            # This file

Technology Stack

• HTML5 - Game structure and layout
• CSS3 - Responsive styling with terminal aesthetics
• Vanilla JavaScript - Game logic, puzzles, and interactivity
• Web Audio API - Sound effects and audio feedback

Gameplay Mechanics

Timer

• Starts at 60 minutes
• Displayed in real-time in the header
• Game ends if timer reaches zero

Scoring

• Players earn points for solving puzzles
• Points displayed and tracked throughout the game
• Final score shown on victory screen

Security System

• Wrong answers trigger system locks
• Lock duration increases with repeated failures
• Adds challenge and consequence to puzzle-solving

Hint System

• Map icon (🗺️) in header can be clicked for hints
• Tracks hint usage

Customization

Branding

• Replace white.png with your event logo
• Replace image.png with your sponsor logo
• Update titles and headers in HTML files

Puzzles

• Each level's logic is in its corresponding .js file
• Modify puzzle solutions and difficulty as needed

Styling

• Edit shared.css to customize colors, fonts, and layout
• Terminal aesthetic can be easily modified

Timing

• Adjust the 60-minute limit in shared.js if desired
• Lock durations and delays can be customized

Browser Compatibility

Browser	Support
Chrome	✅ Full
Firefox	✅ Full
Safari	✅ Full
Edge	✅ Full
IE 11	❌ Not supported

Contributing

Feel free to fork, modify, and create your own version of The Hidden Trail! Some ideas:

• Add new levels
• Create custom puzzle themes
• Develop alternative story arcs
• Enhance the UI/UX
• Add difficulty settings

License

[Add your license here - e.g., MIT, GPL, etc.]

Acknowledgments

• Created for [Your Event Name]
• Special thanks to [Sponsor/Organization Names]

---

Ready to become a Digital Recovery Agent? Start the game and uncover The Truth!