Plugins + Scripts SexyFluids

Introduction​

This package introduces the fluid module from DildoLanguage as a standalone plugin.

The initial release can be used on person atoms of any kind. It will enable different fluid emitters based on the person type.

At technical level, it consists of:

• Fully custom fluid renderer
• Procedural cumstain generator
• Specialized fluid particle emitters

Usage​

Add the SexyFluids plugin to a person atom. It will automatically adjust itself based on the person type, even if you later switch the skin, preset or add or remove the AltFuta plugin.

This version supports these atom types:

• Female person atoms
• Male person atoms
• Legacy futa person atoms, which are really no different from males
• AltFuta person atoms, females with Stopper's Alternative Futa plugin attached

Depending on the atom type, the following fluid emitters will be enabled in the plugin's options:

• Males, legacy futas, alt-futas: Penis, Left Nipple, Right Nipple
• Females: Squirt, Left Nipple, Right Nipple

Squirt is intentionally disabled for AltFutas, since it makes little sense logically ; assuming futas with vaginas make sense at all to begin with. Also the location where the emitter would be positioned is usually blocked by the ballsack anyway. But I could trivially allow it if there is any demand.

And yes, if you want to milk your males, you are free to do so . The nipple emitters are enabled for males because they are really no different from legacy futas, and you probably want to have the nipple emitters available there. But be aware that the positions of the nipple emitters might be less precise compared to females, and not adjust correctly with breast morphs, since male person atoms lack some rigid bodies and colliders in that area. Position and orientation of each emitter can be tweaked to better match your specific person's morphs in the plugin's options.

Presets​

The top tab bar in the plugin's options can be used to select the emitter. Each emitter has its own settings and presets, but the available settings are almost identical. The Penis settings will be used as an example in this documentation.

Just below the emitter selection bar is the Preset UI. If you ever used DildoLanguage before, you will be already familiar with this.

• Each emitter supports up to 10 preset slots, which can be switched at any time, either in the UI or through triggers.
• When a preset slot is changed, the fluid parameters will smoothly transition to the new setup ; use the Preset Change Duration slider to change the speed of the transition.
• All other settings affect the currently selected preset.
• Click Load Preset to load a previously saved preset into the current slot.
• The plugin comes with several preconfigured presets for all emitters. Check those out first, they should make it easier to understand all the settings.
• The presets are compatible between different emitters, and even between SexyFluids and DildoLanguage. So if you want to load a cum preset onto the nipple emitter, nothing will break, just the forces configured in the preset will be ignored.
• You can Copy/Paste the presets. The system clipboard is used, so you can copy-paste presets not just between different slots of one emitter, but also between different emitters, different atoms, or even between DildoLangauge and SexyFluids.
• A preset can be reset to defaults relevant for current emitter type. Doing so will first copy the preset into the clipboard, so you can always paste it back.
• This area also offers few buttons that can be used to test the current preset. They correspond to trigger actions documented below.

Orgasm and Bursts - How does it all work?​

Each preset configures not just visuals, but also the behavior of the selected emitter. This section briefly describes the "behavior" aspect, which is configured mostly on the first tab (called Orgasm for the penis emitter).

Burst Sequence

When you click Test Orgasm, or run the "penis:start" action from a trigger, a "burst sequence" is started. This consists of several fluid particle bursts and pauses inbetween them, all randomized within the configured parameters. The sequence ends when the bursts consume the configured "load":

• Each burst takes Burst Length seconds, on average
• The pause between consecutive bursts is Pause Length seconds, on average
• Each burst reduces the emitter's Load by its duration
• Bursts get shorter as the load decreases
• Once the load drops to zero, the sequence ends

Particle Types

Each burst emits two kinds of particles from the source: Stream and Spray. These two kinds of particles differ in looks and behavior:

• When Stream particles collide with another atom, they immediately disappear and the collision contact point is then used to procedurally generate cumstains on the target.
• When Spray particles collide, they bounce/slide off according to their Bounce and Dampen settings.
• The looks of each particle type depend on the exact settings. But the Stream particles offer one special feature - Join Particles by a curve. This is configured on the Burst Shape tab. Stream particles that stay within the configured distance will not be rendered as individual fluid particles, instead a curve will be drawn connecting the particle positions. This is mostly used for the cum presets. Set the value to 0 to disable this special rendering mode.
• In general, the Stream particles will use smaller Spread Angle. Especially if the Join Particles feature is used, larger Spread Angle results in unnatural zig-zagging curve connecting them.

Cumstains

