While VRCFury is the main intended way to install the prefab I still like offering manual install instructions for those who don’t want to use VRCFury.

Make sure you have AV3 Manager and HFCRed’s Animation Repathing tool. You probably won’t need the Repathing Tool but it’s nice to have as a backup.

Song Setup

Before we start I want to have you go over your song files in unity to make sure they‘re set up the way VRC wants them, otherwise the avatar build may fail and the SDK isn’t too good at explaining the reason sometimes.

  1. Import the song files into your unity project if you haven’t already done so
  2. Select all of your imported song files
  3. In the Inspector check the ‘Load in Background’ checkbox
  4. Hit Apply

Scene Setup

  1. Find the BoomBoxSystem Prefab you want to use in the BoomBox/PREFABS folder. There are a 5 song and 10 song variant.
  2. Drag the Prefab so that it’s a child of your avatar. Right Click on the Boombox System and select Prefab→Unpack Completely. If you do not do this step you cannot move the child objects later in the setup
  3. Rename the BoomBoxSystem game object to just ‘BoomBoxSystem’ i.e. Remove the 5/10Song section
    1. Make sure the Capitalization is correct. Failure to follow this section will cause the audio to not work correctly as the ‘Play Audio’ State Behaviors are expecting the audiosources to be in a specific place and that involves making sure that the Boombox system is named correctly
  4. To scale the boombox to better fit your avatar you can scale the gameobject named ‘BoomBox’ under BoomBoxSystem/WorldConstraint/BoomBoxContainer
    1. You can also scale the BoomBoxGuide objects under the Wrist_Target objects in the ConstraintTargets object by the same amount for better placement.
  5. Expand the BoomBoxSystem object and find the ConstraintTargets object, also expand that.
  6. Select the LeftWrist_Target and reparent it to your avatar’s left wrist/hand bone. Move it with the move gizmo to your avatar’s left hand. Use the red boombox mesh as a guide to help position the target. Once you’re done you should delete the LeftBoomBoxGuide child object of the LeftWrist_Target.
  7. Repeat step 4. but for the RightWrist_Target
  8. Reparent the HolsterTarget to your Chest bone and move it so that the BoomBox is on your upper back.

Animator Setup

  1. Find the BoomBox/Animators folder and find the FX animator for your specific boombox (5 or 10 song). Merge this onto your avatar with AV3 Manager
  2. Merge the parameters for the boombox onto your avatar’s parameters. It should be the ‘BoomBox - Parameters’ file under BoomBox/VRChatAssets