Mario-ISN

A Mario Bros game in C, ISN scientific project
Explore the documentation »


Report a bug · Suggest a feature

Table of Contents

1. About the Project
2. Getting Started
   • Prerequisites
   • Installation
   • Commands
   • Download release
3. Usage
4. Contributing
5. License
6. Acknowledgments

About the Project

Mario-ISN is a project for the baccalauréat scientifique, specializing in ISN (Computer Science and Numerical Sciences). The goal is to recreate a Mario Bros-type game in C language, using the SDL2 library.

The project received the second prize of Labex Digicosme:
🔗 Read the article (french)

Initially developed in 2017/2018 with 2 fellow students, the project has been updated in SDL2.

(back to top)

Getting Started

Here are the steps to run the project locally (currently only on macOS ARM64 - windows and linux in progress).

Prerequisites

• C
• Makefile
• CMake
• Ninja
• SDL2, SDL2_image, SDL2_mixer
• homebrew (macos)

Installation

⚠️ only for macos for moment

1. Clone the repository

git clone https://github.com/aymnms/mario-isn.git
cd mario-isn

2. Install dependencies

xcode-select --install                                 # Outils Apple (clang, lldb…)
brew install cmake ninja sdl2 sdl2_image sdl2_mixer    # CMake + (optionnel) Ninja

3. Build and Run

make run

Commands

To know what command you can to execute

make

Download release

macOS (only arm)

ℹ️ Note for distribution: The generated .app may be marked as coming from an unidentified source (attribute com.apple.quarantine). To run the application, go to system settings to “execute anyway”.

(back to top)

Usage

The game launches in windowed mode, with a main menu (the size of which cannot be changed). Use the keyboard arrows to move the player, jump and interact with enemies.

(back to top)

Contributing

Initial contributors

• Aymerick Michelet - @aymnms
• Anthony Quéré - @Anthony-Jhoiro
• Léo LIRZIN

And others... (or not 🥲)

License

Distributed under the MIT License. See LICENSE for more information.

(back to top)

Acknowledgments

• The ISN teaching team
• Labex Digicosme

(back to top)