Update default payload and bundle Aurora dashboard
This commit is contained in:
54
README.md
54
README.md
@@ -19,29 +19,46 @@ BadBuilder is a tool for creating a BadUpdate USB drive for the Xbox 360. It aut
|
||||
### 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.
|
||||
- Prompts for the path of the entry point if it could not be automatically determined.
|
||||
- Automatically searches for the entry point (`.xex`) file within the folder.
|
||||
- If multiple `.xex` files are found, BadBuilder will prompt you to select the correct one.
|
||||
- Copies all necessary files and patches the entry `.xex` using the downloaded XexTool.
|
||||
- Includes optional content packs such as **ABadAvatar** and the **Aurora Dashboard**.
|
||||
|
||||
## Build
|
||||
|
||||
Run these commands from the repository root:
|
||||
|
||||
```
|
||||
dotnet restore
|
||||
dotnet build BadBuilder.sln
|
||||
```
|
||||
|
||||
To publish a self-contained single-file release for 64-bit Windows:
|
||||
|
||||
```
|
||||
dotnet publish BadBuilder/BadBuilder.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true
|
||||
```
|
||||
|
||||
If you want the runtime bundled but with trimming and compression enabled (smaller exe, may require extra testing):
|
||||
|
||||
```
|
||||
dotnet publish BadBuilder/BadBuilder.csproj -c Release -r win-x64 --self-contained true -p:PublishSingleFile=true -p:PublishTrimmed=true -p:EnableCompressionInSingleFile=true -p:IncludeNativeLibrariesForSelfExtract=false
|
||||
```
|
||||
|
||||
To create framework-dependent single-file publishes (requires .NET 8 runtime on the target machine), omit `--self-contained true` and pick the architecture you need:
|
||||
|
||||
```
|
||||
dotnet publish BadBuilder/BadBuilder.csproj -c Release -r win-x64 -p:SelfContained=false -p:PublishSingleFile=true
|
||||
dotnet publish BadBuilder/BadBuilder.csproj -c Release -r win-x86 -p:SelfContained=false -p:PublishSingleFile=true
|
||||
dotnet publish BadBuilder/BadBuilder.csproj -c Release -r win-arm64 -p:SelfContained=false -p:PublishSingleFile=true
|
||||
```
|
||||
|
||||
## How to Use
|
||||
1. **Launch the executable**. It will open inside of a Terminal window.
|
||||
2. **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.
|
||||
3. **Download Files:** BadBuilder will fetch the required exploit files or let you specify an existing location.
|
||||
3. **Download Files:** BadBuilder will fetch the required exploit files or let you specify an existing location. This includes the ABadAvatar payload, XeUnshackle, Aurora Dashboard, Rock Band Blitz, XeXMenu, and Simple 360 NAND Flasher.
|
||||
4. **Extract Files:** BadBuilder will automatically extract everything needed.
|
||||
5. **Select default program**: BadBuilder will prompt you to choose a program that BadUpdate will try and invoke, being either [FreeMyXe](https://github.com/FreeMyXe/FreeMyXe), or [XeUnshackle](https://github.com/Byrom90/XeUnshackle)
|
||||
6. **Copy Files:** BadBuilder will copy all of the extracted files to the correct locations.
|
||||
7. **Add Homebrew (Optional):**
|
||||
- Specify the root folder of your homebrew application (e.g., `D:\Aurora 0.7b.2 - Release Package`).
|
||||
- If no `.xex` files were located in the root folder, BadBuilder will prompt you for the path of the entry point.
|
||||
- BadBuilder will locate the `.xex` file inside.
|
||||
- If multiple `.xex` files exist, you’ll be prompted to choose the correct entry point.
|
||||
- First, all necessary files will be copied, then, the `.xex` file 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.
|
||||
5. **Configure Payload:** BadBuilder automatically configures [XeUnshackle](https://github.com/Byrom90/XeUnshackle) as the default payload for BadUpdate.
|
||||
6. **Copy Files:** BadBuilder will copy all of the extracted files to the correct locations, including deploying the Aurora Dashboard to `Apps\Aurora`.
|
||||
|
||||
## Example Homebrew Folder Structure
|
||||
If you want to add Aurora, you would select the **root folder**, like:
|
||||
@@ -73,7 +90,8 @@ If you encounter any problems, please create a new issue with details about your
|
||||
|
||||
### Credits
|
||||
- **Grimdoomer:** [BadUpdate](https://github.com/grimdoomer/Xbox360BadUpdate)
|
||||
- **InvoxiPlayGames:** [FreeMyXe](https://github.com/FreeMyXe/FreeMyXe)
|
||||
- **shutterbug2000:** [ABadAvatar](https://github.com/shutterbug2000/ABadAvatar)
|
||||
- **Phoenix:** [Aurora Dashboard](https://phoenix.xboxunity.net/#/news)
|
||||
- **Byrom90:** [XeUnshackle](https://github.com/Byrom90/XeUnshackle)
|
||||
- **Swizzy:** [Simple 360 NAND Flasher](https://github.com/Swizzy/XDK_Projects)
|
||||
- **Team XeDEV:** XeXMenu
|
||||
- **Team XeDEV:** XeXMenu
|
||||
Reference in New Issue
Block a user