Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/najlae01/mario
Super Mario - CS50 Version
https://github.com/najlae01/mario
cs50 gamedev love2d lua
Last synced: about 1 month ago
JSON representation
Super Mario - CS50 Version
- Host: GitHub
- URL: https://github.com/najlae01/mario
- Owner: najlae01
- Created: 2024-05-12T19:03:57.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-05-28T13:01:26.000Z (6 months ago)
- Last Synced: 2024-09-26T19:43:45.064Z (about 2 months ago)
- Topics: cs50, gamedev, love2d, lua
- Language: Lua
- Homepage: https://youtu.be/TNy-LPcTCSg
- Size: 16.9 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Super Mario - CS50 Version
## Introduction
This is a simplified version of the classic game "Super Mario" developed as part of the CS50 Introduction to Game Development course. In this game, players control Mario as he navigates through various levels, avoiding obstacles, defeating enemies, and collecting coins to reach the end goal.
## Features
- Side-scrolling platformer gameplay.
- Player movement and jumping mechanics.
- Basic enemy AI with collision detection.
- Level generation with random obstacles and platforms.
- Collectible coins and power-ups.
## Additional Features (from Game Dev Specifications)
1. **Safe Player Spawning**: The player is always spawned above solid ground. This ensures that the player starts the level safely and does not fall upon spawning.
2. **Key and Lock Mechanic**: Generated random-colored key and lock block that unlocks when the player collides with it. The goal post should spawn at the end of the level if the locked block is collected.
3. **Dynamic Level Length**: When the player reaches the goal post, the level is regenerated, the player is spawned at the beginning again, and the level is a little longer than before.
## Controls
- Arrow keys: Move Mario left or right.
- Spacebar: Jump.
## Installation
To run the game, ensure you have Love2D framework installed on your system. You can download Love2D from [the official website](https://love2d.org/).
Clone this repository to your local machine:
```
git clone https://github.com/najlae01/mario
```
## Usage
Navigate to the project directory and run the game with Love2D:
```
cd mario
```
```
love .
```
## Credits
- Developed with Love2D (Lua) as part of the CS50 Introduction to Game Development course.
- Game development specifications and guidance provided by CS50 team.