Plugins + Scripts Physics Attachment Engine

Physics Attachment Engine — Major System Upgrade​

This update is huge — Physics Attachment Engine has evolved from a simple controller-to-controller joint system into a fully featured attachment framework.
With new modes, presets, offset memory, perfect-follow logic, VR-optimized UI, and smarter triggers, the plugin is now ready for professional scene building.


Below is a full overview of everything new.

---

1. Perfect Follow Mode (ZERO-Lag Attachment)​

A brand-new attachment mode designed for scripted thrusting, machines, handheld props, and anything that must follow exactly with no spring delay.

• Uses kinematic rigidbody following (not physics springs)
• Powered by MovePosition() + MoveRotation() for precision
• 100% zero-lag tracking
• Fully supports positional + rotational offsets
• Ideal for toys, machines, multi-atom rigs, and animation-driven props

This mode delivers accuracy traditional spring joints can never achieve.

---

2. Use-Case Presets (One-Click Setup)​

New preset selector instantly configures the attachment for common scenarios:

• Hand → Breast
• Hand → Hip
• Hip → Chair
• Chest → Chest (hugging)
• Head → Pillow
• Custom mode

Each preset automatically adjusts:

• stiffness
• damping
• attachment mode
• offset rules
• blend speed

Perfect for quick scene building.

---

3. Mirror Mode (Attach Left + Right Simultaneously)​

Attach one hand and the plugin automatically attaches the mirrored hand to the corresponding body part.


Especially useful for VR posing or symmetrical rigs.

---

4. Offset Memory System (New)​

The plugin now remembers the exact positional and rotational offset used during attachment.

• Reattach → original offset restored
• Perfect for repeated actions
• Ideal for animation setups
• Symmetry stays consistent

This makes re-attachment extremely fast and consistent.

---

5. New Attachment Modes​

In addition to Soft / Firm / Lock, you now have:

• Grab / Hold — strong position, soft rotation
• Glue — stiff rotation & position (perfect for hugging or close body contact)
• Loose Follow — soft springs with natural lag/wobble
• Perfect Follow — zero-lag kinematic mode

These modes dramatically expand how attachments behave in scenes.

---

6. Full Rigidbody Support​

You are no longer limited to controllers.


Attach to:

• breasts
• hips
• abdomen
• chest
• thighs
• any Person rigidbody

Dropdown lists are now split into:

• Controllers
• Body Parts (Rigidbodies)

This makes navigation cleaner and more intuitive.

---

7. Completely Redesigned UI System​

The entire UI has been modernized:

• Long lists organized into categories
• VR-friendly selections
• Rebuilt “Active Attachments” section
• Clean human-readable formatting
• Preset + atom names displayed together

Much easier to use both on desktop and in VR.

---

8. Attachment Counter (VR-Friendly Feedback)​

Always visible at the top of the UI.


Shows exactly how many attachments are active at any time.

---

9. Expanded Trigger Support​

New JSON Actions added:

• Attach
• Detach All
• Detach Last
• Attach Preset Slot 1
• Attach Preset Slot 2
• Attach Preset Slot 3

These allow fully automated attachments in:

• story scenes
• animations
• toys/machines
• hands-on interactions

---

10. Enable/Disable All Attachments (List Preserved!)​

Turning attachments OFF no longer deletes them.

• OFF → joints removed but list stays
• ON → all joints recreated instantly

Huge quality-of-life upgrade for scene work.

---

🛠 11. Fully Rewritten Joint System​

The physics core has been rebuilt:

• Correct spring/damper interpolation
• Independent angular + linear logic per mode
• Smooth blend-in and blend-out
• More stable under heavy physics load

Much more reliable in complex scenes.

---

🛠 12. Save/Load Restored & Improved​

Scenes now correctly save:

• attachment modes
• stiffness & damping
• blend speed
• offset data
• active attachment list

UI is rebuilt cleanly on load with no duplicates.

---

