SSPy - A python-based level editor for SS+, Sound Space, and Vulnus
What's up with the previous versions of the FAQ?
I was unreasonably angry at the Vulnus community. I don't hold those views anymore, and I'm sorry if they disturbed you.
What platforms does this run on?
Almost any platform that supports OpenGL and Python. Windows, MacOS, and most Linux distributions should work.
What do I do if it crashes?
Report it! My discord tag is in the crash message, but if you can't reach me from there, feel free to open an issue.
When the program crashes, an error message is written to crashlog.txt
in the directory you ran the program from.
Include this in your crash report, it helps me diagnose the issue.
First, you're going to need Python. This is developed on Python 3.10.8.
- If you're on Windows 10, you can get it on the Microsoft Store.
- You can probably get Python 3.10 using your package manager.
- If you don't fall into either of the two above, you can get it from the official website.
You're also going to need ffmpeg. Same story as with Python:
- If you're on Windows 10, you can get it on the Microsoft Store.
- ffmpeg should be in your package manager.
- You can get a download from the ffmpeg website.
Next, you're going to need a local copy of the repository.
- If you have
git
installed, you can rungit clone https://github.com/balt-dev/SSpy/ sspy
in the command prompt to get it. - Otherwise, you can download and extract the repository as a zip file.
Finally, you need to install the python libraries that this runs on.
You can do this by running pip install -r requirements.txt
(or pip3
if pip
isn't found)
in the command prompt in the directory you extracted/cloned into.
- If you get an error about missing Microsoft Visual C build tools, follow the link it gives you and install those.
If everything goes right, you should be able to run the program by running python main.py
in the command prompt.
If you're getting errors past that, please create a bug report.
It's crashing and complaining about a file not found when loading a map!
Check if you've added ffmpeg
to your system PATH.
It's giving me a divide by zero error!
You probably did something that doesn't make sense. Report the crash.
My song file is corrupted! What do I do?
This usually happens when the level is interrupted during saving. It's good practice to make backups often. Not much you can do :/
If it crashes, report the crash to me and I'll handle it. Make semi-frequent backups.
The code behind the file picker was taken from https://github.com/Zygahedron/Parabox-Editor, with explicit permission from the repository owner.
The in-app file picker has been removed in favor of a native dialog.
TODO: make a demo of the editor in action