hx/mario-kart-js
1
0
Fork 0
mirror of https://github.com/Nathan-Richard-21/mario-kart-js.git synced 2026-06-03 18:06:34 +00:00
Code Issues Projects Releases Packages Wiki Activity
No description https://mario-kart-js.vercel.app
1 commit 1 branch 0 tags 18 MiB
  • JavaScript 56.7%
  • TypeScript 22.3%
  • CSS 17.9%
  • GLSL 2.8%
  • HTML 0.3%
Find a file
Exact
Nathan Richard 0f7a430598 first commit
2025-07-29 14:00:38 +02:00
public first commit 2025-07-29 14:00:38 +02:00
src first commit 2025-07-29 14:00:38 +02:00
.gitignore first commit 2025-07-29 14:00:38 +02:00
bun.lockb first commit 2025-07-29 14:00:38 +02:00
eslint.config.js first commit 2025-07-29 14:00:38 +02:00
index.html first commit 2025-07-29 14:00:38 +02:00
package-lock.json first commit 2025-07-29 14:00:38 +02:00
package.json first commit 2025-07-29 14:00:38 +02:00
README.md first commit 2025-07-29 14:00:38 +02:00
vite.config.js first commit 2025-07-29 14:00:38 +02:00

README.md

Mario Kart 3.js - JavaScript/WebGL Mario Kart Game

Mario Kart Banner

Demo Project: This is a demo project that brings the magic of Mario Kart to your browser using Three.js and WebGL technology.

Live Demo Link

Open in GitHub Codespaces

Features

  • Modern homepage with animations using GSAP
  • Both regular game mode and Time Trial mode
  • Enhanced UI with game information display
  • Realistic driving physics with drift mechanics
  • Particle effects for drift, boosts, and more
  • Sound effects and background music
  • Responsive design that works on desktop and mobile
  • Touch controls for mobile devices

How to Install

  1. Clone the repository:
git clone https://github.com/Nathan-Richard-21/Mario-Kart-game.git
cd Mario-Kart-game
  1. Install dependencies:
npm install
# or
bun install
  1. Start the development server:
npm run dev
# or
bun run dev
  1. Open your browser and navigate to http://localhost:5173 (or the URL displayed in your terminal)

Game Controls

Keyboard/Mouse

  • W or ↑ - Accelerate
  • A/D or ←/→ - Steer left/right
  • Space - Drift (Hold and steer to maintain drift, release for mini-turbo)
  • E - Use current item
  • R - Reset position

Mobile

  • Joystick on left side of the screen - Move/Steer
  • Buttons on right side - Special actions (jump, use items)

Game Modes

Regular Mode

  • Classic racing experience with regular controls

Time Trial Mode

  • Challenge yourself to beat your own record
  • Tracks your best lap and total time

Development Roadmap

  • Design modern landing page
  • Add Time Trial mode
  • Add game controls modal
  • Add countdown before race start
  • Implement background music and sound effects
  • Add smokes and particle effects
  • Add more items
  • Add texture to the flame shaders
  • Add curve/length modifiers to drift particles
  • Add Skid marks
  • Add wind screen effect when boosting
  • Design additional tracks and checkpoints
  • Add Minimap
  • Add more items:
    • Tennis ball
    • Bomb
    • Red shell
    • Treats

Project Information

This project is a non-profit fan project that recreates the fun of Mario Kart using web technologies. It's built with Three.js, React, and WebGL, demonstrating what's possible in modern web browsers.

The Mario Kart intellectual property is owned by Nintendo Co., Ltd. This project is not affiliated with Nintendo and is created for educational and demonstration purposes only.

License

License: MIT

MIT License

Copyright (c) 2025 Infinity Cybertech

This is a work by Infinity Cybertech.

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.