When Stream particles collide with anything, the contact points are recorded and then later processed to generate procedural cumstains.

This processing happens usually once per burst, but will be done more often if a burst has longer duration. Since the processing if quite CPU intensive, it's performed on a background thread and the cumstains appear only once it's done. The algorithm evaluates all contacts in certain order, groups them into "streaks", then renders a curve connecting contacts in each streak. This is repeated up to Generator Loop times. Set this value to zero to completely disable the cumstain feature for a preset.

Cumstains on person atoms are handled in a more advanced way:

• The contact points are adjusted to the nearest point on the character skin. On other objects, the collision points are used as is.
• The generated curves are also snapped to the skin.
• During character movement, the stains are animated using a special compute shader (also known as a cumpute shader, har har) and stay attached to the skin, even as it bends or if any morphs are applied to it. On other objects, the cumstains stay attached to the colliders.

Settings​

This section briefly describes settings available in each tab for the selected emitter.

Orgasm​

The first tab is used mostly to configure the emitter's behavior. Its name differs depending on the emitter, Orgasm is used for the penis.

• Load, Burst Length and Pause Length control the burst sequence, as described above.
• Randomness: Tweaks how much the actual values can differ from the configured ones. Set it to 0 for no randomness at all.
• Burst Velocity: Sets the speed of the emitted fluid particles.
• Particle Rate: Tweaks how many fluid particles are generated. Performance will suffer if set too high!
• Forces:
  Some emitters apply forces to the person atom on each burst. The Tip Force is an upwards force applied to the penis tip. The Pelvis Force is a forwards force applied to the pelvis (approximately) during penis or squirt orgasm.
  Even if you use the bundled presets, you might have to tweak these forces so they work correctly for your person atom's setup. Their behavior can change a lot depending on the pose and the spring forces configured for the joints. Or set them to zero if you prefer to animate the whole thing in timeline, or use other force system for the orgasm animation.
• Decay:
  Some values decay over time during each burst. They will start at the configured value when the burst starts, and decay to given fraction of the value at the end of the burst. So a Decay slider set to 1 means that the corresponding value will NOT decay at all. Decay slider set to 0 means that the value will smoothly decay to 0% at the end of each burst.

Burst Shape

This tab configures overall shape and position of the emitters.

• Spray-Stream Ratio: When set to 0, only Spray particles will be generated. When set to 1, only Stream particles will be emitted. Value around 0.2 usually makes the most sense, especially when Join Particles mode is enabled for the Stream particles - you don't want too many Stream particles generated to make the curve look more natural.
• Join Stream Particles: If consecutively emitted Stream particles are within this distance, they will be joined by a curve instead of rendering them individually.
• Spread Angle: The width of the cone angle in which the Stream and Spray particles are randomly generated.
• Offset and Rotation: Tweak the exact position and orientation of the fluid emitters. While on this tab, orientation axes are drawn, with the blue line pointing forwards.

Spray Visual​

This tab configures the visualization parameters of the Spray particles.

The first part controls the particle lifetime and shape:

• Life Time: Each emitted Spray particle will exist for this amount of time, in seconds (randomly within the range)
• Collision Bounce and Dampen: How the particles behave on collisions. Dampen below 1 slows them down on each collision, Bounce reduces the bounce angle.
• Particle Stretch and Slimming: Spray fluid particles are drawn as stretched ovals (approximately, there is a lot of magical processing afterwards happening as well). Constant Stretch elongates them in the direction of travel ; set it to 1 for no stretch, and below 1 to actually shorten them instead. Velocity Stretch does the same, but based on the particle's speed ; set it to 0 for no effect. Slimming larger than 0 reduces the particle's width as the speed increases.

The second part controls the particle visuals. Many of the values change over the life time, starting with the value in the left column when the fluid particle is emitted, and transitioning to the value in the right column just before it dies. Many of these properties are self-explanatory, here are some of the more important/tricky ones:

• Thickness: Controls the overall visibility of the particle, almost like a texture alpha would on a traditional alpha-blended material. If there are multiple fluid particles overlapping on the screen, the overall thickness of the fluid effect is accumulated.
• Color: Rather obvious, but this is also one of the properties that accumulates if particles overlap on the screen, weighted by thickness, effectively mixing fluid colors. Of course real fluids mix in a very complex manner depending on their physical and chemical properties, this is just a very simplified approximation of colored water-like fluids.
• Reflectivness: How much of the VAM's Global Illum cubemap is reflected. The cubemap is the one configured in the VAM's global Scene Lighting settings.
• Shininess: Larger values will make the specular highlights more localized, which is usually what you want to happen for fluid-like materials.
• Refraction Strength: Controls the effect of the screen-space refraction. Set to 0 for no refraction.
• Transmission: How much of light is refracted and transmitted through the fluid, vs the diffuse and specular color.
• Fresnel: Controls how the material transitions between reflected and diffuse/transmitted properties based on the normal-vs-viewing angle.

