hmxmilohax / rock-band-3-deluxe

QoL enhancements and additions to Rock Band 3

Downloads and install instructions have been moved to our brand new website!

Welcome to the Rock Band 3 Deluxe repository!

Below are instructions for building the game yourself.
Please visit our website if you're looking for downloads.

📥 Downloads

🔨 Building (NOT standard download and install)

NOTE: This is for building the game, for developers and contributors.
If you're looking for downloads, please visit our website.

Installing Python (Required)

• Head to the Python downloads, download and install Python (version 3.11 or later).
  • Select "Add python.exe to PATH" on the installer.

Initializing the Repo

• Go to the Releases of this repo and download init_repo.py.
  • Make a new empty folder, put init_repo.py in the folder, and run it.
    • This will pull the repo for you and install all required dependencies. This will take some time.
    • You may have to run the script multiple times on Windows.

The folder should look something like this once it's done:

✅ The Rock Band 3 Deluxe repo is now set up!

From here, you can make any personal modifications to the game or build it yourself.

Windows *.bat files.

• Navigate to scripts if you're on Windows.
  • Run the build_ script for your platform of choice to build Rock Band 3 Deluxe.
  • Built contents will be in the out folder on the root of the repo.

Manual

• Navigate to the root of the repo in your shell of choice.

• Run the following commands:

  • python3 dependencies/python/configure_build.py <platform>
  • dependencies/<os>/ninja

• Built contents will be in the out folder on the root of the repo.

✅ You have now built Rock Band 3 Deluxe!

🎨 Custom Textures

Follow Building (Advanced) first in order to properly follow this guide.

• Copy any .jpg, .png, or .bmp file to the appropriate place in \_ark\dx\custom_textures\***\.
• Re-build the game!

✅ Your custom textures have been converted and will show up ingame!

🖥️ Dependencies

Git for Windows - CLI application to allow auto updating Deluxe repo files

Dot Net 6.0 Runtime - Needed to run ArkHelper

Python - For user script functionality (NOTE: 3.9 or newer is highly recommended!)

Mackiloha - ArkHelper for building Deluxe - SuperFreq for building .bmp_xbox highway images

swap_rb_art_bytes.py - Python script for converting Xbox images to PS3

dtab - For serializing .dtb script files

RB3DXBuildPkgPS3 - For building an RB3DX PKG for PS3