🛠 13. Automatic Error Handling​

The plugin now detects and safely handles:

• missing atoms
• missing rigidbodies
• destroyed controllers
• invalid states

Clear messages prevent confusion and broken setups.

---

Summary​

This update transforms Physics Attachment Engine into a complete attachment and interaction system with:

• Zero-lag modes
• Realistic spring physics
• Smart presets
• Offset memory
• Mirror logic
• VR-optimized UI
• Robust triggers
• Full rigidbody support

It is now one of the most versatile attachment tools available for VaM.

---

License Update​

PhysicsAttachmentEngine is now released under CC BY-SA, matching VaM Hub requirements and enabling community contributions while preserving attribution.

Physics Attachment Engine – Update 2.1 ​

This update introduces two major improvements: a zero-lag attachment mode and searchable selector fields for faster workflow.

---

1. Perfect Follow Mode (Zero-Lag Attachment)​

A brand-new attachment mode designed for situations where absolute, instant following is required.


What it does:

• Zero delay between source and target
• Uses kinematic tracking, not springs
• Fully supports Position-Only, offsets, and all existing controls
• Ideal for scripted motion or fast-moving interactions (e.g., thrusting objects, hand attachments, tools, etc.)

How it works internally:

• Target rigidbody is temporarily set to kinematic
• Movement updated through MovePosition() and MoveRotation()
• No spring physics → no latency, no wobble

Result:
A perfectly locked follow-behavior that feels instant and precise.

---

2. Searchable Selector Fields​

All dropdown selectors now include built-in search filters:

• Source Atom Filter
• Source Controller Filter
• Target Atom Filter
• Target Controller Filter

Features:

• Filter appears directly under each selector
• Type to instantly narrow the list
• Case-insensitive
• Massive quality-of-life upgrade, especially in VR or scenes with hundreds of controllers

---

Both improvements make Physics Attachment Engine faster, cleaner, and easier to use—whether you’re attaching hands, props, toys, or full-body rigs.

Physics Attachment Engine 2.0 Update (experimental)​

This update builds on the previous improvements (Position-Only tracking, rotation fixes, and the new “Enable All Attachments” system) and brings the plugin to a full behavior-driven attachment system.
Physics Attachment Engine is no longer just an attach/detach tool — it now provides realistic grab, hold, hug, sit, and soft-follow behaviors with offset capture and scene presets.

---

NEW FEATURES​

1. Attachment Modes (New Behavior System)​

In addition to stiffness presets (Soft / Firm / Lock), attachments now have behavior modes that define how the joint acts:

Grab / Hold (Default)​

• Strong positional tracking
• Soft rotational control
• Perfect for hand → object, hand → breast
• Natural, controlled follow behavior

Glue Mode​

• Stiff position & rotation
• +20% damping for elasticity
• Great for body → body, hip → chair, chest → chest (hug)
• “Solid connection” while still feeling organic

Loose Follow Mode​

• 40% softer springs
• 60% reduced damping
• 70% reduced force
• Ideal for soft “trailing” motion like hand following breast
• Very natural for relaxed scenes or cuddle motions

---

2. Offset-Based Attach (Attach in Current Pose) — ON by default​

Attachments now preserve the exact spatial relationship at the moment of attaching.

What this fixes:​

• No more snapping
• No more “pivot-to-pivot jumps”
• Perfect for custom posing before attaching

Technical highlights:

• Captures relative position + rotation
• Writes into joint anchor & targetRotation
• Works with all modes and stiffness presets

---

3. Use-Case Presets (1-Click Scene Setup)​

A new dropdown provides ready-made setups for common VaM scenarios:

• Hand → Breast – Soft, Grab/Hold, faster blend, offset ON
• Hand → Hip – Firm, Grab/Hold, offset ON
• Hip → Chair – Lock, Glue, slower blend, offset ON
• Chest → Chest (Hug) – Firm, Glue, offset ON
• Head → Pillow – Soft, Loose Follow, offset ON

Each preset configures:

• Behavior mode
• Stiffness
• Blend speed
• Offset usage

This makes attachment setups significantly faster for scene creators.

---

4. Enhanced Trigger Action System​

New trigger actions for Timeline, LogicBricks and other plugin control:

New actions:​

• Detach Last – Removes the most recently created attachment
• Attach Preset Slot 1 / 2 / 3 – Quick preset-based attach (framework ready)

Existing:​

• Attach
• Detach All

You can now create full attachment sequences in Timeline:

• Attach hand to cup at scene intro
• After 5s → Detach Last
• After 10s → Attach preset #1

---

5. Role Tags (Future AI / Locomotion Integration)​

Every attachment now includes a small string identifier:



role = "HandGrab", "HugLink", "ChairSit", etc.


This prepares the engine for:

• Locomotion systems
• Interaction AI
• State-based attachment logic

Not used yet — but extremely powerful groundwork.

---

UNDER THE HOOD IMPROVEMENTS​

✔ Updated joint creation system​

Now applies behavior mode, offset, and stiffness correctly on creation & recreation.

✔ Backward compatible​

Old scenes using classic controller-based attachments still work.

✔ UI improvements​

• New dropdowns: Use-Case Preset, Attachment Mode
• New toggle: Attach in Current Pose (Keep Offset)
• New button: Detach Last
• Status now reports active mode + offset info

---

RECOMMENDED USAGE​

For grabs and interactions​

Grab/Hold mode, Soft or Firm stiffness, Offset ON

For hugs or body-to-body​

Glue mode, Firm or Lock stiffness

For soft trailing movement​

Loose Follow mode, Soft stiffness

For chair sitting​

Preset: Hip → Chair

---

This update transforms Physics Attachment Engine into a complete physical interaction system — not just an attachment tool.​

Physics Attachment Engine – Update​

This update brings major workflow improvements, more control over attachment behavior, and full trigger-friendly management of multiple attachments.

---

✔ New Features & Fixes​

1. Position-Only Tracking​

You can now choose to follow position only while keeping the rotation completely free.

• Added toggle: “Position Only (No Rotation)”
• When enabled:
  • Only position is synced
  • Angular motion is set to Free
  • Perfect for natural hands-to-body or object interactions
• When disabled:
  • Full position + rotation tracking (default)

---

2. Rotation Handling Fixed​

Rotation is no longer applied when using position-only mode.

• Proper angularX/Y/Z motion configuration
• Cleaner, more predictable attachment behavior

---

3. Global Enable/Disable Toggle​

Introducing the new workflow toggle: “Enable All Attachments”

• OFF: All joints are removed, but your attachment list is preserved
• ON: All joints are automatically recreated from saved configurations
• No more losing your controller pairs
• Ideal for animations, timelines, triggers, and scene automation

---

4. New Internal Methods​

To support the improved behavior:

• DestroyJoint() – Removes the joint while keeping the attachment data
• RecreateJoint() – Rebuilds the joint using stored rigidbody references
• Smooth fade-in when attachments are restored

---

✔ Trigger Support​

Full integration for LogicBricks, Timeline, and other trigger systems:

• Attach (per-attachment)
• Detach All
• AttachmentsEnabled (bool) — perfect for toggling groups on/off

---

✔ Usage Examples​

Position-Only Tracking​

1. Enable Position Only (No Rotation)
2. Click Attach
3. Source should follow the target’s movement while keeping its own rotation

Non-Destructive Toggle​

1. Create multiple attachments
2. Toggle Enable All Attachments OFF → detaches safely
3. Toggle ON → everything is restored instantly

v1.0.1 – Trigger Support Added(FORGOT!! )

• Added JSONStorable actions: Attach and Detach All
• Now works with PoseSaver, Timeline, LogicBricks, and all trigger systems
• Attach/detach can be automated by scene triggers (OnEnter, OnExit, collision, button press, etc.)