4.0 KiB
BadBuilder
BadBuilder is a tool for creating a BadUpdate USB drive for the Xbox 360. It automates the process of formatting the USB drive, downloading required files, extracting them, and allowing the addition of homebrew applications.
Features
USB Formatting (Windows Only)
- Uses a custom FAT32 formatter that supports large USB drives (≥32GB).
- Ensures compatibility with the Xbox 360.
Note
Currently, the formatting feature is Windows-only. If you compile BadBuilder for another OS, it'll prompt you to manually format your target disk.
Automatic File Downloading
- Detects and downloads the latest required files automatically.
- Recognizes previously downloaded files and reuses them by default.
- Allows specifying custom paths for required files if they are already on your system.
Important
BadBuilder does not dynamically locate files inside ZIP archives. If your provided archive has a different folder structure than expected, the process will fail abruptly. Ensure your archive matches the expected format if specifying an existing copy.
File Extraction & Copying
- Extracts all necessary files automatically.
- Prepares the USB drive for the BadUpdate exploit by copying all required files.
Homebrew Support
- Allows adding homebrew applications by specifying their root folder.
- Automatically searches for the entry point (
.xex) file within the folder. - If multiple
.xexfiles are found, BadBuilder will prompt you to select the correct one. - Copies all necessary files and patches the entry
.xexusing the downloaded XexTool.
How to Use
- Launch the executable. It will open inside of a Terminal window.
- Formatting (Windows Only): BadBuilder will format your USB drive as FAT32, even if it’s larger than 32GB.
Caution
Formatting a disk means that all data will be lost. Make sure you have selected the right drive before confirming the format. I am not responsible for any data loss.
- Download Files: BadBuilder will fetch the required exploit files or let you specify an existing location.
- Extract Files: BadBuilder will automatically extract everything needed.
- Copy files: BadBuilder will copy all of the extracted files to the correct locations.
- Add Homebrew (Optional):
- Specify the root folder of your homebrew application (e.g.,
D:\Aurora 0.7b.2 - Release Package). - BadBuilder will locate the
.xexfile inside. - If multiple
.xexfiles exist, you’ll be prompted to choose the correct entry point. - First, all necessary files will be copied, then, the
.xexfile will be patched using XexTool.- This ensures that the original copy of the homebrew program will not be modified, as it is instead done in-place on the USB drive.
- Specify the root folder of your homebrew application (e.g.,
Example Homebrew Folder Structure
If you want to add Aurora, you would select the root folder, like:
D:\Aurora 0.7b.2 - Release Package
Which contains:
Aurora 0.7b.2 - Release Package/
├── Data/
├── Media/
├── Plugins/
├── Skins/
├── User/
├── Aurora.xex
├── live.json
├── nxeart
BadBuilder will detect Aurora.xex as the entry point and patch it accordingly.
Important
Homebrew apps which do not contain the entry point in the root folder are not currently supported.
Using unsupported homebrew
If you would still like to use unsupported homebrew apps, you'll have to copy them manually. To do so, perform these steps:
- Copy the entire root folder into the
Appsfolder on your target drive. - Find and copy the path of the entry point.
- Open a terminal window and construct the following command:
- Command:
"<path_to_folder_of_BadBuilder.exe>\Work\Extract\BadUpdate Tools\XePatcher\XexTool.exe" -m r -r a "<path_to_entry_point>" - Example:
"C:\BadBuilder\Work\Extract\BadUpdate Tools\XePatcher\XexTool.exe" -m r -r a "H:\Apps\Aurora 0.7b.2 - Release Package\Aurora.xex"
- Command:
Reporting Issues
If you encounter any problems, please create a new issue with details about your setup and the problem.