Plugins + Scripts RecoveryTools

RecoveryTools is a session plugin designed to protect your VAM scenes from accidents, bugs, or unexpected physics explosions, giving you fast recovery options and peace of mind while building.

Main Features

SCREEN RECOVERY: Restore camera if you spawn off screen or in the void.

PHYSICS RECOVERY: Recover from physics explosions or overlapping characters.
AUTO SAVE: Save scenes on a timer with optional screenshots and naming.

Hotkey support included for fast access.

---

Before: RecoveryTools - Screen Recovery
All Scenes Browser or Hub Browser spawns you in the void or off screen.

After: RecoveryTools - Screen Recovery
All Scenes Browser or Hub Browser fixed.

---

Before: RecoveryTools - Physics Recovery
Physics Explosion with Person Atom. Trying to resolve before scene crashes losing all progress.

After: RecoveryTools - Physics Recovery
Pose reset, physics settled, and characters recovered with a hotkey.

---

Before: RecoveryTools - Auto Save
"Can someone help, my scene won't open?"
"How do you fix a corrupt .json scene file?"
"I forgot to save and lost 4 hours of work!"
"I accidentally opened the scene browser and exited out my scene before saving it!"

After: RecoveryTools - Auto Save
Auto Save your important scene project in intervals while working on it to do a rollback if needed, issue fixed.

---

How do I setup/add this plugin?

This is a session plugin, so to use it:

1. Enter Edit Mode
2. Click Open Main UI
3. Go to the Session Plugins tab
4. Click Add Plugin → Select File and choose the .cslist inside the .var
5. Click Open Custom UI to edit preferences.

To make it auto-load in all future VAM Sessions:

1. Go to the Session Plugin Presets tab
2. Click Change User Defaults
3. Select Set Current as User Defaults

---

My browser is loading off screen but I forgot to add RecoveryTools as a session plugin?
On your keyboard click on the "U" key and it will open VAM Edit Mode. From there you can go to the Session Plugins tab and add it and then use the Screen Recovery tab to restore your screen.

---
Here’s an overview of how the tabs work:

Screen Recovery Tab​

• Reset Screen – Manually resets camera based on X/Y/Z sliders.
• CTRL + [Key] – Hotkey reset of camera position. Hold down CTRL, then tap the key.
• Camera X/Y/Z – Set target screen coordinates.
• Screen Recovery Logs – Optional log messages.

Important Note
When your UI loads off screen, click the "U" key and it will open VAM Edit Mode. You can then navigate to the Session Plugins tab and adjust the sliders and click the Reset Screen button to fix your screen or use the Hotkey default of CTRL + R. The reason this issue occurs is something in a scene you are in altered your CAM position and when VAM exits the scene it uses that last location and spawns you in the clouds/void. Once this occurs you can use this plugin to resolve it to get back if needed. However once you get back and do what is needed, you may want to eventually restart VAM to clear the issue as it can persist until you restart VAM.

---

Physics Recovery Tab​

• Reset Physics – Recover selected characters using pose/physics tools.
• CTRL + [Key] – Hotkey physics recovery. Hold down CTRL, then tap the key.
• Person Atoms – Automatically detects Females/Males in scene.
• All Females / All Males – Apply to all matching characters.
• Reset Pose – Applies Reset Pose.
• Reset Pose Distance / Rotation – Auto-separate and rotate atoms to avoid overlaps.
• Toggle Physics – Temporarily disables and re-enables plugins to reset ragdoll state.
• Zero Velocity – Stops all Rigidbody motion (prevents flying or spinning).
• Females/Males Collision Off – Temporarily disables collision to avoid stacking.
• Collision On (All) – Manually re-enables all collisions.
• Auto Collision Enable (All) – Automatically re-enables collision after delay.
• Auto Collision Timer (0–120s) – Set collision delay.
• Physics Recovery Logs – Optional log messages.

With Plugins, collision has to be disabled and enabled programmatically as the toggle for it in VAM, does not directly turn it on and off by itself but just shows the active state. So if turned off with this plugin, it needs to be turned back on with this plugin because it runs a command to turn it off or on programmatically. You can use Auto Enable to turn collision back on for convenience but be sure to set it at enough time where you can safely then start another animation to move models to a safe location, or manually move the models. The distance and rotation sliders are designed to help with this but are not guaranteed to resolve it because each scene uses different environments and the location they spawn in after reset can be near or inside something. So you still want to manually move the models after. This is the same result if you did an actual Reset Pose except it allows you to automate it. Depending on how long you wait to try to recover or let the collision happen, after you do your recovery and fix what is needed or do an emergency save, it's recommended to restart VAM if working on an important scene, as serious collision issues can persist in VAM or be more likely to happen again once they happen. CTRL + X is used as the default hokey and can be changed. Please note CTRL + P is a common print command. It's recommended to not use CTRL + P.

---

Auto Save Tab​

• Save Prefix – Label your scene files (e.g., “MyProject 05-02-2025 01:17 pm.json”)
• Enable Auto Save – Turns on automatic timed saves.
• Include Screenshot – Save with thumbnail.
• AutoSave Interval – Set in minutes (1–60).
• Edit Mode Active – Only saves in Edit Mode to reduce performance hit.
• Freeze Motion/Sound Checked – Save only when motion is frozen.
• Manual Save Now – Save on demand.
• Select Save Folder – Choose output path.
• Save Path Display – Shows the current save folder.
• CTRL + [Key] – Manual save hotkey. Hold down CTRL, then tap the key.
• Enable Auto Save With Hotkey – Start autosaving via hotkey.
• Auto Save Logs – Optional log messages.

Important Note
The purpose of this is for backup save recovery. It is still recommended to do manual saves for important progress in VAM like normal.

---