Skip to content

Prehtagonist/MAGRUN

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

15 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

๐Ÿš— MAGRUN

MAGRUN is a competitive, web-based driving game built around skill progression, speed control, and escalating seismic intensity. Players navigate obstacles, increase MAG levels, and compete on a persistent leaderboard to achieve the highest score.

MAGRUN combines arcade-style gameplay with polished UI, dynamic visual feedback, and a structured progression system.


๐ŸŽฎ Gameplay Overview

Players control a car navigating through increasingly difficult obstacles.

Progression is based on MAG Levels (MAG 1 โ€“ MAG 9).

Each MAG level increases intensity, speed, and visual escalation.

The game features crash detection, restart options, and return-to-menu controls.

A persistent leaderboard tracks top players over time.


๐ŸŒ‹ MAG System

The MAG system represents increasing seismic intensity during gameplay:

MAG Level Visual Identity

MAG 1 Pale Yellow / Cream MAG 2 Teal / Aqua Green MAG 3 Bright Green MAG 4 Light Green MAG 5 Yellow-Green MAG 6 Yellow MAG 7 Orange MAG 8 Red MAG 9 Cyan / Turquoise Blue

Each level features:

Unique glow effects

Icon badge reveal animations

Escalating difficulty

Cinematic moment at MAG 9 ("Seismic Collapse")


๐Ÿ† Leaderboard System

MAGRUN includes a persistent leaderboard system that tracks:

๐Ÿฅ‡ Rank

๐Ÿ‘ค Username

๐ŸŽฏ Highest Score

๐ŸŒ‹ Highest MAG Attained

๐Ÿ“… Date of Best Run

Features:

Automatically sorts by highest score (descending)

Top 3 special styling (Gold, Silver, Bronze)

Current player highlight with โ€œYOUโ€ badge

Player rank display even outside Top 10

Persistent storage across sessions


๐Ÿ‘ค Player Identity System

Before accessing the main menu, players must:

  1. Enter a unique in-game username.

  2. The username is stored persistently.

  3. Username replaces character name in the main menu.

  4. All leaderboard entries are tied to this identity.


โš™๏ธ Settings Menu

The game includes a structured settings system:

๐ŸŽฎ Gameplay

Difficulty: Easy / Medium / Hard

๐Ÿ”Š Audio

Music On / Off

Sound Effects On / Off

Mute All toggle

All settings update dynamically and persist across sessions.


๐ŸŽจ UI & Design Philosophy

MAGRUN is designed with:

Dark, modern UI

Smooth transitions

Subtle glow effects

Responsive layout (desktop + mobile)

Performance-optimized animations

Clean and competitive presentation


๐Ÿ“ Project Structure (Example)

/assets/ /audio/ background-music.mp3 /branding/ magrun-logo.png /mag-badges/ mag1.png mag2.png ... mag9.png


๐Ÿš€ Features

Realistic-feel car movement with momentum

Adjustable difficulty system

Persistent leaderboard

Dynamic MAG badge animations

Crash state system with return-to-menu option

Background music system

Mobile optimization

Smooth UI animations


๐Ÿ›  Technologies

HTML5

CSS3

JavaScript

LocalStorage (for persistence)

Responsive design principles

(Modify this section if using React, frameworks, or additional libraries.)


๐ŸŽฏ Project Goals

MAGRUN aims to:

Deliver competitive arcade-style gameplay

Encourage skill progression through MAG levels

Create long-term engagement via leaderboard tracking

Maintain clean, scalable, and modular architecture

Provide a polished user experience


๐Ÿ“ˆ Future Enhancements

Global online leaderboard (database-backed)

Player avatars

Weekly challenges

Additional car unlocks

Achievement system

Cloud save functionality


๐Ÿ“œ License

This project is proprietary unless otherwise stated. All branding, assets, and game systems are part of the MAGRUN project.


๐Ÿ‘จโ€๐Ÿ’ป Author : Prehtagonist

Developed as part of the MAGRUN competitive driving experience.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors