Bone Visualizer
Blender-style, in-viewport bone editing for HS2 Studio.
Version
1.7.0
Access
Pro
Category
Rigging
Hotkey
V
GUID com.zolteq.bonevisualizer
Overview
Bone Visualizer is an in-viewport bone editor for Honey Select 2 Studio that lets you grab, rotate, and scale any character or item bone directly in the scene using Blender-style G/R/S controls. Clickable markers sit on every weighted bone, and a live color heatmap shows exactly which part of the mesh each bone moves. Region filters let you focus on the face, body, hair, individual clothing slots, accessories, or your own curated favorites, and clothing bones are edited on an isolated shadow skeleton so you can reshape a garment without deforming the body underneath. Edits persist with the Studio scene and support undo/redo, mirror editing, multi-bone and chain selection, and an optional hand-off into HSPE.
Hotkeys
| Key | Action |
|---|---|
| V | Toggle the bone editor on the selected character or item (falls back to the first character in the scene) |
| G | Grab / move the selected bone |
| R | Rotate the selected bone |
| S | Scale the selected bone |
| X / Y / Z | Lock the current move, rotate, or scale to that axis (tap while dragging; tap again to release) |
| Left click | Confirm the in-progress transform, or select a bone marker |
| Right click / Esc | Cancel the in-progress transform and return the bone to where it started |
| Ctrl + click | Add or remove a bone from the multi-selection so a later G/R/S edits them together |
| Right click a marker | Open HSPE's advanced bone editor focused on that bone (if HSPE is installed) |
| Scroll wheel (while dragging) | Fine-tune the drag sensitivity up or down |
| Shift (bone selected) | Temporarily hide the weight heatmap so you can see the mesh clearly |
| M | Mirror-select: add the left/right counterparts of selected bones so they move in opposite directions |
| C (hold) + scroll | Grow or shrink the selection along the bone chain (up = parents, down = children; hold Shift for both at once) |
| B | Select the bone's entire chain at once (all parents plus the full child subtree) |
| Ctrl + Z | Undo the last bone edit (multi-edits and region resets undo as one step) |
| Ctrl + Y | Redo the last undone edit |
Features
- In-viewport Blender-style posingGrab, rotate, and scale any weighted bone right in the scene with G/R/S, axis locks, adjustable sensitivity, and a colored axis guide line.
- Live weight heatmapSelecting a bone paints a blue-to-red overlay on the mesh showing exactly which vertices that bone influences, and multi-selection sums the weights across every chosen bone.
- Region filteringShow or hide markers by area (favorites, head, body, hair, eight separate clothing slots, accessories, or props) so dense rigs stay readable.
- Isolated clothing deformationClothing bones are edited on a per-garment shadow skeleton, letting you reshape a shirt or bra without dragging the body or other layers along.
- Symmetry and multi-bone editingMirror-select left/right pairs that move in opposite directions, Ctrl-click to edit several bones at once, or walk the bone chain to grab whole limbs.
- Undo/redo and one-click resetsA 100-step history reverts edits atomically, with a two-click reset for a single bone and a Reset button per region.
- FavoritesStar bones you use often into a global Favorites region that applies to every character and persists across sessions.
- Prop and item bonesBind to a selected Studio item to pose the bones of skirts, hair, blankets, and other rigged props, with child bones isolated so each moves independently.
- Marker and readability optionsChoose from five marker shapes, tint edited bones and face groups distinctly, and auto-hide markers on the far side of the character.
- Scene persistence and HSPE hand-offCommitted poses save and reload with the Studio scene, and right-clicking a marker jumps into HSPE's advanced editor so edits also reach HSPE and Timeline.
Configuration
| Setting | Default | What it does |
|---|---|---|
| Marker Style | Sphere | Shape of the bone markers: Sphere (filled disc), Diamond, Ring (hollow outline), Cross (3D axis cross), or WireSphere (three line circles). |
| Sphere Size | 0.01 | World-space radius of the bone markers; increase it if they are hard to see or click. |
| UI Scale | 1.0 | Scale factor for the plugin window (0.5 to 3.0), useful on high-DPI displays. |
| Hide weight heatmap while busy | On | Temporarily hides the weight colors while you move a bone or hold Shift, so the mesh stays visible during editing. |
| Shift behavior | Hold | How Shift affects the heatmap: Hold hides it while held, Toggle flips it per press, OnTransform ignores Shift and only hides during a G/R/S drag. |
| Hide bones on far side | On | Culls markers on the side of the character facing away from the camera to reduce clutter; the selected bone always stays visible. |
| Visible cone angle | 180 | Width in degrees of the front-facing cone kept visible when far-side hiding is on; 180 is the front hemisphere, smaller hides more, 360 shows everything. |
| Colorize Edited Bones | On | Draws bones that already have a saved edit in a distinct color (bright cyan by default, and configurable) so you can spot your changes at a glance. |
| Colorize Face Bone Groups | On | Tints individual face bones by expression group (eyes, brows, nose, cheeks, mouth, teeth, tongue, jaw, ears) instead of one flat head color. |
| Expand Clothing Subcategories | Off | When on, the Regions panel breaks Clothing into its eight garment slots, each with its own toggle and Reset; when off a single master row controls them all. |
| Activation Modifier | None | Optional modifier (Shift, Ctrl, or both) required alongside G/R/S to start a transform, for avoiding clashes with other plugins. |
| Undo Modifier | Ctrl | Modifier required for the undo and redo keys; defaults to Ctrl to match the standard Ctrl-Z / Ctrl-Y convention. |
| Language | English | Display language for the plugin window; Simplified Chinese is also available and swaps in a CJK font. |
| Show Controls Reference | On | Shows the on-screen key-hint card in the window; can also be toggled with the '?' button in the title bar for a minimalist view. |
| Performance Logging | Off | Diagnostics option that logs per-frame work and FPS (with a configurable hitch threshold) to help trace frame drops; leave off unless investigating a problem. |
Requirements
- Honey Select 2 Studio (StudioNEOV2). The plugin only runs inside HS2 Studio; it does not load in the main game.
- BepInEx 5 with KKAPI (Modding API / KoikatuAPI). Hard dependency used for the Studio hooks, selection tracking, and scene save/load; the plugin will not load without it.
- HSPE / HS2PE (optional). Enables right-clicking a marker to open the advanced bone editor and lets your edits appear in HSPE and be animated via Timeline; without it the right-click hand-off is silently skipped.
- KK_PregnancyPlus (optional). When present, a built-in bridge keeps clothing belly inflation working correctly while the clothing shadow skeleton is active.
Tips
- Pressing V starts with only the Head region shown; use the Regions panel toggles or the 'Show all' button to reveal body, hair, and clothing markers.
- While dragging, tap X, Y, or Z to constrain the move to an axis and scroll the wheel to dial in finer or coarser control.
- To reshape clothing without disturbing the body, turn on the relevant Clothing slot and edit those markers; each garment layer moves on its own isolated bones.
- Right-click any marker to jump straight into HSPE's advanced editor for that exact bone.
- When editing classic FK chain bones for Timeline, disable FK in HSPE first; fingers, hair, cloth, face, and custom-rig bones are tracked without that step.