# Super Mario Bros Remastered
A Remake / Celebration of the original 'Super Mario Bros.' games. Features new levels, custom modes, new characters, alongside a full level editor / custom level system!

<img width="3840" height="2160" alt="SMB1R_BANNER_printable" src="https://github.com/user-attachments/assets/ed0e97a8-614a-44e2-b69f-2654fca6196c" />

### Art by [@krystalphantasm.bsky.social](https://bsky.app/profile/krystalphantasm.bsky.social/post/3lvgmgvjeks2f)

### Download: https://github.com/JHDev2006/Super-Mario-Bros.-Remastered-Public/releases

# Requires an original SMB1 NES ROM to play! None of the original assets are contained in the source code, unless it was originally made by us!

# This does NOT act as a replacement for the original Super Mario Bros. games. Super Mario Bros. & Super Mario Bros.: The Lost Levels, can be played now on Nintendo Switch, through Nintendo Switch Online

## Features
- Super Mario Bros., Super Mario Bros.: The Lost Levels, Super Mario Bros. Special and All Night Nippon: Super Mario Bros. Fully recreated from the ground up!
- Improved physics / level design
- Resource Packs! Fully customize how the game looks and sounds.
- Custom Characters - Add in your own characters to use in game.
- Fully Open Source!
- Level Share Square Partnered
- Portable mode by creating `portable.txt` in the executable directory

## Downloading

### Windows/Linux
1. Go to the 'Releases' page
2. Look for the latest version
3. Download the .zip for your OS
4. Extract and run
5. Enjoy!

### macOS (Unofficial)
1. Go to the [macOS repo](https://github.com/yuriko-shimizu/Super-Mario-Bros.-Remastered-Public-Mac/releases)
2. (NOTE: THIS IS AN UNOFFICIAL FORK OF THE GAME)
3. Look for the latest version
4. Download the .zip file
5. Extract, drag into the 'Applictions' folder and run
6. Enjoy!

## Importing for editing
1. Download the source
2. Download Godot 4.5 beta 3
3. Import the project
4. Enjoy!

## Contributing
You are more than welcome to contribute any fixes / improvements you'd like, simply open a pull request, and I'll review it ASAP!

## System Requirements

Please refer to the Godot engine requirements for minimum and recommended hardware specifications.

[Minimum Requirements](https://docs.godotengine.org/en/latest/about/system_requirements.html#desktop-or-laptop-pc-minimum)

[Recommended Requirements](https://docs.godotengine.org/en/latest/about/system_requirements.html#id3)


## Issues
When opening an issue, please keep it to one report, per post, and try and be as helpful as possible, when telling me what has occured, so that its as easy to fix as possible.
Please do not open issues, for feature requests, suggestions, or opinions. BUG REPORTS ONLY

## Known Issues
There are a couple known issues, mainly due to being built off of Godot, and these issues existing in the engine itself.
- Steam deck controls do not work natively, you can circumvent this by setting up controller bindings to emulate keys instead, apologies.
- Physics are weird, when interacting with corners + the camera barrier
- Drop shadows jitter when playing with "Smooth Rendering"
- Several entities jitter at times.
- Blocks + coins, respawn when reloading resource packs
