mmm-nsf-changer/README.md
2023-11-09 17:36:44 -04:00

40 lines
2.9 KiB
Markdown

# Mega Man Maker Custom NSF Changer
Made by Timothy GFO (https://gamefeveronline.gitlab.io | https://youtube.com/gamefeveronline)
## What is this?
I got tired of waiting for actual custom music to be added to Mega Man Maker. So, I made this tool for changing the nsf files on Mega Man Maker to a custom one. The awesome part is that it works while you are playing. You only need to restart the level or respawn from check point. I made this in just one day (first commit), but I expect this to improve a lot in the future.
![Alt text](/nsf_changer.png?raw=true "NSF Changer window")
## Installation
You will need to install through PIP the package PySimpleGUI and maybe requests. The rest of the dependencies *should* be already installed.
## Usage
Please use at your own risk and make backups of the MegaManMaker folder before you use it.
To use it just launch the executable file (if available for your os) or type "python mmm-nsf-changer.py" in the terminal or commandline, and the GUI will launch. Maybe CLI support will come in the future. Then you choose your nsf file and where your Mega Man Maker folder is. Please note that support for Windows systems is not tested much since I don't use it. On windows systems the program may freeze for about 5 seconds, please DO NOT CLICK RESET ON MEGA MAKER WHILE THE TOOL IS FROZEN, IT WILL CRASH THE GAME.
## Features
* Easy way to choose a NSF, NSFe, SPC, VGM, GYM, AY, HES, KSS, SAP or GBS file as a replacement for every song in the game. Yes, you heard that right: You can use SNES Music, Sega Genesis Music, and more in Mega Man Maker!
* A "mute" button for replacing every song in the game with a silent song. For people that play Mega Man Maker with external music, like streamers.
* Reliable way to restore the original songs.
* A decent interface.
## Support
If you have any issues, which is probable, make a gitlab issue. There may be bugs.
## Roadmap
* add support for choosing a nsf file from a different drive letter (windows only)
* add selective mute, so that you mute every music except the boss music, or every song except menu music or both.
* figure out the best way to add a setting for changing each of the level editor songs, menu music, or a specific level song. Maybe an extra popup window or a check box for "replace every one" "menu" and "levelBuild"
* add a way to change boss music separate from level music and menu music
* add a way to show the available nsf files in the selected folder, like a playlist.
* add a settings file for the last folder chosen, so if there is a path try to use that so that you don't have to choose it manually
* fix slowdown on windows systems
* Instead of duplicating a single file a lot of times, maybe I'll implement symlink support.
* add autoupdater??
## Contributing
You can help with the project by testing it and reporting issues, or by making pull requests. Windows testers are especially needed since I don't daily drive Windows.
## License
For open source projects, say how it is licensed.