FAQFAQ   SearchSearch   MemberlistMemberlist   UsergroupsUsergroups   RegisterRegister 
 ProfileProfile   Log in to check your private messagesLog in to check your private messages   Log inLog in 
Basic Guide on Custom Songs for Rock Band 3 (Wii/vWii)

 
Post new topic   Reply to topic    ScoreHero Forum Index -> Software
View previous topic :: View next topic  
Author Message
HarvHouHacker  





Joined: 20 Jul 2019
Posts: 35

PostPosted: Fri Aug 16, 2019 12:48 am    Post subject: Basic Guide on Custom Songs for Rock Band 3 (Wii/vWii) Reply with quote

This guide is no longer being maintained by the OP. Please see the latest post for details.

This is a more up-to-date guide than Koetsu's "How to" thread. You may continue to reference that thread for converting CONs, but this guide will cover and expand on mainly the basic concepts of adding customs. This guide is a combination of StackOverflow0x/Koetsu's ScoreHero thread (as already linked) and his Customs Creators thread.

Hey there, rockers! HarvHouHacker here! Today, I am going to teach you how to properly add to, and perfect, your custom song library on Rock Band 3! This may also work on Rock Band 2, but I have yet to get it working right, so in this guide we'll focus on RB3.

What You Need
  • An original Wii, a Wii Family Edition, or a Wii U.
  • A computer with Windows XP or higher on it (Windows 7 recommended). You can try to use WINE on Linux or something similar on Mac, but the results may vary. Make sure to configure WINE to have access to your SD card and project folders before starting!
  • An SD card compatible with your Wii. If your Wii is SDHC compatible (Wii version 4.3 or Wii U any version), 4 GB minimum is recommended. You'll also need an SD card reader for your PC, if it doesn't already have one.


Modding Your Wii

If you've never softmodded your Wii before, choose an exploit from WiiBrew.org. Keep in mind that some exploits don't work for Wii Mode on the Wii U. Also, follow these cIOS steps on the Complete Softmod Guide. This will help you install IOS 249 and IOS 250 in your Wii's NAND (storage). Make sure to follow the Wii instructions for *the* Wii, or vWii instructions for Wii U. If you don't, you may end up with a corrupt NAND! Once you have done this, you can use IOS 249 or IOS 250 for homebrew applications.

Get the Repo Software

Download the master branch of this repo (https://gitlab.com/HarvHouHacker/rock-band-customs). I recommend either a ZIP or using git clone.

There are several packers included in this repo. If using Git, use git checkout DLC_Packers_REGION, where REGION is either NTSC for North America, or PAL for Europe. If downloading via ZIP, download the appropriate branch and extract them all to your project directory. For this example, we'll be using the contents of the sZAE folder.
  • You'll need the Wii common key, in binary format. One is included in the repo, but if you want to make your own, ShowMiiWads can create one for you. For the latest version of ShowMiiWads, go to Sourceforge. It should have no file extension and be called "common-key". If it adds an extension, rename it without one.
  • FS Toolbox is included in the repo. While some of the instructions are written for FS Toolbox, you may find it easier to use WiiXplorer. Again, download from Sourceforge for the latest version.
  • If you've never had any DLC for Rock Band 3, you'll want to start by installing sZAE.wad from the RockBand-WADs folder using a WAD installer, like Some YAWMM Mod. Look for and download the latest release.


Installing Homebrew Channel Programs

The programs FS Toolbox, xyzzy, WiiXplorer, ans Some YAWMM Mod are for the Homebrew Channel. To install and use them:
  1. On your computer: Insert your Wii (or Wii U) SD card. If there isn't a folder named apps, make one. Move the entire folders of the programs you want to use in the apps folder. For instance, the FS Toolbox program will be in SDCARD/apps/fs-toolbox. To test them, unmount and eject the card.
  2. On your Wii: Put the card in your Wii and launch the Homebrew Channel (on the Wii U, launch Wii Mode first if you're not in it already). The apps should appear as a list. If they don't, check to make sure they are in the right folders and that each one at least has a boot.dol file. Keep in mind that some apps don't have descriptions or icons to identify themselves.


Get your Wii Rock Band 3 ticket and keys

You'll need the ticket from the sZAE category. If you never got DLC for Rock Band 2, or don't know if you have DLC for sZAE, follow these steps:
  1. On your computer: Put sZAE.wad on the SD card. You can make a wads folder to put it in, if you like.
  2. On the Wii: In the Homebrew Channel, load Some YAWMM Mod. Select Wii SD Card Slot, then navigate to the WAD you added. Select it, then select Install WAD. You'll get a -1022 error. Select it again, and choose Uninstall WAD. Then, install it again. You'll get the same error. Believe it or not, it actually succeeded!

Once you have done that, you should now be able to get a ticket.
  1. On the Wii: Put the SD card in. Launch the Homebrew Browser Channel.
    - Using FS Toolbox: Navigate to /ticket/00010005. Highlight 735a4145.tik and press - on your Wii remote to copy the file to your SD card.
    - Using WiiXplorer: Navigate to NAND:/ticket/00010005. Highlight 735a4145.tik and press +. Select copy, then navigate to your SD and paste it there. If you like, you can create a folder called "RB3_Stuff" or similar and paste it in there.
    - After doing either option, take out the SD card.
  2. On your computer: Plug in the SD. Navigate to FS-TOOLBOX/ticket/00010005 if using FS Toolbox, or wherever you put it if using WiiXplorer. Rename 735a4145.tik to title.tik and put it in the root of the RBWii-DLC-Packer folder.

If you're doing real NAND, you'll need an unique console ID key. This is an 8-digit hexadecimal number.
  • The easiest way is to use xyzzy, included in this repo. Launch it from the Homebrew Channel. It will not only show you your console ID, but dump it to a file as well.
  • If you've recently backed up your NAND, you should have keys unique to your console. I may explain in a later update to the wiki how to access them.
  • You can also find your console ID by using a hexadecimal editor to open any DLC you may already have and write down (without spaces) the part highlighted in the following image. It must be 8 characters long.




Get your console ID and paste it in ng_id.txt.

A title.tmd file is included, as well as the content generation banner file 000001D2.app. However, if you'd rather use your own, navigate to title/00010005/735a4145/content in either FS Toolbox or WiiXplorer and grab both files (if they exist). You may need these for packing DLC.

Get the Songs You Want

You can either repack official DLC, or pack a custom-made song.

Get Songs from Rock Band Game Discs

Please note: To prevent piracy, the files from Rock Band discs are intentionally left out of this repo. In order to add the songs for official DLC, you must have the files from Rock Band discs, if you have them. To get the song data you need from Wii discs, you'll need to learn how to extract .ark files and use ArkTool (my wiki page on GitLab covers this).
  • It may be possible to import a song you have bought and converted into a MOGG or BIK file, but it will be a single-track format and is likely to cause problems. For more information, read this wiki on how MOGGs work.
  • If you do not have other Rock Band Wii titles, consider looking for them in thrift stores and pawn shops, or online via eBay, Amazon or Craigslist.
  • Songs from the first Rock Band title and all Track Packs will be out of sync if you use the Wii discs. To get them in sync, see my GitLab wiki page on aligning tracks.


The files in the branches starting with DLC_from_RockBandVersion or RBN_DLC_#### are an older version of the Rock Band Harmonies Project, and are partly needed for database files (.dta), especially when extracting from disc. The remaining files can be used to upgrade existing songs in your Rock Band 3 library. You can either download one of the song branches in this repository, or download from the Rock Band Harmonies Project on GitHub. They should be able to be used as DLC for the Wii version of Rock Band 3.

Get custom songs

There's an extensive list on Customs Creators, available in various formats. Note that there may be some with dead links, so do some web searches if a song you want isn't available. Find and download one you like.

Xbox 360 customs are usually in CON format. You can use the C3 Con Tools to extract or simply convert the package. If you converted the package, you don't have to sort the files, as they should already be structured properly.

Modify the Packer

Here is how your folder should look like with everything in it.



First of all, let's take a look at how 061_0000003d_upgrades is titled. The first digits (061) of the folder name are in "normal" base ten, the actual number of the song. The next eight digits separated by the underscore (0000003d) is the hexadecimal number of 61. This is not always true, however; use the Rock Band 3 Customs Manager to check the hexadecimal order. The last part is the type of DLC that it will make (upgrades). That part can be preceded by another name separated by an underscore, like "mysong", so it reads 061_0000003d_mysong_upgrades. This folder will pack to 0000003d.app for adding directly to the NAND, which will then be used for creating 061.bin for the SD card.

The first folder in the sample (001_00000001_spoof) has a spoof file required by RBHP. It is simply a songs.dta file which can contain updated DTAs to force harmonies to load on upgraded songs. You need the Wii version of the DTA to upgrade songs, though. This spoofing file is set to overwrite song 001, "The Kill". You can find out which songs will be overwritten by seeing the archived RawkSD Master DLC list. If you do have that song, you'll have to overwrite it and add it back some other way.

Folder 002_00000002_upgrades contains the upgrade RBHP MIDIs. You can add in your own Pro Guitar and Harmony upgrades here, as long as you update the upgrades.dta correctly. Wii/vWii requires the file path to contain dlc/sZAE/002/content/songs_upgrades/. For content to be found, you need to include the content generation title and the number of the folder it's in, which in this case is 002. After that path, you then add the upgrade MIDI's name, such as song_plus.mid.

You can pack multiple songs into each slot in the folders, but there is a limit of approximately 400MB for APP files, 40MB for BIN song data files, and 500KB for BIN metadata files.

Putting the Files in the Appropriate Folders

In the project sZAE folder, we'll make this song 063/064. Make 2 folders and call them:
Code:
063_0000003f_songname_meta
064_00000040_songname_song

...Where songname is the condensed title of the song, i.e. detroitrockcity. Your song doesn't have to be in the list to be added; just assign it any number you wish. It can even be an official DLC out of order, with this method!

Note: If you converted a CON custom from Customs Creators, the folders should already be structured. Just rename the folders, move them to the packer directory, and skip ahead to section "Execute the Packer".

Open the meta folder and make the folders to match the structure below. Copy the files for the song you chose into the folders as shown.
Code:
>content
 >songs
  *songs.dta
  >songname
   *songname_prev.mogg
   >gen
    *songname_keep.png_wii

An asterisk (*) indicates a file, while an arrow (>) indicates a folder. The following files and folders indented after a folder indicate what's supposed to be in it.
  • If you don't have a .png_wii file, you can make one using Album Make (see my GitLab Album Make wiki page). It isn't necessary, though.
  • If you don't have a songname_prev.mogg, you can make one with an audio editor. It can be a mono ~10 second clip of the song in MOGG format. This is not needed, either.
  • Some DTA files include a (preview [# milliseconds in to start] [# milliseconds in to end]), i.e. preview 15000 20000) which bypasses the need for a separate preview audio file altogether. However, this line is required when adding a preview MOGG, to have the album cover and preview MOGG appear simultaneously.

Now open the song folder you made for 064 and create the following structure. Drop the files where they are necessary.
Code:
>content
 >songs
  >songname
   *songname.midi
   *songname.mogg
   >gen
    *songname.milo_wii

In some Rock Band discs, i.e. Rock Band 2, you'll see a songname.bik in place of the .mogg file. This can be used, as well.

Normally, custom songs from places like Customs Creators come with .milo_xbox files, and renaming them to .milo_wii seems to work just fine. Now you should have all the song files moved in the appropriate DLC folders.

Go back to the songs.dta file that was placed in the meta folder and open it in a text editor. In the name path, just like what had to be done with the upgrades.dta path, you have to add the Wii-specific path so it reads as dlc/sZAE/063/content/songs/songname/songname. The file has to point to the meta folder we created.

Execute The Packer

Use either the batch script file Packer_Script.bat, the packdlc.bat generated by Packer_Script_Creator.exe, or Custom Creator's Rock Band 3 Wii Customs Manager (Windows 64-bit only) to start the packing process. All three use u8it.exe to make .app files and wadpacker.exe to turn them into .bin files.

Using the Packer Script Creator

If you'd rather do it the easy way, simply click on Packer_Script_Creator.exe to generate a packdlc.bat file, then click on the batch file it created to create your .app and .bin files. The benefit of this is that it automatically adds extra lines of code for you, to remove unneeded files automatically created by the packers.

Editing and Running the Packer Script

If you want to better control what gets packed, you may prefer modifying Packer_Script.bat, as running the automatically generated packdlc.bat script will pack every DLC, every time. Open Packer_Script.bat with your text editor. Notice that there already are some lines of code:
Code:
@echo off

REM This packs files for emulated NAND.
u8it 001_00000001_spoof 00000001.app -pack
u8it 002_00000002_upgrades 00000002.app -pack
u8it 061_0000003d_upgrades 0000003d.app -pack

REM This packs files for real NAND.
wadpacker 1, 2
wadpacker 61, 1

REM If you want a more verbose output, delete the "@echo off" line.

Erase the line to pack 061 and add the folders we created under the emulated NAND part to read like so:
Code:
u8it 063_0000003f_meta 0000003f.app -pack
u8it 064_00000040_song 00000040.app -pack

This part is needed even if we don't want to use the .app files, because they'll be used for making .bin files.

The last part of the batch command is split up in 2 commands because the tool stops if it can't find more DLC that's a number immediately after the last one. Thus, wadpacker 1, 2 won't pack 061_0000003d_upgrades because 061 is not immediately after 002; it's stops when it can't find 003. Retype the last part at the bottom to pack 063 and 064.
Code:
wadpacker 63 2

Now, if you ever have to add more songs, in 065/066 and on, you increment the second number for every file you make. Thus, changing it to wadpacker 63 4 would pack 4 files starting with 63, and so on.

Save that and run pack-dlc.bat.

Using the Rock Band 3 Wii Customs Manager

If you have a 64-bit Windows, you can also use the Rock Band 3 Wii Customs Manager supplied by Customs Creators (via MediaFire). Copy the program into any packer you're working in (in this case, the sZAE one), run it, make sure there are no errors, and then click either Build APPs or Build BINs.

Placing the Files

You will have APP files and BIN files.
  • Real NAND SD users will take the .bin files and place them in the sZAE folder of their SD card (private/wii/data/sZAE).
  • Emulated NAND users should take the .app files and put them in title/00010005/735a4145/content using FS Toolbox or WiiXplorer. If This can be done on real NAND too, but be sure to put only the .app files there and not other files, or you may corrupt your game!


Reset the Cache

Finally, every time you change the contents of a DLC slot, you must reset the song cache.
  • With FS Toolbox, navigate to title/00010000/535a4245/data. Let it create those folders on your SD, then put the clean MSTORE.vff file from this repo in the data folder and repeat. Press + to replace the file.
  • With WiiXplorer, go to Settings > Boot Settings > NAND Write access. Select "Yes" and "Accept". Then, navigate to title/00010000/535a4245/data and delete MSTORE.vff. This will force the software to recreate it.


Running the Game

Depending on your configurations will depend on how you run the game. In most cases, a USB loader may be needed. You can use USB Loader GX from SourceForge , Configurable USB Loader Mod from WiiDatabase (Warning! Site is in German; use a translator if you need), or WiiFlow Litefrom GitHub.

If you are having trouble connecting instruments through USB Loaders, you may need cIOS 249 and cIOS 250. The cIOS installation guide on the Complete Softmod Guide should be able to help you. Make sure to not get the instructions for vWii mixed up with Wii, or else you may brick your Wii/Wii U!

Your DLC:
    If you put the DLC on your SD card expecting it to automatically work with Rock Band 3 when loading it from the Disc Channel, you will receive the "Add-on Content cannot be restored to the Wii System Memory" message when it tries to load it after selecting your profile. This may be due to Rock Band 3 detecting mismatched song IDs (since this guide allows you to assign a number set to any song). Use a USB Loader instead.
  • If you injected the .app files into your NAND, the songs will appear and be playable. This will work for real NAND users.

Your NAND:
    If real, using .app files will work, even when loading the game from the Disc Channel, however not very many songs will be able to be played all at once using this method. Using .bin files are better, since you can load more songs that way.
  • You can run games from an emulated NAND, however this definitely requires a USB loader of some kind. Some loaders will dump the real NAND for you so that you can use the dump as an emulated NAND. Make sure the SD card or USB storage device that you will dump the NAND to has room for at least 4 GB or more!

Your Game:
    If using a physical disc, any of the above configurations will work, however you will not be able to modify anything that is on the disc directly.
  • Some loaders can rip game discs in the Wii U to an ISO, WBFS, or other disc-type file, but in order to use them, a USB loader is necessary. Also, you need room on an SD card or USB storage for as much as one DVD (approx. 4.7 GB). Burning the file to a DVD and trying to run it that way will not work, as the disc will not be able to be read.


Upon launching the game, if you followed all the instructions carefully, your songs will appear and be playable. Any known issues (with workarounds) are at the bottom of this tutorial. If anything goes wrong, leave me a comment or check out my GitLab issues.

Videos

  • This video posted by StackOverflow0x shows how to reset the cache using FS Toolbox, and shows Rock Band 3 loaded via CFG USB Loader. StackOverflow0x also plays two customs; he does a Quickplay of "Prisoner of Society" by The Living End and practices a segment from "Buddy Holly" by Weezer. http://youtu.be/Ts9zgCQxUxw
  • StackOverflow0x demonstrates an imported song working, with RBHP upgrades included. The song is "In Too Deep" by Sum 41, and he attempts Expert Guitar mode. http://youtu.be/fi65zhToOX0
  • A song from the original Rock Band title, "Timmy and the Lords of the Underworld", is shown to be playing in Rock Band 3 on the Wii. Notice that the venue and character actions have been removed, possibly due to a cleaned MIDI. Again, StackOverflow0x attempts Expert Guitar. http://youtu.be/oPwQaKmILnM


Known issues
For all issues, please see my GitLab Snippet or GitLab Issues page.

Let me know in the comments below if there's anything I can do to improve this guide. Rock On! [/b]


Last edited by HarvHouHacker on Mon Jun 29, 2020 5:05 am; edited 7 times in total
Back to top
View user's profile Send private message
HarvHouHacker  





Joined: 20 Jul 2019
Posts: 35

PostPosted: Fri Aug 16, 2019 1:17 am    Post subject: ScoreHero Error Reply with quote

This is a modified copy of a thread I made on GBAtemp, and in using cut-and-paste, I was not able to add an URL with parentheses in the linked text. Upon attempting to preview or save my post, it kept trying to connect to domain "https://rockband.scorehero.com/forum/posting.php", which gave me a 403 Forbidden error. Weird. At least I managed to get it posted by editing the line.
Back to top
View user's profile Send private message
HarvHouHacker  





Joined: 20 Jul 2019
Posts: 35

PostPosted: Sun Aug 25, 2019 1:35 am    Post subject: Sd Card Issues? Reply with quote

We have a Snippet for that! https://gitlab.com/HarvHouHacker/rock-band-customs/snippets/1887560

Known Issues: https://gitlab.com/HarvHouHacker/rock-band-customs/snippets/1844058

Submit more issues: https://gitlab.com/HarvHouHacker/rock-band-customs/issues
Back to top
View user's profile Send private message
HarvHouHacker  





Joined: 20 Jul 2019
Posts: 35

PostPosted: Sun Sep 01, 2019 3:12 am    Post subject: Guide Updated Reply with quote

Rock Band 3 Customs Manager can actually be used to check for missing files required for building, as well as a list of APP names in order of being built, and how many files there can be in a content generation. If you have a 64-bit windows, I recommend this program, else it might take some guessing to get it right.
Back to top
View user's profile Send private message
HarvHouHacker  





Joined: 20 Jul 2019
Posts: 35

PostPosted: Thu Sep 26, 2019 2:51 am    Post subject: Already old?!? Reply with quote

This guide will have to be updated, since the GitLab wiki and repo that this guide is based off of have changed. Sorry for the inconvenience.
Back to top
View user's profile Send private message
HarvHouHacker  





Joined: 20 Jul 2019
Posts: 35

PostPosted: Mon Jun 29, 2020 5:03 am    Post subject: Abandoned! Reply with quote

Hey there, those who are still rockin' out on ScoreHero! If you came here hoping that this Basic Guide would help you... well, you're out of luck. This guide has since been abandoned in favor of the tutorial on GBAtemp, as well as my very detailed and more up-to-date GitLab wiki.

You can find the GBAtemp tutorial here: https://gbatemp.net/threads/a-guide-to-creating-rock-band-3-custom-songs.534832/

The official GBAtemp thread for RBC for Wii, vWii, and Dolphin can also be found here: https://gbatemp.net/threads/rock-band-customs-wii-vwii.543006/

The wiki, which I highly recommend checking out, is here: https://gitlab.com/HarvHouHacker/rock-band-customs/-/wikis/home

Eventually, I'd like to start a thread here similar to the one on GBAtemp for RBC, but it may cover more than just Wii and vWii if I can garner enough interest here. However, I'm not too familiar with BBCode, and I noticed that this site has some issues with editing and posting, so it probably won't be as active as the one on GBAtemp, but it's still a possibility.

Anyway, thanks for checking this guide out! Keep Rockin'!
Back to top
View user's profile Send private message
Display posts from previous:   
Post new topic   Reply to topic    ScoreHero Forum Index -> Software All times are GMT
Page 1 of 1

 
Jump to:  
You cannot post new topics in this forum
You cannot reply to topics in this forum
You cannot edit your posts in this forum
You cannot delete your posts in this forum
You cannot vote in polls in this forum





Copyright © 2006-2024 ScoreHero, LLC
Terms of Use | Privacy Policy


Powered by phpBB