Skip to main content

Force Write Defaults v1.0.* Instructions

Overview​

This is a NDMF plugin that non-destructively forces a animator state writes defaults or not.

Notes​

  • This package has only been tested with VRCSDK3 and Unity 2022.3.22f1.
Overview end

Installation​

Dependencies​

This package depends on the following packages. Make sure you have installed it before installing this package.

Installing Package​

  1. Go to our vpm package listing page.
  2. Click on Add to VCC button to add the repository into VCC/ALCOM.
  3. In VCC/ALCOM, go to the project's manage page and install Force Write Defaults.
Installation end

How to Use​

This plugin supports overriding animator states' write defaults with State Behaviour or state name marks, State Behaviour method has higher priority.

Override Write Defaults with State Behaviour​

  1. Select states that need to be override in Animator;
  2. Go to Inspector and click on Add Behaviour;
  3. Search for Force Write Defaults and add it to the selected state;
  4. Check / Uncheck the Write Defaults field in the added Force Write Defaults to override the write defaults.

Override Write Defaults with State Name Mark​

  1. Select states that need to be override in Animator;
  2. Go to Inspector and edit the name of the selected state, Add (WD On)/(WD Off)(Case-insensitive) at the end of the name to override the write defaults.

Done​

Enter play mode or build the avatar to see the result.

How to Use end

How Does It Work​

This plugin runs in NDMF's optimizing phase.

What Does It Do​

When it runs, It:

  1. Searchs for every Animator State and Animator State Machine in avatar;
  2. Finds out if there's any Force Write Defaults in that state or state machine;
  3. If there's any Force Write Defaults in the state, or the state's name ends with (WD On)/(WD Off), overrides it's write defaults;
  4. Destroy Force Write Defaults in the state or state machine.
How Does It Work end