Skip to content

Murder Mystery project is designed to engage users in a thrilling murder mystery investigation. Users explore locations, interact with suspects, and ultimately solve the mystery by determining the killer.

Notifications You must be signed in to change notification settings

Apollo-Blaze/Murder-Mystery

Repository files navigation

Ravenswood Murder Mystery

Welcome to the Ravenswood Murder Mystery Interactive Experience! Immerse yourself in a captivating mystery investigation, where you explore different locations, interrogate suspects, and use clues to ultimately identify the killer. The game is designed to provide an interactive and dynamic gameplay experience, enhanced with new features such as a notepad, loading screens, toast notifications, the ability to unlock clues from the chat history, and forensic analysis.


🕵️ Project Overview

The goal of this project is to create an immersive and interactive murder mystery experience where users can:

  • Navigate through different locations (e.g., dining room, kitchen, garden) to gather clues.
  • Interact with suspects, each with unique backgrounds, alibis, and motives.
  • Use clues from a dynamic notepad to help solve the mystery and choose the killer.
  • Engage in conversations with suspects powered by a Python-based NLP chatbot, which helps uncover hidden information and secrets.
  • Utilize forensic analysis to examine the crime scene in detail and uncover hidden evidence.
  • Use Speech-to-Text (STT) functionality to transcribe your spoken questions and responses with suspects.
  • Receive toast notifications for key events and actions to provide instant feedback and enhance interactivity.

New Features:

  • Notepad: A handy tool that keeps track of clues discovered throughout the game.
  • Loading Screens: Smooth transitions with loading indicators, adding suspense and enhancing the experience.
  • Unlockable Clues: As users progress, more clues become available in the chat history, allowing them to piece together the mystery.
  • Toast Notifications: Instant on-screen notifications that provide feedback on actions, clues found, or new locations unlocked, enhancing the user experience.
  • Music: Background music enhances the atmosphere, adding suspense during key moments.
  • Forensic Analysis: An investigative tool that reveals forensic details about the crime scene, adding depth to the evidence available.
  • Speech-to-Text: Transcribe your voice into text to ask questions and interact with suspects.
  • Responsiveness: The game is fully responsive, ensuring a seamless experience on both desktop and mobile devices.

🛠️ Tools and Technologies Used

Frontend:

  • React: For building the user interface and managing the interactive features.
  • Tailwind CSS: To style the components, implement a responsive layout, and create an immersive theme.
  • React Router: For navigation between different locations and suspects.
  • JavaScript & JSX: Used to handle dynamic content and manage user interactions.
  • React Toastify: Used to implement toast notifications for a better user experience.

Backend:

  • Python: A Python file uses Natural Language Processing (NLP) to power a chatbot that responds to user interactions, providing clues and alibi details.
  • Flask/Django: Can be used to handle backend requests and serve the chatbot responses.

🎨 Key Features

  1. User Navigation:

    • Users begin the game in a default location.
    • They can use a menu bar styled with a dark purple, slightly transparent background to navigate to different rooms.
    • Each room contains important clues related to the murder.
  2. Suspect Interaction:

    • Clicking on a suspect opens a chatbot interaction, allowing the player to ask questions about alibis, motives, and backgrounds.
    • The chatbot reveals new information that can be added to the notepad.
    • Toast notifications pop up when key discoveries or actions take place.
  3. Forensic Analysis:

    • Examine the crime scene for forensic evidence (e.g., blood samples, fingerprints).
    • Forensic findings are logged in the notepad and can help in making deductions.
  4. Unlocking Clues:

    • As the investigation progresses, users unlock new clues through interactions and exploration.
    • The chatbot responds based on the current context of the investigation, giving new details as the story evolves.
    • Toast notifications alert the player when new clues are found.
  5. Final Decision:

    • After gathering enough evidence, the player can choose the killer.
    • The chat history and clues in the notepad help in making an informed decision.
    • A toast notification confirms the final choice.
  6. Background Music:

    • Suspenseful and atmospheric background music sets the mood as players investigate.
    • Music changes dynamically based on the current location or event.
  7. Speech-to-Text (STT):

    • Use the Speech-to-Text feature to speak directly to the chatbot and uncover clues.
    • The STT functionality adds immersion by allowing players to directly speak their questions instead of typing them.
  8. Toast Notifications:

    • Instant feedback on game events such as discovering clues, interacting with suspects, or unlocking new areas.
    • Notifications appear on the screen and provide timely updates, helping players stay informed and engaged in the investigation.
    • The notifications are styled with Tailwind CSS to match the overall theme and feel of the game.
  9. Notepad:

    • Keep track of discovered clues with a dynamic notepad.
    • As users uncover new information, clues are added to the notepad, and the player can access them anytime during their investigation.
    • Clues are linked to specific locations or suspects, aiding in the process of identifying the killer.

🐞 Current Bugs to Be Fixed

  • Audio Clipping: In some scenarios, the background music may overlap or stop unexpectedly. This is particularly noticeable when transitioning between rooms.
  • Speech-to-Text Accuracy: The Speech-to-Text feature occasionally misinterprets certain words, especially with accents or unclear pronunciation.
  • Output Inaccuracy during Toast: Sometimes there are typos when clues are unlocked and the toast message pops up.
  • Forensic Logic: There is a logical error in hiding controls when clicking the Forensics button.

📝 Credits

This project was built as a creative exploration of interactive storytelling, combining frontend development, natural language processing, and UI/UX design. The goal was to create a fun, immersive experience that challenges players to solve a complex mystery.


🎥 Demo

Watch the interactive gameplay in action!

Demo of the Project


Feel free to explore, investigate, and most importantly—solve the mystery!

About

Murder Mystery project is designed to engage users in a thrilling murder mystery investigation. Users explore locations, interact with suspects, and ultimately solve the mystery by determining the killer.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published