Plugins + Scripts CircleLooks

CircleLooks is a lightweight utility plugin for Virt-A-Mate designed to organize your .vap appearance presets into folder-based collections (Looksets) and cycle through them on any Person atom in a scene—without breaking poses, animations, timelines, or scene triggers.

Key Features​

• Folder-Based Looksets: Automatically scans top-level subfolders inside Custom/Atom/Person/Appearance/ and groups presets into clean collections with preset counters.
• Scene-Safe Switching: Applies presets natively through AppearancePresets (LoadPresetWithPath), leaving scene logic, IK targets, and animations untouched.
• Gallery-Style Navigation: Smoothly step forward and backward through your looks with zero step-skipping when changing direction.
• Visual Target Highlight: Briefly blinks the selected character in the 3D view so you can immediately see which Person atom is targeted in multi-character scenes.
• 3D HUD Overlay: Displays clean, auto-fading status notifications directly in your view (works in both Desktop and VR).
• Hotkeys & VaM Triggers: Full support for rebindable keyboard shortcuts and native VaM trigger actions.

How to Organize Your Looks​

Create subfolders inside Custom/Atom/Person/Appearance/ and place your saved .vap appearance presets inside them:

Code:

Custom/Atom/Person/Appearance/
  ├── Casual/
  │     ├── Preset_Anna.vap
  │     └── Preset_Kate.vap
  └── SciFi/
        └── Preset_Nova.vap

Note: Make sure to save your presets from the Appearance Presets tab rather than full Atom Presets.

Installation & Setup​

Option 1: Session Plugin (Recommended)

1. Place the .var file into your AddonPackages folder.
2. Open Main Menu → Session Plugins and click Add Plugin.
3. Select the CircleLooks .var package and load CircleLooks.cslist.
4. Click Save As Default in the Session Plugins tab so the plugin automatically loads into every scene you open.

Option 2: Scene / Atom Plugin

1. Open Scene Plugins (or the Plugins tab on any atom) and click Add Plugin.
2. Select CircleLooks.cslist from the package.
3. Pick an Active Lookset and a Target Person from the dropdowns, then start cycling!

Hotkeys & Trigger Actions​

All hotkeys can be customized or disabled (None) in the plugin UI, and are automatically ignored while typing in text fields:

• Next Look — Default Key: L — Trigger Action: NextLook
• Prev Look — Default Key: K — Trigger Action: PrevLook
• Cycle Lookset — Default Key: O — Trigger Action: CycleLookset
• Cycle Person — Default Key: P — Trigger Action: CyclePersons

Credits & License​

• Created by: GRomVAM (GitHub Repository)
• Special Thanks: atani for valuable advice and helpful recommendations!
• License: Distributed under the Creative Commons Attribution-ShareAlike (CC BY-SA) license.