VNyan pendulum chains
vnyan_pendulumControl pendulum chains for VNyan avatar physics: create new chains, adjust their position or rotation, delete them, and list existing chains.
Instructions
'list' (disk, always readable) reads the pendulum chains configured in VNyan's UI (settings.json 'Chains' - spring-physics bone chains like ear/tail wiggle, each with input/output bindings). 'create'/'delete'/'setPosition'/'setRotation'/'chains' (plugin, live) manage a SEPARATE set of chains created at runtime via this API, addressed by the numeric handle 'create' returns - they are not the same chains as 'list' and don't persist across a VNyan restart. See vnyan_guide topic:'pendulum-tuning' for the full physics explanation.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| inert | No | How much of the avatar's own movement is transferred into the chain, 0-1 (hard-clamped). Default 0. For 'create', at runtime creation time only. | |
| value | No | Drive value for setPosition/setRotation - setPosition makes the pendulum swing back and forth as this value changes over repeated calls; setRotation swings it to this angle and holds it there. | |
| action | Yes | Which pendulum operation to perform | |
| handle | No | Handle from a prior 'create' (required for all but 'create') | |
| damping | No | How fast motion decays, 0-1 (hard-clamped by VNyan). Default 0.1. Higher = settles sooner. For 'create', at runtime creation time only. | |
| boneCount | No | For 'create'. Typical chains use 2-4 bones. Default 4 | |
| stiffness | No | Resistance to being rotated away from the rest orientation, 0-1 (hard-clamped). Default 0.1. For 'create', at runtime creation time only. | |
| elasticity | No | Restoring force pulling each bone back to its rest position, 0-1 (hard-clamped). Default 0.1. LOWER = floppier / more swing-bounce; higher = snaps back fast - it's a return-strength, not a bounce-amount, so low values look bouncier. Applies uniformly across the whole chain (VNyan does not use per-bone distribution curves), though motion naturally accumulates toward the chain tip. For 'create', at runtime creation time only. |