Contains executable files or external scripts. Ensure you trust the creator and apply your own security measures.
BlendMate - User Manual
1. Introduction
BlendMate is a plugin designed to bring the efficient workflow of Blender into Virt-A-Mate (VaM). It allows users to manipulate objects using standard G/R/S hotkeys, axis locking, and numeric input, bypassing the need for the traditional slow Gizmo dragging. Additionally, it features a powerful "Scene Outliner" that integrates object filtering, hierarchy management, physical state toggling (ON/OFF), and parent-child binding operations.It allows you to avoid frequent UI switching when using the timeline plugin to create animations.
2. UI Interface & Scene Outliner
The plugin interface is docked on the right side of the screen by default. Press F1 to toggle the window visibility. The interface is divided into the Top Toolbar and the Object List.2.1 Top Toolbar
| Area / Button | Description |
|---|---|
| Refresh | Refreshes the object list. Recommended after loading new atoms into the scene. |
| [ BLENDER ] / [ VAM ] | Indicates the current operation mode. Use the~(between Esc and Tab) keys to switch modes. |
| Sel: X | Displays the count of currently selected controllers. |
| Z-Up | If checked, the axis colors adapt to Blender standards (Blue for Vertical Z, Green for Forward Y). |
| Pivot | Indiv (Individual): Transformations occur around each object's own origin. Median: Transformations occur around the geometric center of all selected objects. Active: Transformations occur around the last selected object (the active element). |
| Mirror | Global: Mirrors transformations based on World coordinates. Local: Mirrors transformations based on the parent or local coordinates. Supports X, Y, and Z axis selection. |
| Filters | Atoms: Filter objects by their state (All / On / Off). Ctrls: Filter controllers by visibility (All / Visible / Hidden). |
2.2 Object List Operations
The Outliner displays a tree structure of Persons, Custom Assets, and other atoms in the scene.| Target | Interaction | Function |
|---|---|---|
| Fold/Unfold | Click Arrow (▶/▼) | Expands or collapses the hierarchy. Hold Shift and click to recursively expand/collapse all child items. |
| Selection | Click Name | Click: Select object (clears previous selection).Will not open the UI. Ctrl + Click: Add to or remove from selection. Shift + Click: Range selection. Double Click: Open the UI and select the object. |
| State Toggle | Click ON / OFF | ON: Atom enabled (Position and Rotation states are On of the Controller). OFF: Atom disabled (Position and Rotation states are Off of the Controller). Note: Supports batch toggling for multiple selected items. |
| Visibility | Click ○ / × | Toggles visibility of the atom or controller. Hold Shift and click the Root node to toggle visibility for all controllers on that Person. |
3. Blender-Style Operations (Hotkeys)
When one or more controllers are selected, you can use the following hotkeys to transform them. The logic mirrors Blender's workflow.3.1 Basic Transformations (G / R / S)
| Hotkey | Function | Details |
|---|---|---|
| ~ | Switch mode | Switch between Vam mode and Blender control mode. |
| G | Grab (Move) | Move the mouse to translate the object. |
| R | Rotate | Move the mouse to rotate the object . |
| S | Scale | Move the mouse to resize the object. |
| X / Y / Z | Axis Lock | Press G then X to move only along the X-axis. Press the same key twice (e.g., X then X) to switch between Global and Local orientation. |
| Key | Function | Example |
|---|---|---|
| Left Click / Enter | Confirm | Apply the current transformation. |
| Right Click / Esc | Cancel | Cancel the current transformation and revert to the original state. |
| Number Keys | Numeric Input | Type numbers directly (supports negatives and decimals). Example: Press R -> Z -> 90 -> Enter to rotate 90 degrees on the Z-axis. |
There are 4 different ways to confirm the operation.
| Basic Operations | |
| Convenient to confirm after inputting numerical values | |
| Press the same operation key again（R→R、G→G） | Quick confirmation to avoid clicking | |
| Press another operation key（R→S→G→R……） | You can confirm the operation and proceed directly to the next operation, as long as you keep pressing different operation keys, you can play a continuous combo. |
3.3 Multi-Selection & Scaling Logic
When multiple objects are selected, the Pivot mode determines how the Scale (S) operation behaves:- Scaling in Median / Active Mode:
- Effect: Converge or Diverge.
- Explanation: Objects will move closer together or further apart based on the pivot point. The size of the objects themselves will not change. This is used for adjusting spacing or formation.
- Scaling in Individual Mode:
- Effect: Resize Objects.
- Explanation: Each selected object will resize in place around its own origin.
4. Advanced Features: Parenting
The plugin provides a quick way to manage hierarchy constraints (LinkTo) without navigating through the VaM properties panel.| Hotkey | Function | Procedure & Logic |
|---|---|---|
| Ctrl + P | Set Parent | 1. Select one or more Child objects. 2. Hold Ctrl/Shift and select the Parent object last (the Active object). 3. Press Ctrl + P. Result: Children are linked to the Parent, and their state switches to ParentLink (they will follow the parent). |
| Alt + P | Clear Parent | 1. Select any number of bound objects. 2. Press Alt + P. Result: The link is broken (LinkTo set to null), and the state restores to ON (Free Control). |
Requirements
Virt-A-Mate (v1.20 or newer recommended)
BepInEx 5.x (x64) installed in your VaM folder.
Installation
Ensure you have BepInEx installed. (If you see a BepInEx folder in your VaM root directory, you are good to go).
Copy the NativeGCPatcher.dll file into: .../Virt-A-Mate/BepInEx/plugins/
Start the game. You should see a status overlay in the top-left corner.
5. FAQ
- Q: Why does nothing happen when I press G?
- A: Please ensure you are not currently typing in a text field (like a search bar). Hotkeys are disabled when typing to prevent accidental triggers.
- Q: How do I delete objects?
- A: Select the object and press the Delete key. The plugin includes a safety check to ensure you are not editing text before deleting.
- Q: How does Undo work?
- A: Standard Ctrl + Z (Undo) and Ctrl + Shift + Z (Redo) are supported for all move, and rotate.(does not support other complex operations)
Contains executable files or external scripts. Ensure you trust the creator and apply your own security measures.
