Effects

Credits: Nin0, Zementblock

Effects from the original game
7xDysvlGILA

General explanation
Effects are split in two files, a  and a   file. All effect files in NSMBW can be found in the directory.

A  file contains the control information and a    file the graphic and texture data. For more information on the file formats themselves, consider visiting http://wiki.tockdom.com/wiki/BREFF_and_BREFT_(File_Format).

Some of the effects need certain sprites placed in the level to be spawned. The files  and   are always loaded though, which means adding a new entry here allows us to easily spawn the new effect with it's name only within our custom Code.

Adding new effects
(written for Windows, should work with other operating systems as well though)

After testing multiple tools, Wiimms SZS Tools proofed to be the most reliable one for adding new effects, as BrawlCrate crashes while editing breff files while BrawlBox breaks the files while saving. Wexos Toolbox supposedly didn't work for someone as well.

After installing Wiimms SZS Tools (wszst), you have to restart your computer once.

If wszst is installed it should have been added to your environment variables (Path). This makes it possible to use wzszt in the cmd without having to specify it's installation path.

Extracting existing effects
Open the cmd and go to the folder of your effects, e.g. : Now extract the existing effects, e.g   and  :

Adding a new effect
To add a new effect you have to make a copy of one of the extracted effects to use as a base.

Basically you have to duplicate an effect from the extracted files, e.g. for  and   in the following directories: (These directories get created while extracting the existing effects with wszst.)

If the new effect shall use the same image as the effect that was used as the base, there is no need to change the  file.

If a new texture should be used, you have to convert the new texture you want to put in the  folder using wimgt according to CLF78.

Now you repack the  and   (see below). Afterwards you can edit the added effects:

- You can edit the duplicated files in the repacked  file with the BREFF Editor.

- BrawlCrate may be able to replace textures in a  without breaking the file, try at your own risk though.

(Re-)Pack the breff and breft files
The last step now is to create the new breff and breft files. You can delete or backup your existing effect files at this point.

While in the directory where you extracted the existing effects, e.g. for  and , type: Now you have succesfully added your new effect(s) to the game.

Spawning effects with code
To spawn a new effect added to  and   you can use the following code: