Skip to content

Commit

Permalink
Customs Songs merging tutorial
Browse files Browse the repository at this point in the history
A tutorial on how to merge loose song folders!
Might need a second grammar pass since I wrote this with barely any sleep.
Has Spanish translation too!

Co-Authored-By: Aloquendiar <[email protected]>
Co-Authored-By: Lynx <[email protected]>
  • Loading branch information
3 people committed Oct 28, 2024
1 parent 7329f7d commit 0eb5928
Show file tree
Hide file tree
Showing 33 changed files with 226 additions and 4 deletions.
5 changes: 5 additions & 0 deletions _data/sidebars/customs_sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,11 @@ entries:
output: web
type: homepage

- title: "Merging Song Folders"
url: /customs_CHtoPS3
output: web
type: homepage

- title: Troubleshooting
url: /customs_troubleshooting
output: web
Expand Down
5 changes: 5 additions & 0 deletions _data/sidebars/customses_sidebar.yml
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,11 @@ entries:
output: web
type: homepage

- title: "Combinando Carpetas de Customs"
url: /customs_CHtoPS3_es
output: web
type: homepage

- title: Problemas y Soluciones
url: /customs_troubleshooting_es
output: web
Expand Down
Binary file added images/xtra/customs/onyxauthormerge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxcreatedpkgmerge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxcreatedpkgmergees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxcreatedrpcs3merge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxcreatedrpcs3mergees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxdraganddropmerge.gif
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxfoldernamepkgmerge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxfoldernamerpcs3merge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxmakepackfilesize.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxmakepackfilesizees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxmakepackpkgmerge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxmakepackpkgmergees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxmakepackrpcs3merge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxmakepackrpcs3mergees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified images/xtra/customs/onyxmakepacks.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxmakepacksmerge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxoutfoldermerge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxoutfoldermergees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxoutpkgmerge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/onyxoutpkgmergees.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/rb3merge.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/rb3mergeafter.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/rb3mergeafteres.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added images/xtra/customs/rb3mergees.png
105 changes: 105 additions & 0 deletions pages/english/customs/merging.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,105 @@
---
title: "Merging Song Folders"
sidebar: customs_sidebar
permalink: customs_merging
folder: english
tags: [customs, english]
summary: "How to merge multiple song folders to reduce startup time."
series: "Converting Customs"
weight: 4
---

Over time, you might amass a large amount of customs folders. This is a problem since, the more folders you have, the longer Rock Band 3 takes to count your songs.
![A screenshot of Rock Band 3 loading downloaded content. It is loading 94 packages.](https://rb3pc.milohax.org/images/xtra/customs/rb3merge.png "RPCS3")


Ideally, you should put as many songs as possible into a pack to load things efficiently.
![A screenshot of Rock Band 3 loading downloaded content. It is loading 48 packages.](https://rb3pc.milohax.org/images/xtra/customs/rb3mergeafter.png "RPCS3")

Thanks to Onyx, you can do this easily! It is basically the same as the earlier as [[the Xbox 360 CON to PS3/RPCS3 format tutorial]](https://rb3pc.milohax.org/customs_360toPS3).
Before starting, keep in mind that you will temporarily need to have the original separated packs and the merged pack installed.
Make sure you have enough space!

#### 1.
Open a file browser and navigate to where your customs are installed.
This is normally within `dev_hdd0\game\BLUS30463\USRDIR\`.
For PS3, you will have to transfer the folder you want to combine to your computer for processing, which may take a while.
If you're on RPCS3, you can get there quickly by right clicking Rock Band 3 within RPCS3 then `Open Folder > Open Disc Game Folder`.
![A RPCS3 with Open Disc Game Folder, within the Open Folder menu, highlighted and with a cursor over it.](https://rb3pc.milohax.org/images/trbl/teleprob/patchgames.png "RPCS3")

#### 2.
Now, open Onyx Music Game Toolkit and click `Quick convert/pack`.
![A screenshot of Onyx's main screen. A cursor hovers over "Quick convert/pack."](https://rb3pc.milohax.org/images/xtra/customs/onyxhomequick.png "Onyx Console")

#### 3.
Stay on the `RB quick convert + pack creator` tab.
You can either drag and drop the files you modified or click on `Add Rock Band Song` to select them.
![A GIF of folders of customs being dragged and dropped into the "RB quick convert + pack creator" tab of Onyx.](https://rb3pc.milohax.org/images/xtra/customs/onyxdraganddropmerge.gif "Quick Convert")

It is also recommended to enable `Author to DTA tag` at the bottom right.
![A screenshot of Onyx's Quick Convert screen. "Author to DTA" is highlighted and has a cursor over it.](https://rb3pc.milohax.org/images/xtra/customs/onyxauthormerge.png "Quick Convert")

#### 4.
Below the first row of gray buttons, click the first menu and select `Make Packs`.
`Make Songs` is useless in this context since it will create loose folders.
![A screenshot of Onyx's Quick Convert screen. "Make songs: produced a single file for each song" has been clicked and the cursor is over "Make packs: combine songs up to a maximum file size."](https://rb3pc.milohax.org/images/xtra/customs/onyxmakepacksmerge.png "Quick Convert")

#### 5.
At the bottom left, make sure `Encrypt .mid.edat` is enabled, then select between either `PKG (PS3)` or `Folders (PS3)`.
* `Folders (PS3)` is recommended for RPCS3 users and PS3 users who know how to use FTP. It is **much** faster than PKG creation. RPCS3 users can also bypass the 4GB folder limit.
* `PKG (PS3)` is only recommended for PS3 users who can only use USB flash drives to add more songs.

<ul id="profileTabs" class="nav nav-tabs">
<li class="active"><a href="#folders" data-toggle="tab">Folders (PS3)</a></li>
<li><a href="#pkg" data-toggle="tab">PKG (PS3)</a></li>
</ul>
<div class="tab-content">
<div role="tabpanel" class="tab-pane active" id="folders">
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxoutfoldermerge.png" alt="A screenshot of Onyx's Quick Convert screen. The cursor is selecting &quot;Folders (PS3)&quot; and &quot;Encrypted .mid.edat&quot; has been enabled." title="Quick Convert">
<h4>6.</h4>
<p><em>(Optional but highly recommended)</em><br>
With these methods, the USRDIR subfolder will have an auto-generated name. For single songs and packs, it'll be <code>OxxxxxSongName</code>. However, if you make a pack, the folder name will only include the first song in the pack.<br>
If you want to find the folder easily, it's recommended to select <code>Custom USRDIR subfolder</code> instead of <code>Combine into one new USRDIR subfolder per pack</code> and entering the name of your choice.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxfoldernamerpcs3merge.png" alt="A screenshot of Onyx's Quick Convert screen. The cursor is selecting &quot;Custom USRDIR subfolder&quot; where &quot;Keep original USRDIR subfolders&quot; once was." title="Quick Convert"></p>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxnamepack.png" alt="A screenshot of Onyx's USRDIR naming popup. The pack has been named &quot;my_custom_pack.&quot;" title="Quick Convert"></p>
<h4>7.</h4>
<p><em>(Optional but highly recommended for RPCS3 users)</em><br>
RPCS3 can smash through the default maximum pack size of 4000 MiB (4.1 GB) since most computers will be running file systems that allow this (NTFS, ext4, APFS.)<br>
Simply change the number at the bottom left to something absurdly high like <code>99999</code><br>
<strong>Please do not do this on PS3 as its file system (FAT32) is limited to 4.1 GBs per folder and changing this can cause severe issues!</strong><br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxmakepackfilesize.png" alt="A screenshot of Onyx's Quick Convert screen. &quot;Max Pack Size (MiB)&quot; has been set to &quot;99999&quot;." title="Quick Convert"></p>
<h4>8.</h4>
<p>At the bottom, select the big button labeled <code>Make pack</code> (or <code>Start</code> if you used the <code>Make Songs</code> option.)<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxmakepackrpcs3merge.png" alt="A screenshot of Onyx's Quick Convert screen. The cursor is over &quot;Make 1 pack.&quot;" title="Quick Convert"></p>
<p>Navigate to your RPCS3 folder and select the <code>dev_hdd0</code> folder.<br>
If you\re going to be installing to a PS3 via FTP, select the most convenient folder.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/savefolder.png" alt="A screenshot of a file browser window. &quot;dev_hdd0&quot; is selected and the cursor is over &quot;Select folder.&quot;" title="Select Folder"></p>
<p>It should successfully convert and auto-install into your RPCS3 directory, ready to play.<br>
If using RB3DX, you can even do this while the game is running. Within RB3, select:<br>
<code>Options &gt; Extras &gt; Refresh Library</code> to reload your song list.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxcreatedrpcs3merge.png" alt="A screenshot of Onyx's USRDIR naming popup. The pack has been named &quot;my_custom_pack.&quot;" title="Quick Convert"></p>

</div>
<div role="tabpanel" class="tab-pane" id="pkg">
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxoutpkgmerge.png" alt="A screenshot of Onyx's Quick Convert screen. The cursor is selecting &quot;PS3 (PS3)&quot; and &quot;Encrypted .mid.edat&quot; has been enabled." title="Quick Convert">
<h4>6.</h4>
<p><em>(Optional but highly recommended)</em><br>
With these methods, the USRDIR subfolder will have an auto-generated name. It'll be <code>OxxxxxSongName</code>, with the <code>SongName</code> being the first song in the pack.<br>
If you want to find the folder easily, it's recommended to select <code>Custom USRDIR subfolder</code> instead of <code>Combine into one new USRDIR subfolder per pack</code> and entering the name of your choice.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxfoldernamepkgmerge.png" alt="A screenshot of Onyx's Quick Convert screen. The cursor is selecting &quot;Custom USRDIR subfolder&quot; where &quot;Keep original USRDIR subfolders&quot; once was." title="Quick Convert"></p>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxnamepack.png" alt="A screenshot of Onyx's USRDIR naming popup. The pack has been named &quot;my_custom_pack.&quot;" title="Quick Convert"></p>
<h4>7.</h4>
<p>At the bottom, select the big button labeled <code>Make pack</code>.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxmakepackpkgmerge.png" alt="A screenshot of Onyx's Quick Convert screen. The cursor is over &quot;Make 1 pack.&quot;" title="Quick Convert"></p>
<p>Select where you would like to save the PKG file and give it a name.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/savepkg.png" alt="A screenshot of a file browser window. The file name has been set to &quot;my_custom_pack&quot;" title="Select Folder"></p>
<p>It should successfully convert and a PKG file will be created, ready to install.<br>
Simply install it like any other PKG.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxcreatedpkgmerge.png" alt="A screenshot of Onyx's USRDIR naming popup. The pack has been named &quot;my_custom_pack.&quot;" title="Quick Convert"></p>

</div>
</div>

{% include custom/series_customs_next.html %}

{% include links.html %}
2 changes: 1 addition & 1 deletion pages/english/customs/troubleshooting.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@ folder: english
tags: [customs, english]
summary: "How to solve common issues with Rock Band 3 customs."
series: "Converting Customs"
weight: 4
weight: 5
---

## Customs not working online / Scores not saving
Expand Down
4 changes: 2 additions & 2 deletions pages/espanol/customs/360aPS3.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,7 @@ Es recomendado que actives la opción de `Author to DTA tag` abajo a la derecha.


#### 10.
Abajo de la primera línea de botones grises, haz click en el menú que dice `Make Packs` o `Make Songs` depende de cómo quieres crear tus PKGs. Es recomendado crear paquetes.
Abajo de la primera línea de botones grises, haz click en el primer menú y luego en `Make Packs` o `Make Songs` depende de cómo quieres crear tus PKGs. Es recomendado crear paquetes.
![Una captura de la pantalla de Quick Convert dentro de Onyx. El cursor presiono "Make songs: produced a single file for each song" y despues elije "Make packs: combine songs up to a maximum file size."](https://rb3pc.milohax.org/images/xtra/customs/onyxmakepacks.png "Quick Convert")

#### 11.
Expand All @@ -79,7 +79,7 @@ Con estos métodos, el PKG va crear una carpeta con un nombre generado automáti
Recomendamos, en caso de hacer paquetes, cambiar la opción de <code>Combine into one new USRDIR subfolder per pack</code> por la de <code>Custom USRDIR subfolder</code> y ponerle el nombre que tu quieras.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxfoldernamerpcs3es.png" alt="Una captura de la pantalla de Quick Convert dentro de Onyx. El cursor esta sobre &quot;Custom USRDIR subfolder&quot; en vez de &quot;Keep original USRDIR subfolders&quot;." title="Quick Convert"></p>
<p>Puedes hacer esto si solo es una canción también. Esto ayuda demasiado si quieres ser organizado y encontrar una canción entre las carpetas.<br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxnamepackes.png" alt="Una captura de Onyx con su pantalla de nombrar el paquete. The pack has been named &quot;my_custom_pack.&quot;" title="Quick Convert"></p>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxnamepackes.png" alt="Una captura de Onyx con su pantalla de nombrar el paquete. El paquete fue nombrado &quot;paquete_de_customs.&quot;" title="Quick Convert"></p>
<h4>13.</h4>
<p>Abajo va ver un un botón verde que dice <code>Make pack</code> o <code>Start</code> si elegiste la opción de <code>Make Songs</code><br>
<img src="https://rb3pc.milohax.org/images/xtra/customs/onyxmakepackrpcs3es.png" alt="Una captura de la pantalla de Quick Convert dentro de Onyx. El cursor esta sobre &quot;Make 1 pack.&quot;" title="Quick Convert"></p>
Expand Down
Loading

0 comments on commit 0eb5928

Please sign in to comment.