<h1><img src="https://github.com/user-attachments/assets/7136948e-4a1c-4ad7-bf5f-b1cdc793a694" alt="BrawlInstaller Logo" width="32" height="32"/> BrawlInstaller</h1> An all-in-one tool for managing mods in Brawl. Manage fighters, costumes, stages, music, and trophies with flexible tools that can support virtually any build.

Features

Add, edit, or delete all of the following in virtually any build:
- Fighters
- Stages
- Music
- Trophies
Manage HD textures associated with any of the above.
Quickly install fighters stored in BrawlInstaller's .fighterpackage format in just a few clicks.
Create .fighterpackage files with ease, or extract them directly from a build.
Automatic validation checks warn you of conflicts, and numerous controls in place to easily resolve said conflicts.
Automatic backups created whenever BrawlInstaller makes a change, which can be restored when unexpected results occur.

Installation

Download BrawlInstaller-win-Portable.zip in the latest release and extract it to a destination of your choosing.
Run BrawlInstaller.exe.
Set your build path to the root of your build.
On the settings tab, set your settings to one of the presets, make any modifications necessary, and hit "Save".

Once you've completed these steps, you're ready to start using BrawlInstaller. For more information, please view the wiki.

Reporting Issues

If you encounter an error or unexpected behavior with the program, please open an issue on the issues page or report the issue on the BrawlInstaller Discord server. If you encountered an error, an Error.txt file should be generated in your BrawlInstaller directory, so please provide that in the issue report. Please also provide as much detail as possible on how to recreate the issue.

Resources

BrawlInstaller Discord Server - Public Discord where you can discuss BrawlInstaller and get support.
Custom Brawl Modding Discord Server - Main hub for discussing Brawl modding.

Credits

BrawlCrate/BrawlLib
- Created and subsequently maintained by Kryal, BlackJax96, libertyernie, and soopercool101
- GNU Lesser General Public License v3.0
Color Smash
- Originally created by Peter Hatch
- GNU Affero General Public License v3.0
lavaKirbyHatManagerV2
- Created by QuickLava
- Used with permission from author
Porting Tools
- Created by TheGag96
- Used with permission from author
Ookii.Dialogs.Wpf
- Copyright (c) C. Augusto Proiete 2018-2021
- Copyright (c) Sven Groot 2009-2018
- BSD 3-Clause "New" or "Revised" License
ColorPicker
- Copyright (c) PixiEditor Organization
- MIT License

Testers

The following people were part of the BrawlInstaller testing team to provide feedback and bug reports during development.

Burrotis Man/SoN1c2001
Cahalan
GoldenNickXT
KingJigglypuff
KorytheMaril
RedipsTheCooler
Szion
Tatsuya
Tyleto
Char
FWCrash
ilikepizza107
gerarreal
Kapedani
MonaFuzz
Oyako
QuickLava
Shadowic
Zataisho

BrawlInstaller

Install / Use

README