BGChanges Generator

This tool allows you to enhance the experience of your simfiles, by allowing you to easily integrate and synchronize background visuals with music, increasing player immersion.

You can specify specific instructions for each background change within a chart. The generator operates on a set of attributes that define each background change event.

Notice: The tool will parse the file and display the existing BGChanges. If none exist, it will use your current background filepath as the first image. You can then modify the existing BGChanges or add new ones. Attributes are listed below.

  • Background File/Folder: The relative filepath to the background image or folder. LUA files are allowed. If a folder is given, it looks for “default.lua”.
  • Beat: The beat a BGCHANGE occurs. Can be negative to start before the first beat.
  • Update Rate: The update rate of the BGCHANGE in Hz. Yes, that's right, in Hz. The formula for this value is as follows: 1 / ((60 * Beats) / BPM).
  • CrossFade: A checkbox to enable crossfading between the current and next background. Overriden by Effect.
  • StretchRewind: A checkbox to enable stretching and rewinding of the background. Overriden by Effect.
  • StretchNoLoop: A checkbox to enable stretching without looping the background. Overriden by Effect.
  • Effect: The visual effect to apply to the background.
  • Transition: The transition effect to apply to the background.
  • Color1/Color2: Formatted as Red^Green^Blue^Alpha, with the values being from 1 to 0, Passed to the BackgroundEffect with the LuaThreadVariable “Color1”/“Color2” in web hexadecimal format as a string. Alpha is optional.
  • File2: The relative filepath to the second background image or folder.