Plugins + Scripts Weaver

WEAVER v0.6
Timeline Animation State Machine

Weaver is a state machine plugin built around Timeline that handles animation flow for you. Instead of manually wiring triggers and transitions, it organizes your clips into states, manages playback, and moves between positions in a way that stays smooth and consistent.

It’s designed to take the usual “stack of triggers” problem and turn it into something more structured and easier to scale.

Weaver v0.6 (hub v2) - Release Notes​

New Features​

Navigate To State: Matching Variant

• New trigger action that intelligently matches your current variant when navigating
• Example: In RIDE-HIPHOLD, trigger "precum" → automatically goes to PRECUM-HIPHOLD
• No more (or, less) manual variant tracking required

Recursive Interrupt Inheritance

• Interrupts now inherit, including through reference chains (A→B→C gets all interrupts of the previously referenced)
• UI shows exactly what's inherited with usable/total counts (e.g., "2/5")

Previous State Memory Duration

• Configure how long "previous state" is remembered (0-300 seconds)
• Toggle whether interrupts pause the memory timer
• Prevents stale PREV STATE button clicks after extended time (ie: 'I dont remember what position I was in previously, after 10 minutes of this one' )

Gaze Enhancements

• Blink Correlation: Eyes more likely to switch targets during blinks (natural behavior)
• Movement Detection(optional, default OFF): Attention snaps to moving targets
  • Configurable threshold, lock duration, and cooldown
  • Instant lock-on when movement detected
  • Performance-optimized (samples every 3 frames)
  • Still possibly a performance hog, in testing!️

Bug Fixes (from v0.5 and pre-release 0.6)​

• Fixed nested borrow/reference interrupt returns
• Referenced interrupts now navigate properly with transitions
• Forced variant application on direct state landing
• Improved interrupt reference chain display in UI

---

What It Does

• Automatically cycles animations and variants within a state
• Selects variants (slow / fast / twisting / bobbing / etc) using weighted randomness
• Routes between positions using BFS pathfinding (so transitions don’t break)
• Handles timing, pacing, and transitions without constant manual input

You set up the structure– Weaver runs it!

---

Example Scene
See here a small example of the basics-- a much larger, truly robust scene is in the works to give a fuller picture of Weaver!

---

Core Systems

Automatic Pre-setup

• Auto-discovery scans and pulls in animations
• Creates base states, variants, and settings for you
• Create transitions
• Understands clip duration and flow
• Understands clip type

Animation Handling

• Clip cycling per state
• Weighted variant selection
• BFS-based transition routing
• Priority system for transitions (P1–P4)
• Variant bridging for smoother in-state changes

Behavior Systems

• Tiredness / Exhaustion — longer activity optionally leads to slower pacing
• Shyness — eye contact and intensity evolves over time
• Speed Control — adjustable playback intensity and randomness
• Rigidity Control — per-variant & per control point physics tuning
• Breathing — reactions and breathing synced to activity level
• Gaze System — easily configurable look-at targeting and behaviors

Logic Layer

• Variables (bool / float / string)
• Interrupts for reactive moments
• Meta states & trigger slots for grouping and easily triggering
• Timed states with auto-transitions
• Entry locks to stabilize flow

Advanced at a Glace

• Allow your person to Ask questions, and receive responses that alter the scene
• React to user input in multiple ways without intertuption
• Intense moments can lead to holding their breath
• Check it out for More!

---

Timeline Integration

• Uses naming convention: STATE-VARIANT/CLIP
• Supports duration markers [5] and priority flags ![10]
• Works directly with Timeline’s existing system

---

Control & Triggers

• Navigate to states or variants directly
• Set & check variables and trigger interrupts
• Toggle systems on/off as needed

---

Use Cases

• Multi-position scenes that transition cleanly
• Pacing systems that change over time
• Conditional content (based on variables or interaction)
• Complex setups without massive trigger chains

---

Requirements

• Timeline plugin (Acid Bubbles)
• Animations set up using Weaver naming conventions
• The willingness to create! lol

---

Status and Help
Currently in beta. Core features are stable, but there are still edge cases — save often.

Includes a full PDF manual with setup and system breakdowns found here on Patreon!

---

Notes
Weaver changes how scenes are structured a bit, especially if you’re used to manual triggers. There’s a learning curve, but it’s pretty manageable once you see how states and variants fit together.

---

Credits:

A huge thank-you to the entire VaM community: the modders, plugin creators, modelers, artists, designers, tinkerers, and all the folks who share their time, talent and knowledge. VaM is an amazing sandbox, but you’ve really expanded what’s possible. Hats off to those who’ve paved the way for scene creators, story tellers, and Patreon-havers. You’re all inspiring, to say the least. Cheers, mates.

If I am ever missing or mis-crediting someone or something please let me know so that I may correct it.

Special thanks to MacGruber
Special thanks to Lapiro
Special thanks to Acidbubbles
Special thanks to Skynet
Special thanks to 14mhz

---

A little help​

If you want to support what I’m building, even a one-time tip goes a long way and directly helps me keep improving these systems and releasing more scenes. Please see my Patreon for such a display of gratitude.