Skip to content

thehimmat/werewolf

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Werewolf - The Social Deduction Game

Introduction

Sus Puppies is an online multiplayer game based on the classic social deduction game Werewolf. The application supports up to 35 players to log in and participate live, with secret chats based on your role, all synchronized live. The game’s internal logic serves as the game narrator, so you and your friends can play, as one of the four main roles: Werewolf, Healer, Seer, or Villager.

Tech Stack

  • React.js: Version 17.0.2
  • Node.js with Express: Version 4.17.2
  • MongoDB with mongoose: Version 4.3.1
  • Socket.io: Version 4.4.1
  • Axios: Version 0.25.0
  • Bootstrap: Version 2.1.1
  • Styled Components: Version 5.3.3
  • use-Sound: Version 4.0.1
  • Webpack: Version 5.67.0
  • Babel: Version 17.16.12

Repo Installation

Local setup

  1. After cloning the repo, ensure that your terminal is in the root folder of the repo and run npm install
  2. Ensure you have an instance of mongodb running prior to moving on to next step.
  3. In your terminal still in the sus-puppies root dir, run the start script.
  4. After running start script, navigate to localhost:3000 in your browser

Scripts to run

  • npm start - Runs server instance and webpack

Demo

Imgur

Imgur

Imgur

Imgur

Features

  • Sync'd multiplayer experience
    • Match/Rule customization
    • Rendering different views based on role
  • Async chats
    • With exclusive rules
  • Animation & Sounds
  • Host controls
  • Login authentication
  • Fully functional warewolf game set (include roles/timer/voting)

Future Feature Updates

  • Video capabilities
  • Additional villager roles implemented
  • Leaderboard

Technical Challenges

  • Maintaining real time connections
    • Firebase vs Socket.io
  • Synchronizing state across multiple users
    • Having a selective state for different roles
    • Event management
  • Authentication for unique profiles
  • Adapting source material into a web application
  • Connecting front end to back end
    • Designing routes

Contributors

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 95.7%
  • CSS 3.4%
  • HTML 0.9%