Stream Visual​

Very similar to the Spray Visual. The only major visual differences are:

• Different rendering mode is used if Join Particles is enabled on the Burst Shape tab, as described above.
• Instead of a stretched oval, the individual particles are rendered as drop-like shapes, or capsules if the Particle Capsule Drop Shape is set to 0.
• If rendered as a curve joining the particles, the drop shape slider controls how much the curve narrows from front to back.

Cumstains​

This is also split into two sections. The first one controls how the stains are generated.

• Generator Loops: Already mentioned in the cumstain overview, this controls how many times the algorithm can process the Stream particle contacts to produce the stains. Higher values can lead to more stains being generated if previous passes did not group all contacts together, but it you could also end up with a mess of weirdly overlapped stains.
• The cumstain life time can be set separately for stains on person atoms and for other types of objects.
• Each cumstain streak is generated from segments of the configured Segment Length. Smaller segments mean smoother curves, but worse performance. If the visual size is larger, it usually also makes sense to use longer segments.
• The stains are thicker at the front, and narrow and fade out towards the tail, controlled by Cumstain End Narrow and Cumstain End Fade.
• Edge Thickness Factor: Controls how smooth or sharp the stains are, side-to-side.

The second part configures the visuals, and is pretty much identical to Spray/Stream. The only major different is that cumstains interpolate more material properties during their lifetime than Spray and Stream particles.

Secondary Bursts

By default, only one burst is generated in the emitter's forward direction (blue line when configuring the Burst Shape). Optionally, additional bursts can be emitted in randomized directions, according to the settings here:

• Spread Angle: Cone angle in which the additional bursts are generated.
• Minimal/Maximal Amount: Number of additional burst to generate. Set both to 0 to disable this feature.
• Length Ratio: Length of the secondary bursts, relative to the main burst. If less than 1, each secondary burst will be shorter, and might start a bit later than the main burst.
• Speed Ratio: Optionally the secondary bursts can be emitted at lower speeds.

Secondary Burst Randomization:
The amount, angle, length and speed of secondary bursts is randomized within the specified value ranges. By default, each burst uses different random numbers. This can be tweaked:

• If only the Reseed on each Burst toggle is turned off, all bursts within the sequence will use the same randomization.
• If both Reseed toggles are turned off, all bursts will use the same randomization and it will never change. The randomization can be tweaked by the Random Seed slider in this case.

The "monster" presets, as well as the Milk Multi Burst and the Fountain presets, utilize this feature.

Drip

In addition to bursts emitted at given speed in forward direction(s), some fluid particles can drip from the source at no speed, falling directly down.

• Buildup Ratio: Controls how much of the emitted particles are added to the virtual "drip storage".
• Emit Rate: Controls how fast the "drip storage" is emptied, producing the drip particles.

Both of these values are relative to the Particle Rate from the first tab. If the Buildup Ratio is zero, no drip particles will be generated. The drip particles use the Spray visuals, further tweaked by the sliders at the bottom of this tab.

The drip emitter uses its own Back/Forward position slider, separate from the slider used for the Spray/Stream emitters. Other position and orientation sliders are shared.

For a bit more natural effect, the drip emit rate is slightly randomized and can emit short higher-rate sequences if the rate is very low. This can be seen in the Squirt Drip Only preset.

Advanced​

The Advanced tab can be used to configure more technical aspects of the fluid emitter and renderer. But sometimes it might still make sense to tweak some of them:

• Simulation Speed and Gravity Multiplier: While setting both to 1 is the "realistic" option, by the default the simulation speed is running at half of that, which produces more pleasing visuals. Some of the presets change these, for example the milk settings use higher simulation speeds but lower gravity.
• Cumstain Processing timers: It's recommended to leave these unchanged, but they can be tweaked to change how soon after collecting the first collision will the cumstain generator be triggered. Shortening the values leads to cumstains appearing sooner after each collision, but can also break the stains into shorter streaks.
• Rendering Depth Offset: Higher values render the cumstains as if they were closer to camera than they really are. This might produce unwanted visual artifacts. But one use case might be if you use skin-tight but still somewhat thick clothes on your character. Since the cumstains stick to the skin, they might end up being hidden under the clothes, but increasing this value could be used to make them still visible as if they were stuck to the clothes instead.
• Cumstain/Compute toggles: Probably no need to ever disable them. This will revert the current compute-based rendering of cumstains sticking to skin to older an version that either run fully on CPU (slower), or stick to colliders instead of skin (can be ugly in motion).

