3.2.1: Avatar scaling and improved settings window

Creator Companion not required. Standalone Avatar SDK is also supported.

However, it is recommended to download the latest Avatar 3.0 SDK using the Creator Companion, available from VRChat official download website. GestureManager, installed from VCC, will provide the nicer looking radial menu.

Whether you import into a standalone project or a creator companion project, note that this version installs into Packages and it is your responsibility to clean up the old Lyuma/Av3Emulator folder and the old GestureManager folder to avoid future conflicts.

To get nice radial menus, GestureManager must be installed into Packages with a new VPM compatible version.

v 3.2.1: Avatar scaling and improved settings window

Download version 3.2.1 .unitypackage HERE!

New features in v 3.2.1:

• Av3Emulator is available in curated packages in VCC!
• Added credits, readme, github, version and changelog to the inspector.
• Introduce a OSC Control Panel window similar to the Settings window.
• Run preprocess hooks by default to make VRCFury testing easier.
• Create an emulator object from settings Apply button if one does not already exist.
• Disable GestureManager when creating an emulator object to avoid conflict.
• Make the settings window easier to use: Apply changes directly to the scene.
• Add avatar scaling support, with checkbox (Thanks, jellejurre)
• Add voice parameter functionality (Thanks, jellejurre)

3.2.0: Bugfixes and VCC compatibility

Creator Companion not required. Standalone Avatar SDK is also supported.

However, it is recommended to download the latest Avatar 3.0 SDK using the Creator Companion, available from VRChat official download website. GestureManager, installed from VCC, will provide the nicer looking radial menu.

Whether you import into a standalone project or a creator companion project, note that this version installs into Packages and it is your responsibility to clean up the old Lyuma/Av3Emulator folder and the old GestureManager folder to avoid future conflicts.

To get nice radial menus, GestureManager must be installed into Packages with a new VPM compatible version.

v 3.2.0: VPM Support, parameter type aliasing and bugfixes

Download version 3.2.0 .unitypackage HERE!

New features in v 3.2.0:

• Av3Emulator is now available in curated packages in VCC!
• Updated version range to not downgrade VRCSDK below 3.3.x
• Show warning if GestureManager is enabled in the same scene. Fix some integration issues with GM 3.8.3 and higher.
• Do not clamp non-synced params. Internal cleanup with duplicate parameters
• Implement Settings page to save Default Settings. Add a button to set blendshape clamping.
• Add Earmuffs and VelocityMagnitude and freeze viseme when Mouth/Jaw animated
• Add localonly contact support
• Mitigation for both GestureManager and Av3Emulator in use in play mode.
• Support for SDK 3.2.x including squish parameter.
• Fix radial menu compact checkbox

3.1.4: Support for beta SDK with squish bone

Creator Companion not required. Standalone Avatar SDK is also supported.

However, it is recommended to download the latest Avatar 3.0 SDK using the Creator Companion, available from VRChat official download website. GestureManager, installed from VCC, will provide the nicer looking radial menu.

Whether you import into a standalone project or a creator companion project, note that this version installs into Packages and it is your responsibility to clean up the old Lyuma/Av3Emulator folder and the old GestureManager folder to avoid future conflicts.

To get nice radial menus, GestureManager must be installed into Packages with a new VPM compatible version.

v 3.1.4: VPM Support, parameter type aliasing and bugfixes

Download version 3.1.4 .unitypackage HERE!

New features in v 3.1.x:

3.1.4:

• Support for beta SDK 3.2.x including squish parameter.

3.1.2, 3.1.3:

• Fix uploading issue caused by VRCSDK reflection fix.
• Compatibility with old VRCSDK <= 3.1.11
• Fix disable radial menu button

3.1.1:

