🎮 Gravity Runner: Defy Physics, Collect Coins, Blame the Wall (STRONGLY ENCOURAGE USING TWO DEVICES TO TEST)

A high-speed, gravity-bending, friendship-testing arcade showdown where "up" is negotiable.

⚠️ Warning: May cause sudden outbursts of laughter, frustration, and questionable accusations of cheating. Play responsibly (or don't, we're not your mom).

---

🚀 Features That'll Make Newton Question His Life Choices

• Multiplayer Mayhem

  • Challenge a friend or a random internet stranger (who are definitely not bots named "Steve").
  • Real-time competition where lag is just an excuse for your poor performance.

• Gravity? More Like Suggestion

  • One tap flips your world upside down (literally).
  • Master the art of aerial dodging or faceplant into spikes like a noob.

• Obstacle Course of Poor Decisions

  • Dodge pipes, spikes, and your own bad timing.
  • Rocket wall slowly crushes your dreams (and your character).

• Persistent Accounts (Because We Know You'll Be Back)

  • Register once, cry forever. Your stats survive server restarts (unlike your dignity).
  • Password security so strong. If you forget it, just register a new account ;)

• Retro UI That Hurts So Good

  • Pixel-perfect fonts that scream "I grew up with dial-up".
  • Colors so vibrant they might violate international treaties.

---

🗂️ Installation: A Three-Step Program to Regret

1. Clone Like You Mean It

   git clone https://github.com/yourusername/gravity-runner.git
   cd gravity-runner

2. Install Dependencies (a.k.a. Magic Spells)

   npm install

   This will install:

• express (web server)
• socket.io (real-time multiplayer)
• bcrypt (password hashing)

3. Start the Party (and the Server)

   node server.js

4. Open Your Browser to http://localhost:8000
   (If it doesn't work, try turning it off and on again.)

---

🕹️ How to Play (Survival Not Guaranteed)

1. Sign Up or Log In

   • Register with an email you'll forget or use "password123" like everyone else.

2. Find a Victim

   • Wait for matchmaking or drag a friend into this mess.

3. Controls

   • PC: Your mouse, left click :)

4. Win Conditions

   • Collect coins to add your score.
   • Survive longer / Run further to add your score
   • Who have larger score in the end, who wins!!!

5. Pro Tips

   • Be careful of the pipes, they will push you back to COMP3711 :)
   • Spikes hurt. A lot.
   • Blaming lag is always acceptable.

---

🕹️ How to play with different devices?

1. Make sure you're connecting to the same wifi

2. Find your host's ip address

   • https://www.avg.com/en/signal/find-ip-address

3. Replace localhost to your ip address

   • EX. http://localhost:8000 -> http://yourIPaddress:8000

🛠️ Project Structure (For Nerds)

gravity-runner/
├─ public/            # Where the magic happens
│  ├─ index.html      # The main event
│  ├─ login.html      # "Forgot password?" lol no
│  ├─ register.html   # Point of no return
│  ├─ game.js         # Spaghetti code central
│  └─ main-game.css   # Pretty colors go here
│  └─ wavs and mp3    # sounds that sound cool
│  └─ gameover.html   # where the game ends
├─ users.json         # Our collection of poor souls
├─ server.js          # The brains of the operation
├─ package.json       # Dependencies and hopes
└─ README.md          # You're reading it right now

---

❓ FAQ (Frequently Avoided Questions)

Q: Why is the wall so fast?
A: To teach you humility.

Q: Can I play against AI?
A: No, but you can pretend your friend is AI.

Q: Is this game balanced?
A: Absolutely not. That's what makes it fun.

Q: How do I report bugs?
A: Yell into the void (or open an issue).

---

🎉 Special Thanks To:

• Sir Isaac Newton (for his laws that we ignore)
• The concept of gravity (for being so flexible)
• You (for reading this far)

Now go flip some gravity! 🚀