Skip to content

Yalilix/unsw-game

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

158 Commits
 
 
 
 
 
 
 
 

Repository files navigation

SUS1511

A multiplayer Among Us-inspired game set on a university campus where students must complete academic tasks while imposters attempt to sabotage the mission. It is ideal for first year COMP1511 students who may find it helpful in making friends, having fun while studying, and familiarising themselves with common locations on campus.

🎮 Game Description

SUS1511 is an online multiplayer social deduction game for 4-10 players. Players are divided into two teams:

  • Students: Answer course questions correctly to complete tasks around campus and save the university
  • Imposters: Eliminate students and sabotage their mission to take over the campus

Students win by completing all tasks or voting out all imposters. Imposters win by eliminating enough students or preventing task completion.

🚀 Features

  • Real-time multiplayer gameplay with 4-10 players
  • Educational twist - tasks involve answering COMP1511 course questions
  • Make friends in your first term at uni
  • Familiarise yourself with your classrooms on campus
  • Cross-platform support - works on desktop and mobile devices
  • Mobile-optimized controls - touch joystick for mobile players
  • Fog of war vision system - limited vision creates suspense
  • Emergency meetings and voting - discuss and vote out suspicious players
  • Responsive design - adapts to different screen sizes

🛠️ Setup & Installation

Prerequisites

  • Node.js (v16 or higher)
  • npm or yarn

Backend Setup

cd backend
npm install
npm run dev

Frontend Setup

cd frontend
npm install
npm run dev

The game will be available at http://localhost:5173 (frontend) with the backend running on http://localhost:3000.

🎯 How to Play

  1. Create or Join a Room: Enter a room ID to join friends or create a new room
  2. Choose Your Username: Pick a unique name for the session
  3. Wait for Players: Need 4-10 players to start the game
  4. Complete Tasks (Students): Answer questions correctly at task locations
  5. Eliminate Players (Imposters): Get close to students and eliminate them
  6. Call Meetings: Report dead bodies or call emergency meetings
  7. Vote: Discuss and vote to eject suspicious players
  8. Win: Complete objectives before the other team!

🎨 Credits

Blue Blob Asset

Special thanks to cactusturtle for the blue blob asset:

Thank you for downloading my art! I hope it helps you with your game dev!

You are free to use, alter, and distribute it as long as you provide credit. :)

Create and Be Merry
-cactusturtle

Educational Content

Course questions and content adapted from UNSW COMP1511 Programming Fundamentals.

📝 License

This project is open source. Blue blob asset is used with permission from cactusturtle under their specified terms.

🤝 Contributing

Feel free to contribute to the project by submitting issues or pull requests!

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors