The easiest way to get Custom Avatars up and running is to use ModAssistant. The latest version of Custom Avatars will always be posted in the releases here, and then become available on ModAssistant a few days later. If you want to install it manually by using the releases available here or are looking for the files to create an avatar yourself, you can follow the instructions below.
Install BeatSaberMarkupLanguage and DynamicOpenVR (the required versions are listed in Custom Avatars' release notes). Download the latest release of Custom Avatars and extract the entire contents of the ZIP file into your Beat Saber folder and overwrite any existing files. By default, your Beat Saber install folder should be C:\Program Files (x86)\Steam\steamapps\common\Beat Saber
for Steam and C:\Program Files\Oculus\Software\Software\hyperbolic-magnetism-beat-saber
for Oculus.
Full-body tracking requires setting up tracker roles in SteamVR. For instructions, check out OpenXRTrackerProfiles' instructions.
To resolve references and automatically copy the compiled DLL into Beat Saber's installation directory, first create files called CustomAvatar.csproj.user
and CustomAvatar-Editor.csproj.user
next to Source\CustomAvatar\CustomAvatar.csproj
and Source\CustomAvatar-Editor\CustomAvatar-Editor.csproj
respectively. Then paste in the following contents:
<?xml version="1.0" encoding="utf-8"?>
<Project>
<PropertyGroup>
<!-- Replace this with the path to your Beat Saber installation -->
<BeatSaberDir>C:\Program Files (x86)\Steam\steamapps\common\Beat Saber</BeatSaberDir>
<!-- To use the included Steam launch profiles and your Steam installation isn't in the default folder, change this -->
<SteamExecutable>C:\Program Files (x86)\Steam\steam.exe</SteamExecutable>
</PropertyGroup>
</Project>
<?xml version="1.0" encoding="utf-8"?>
<Project>
<PropertyGroup>
<!-- Replace this with the path to your Beat Saber installation -->
<BeatSaberDir>C:\Program Files (x86)\Steam\steamapps\common\Beat Saber</BeatSaberDir>
<!-- Replace this with the path to your Custom Avatars Unity Project or leave it empty if you don't have one -->
<UnityProjectDir>C:\Users\Me\Documents\AvatarsUnityProject</UnityProjectDir>
</PropertyGroup>
</Project>