⚠ If you were looking for a way to customize an avatar while you play, go get Avatar Stats Loader, not this. This is for including stats with the avatar pallet for download, not customizing them while you play.
Avatar Extensions is a hybrid SDK Plugin x MelonLoader mod that allows you to customize your avatar's stats and masses, and preview the vanilla values, all from within the SDK! It also allows you to create new types of sound effects for reactions to things in the world. Now that's a fine sewer melon.
While similar, this is different than the Avatar Stats Loader mod. This mod allows avatars to include their custom stats with their released pallet, as a means of creative or mechanical expression on behalf of the avatar's creator. The creator chooses its stats so it plays and acts like they want it to, you download it and choose it, and it already has its custom values right out of the box.
The SDK and mod are both available on the GitHub.
Let me know in the Issues tab at the top of the page (or click that link).
You need both their avatar and this mod (the mod is what tells the game to get rid of the vanilla stats and use these instead). See below for how to install.
There is a mod (that's this repo), and there's a Unity Package (for the editor, check the releases). This goes over installing the mod portion.
- Download BoneLib first.
- Download FieldInjector next.
The mod will fail to load and/or crash if you do not have these installed. Install them.
- Install MelonLoader. Download it here
- YOU MUST USE MELONLOADER 0.5.7 - IF YOU DO NOT, YOUR GAME WILL CRASH AND BREAK.
- Launch the game without any mods installed. It will take longer than usual, but this sets it up for modding.
- Upgrade BONELAB to Patch 3 if you haven't already
- Right click on the game in Steam, and click properties
- Click on "Betas" on the side of the menu that opens up.
- In the dropdown, select public_beta
- Wait for the update to download.
- Install BoneLib if you haven't already. Download BoneLib here.
- Install FieldInjector if you haven't already. Download FieldInjector here.
- Install this mod by downloading it from the top most file from the Releases page.
- Now, if you download (or make) any avatars that use the Stat Driver, they will load their custom stats!
⚠ NOTE: This hasn't been tested on Quest and was not made for it. This mod might be very broken, and I have no way to fix it for Quest!
- Install LemonLoader. Click here for a tutorial on YouTube
- Upgrade BONELAB to Patch 3 if you haven't already
- Go to the Oculus Store (or your game library) and select BONELAB.
- Scroll down to Additional Details
- Find Version, and choose the version number that is next to it.
- Press the Channel button, and choose public_beta
- The game should update. If it doesn't, try restarting your Quest.
- Install BoneLib if you haven't already. Download BoneLib here.
- Install FieldInjector if you haven't already. Download FieldInjector here.
- Install this mod by downloading it from the top most file from the Releases page.
- Now, if you download (or make) any avatars that use the Stat Driver, they will load their custom stats!
- BACK UP YOUR UNITY PROJECT. It's not necessary, but it's usually a good idea, especially since this is still in testing phase.
- Install the Unity Editor Package by downloading it from the top most file from the Releases page.
- Follow the instructions on the Documentation website.
About a day straight in IDA, reading raw assembly, and translating it by hand to C#. It was not easy.