2023-12-03 21:31:09 +00:00
|
|
|
# Super Mario Bros.: Tale of the Black Koopa
|
2023-12-03 00:20:32 +00:00
|
|
|
|
2023-12-03 21:31:09 +00:00
|
|
|
A hack of Super Mario Bros.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
## 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-tale-of-the-black-koopa.git super_mario_bros_tale_of_the_black_koopa
|
|
|
|
|
$ cd super_mario_bros_tale_of_the_black_koopa
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
Copy the graphics file:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
$ cp <path_to_the_graphics_file> src/smb.chr
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Building
|
|
|
|
|
|
|
|
|
|
To build the binary, execute:
|
|
|
|
|
|
|
|
|
|
```shell
|
|
|
|
|
$ cl65 -t nes -o target/smb.nes src/smbdis.asm
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
### Running
|
|
|
|
|
|
|
|
|
|
To run the game, open the file `target/smb.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](/LICENSE).
|
