You are viewing a potentially older version of this package. View all versions.
FirEmerald-AvatarStatsLoader-1.3.3 icon

AvatarStatsLoader

Override default avatar stats with values specific to each avatar.

Date uploaded 2 years ago
Version 1.3.3
Download link FirEmerald-AvatarStatsLoader-1.3.3.zip
Downloads 353
Dependency string FirEmerald-AvatarStatsLoader-1.3.3

This mod requires the following mods to function

gnonme-BoneLib-3.1.2 icon
gnonme-BoneLib

A BONELAB mod for making life easier for other mod creators.

Preferred version: 3.1.2

README

BoneLab AvatarStatsLoader

Allows loading of customized avatar stats in BoneLab


AvatarStatsLoader loads customized avatar stats from "<Game directory>\UserData\AvatarStats\<avatar name>.json".


Setting up custom stats using BoneLib 2.0.0 or newer using the BoneMenu

In-game, switch to the avatar you want to set up.
IMPORTANT: DO NOT ATTEMPT TO CHANGE STATS AFTER LOADING A LEVEL (INCLUDING LOADING THE GAME) BEFORE SWAPPING AVATARS AT LEAST ONCE. THERE'S A BUG WHERE DOING SO PUTS YOU INTO A POLYBLANK
Open up Menu->Preferences/Options->BoneMenu->Avatar Stats or Avatar Mass
Select which attribute(s) you would like to change - they should hold the current value for the avatar - and edit them to your liking.
Finally, if you want the changes to persist when you next load this avatar, click "Save stats" or "Save masses", depending on what you editet.


Setting up custom stats using MelonPreferencesManager

In-game, switch to the avatar you want to set up.
IMPORTANT: DO NOT ATTEMPT TO CHANGE STATS AFTER LOADING A LEVEL (INCLUDING LOADING THE GAME) BEFORE SWAPPING AVATARS AT LEAST ONCE. THERE'S A BUG WHERE DOING SO PUTS YOU INTO A POLYBLANK
Open up the preferences manager and navigate to the AvatarStatsMod options.
The options will have been populated with the current values for the avatar.
Edit any values to your liking, and then click "Save preferences" again. Use the "default" button to reset any values to the avatar's normally calculated value.
Finally, if you want the changes to persist when you next load this avatar, check "Save stats" and/or "Save masses", depending on what you edited, and click "Save Preferences".


A breakdown of the the different stats and what they do:

Agility: determines how fast an avatar can change direction and accelerate.
Speed: determines the maximum running speed of an avatar.
Strength Upper (Arm strength): determines the force with which an avatar can move things with it's hands. Beware - high values will cause issues when holding objects with two hands or climbing!
Strength Lower (Leg strength): determines jump height. Higher values have greatly diminishing effects - don't expect to be able to super-jump.
Vitality: determines how much damage the avatar takes from attacks.
Intelligence: has no affect on an avatar at the moment.


Compilation

To compile this mod, create a file named AvatarStatsLoader.csproj.user in the project. Copy this text into the file, replacing the path in BONELAB_PATH with the path to your BONELAB installation.

<?xml version="1.0" encoding="utf-8"?>
<Project>
    <PropertyGroup>
        <BONELAB_PATH>C:\Program Files (x86)\Steam\steamapps\common\BONELAB</BONELAB_PATH>
    </PropertyGroup>
</Project>


This mod was inspired by StatsOverride , and I looked at (disassembled) code for it and for DynamicBones in order to figure out how to make this mod. NO SIGNIFICANT PORTIONS OF CODE WERE COPIED TO MAKE THIS MOD.

CHANGELOG

1.3.5

  • Fix avatar masses not saving or loading
  • Remove unnecessary bonelib page max size specification
  • Pretty-print JSON files
  • Allow trailing commas in JSON files

1.3.4

  • Remove BoneLib version checker
  • Consolidate assembly info

1.3.3

  • Fix issue with BoneLib 3.1.0

1.3.2

  • Fixed avatar masses not being loaded

ALL ENTRIES BELOW THIS LINE ARE RECONSTRUCTED FROM THE COMMIT HISTORY AND MAY NOT BE FULLY ACCURATE

1.3.1

  • Ported to BoneLib 3.0.0

1.3.0

  • Ported to BoneLab Patch 4/5
  • Still used Bonelib 2.2.X menus
  • Avatar mass loading was broken

1.2.3

  • Actually fixed bad paths on quest

1.2.2

  • Attempted to fix bad paths on quest

1.2.1

  • Implemented real-time avatar stat value updating
  • Added additional increment/decrement values to the bonemenu

1.1.1

  • Added BoneMenu support

1.1.1

  • General improvements

1.1.0

  • Added avatar mass support

1.0.0

  • Initial release