super-mario-bros-corrected/README.md

# Super Mario Bros. Corrected

Super Mario Bros. with as many bugs and inaccuracies corrected as possible; includes every optimization from Super Mario Bros. Optimized.

![Super Mario Bros. Corrected in action](/demo.png)

## Usage

### Requirements

cc65 must be installed on your system; the oldest supported version is `2.18`. No other dependencies are required.

Additionally a file containing the graphics for the original Super Mario Bros. game must be present on your system. This file is not provided.

### Installing

Clone this repository locally:

```shell
$ git clone https://forge.thatspaceandtime.org/ooxie/super-mario-bros-corrected.git super_mario_bros_corrected
$ cd super_mario_bros_corrected
```

Copy the graphics file:

```shell
$ cp <path_to_the_graphics_file> src/chars.bin
```

Create the target directory:

```shell
$ mkdir target
```

### Building

To build the binary, execute:

```shell
$ cl65 -t nes -o target/super_mario_bros_corrected.nes -C src/linker.cfg src/main.asm
```

### Running

To run the game, open the file `target/super_mario_bros_corrected.nes` in your favorite NES emulator. Alternatively you can run it on original hardware.

### Playing

Refer to the original manual for Super Mario Bros.

## License

The source code of this project is not licensed, as the original work it is based on is not (see [LICENSE](/ooxie/super-mario-bros-corrected/src/branch/master/LICENSE)).