Skip to content
/ gdfxr Public
forked from timothyqiu/gdfxr

timothyqiu's sfxr Godot editor plugin ported to Pandemonium.

License

Notifications You must be signed in to change notification settings

Relintai/gdfxr

 
 

Repository files navigation

gdfxr

MIT license AssetLib 中文 README

A Godot plugin that ports sfxr, the popular program of choice to make retro sound effects for games.

You can use sfxr sound files like regular audio files in Godot and edit sound files like in the original sfxr.

🚧 Checkout the godot-4 branch if you want to use this plugin in Godot 4.

Installation

This is a regular plugin for Godot. To install, download the ZIP archive, extract it, and move the addons/ folder it contains into your project folder. Then, enable the plugin in project settings.

Usage

After enabling the plugin, you'll see a bottom panel named "gdfxr" appear. This is the sound editor.

Buttons on the left are sound generators of 7 different categories. There are also an option to mutate the current sound slightly, and an option to generate a completely random sound. These are the buttons you'll be working with most of the time.

After a random sound is generated with the generator buttons, you can fine-tune the sound with the controls on the right.

The generated sound can be saved and edited later as an .sfxr file. These files only contain the generator parameters, so they are only about 100 bytes. But they can be used directly as regular AudioStreams.

If you want to reuse an existing sound from the original sfxr, make sure to save it with an .sfxr extension. You can also load & edit the .sfxr file with the original sfxr.

Options for changing Looping, Bit Depth, and Sample Rate are available as import options of the .sfxr file. You can find these options in Godot editor's Import dock.

Note: Due to performance constraints with GDScript, the editor may freeze a bit when generating long sounds. This only happens in-editor. Using .sfxr files in-game won't generate anything at runtime.

Changelog

See CHANGELOG.

About

timothyqiu's sfxr Godot editor plugin ported to Pandemonium.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • GDScript 99.3%
  • Makefile 0.7%