• Fix error when DynamicBone is not present in project.
• Fix one cause of random bicycle pose when using experimental editor features. Thanks for reporting, DorCoMaNdO (Fixes #92 and #99)
  (In general, experimental features can lead to editor instability or crashes. Use at your own risk.)
• Deduplicate OSC warnings to avoid logspam. Thanks, Razgriz (Fixes #74)
• Allow emulating avatars in additively loaded scenes (PR #73). Thanks, SenkyDragon.

3.1.0:

• Make clone offset purely visual (from preCull until postRender). This may make testing network sync with contacts easier.
• Perform conversion of DynamicBone for legacy avatars that still use them.
• Implement descriptor colliders & senders emulation. Thanks, Dreadrith.
• Add local expression parameter support
• Add option for default poses. Thanks, Dreadrith.
• Add direct syncing between local and shadow/mirror clone. OSC now only initializes once.
• Performance optimizations for update loop. Thanks, jellejurre.
• Add renderer caching, fix skinned renderer mirror/shadow toggles. Thanks, jellejurre
• Compatibiltiy with GestureManager 3.8.3 only. Will enable GM menu by default if installed.

v3.1.3: GestureManager 3.8.3, performance improvement, clone visuals, colliders

Creator Companion not required. Standalone Avatar SDK is also supported.

However, it is recommended to download the latest Avatar 3.0 SDK using the Creator Companion, available from VRChat official download website. GestureManager, installed from VCC, will provide the nicer looking radial menu.

Whether you import into a standalone project or a creator companion project, note that this version installs into Packages and it is your responsibility to clean up the old Lyuma/Av3Emulator folder and the old GestureManager folder to avoid future conflicts.

To get nice radial menus, GestureManager must be installed into Packages with a new VPM compatible version.

v 3.1.3: VPM Support, parameter type aliasing and bugfixes

Download version 3.1.3 .unitypackage HERE!

New features in v 3.1.x:

3.1.2, 3.1.3:

• Fix uploading issue caused by VRCSDK reflection fix.
• Compatibility with old VRCSDK <= 3.1.11
• Fix disable radial menu button

3.1.1:

• Fix error when DynamicBone is not present in project.
• Fix one cause of random bicycle pose when using experimental editor features. Thanks for reporting, DorCoMaNdO (Fixes #92 and #99)
  (In general, experimental features can lead to editor instability or crashes. Use at your own risk.)
• Deduplicate OSC warnings to avoid logspam. Thanks, Razgriz (Fixes #74)
• Allow emulating avatars in additively loaded scenes (PR #73). Thanks, SenkyDragon.

3.1.0:

• Make clone offset purely visual (from preCull until postRender). This may make testing network sync with contacts easier.
• Perform conversion of DynamicBone for legacy avatars that still use them.
• Implement descriptor colliders & senders emulation. Thanks, Dreadrith.
• Add local expression parameter support
• Add option for default poses. Thanks, Dreadrith.
• Add direct syncing between local and shadow/mirror clone. OSC now only initializes once.
• Performance optimizations for update loop. Thanks, jellejurre.
• Add renderer caching, fix skinned renderer mirror/shadow toggles. Thanks, jellejurre
• Compatibiltiy with GestureManager 3.8.3 only. Will enable GM menu by default if installed.

v3.1.2

unitypackage was reuploaded with hotfix

New features in v 3.1.2:

3.1.2:

• Compatibility with old VRCSDK <= 3.1.11

3.1.1:

• Fix error when DynamicBone is not present in project.
• Fix one cause of random bicycle pose when using experimental editor features. Thanks for reporting, DorCoMaNdO (Fixes #92 and #99)
  (In general, experimental features can lead to editor instability or crashes. Use at your own risk.)
• Deduplicate OSC warnings to avoid logspam. Thanks, Razgriz (Fixes #74)
• Allow emulating avatars in additively loaded scenes (PR #73). Thanks, SenkyDragon.

v3.1.1

v 3.1.1: VPM Support, parameter type aliasing and bugfixes

New features in v 3.1.1:

• Fix error when DynamicBone is not present in project.
• Fix one cause of random bicycle pose when using experimental editor features. Thanks for reporting, DorCoMaNdO (Fixes #92 and #99)
  (In general, experimental features can lead to editor instability or crashes. Use at your own risk.)
• Deduplicate OSC warnings to avoid logspam. Thanks, Razgriz (Fixes #74)
• Allow emulating avatars in additively loaded scenes (PR #73). Thanks, SenkyDragon.

v3.1.0

v 3.1.0: VPM Support, parameter type aliasing and bugfixes

Download version 3.1.0 .unitypackage HERE!

New features in v 3.1.0:

• Make clone offset purely visual (from preCull until postRender). This may make testing network sync with contacts easier.
• Perform conversion of DynamicBone for legacy avatars that still use them.
• Implement descriptor colliders & senders emulation. Thanks, Dreadrith.
• Add local expression parameter support
• Add option for default poses. Thanks, Dreadrith.
• Add direct syncing between local and shadow/mirror clone. OSC now only initializes once.
• Performance optimizations for update loop. Thanks, jellejurre.
• Add renderer caching, fix skinned renderer mirror/shadow toggles. Thanks, jellejurre
• Compatibiltiy with GestureManager 3.8.3 only. Will enable GM menu by default if installed.

3.0.1: VPM Support, parameter type aliasing and bugfixes

Creator Companion not required. Standalone Avatar SDK is also supported.

However, it is recommended to download the latest Avatar 3.0 SDK using the Creator Companion, available from VRChat official download website. GestureManager, installed from VCC, will provide the nicer looking radial menu.

Whether you import into a standalone project or a creator companion project, note that this version installs into Packages and it is your responsibility to clean up the old Lyuma/Av3Emulator folder and the old GestureManager folder to avoid future conflicts.

To get nice radial menus, GestureManager must be installed into Packages with a new VPM compatible version.

v 3.0.1: VPM Support, parameter type aliasing and bugfixes

Download version 3.0.1 .unitypackage HERE!

New features in v 3.0.1:

• If you import this package, it will import to the Packages folder. If you have the old (Assets folder) version, delete it or you won't have access to the new features.

• Finally, VPM support for VRChat Creator Compnaion! Thanks to jellejurre and anatawa12 for your hard work in making this happen!

• Added VCC/VPM Support.

  • This means added compatibility with the VCC GestureManager, but removed compatibility with the pre-VCC GestureManager.
  • You can still import the unitypackage as usual, but it will be unpacked to the Packages folder, not the Assets folder.
  • You can also copy the created lyuma.av3emulator folder to another location, add that folder to the VCC in the settings menu, and install the emulator with a single click for any of your other projects.

• Installs in Packages with unique GUIDs. you are free to remove the old Lyuma/Av3Emulator directory after upgrading.

• Fixed the wrong guid being used for the Action controller. Thanks, ShingenPizza.

• Generate AvatarMask in code instead of using assets.

• Implement parameter mismatch, so bool parameters can be coerced into floats, for example for usage in blend trees.

• Added rich text support for VRCExpressionMenus in the simple parameter menu.

• Fixed one instance of "Can't remove component" error appearing when filtering components to emulate shadow and mirror clones.

• Fixed mirrorclone and shadowclone having IsLocal set to false.

Avatar Dynamics integration (read NOTE)

Latest VRCSDK provides Avatar Dynamics support built-in.

NOTE: To test Avatar Dynamics, you must have a Camera in your scene tagged as "Main Camera" (top of the inspector next to the layer dropdown).

To test, you must be in Game View. Make use of GameObject menu -> Align With View (Ctrl+Shift+F) for easily copying the Scene View to your camera transform.

This update hooks into the driven parameters on both PhysBone and ContactReceiver. Enabled by default. Can be disabled by ticking a box on the Emulator Control before entering play mode. Recommended to set Radius greater than 0.

OSC Now works in the emulator (opt-in): Supports sending and receiving OSC messages for your avatar. Off by default. Simply tick "Enable Avatar OSC" to turn it on.

Supports generating, loading and saving JSON config files for OSC for use in VRChat.

Compatible with VRCFaceTracking. Avatar switch messages are now implemented! Messages are sent without bundles for compatibility.

(Open the above full explanation image)

See more features and bugfixes in the README.

v2.9.12: Last non-VPM release with parameter type aliasing fix + GM 3.7

New features in v 2.9.12:

This version was released from the legacy-emulator-v2.9 branch.

Download version 2.9.12 .unitypackage HERE!
Download Av3Emulator .zip only (no GestureManager) HERE.

This will likely be the last and final non-VPM release in the 2.9 series. Includes GestureManager 3.7

You are encouraged to install the 3.0 release, which includes VPM support (for VCC), and installs into the Packages directory.

Version 3.0 should work even in a non-VCC project, but I am releasing this version in case some people still wish to avoid this change.

Here are the Cherry-picked useful changes from 3.0. Thanks, Shingen, jellejurre, anatawa12 and Dreadrith for your help!

• Fixed GUID for Action playable layer.
• Generate AvatarMask in code instead of using assets.
• Implement parameter mismatch, so bool parameters can be coerced into floats, for example for usage in blend trees.
• Rich text support for simple parameter menu.
• Filter components to more accurately emulate shadow and mirror clones.

v2.9.11: SDK 2022.10.12.21.07 + GM 3.7

Please make sure you use The latest VRCSDK Avatar 3.0. Update first!

Creator Companion not required. Standalone Avatar SDK is supported.

v 2.9.11: Compatibility with new VRCSDK; Upgrade to GestureManager 3.7.

Download version 2.9.11 .unitypackage HERE!
Download Av3Emulator .zip only (no GestureManager) HERE.

New features in v 2.9.11:

• Updated for new GestureManager.
• Support sending and recieving avatar dynamics over OSC.
• Support receiving in-game input (velocity, etc.) from OSC. Thanks, NotAKidOnSteam.
• Can also test loopback using same send and recieve port. Enable Gizmos in Game View toolbar.
• Add checkbox to enable Avatar Preprocess hooks. Thanks, bd_. May interfere with the first clone.
• Fix for new FX mask behavior. Thanks, Mysteryem.
• Attempt to mitigate default mask and controllers from Creator Companion SDK.

New features in v 2.9.10 (3.0 rc7):

• Fixed legacy menu being completely broken.
• Fixed ParameterDriver Copy when setting float parameters.
• Made ParameterDriver Copy set boolean to true if negative, to match docs.
• Allow dragging Expression Value in the Floats section of the inspector.
• In the Floats section, "Value" will show the animated Animator parameter (if driven by curve) which may be different from the expression value which is used for sync and parameter driver Copy.

New features in v 2.9.9 (3.0 rc6):

• Only compatible with the SDK VRCSDK3-AVATAR-2022.06.03 or newer! Please update the SDK if it is from before June 2022.
• Added support for the new Copy ParameterDriver feature.
• Bifurcate exported and internal float values to avoid pollution from AAPs. This should match game better, as you cannot sync an AAP value over the network.
  You will not see exportedValue and value sliders for floats. Value will represent what the Animator sees, while Exported represents the value which is synced (and used for parameter Copy).
• Please let me know if there are bugs related to the bifurcated float parameters.
• Make buttons compact by default to avoid issue with huge buttons.
• Remove use of Reflection, as we are breaking compatibility with older VRCSDK versions.

Avatar Dynamics integration (read NOTE)

Latest VRCSDK provides Avatar Dynamics support built-in.

NOTE: To test Avatar Dynamics, you must have a Camera in your scene tagged as "Main Camera" (top of the inspector next to the layer dropdown).

To test, you must be in Game View. Make use of GameObject menu -> Align With View (Ctrl+Shift+F) for easily copying the Scene View to your camera transform.

This update hooks into the driven parameters on both PhysBone and ContactReceiver. Enabled by default. Can be disabled by ticking a box on the Emulator Control before entering play mode. Recommended to set Radius greater than 0.

OSC Now works in the emulator (opt-in): Supports sending and receiving OSC messages for your avatar. Off by default. Simply tick "Enable Avatar OSC" to turn it on.

Supports generating, loading and saving JSON config files for OSC for use in VRChat.

Compatible with VRCFaceTracking. Avatar switch messages are now implemented! Messages are sent without bundles for compatibility.

(Open the above full explanation image)

See more features and bugfixes in the README.