The bottom section is super-technical and controls the fluid renderer. It safe to ignore it. But for the nerds:
By default if there are multiple instances of SexyFluids and DildoLanguage plugins in the scene, they will communicate with each other and elect one plugin instance as the "fluid compositor". This greatly improves the performance; instead of each plugin rendering the full fluid effect on its own, they will all render into the same set of textures and then process them only once. This can be either disabled for some plugin instances (turn off Share Compositor), or one of the plugins can be forced to be the compositor (turn on Always Make... but NEVER do this for more than one fluid renderer in the scene). Forcing one of the plugins to be the compositor can be useful to tweak the compositor's parameters, such as the Debugging Layer View.

Storables and Actions​

Each active emitter can be controlled from triggers. The provided storables and actions are the same for each emitter and differ in their prefix which is one of "penis:", "squirt:", "lnipple:", or "rnipple:". The storables and actions are the same as the "fluids:" ones for DildoLanguage.

• penis: Preset: Changes the current preset. Same as changing it in the UI dropdown.
• penis: presetChangeTime: Changes how long it takes to interpolate between presets. Same as changing the slider in the UI.
• penis:start: Starts the preconfigured burst sequence.
• penis:startEndless: Same as above, but does not consume any "load", effectively bursting until stopped.
• penis:burst: Starts a single burst of specified length. This is a float storable, with the value being the burst duration.
• penis:stop: Stops the burst sequence.
• penis:clean: Removes all stains generated by this emitter
• Overrides: Several storables can be set to override the next start/startEndless/burstaction. These values reset back to default after the next action is started, or after several frames:
  • penis:loadOverride: Changes the load used by next penis:start (not relevant for penis:startEndless or penis:burst).
  • penis:speedMultiplier: Can be used to tweak the speed of emitted fluids for the next burst sequence.
  • penis:forceMultiplier: Can be used to tweak the forces applied to penis/pelvis during the next burst sequence.

BodyLanguage Integration​

Here are some tips on using SexyFluids together with BodyLanguage:

Male Orgasm​

Add the SexyFluids plugin to the male atom and load/configure your preferred preset on the penis.

Then go to the female's FillMeUp settings, the Males/AltFuta tab:

• On the Info & Triggers sub-tab, configure the On Orgasm trigger, and set it to target the Male atom, the SexyFluids plugin, and the "penis:start" target.
• On the Settings sub-tab, disable the Particles Enabled (M/F) option, to turn off the simple particles built into BL. Turn off or leave on cum clothes depending on your preferences.
• As far as I know, there is no way to turn off BL's forces applied to the male during orgasm. So I'd recommend setting the forces in the SexyFluid's settings to zero. Unfortunately there is no way to synchronize the SexyFluid's bursts to the BodyLanguage's forces. Maybe one day BL will support SexyFluids more directly.

Squirt​

To make the female squirt on each orgasm, add the SexyFluids plugin to the female atom and then in her FillMeUp settings, on the Orgasm tab, edit the On Orgasm Start trigger. Set it to target the female atom, the SexyFluids plugin, and the "squirt:start" target.
If you want a more complex logic, such as squirting only after certain amount of consecutive orgasms, you could use the Orgasm Count Triggers or Multi Orgasm Triggers. There I'd recommend hooking the On Value Changed trigger through few logic bricks. But it can be pretty tricky to set up, so I might build a direct support for this kind of logic directly into SexyFluids in future updates.

PoseMe

Sometimes it might make sense to use slightly different settings for different poses. Especially the rotation parameters on the Burst Shape tab, or the fluid emission Burst Velocity. To do so:

• Create multiple presets for different poses. You can just copy/paste your main preset and then tweak some of the settings.
• In the PoseMe plugin, edit the On Pose Enter actions.
• Select the SexyFluids plugin of the relevant atom as the receiver, and use the "penis: Preset" target (or whatever emitter's preset you want to change).
• If you do this, it might make sense to set the Preset Change Duration to a low value, or even zero. Especially if you want to also force an orgasm when the pose is activated.

FAQ​

Q: What does the "f1" in the version mean?
A: This is the "fluids module compatibility version". If you use DildoLanguage and SexyFluids in the same scene, both should have the same f-number, or they won't be able to cooperate correctly.