Repository navigation
Releases
v3.0.0: Soft Body Suite 3
A big new version of the suite: a fourth physics stage, much better clothes, two overall jiggle sliders, and a lot of speed.
New
- A fourth stage, Field, runs after Squish on its own remeshed cage: contact-driven flesh with the effect families Squish, Squish & Inflate, Ripple, Fat Jiggle, Penetration and Squish Organic. Switch it on with the Field · Master tick; each region then has its own Field Mix (0 = off), so you can blend it in as much as you like.
- Every painted region (breasts, thighs, ...) now has its own solver, cage, settings and motion, so adding a second region no longer changes how the first one behaves.
- Ripples can start from the outermost point, the touch point, automatically found nipples, or points you click on the body. The body's own movement can set them off too, with nothing touching it.
- New contact shaping controls: Splay, Ring and Lift.
- Clothes stay on better. A skin guard pass at the very end lifts cloth out of the body you actually see, with a "fix cloth sunk in skin" slider for clipping that is baked into the model. Floating accessories such as bows move as one piece, and leg straps follow a thigh region even when they are rigged to differently named leg bones.
- Region presets: save one region's settings and apply them to another, or copy everything from another region. There is also a Normalize weights button for paint picked from bones.
- A new Overall jiggle section at the top of the window has Jiggle strength (how big all the jiggle is, same timing) and Jiggle settle time (how quickly it calms down after a movement). 100% is exactly your tuned look.
- Paint edits now rebuild every stage, not just Squish.
Faster
Most heavy loops now run on all CPU cores through a set of always-ready helper threads, a lot of work whose result was never used is gone, and the Jell-o physics runs at the same time as the clothes are prepared. With Wobble, Jell-o and five garments following the body, a dance went from about 45 fps to a steady 60 fps (VNyan's cap) with the same look.
Upgrading from the classic suite
- The installer moves the classic Soft Body Suite (v2) and the old v1 Squish / Wobble / Jello Studio plugins into
RetiredPlugins(moved, never deleted). Two soft-body plugins running at once would move the same body twice. - On first start, Soft Body Suite 3 brings your classic settings and presets over by itself.
softbodysuite.jsonis only read, never changed; the new settings live insoftfleshfield.json. - Prefer the classic suite? Install v2.0.1 Final classic edition instead.
Install
- Download
VNyan-SoftBody-Suite-v3.0.0.zipand unzip it. - Close VNyan and run
install.bat. It looks for your VNyan folder by itself, or asks you to open it (the folder withVNyan.exeinside). Admin rights are asked for only if that folder is write-protected. - Start VNyan, open Soft Body Suite from the plugins menu and tick On.
The plugin files go to <your VNyan folder>\Items\Assemblies\SoftFleshField\. Guides: Install, Usage, FAQ.
v2.0.1: Final classic edition
The last release of the classic Soft Body Suite: Wobble, Jell-o, Squish and clothes follow in one plugin, exactly as in v2.0.1.
This is the same build as v2.0.1 (the files are byte-for-byte identical), published once more under this name so the classic suite stays easy to find.
What comes next
From v3.0.0 on, the suite continues as Soft Body Suite 3, a new plugin with a fourth stage, one physics solver per painted region, a skin guard for clothes, overall jiggle sliders and much better performance.
The Soft Body Suite 3 installer moves this classic plugin into RetiredPlugins (moved, never deleted), because both running at once would move the same body twice. If you prefer the classic suite, install this release instead.
Install
- Download
VNyan-SoftBody-Suite-v2.0.1-final-classic.zipand unzip it. - Close VNyan and run
install.bat. It looks for your VNyan folder by itself, or asks you to open it (the folder withVNyan.exeinside). - Start VNyan, open Soft Body Suite from the plugins menu and tick On.
Your settings stay in softbodysuite.json. Soft Body Suite 3 only reads that file once, to bring your setup over, and never changes it.
v2.0.1: the remesh cage was built with no colliders
A one-bug hotfix. If you use the Jell-o stage with Use remesh cage on (the default), its collision was doing nothing.
What was wrong
The remesh cage builds a synthetic region by cloning the first painted region through JSON. StageRegion.colliders is [JsonIgnore], because the region's Sync() wires it as a reference to the painted region's own list rather than duplicating it for each stage, so it deliberately does not serialise.
The clone therefore came back with an empty collider list. The merge step after it only adds colliders from other regions, skipping the source on the assumption the clone already carried them. So with a single painted region, or with the colliders sitting on the first enabled one, the cage sim ended up with no colliders at all, and nothing pushed the flesh.
Nothing else was affected: per-region sims (remesh cage off) always had their colliders, and Wobble, Squish and Clothes are untouched.
What changed
- The cage's region now takes a deep copy of the source region's colliders.
- The
remesh cage LIVElog line now reports the collider count, so an empty collider list is easy to spot.
With the fix, the cage sim gets the same colliders as the painted region it was built from.
Upgrading
Unzip and run install.bat (or install.ps1) exactly as before. Your settings, regions and presets are untouched: this release changes no config format and no defaults.
Full changelog: v2.0.0...v2.0.1
v2.0.0: Soft Body Suite, one plugin
Soft Body Suite v2.0.0: one plugin
Wobble, Jell-o and Squish Studio are now one plugin with one window. The stages hand their result to each other in the same frame, and your clothes are fitted once, at the very end, to the body you actually see.
What's new
- One window with Mesh & Region, Weight painting, Colliders, Wobble, Jell-o, Squish, Clothes, Performance and Presets. Click a title to fold a section open or shut; the four stage sections have their own on/off tick.
- Clothes stay on: garments ride exactly the same movement as the body, and take their resting fit from the body without the wobble swing, so turning stages on and off mid-motion no longer bakes a clip in.
- One preset now holds every stage. Auto-load it by the model's file name, or by any text the model name includes. Two small windows let you rename/load/delete presets and edit/switch/delete auto-load rules.
- Substeps, half-rate, smooth blend and async physics can be set for each stage.
- The log is quieter: the Wobble diagnostics line only prints while F10 is on.
Installer
- Looks for VNyan by itself (an open VNyan, VNyan's own log, Steam, the itch app) and asks you to confirm.
- If it can't find it, or you say no, it asks you to open your VNyan folder (the one with
VNyan.exeinside). VNyan has no installer of its own, so it can live anywhere. - Moves the old Squish / Wobble / Jello Studio folders to
RetiredPlugins(moved, never deleted). - Only asks for admin rights if your VNyan folder is write-protected.
Upgrading from v1
- Run
install.batand say yes to moving the old studios. VNyan loads every folder inItems\Assemblies, so leaving them would move the body twice. - Your regions, colliders and slider values are brought over automatically the first time the suite starts (see
softbodysuite.migration.log). The old settings files aren't touched. - Presets saved in the old Jello Studio aren't carried over, so save them again in the suite.
- SoftBody Studio isn't part of the suite. It's still available in v1.2.0; its source is in
legacy/.
Install
Download VNyan-SoftBody-Suite-v2.0.0.zip, unzip it, close VNyan and double-click install.bat. Manual steps are in INSTALL.md.
v1.2.0: Region Copy to Other Meshes
Region Copy to Other Meshes
Clothing and accessory meshes covering the same body part can now inherit your painted regions in one click. In Squish Studio, open Apply to other meshes and pick a method:
- "Auto: same bones as the painted area" (new, default) reads which bones actually skin your painted vertices (full multi-influence skin data) and selects the matching vertices on each target mesh. A weight-share stepper sets how dominant a bone must be to count.
- "By bone group" reuses your last manual bone-group pick.
- "By surface transfer" projects the painted area through space onto each target, now with an adjustable projection radius (was fixed at 3 cm).
- "Copy ALL regions of this mesh" copies every region in one click (Auto / surface methods).
Copies carry all sim parameters and colliders. A successful apply auto-saves, so Wobble Studio and Jello Studio mirror the new regions within ~2 s, including a background rebuild of the remeshed sim cage. (A mesh that is brand-new to Wobble/Jello arrives there disabled; enable it once and it stays in sync.)
Improvements & fixes
- The vertex-group picker is now a scrollable list showing every skinned bone (previously capped at 24), and it keeps your scroll position while ticking boxes.
- Copied regions now include the dent-limit / evacuation settings and mesh-collider fields (previously dropped).
- Existing paint on a target is only overwritten when the transfer actually found vertices there, every overwrite is undoable (Ctrl+Z), and failed applies no longer create do-nothing mesh entries.
- Surface transfer samples the rest pose on both sides, so live jiggle no longer shifts the projection.
- The apply panel is hardened against switching mesh/region while it is open.
Install
Download VNyan-SoftBody-Suite-v1.2.0-all.zip, extract, and run install.bat. It lets you pick your VNyan folder and only asks for elevation when the folder needs it. Or copy each studio folder into Items\Assemblies inside your VNyan folder. Full docs in docs/.
VNyan SoftBody Suite v1.1.0: One-Click Installer
v1.1.0: One-Click Installer
New: install.bat. Unzip anywhere and double-click it:
- Looks for your VNyan folder, and if it can't find it, opens a folder picker so you can choose it (portable and itch.io installs included)
- Requests admin rights only if your VNyan folder is actually write-protected, so portable and user-folder installs never see a UAC prompt
- Verifies the folder looks like VNyan, warns if VNyan is running, and installs all four studios in one go
Plugin binaries are unchanged from v1.0.0. Docs updated: Install Guide now covers both installer and manual paths, and the FAQ answers the custom-location and UAC questions.
VNyan SoftBody Suite v1.0.0
VNyan SoftBody Suite v1.0.0
First public release: mesh-level soft-body, jiggle and collision-squish physics for VNyan avatars.
Grab the all-in-one zip, or individual studios. Copy each studio folder into Items\Assemblies\ inside your VNyan folder (details in the Install Guide).
Included
- Squish Studio: collision squish, depth-field marshmallow dents, bone + blob evacuation (incl. nested-bone mode), region painting, auto capsule colliders, contact sleep-gating, async worker-thread physics
- Jello Studio: XPBD soft body on an auto-remeshed proxy cage, valley-gated projection, seam smoothing with ramp limiting, live tuning sliders
- Wobble Studio: jiggle/waves/jell-o (with randomizer)/cloth/liquid/sway/pulse modes
- SoftBody Studio: attached-mode XPBD variant (experimental)
- Half-rate and half-rate + smooth-blend performance modes in all studios
See the Usage Guide and FAQ.