Offset Constraint

Generic badge Generic badge Generic badge Generic badge Generic badge

Generic badge Generic badge

A constraint system to preserve offsets

OffsetConstraint

⬇️ Download Latest Version

📦 Add to VRChat Creator Companion

How it works

  • Constraints reference each other as sources and swap their enabled state to preserve offset transforms.

Install guide

https://github.com/VRLabs/Offset-Constraint/assets/76777936/f20790ad-0a5e-49ee-aaac-3b2e380f5f93

  • Merge the Animator Controller Offset Constraint FX to your own FX Controller, using the Avatars 3.0 Manager tool.
  • Drag & drop the Offset Constraint prefab into the base of your Hierarchy.
  • Right click and unpack the prefab, then drag & drop it onto your avatar.
  • Expand the prefab hierarchy and find Offset Target
  • Move Offset Target outside of Offset Constraint and place it anywhere in your avatars hierarchy as needed.

[!NOTE]
When building for Quest, you will have to remove unsupported components and shaders

How to use

  • Place the objects you want to to use inside Offset Constraint -> Container.
    • Alternatively you can constrain the objects to Container.

There are two bools in your FX Controller:

  • OffsetConstraint/Control:
    • True: Places the Container in world space and allows the user to set the specified offset.
    • False: Constraints the Container to the Offset Target with the specified offset.
  • OffsetConstraint/Reset moves the Container to the Offset Target.

Performance stats

Constraints:        2
FX Animator Layers: 1

Hierarchy layout

Offset Constraint
|-Container
|  |-Cube
|-Root
|  |-End
|-Offset Target

Contributors

License

Offset Constraint is available as-is under MIT. For more information see LICENSE.

​

Package Name

dev.vrlabs.offset-constraint

Documentation

Undefined

Repositories

Version

1.0.3

Unity version

2022.3 or later

Dependencies

No dependencies

VPM Dependencies

Legacy Packages

No legacy packages

License

MIT

Author

VRLabs

Package JSON from Repository

{
  "name": "dev.vrlabs.offset-constraint",
  "displayName": "Offset Constraint",
  "version": "1.0.3",
  "license": "MIT",
  "unity": "2022.3",
  "description": "A hierarchy of animated constraints that display how to move an object in world space while preserving previously generated offsets.",
  "author": {
    "name": "VRLabs",
    "email": "mail@vrlabs.dev",
    "url": "https://vrlabs.dev"
  },
  "siteUrl": "https://github.com/VRLabs/Offset-Constraint",
  "vpmDependencies": {
    "dev.vrlabs.instancer": ">=1.0.2",
    "com.vrchat.avatars": "^3.7.0"
  },
  "legacyFolders": {
    "Assets\\VRLabs\\Offset Constraint": "594678af05e88bd41bf2421d9acb9365"
  },
  "unityPackageDestinationFolder": "Assets/VRLabs/Offset Constraint",
  "media": {
    "previewImage": "https://raw.githubusercontent.com/VRLabs/Offset-Constraint/main/Media/Web/Preview.webp",
    "previewGif": "https://raw.githubusercontent.com/VRLabs/Offset-Constraint/main/Media/Web/PreviewGif.webp"
  },
  "unityPackageDestinationFolderMetas": {
    "Assets/VRLabs": "652a1ba5b00554143bc9a76307dbc4e8",
    "Assets/VRLabs/Offset Constraint": "594678af05e88bd41bf2421d9acb9365"
  },
  "questCompatibility": "full",
  "url": "https://github.com/VRLabs/Offset-Constraint/releases/download/1.0.3/dev.vrlabs.offset-constraint-1.0.3.zip",
  "unityPackageUrl": "https://github.com/VRLabs/Offset-Constraint/releases/download/1.0.3/dev.vrlabs.offset-constraint-1.0.3.unitypackage",
  "zipSHA256": "ff60a76ba001adde742519b45f796355db4ba007dde0d3e93137b14dc61268b2"
}