Inspiration

Reddit has always been a treasure trove of communities, memes, and inside jokes. We were inspired by the idea of turning Reddit's vast ecosystem into an interactive game where users could test their knowledge of the platform while having fun. The concept of a mystical treasure hunt with Zephyrus as the guide originated from a desire to create an immersive experience that makes users feel like they're on an epic quest, rather than just playing another trivia game.

What it does

ReadyPlayerHunt transforms Reddit into a mystical treasure hunt game where players solve riddles to discover specific subreddits. Users join Zephyrus, the Keeper of Secrets, in daily challenges that test their Reddit knowledge through creative puzzles. Players earn keys for correct answers, compete on a real-time leaderboard, and experience personalized welcome messages based on when they join. The game features a beautiful, responsive interface that fits perfectly within any viewport without scrolling.

How we built it

We built ReadyPlayerHunt using React 19 with TypeScript for the frontend, Express.js for the backend logic, and Tailwind CSS for styling. The project is deployed on Devvit, Reddit's developer platform, which allows seamless integration with Reddit's ecosystem. We used Vite as our build tool for fast development and optimized production builds. The game state management uses React hooks, and we implemented a quest generation system that creates diverse riddles targeting different types of Reddit content (subreddits, users, memes, etc.).

Challenges we ran into

The biggest challenges included: CSS Integration Issues: Multiple attempts to get Tailwind CSS working properly with the Devvit platform, including version conflicts and configuration problems State Management Complexity: Initially had issues with localStorage persistence and complex state dependencies that caused rendering problems Quest Solvability: Early versions had vague, unsolvable riddles that frustrated users - we had to redesign the quest system to be more direct and fair Platform Integration: Learning Devvit's specific requirements and ensuring our app worked seamlessly within Reddit's environment

Accomplishments that we're proud of

Created a fully functional, immersive game that transforms Reddit into a treasure hunt experience Successfully integrated with Reddit's platform using Devvit, including username detection and API calls Built a responsive design that works perfectly on all screen sizes without scrolling Developed a quest system with diverse, solvable riddles that test different aspects of Reddit knowledge Implemented real-time leaderboards and scoring systems Created a memorable character (Zephyrus) that guides users through the experience

What we learned

Devvit Platform: Gained deep understanding of Reddit's developer platform and its capabilities CSS Framework Integration: Learned the complexities of integrating modern CSS frameworks with specific deployment platforms Game Design: Discovered the importance of balancing challenge with solvability in puzzle games State Management: Improved our skills in React state management and localStorage integration User Experience: Learned how to create immersive experiences that feel like games rather than simple web apps

What's next for ReadyPlayerHunt

Progressive Hints System: Add hints for difficult quests to help players who get stuck Social Features: Implement friend systems and team-based challenges Advanced Scoring: Add time-based bonuses and streak multipliers Quest Categories: Expand into different types of challenges (image recognition, audio clues, etc.) Mobile Optimization: Further enhance the mobile experience with touch-friendly interactions Community Features: Allow users to submit their own riddles and vote on quest difficulty Achievement System: Add badges and milestones for different accomplishments Multiplayer Modes: Real-time competitions and collaborative puzzle-solving

Built With

Share this project:

Updates