Sexout Spunk 1.01.08 (20190112)

 

 

What it is

 

Sexout Spunk is in essence a data communication mod. It was meant as a detailed and flexible system of determining who orgasms, and what happens with the cum. It generates a bunch of data when an actor orgasms - gender, race, species, location where the ejaculate ends up, volume, time of ejaculation etc - and then tracks and recalculates that. Over time, some other systems were added to it, although they are all modular so you can pick and choose. Let's go over all of them:

 

1. Lust tracking

 

Lust is conceptualized as a primary need. A long-term need that becomes an itch that needs scratching. This is made a bit more real for you with buffs and debuffs.

 

In spunk, it goes from 0 to 100. Spunk can visualize this on screen with its own HUD or with the patches that work with oHUD and IMCNNV.

 

As soon as lust tracking is on (default), the player is tracked. In order to add an NPC to the system, you get them under your crosshair and press the hotkey you select in the MCM submenu. Do it again to remove the NPC.

 

Lust is reduced by sexual acts, if the actor can be expected to be able to orgasm from it.

 

Actors who get raped will be set to a negative value which will only be restored back to 0 over time, taking into account a setting you select for that.

 

Drugs, alcohol and drug withdrawal can all have an impact on lust increase rate. Some will boost it, others will slow it down. SleepEZ and LustOh from SODrugs affect lust increase rate as well.

 

Lust increase can be affected by the Frigid and Horndog perks, by 5% per rank. The Nymphomaniac perk also boosts lust increase, as well as arousal increase by 5%. The masochist perk makes you hornier and easier to please when wounded.

 

2. Arousal and orgasm

 

During a sex act, an 'arousal' variable will be calculated for each actor in it. When it exceeds the value of 100, this is taken to be an orgasm, kicking into gear the other functionalities below like cum tracking etc.

 

Arousal is affected by
- the lust value the actor had at the time,
- a gender-specific value you can set in MCM,
- the experience they and their partners have for their roles in the act if the XP system is used,
- the personal preference they have for their roles in the act if the enjoyment system is used,
- lingering rape penalties (see lust tracking)
- the timing of the act compared to Sexout's default time

 

It is possible, then, for an actor not to receive an orgasm when the act is terminated, and this can lead to a lowering of enjoyment for the roles performed in the act, starting a vicious circle! To combat that, when the player is involved in an act, you can try holding down the 'run' control key to speed up your own arousal increase, or the 'crouch' control to slow it down. A HUD readout should give you some indication of how you're doing.

 

If an actor can't orgasm from an act, eg performing oral, their arousal will be capped.

 

Turning arousal on can affect the duration of the act: if both actors have orgasmed and the current timing's within the window you've set in MCM there's a good chance the act will stop early. Conversely, if an actor is 'nearly there', the act may be prolonged until orgasm.

 

The Insatiable perk makes it more likely for you to continue after orgasm.

 

3. Cum tracking

 

Cum tracking is as explained above, a background core system that the others rely on. It really is only a virtual representation of what happens when people orgasm during sex.

 

Depending on settings like 'pullout', 'squirt' and 'overflow', cum will be determined to land on different places, and will be tracked in arrays that I call 'spurts'. They contain information about the actor's species, race, gender, identity, volume and the time of ejaculation.

 

4. Sperm tracking

 

Any vaginal cum spurts start to release sperm into the sperm tracking system, a copy of cum tracking that replaces "volume" with "sperm count" and carries over the other information. This means that sperm increases gradually over time, and is also killed off after a set time. In between, the number's ready for a mod like Sexout Pregnancy to determine it's enough to trigger a pregnancy. This makes for a system that's fairly realistic, but precludes insta-pregnancy. If you want to increase your odds, try raising cum volume settings in MCM.

 

5. Smell tracking

 

Upon orgasm, a non-human species will leave behind a 'smell' that makes other creatures of that species friendly to the 'receiver'. MCM settings let you determine how long that lasts.

 

Left out of the system are anchorage chimera tanks, lucky 38 securitrons, liberty prime and ZAX computers. Dogs that are faction sniffers won't make you legion, ncr etc.

 

6. Cum shaders

 

On orgasm, it's possible that cum shaders are applied to the receiver's body. If in your MCM settings you choose to 'let spunk decide', this will depend on how much lands on the outside of the body in the (virtual) cum tracking system (3). You may want to override with other settings to force it to always happen.

 

Some creatures' cum may look funny. This is intentional.

 

In order to line up the fading out of the 'dripping' shader with the application of the 'permanent' one, the timing of the dripping one is rather short. I've provided intel on how to increase that duration... somewhere in the thread.

 

7. Washing

 

On interaction with water, you can be prompted to wash yourself if there's cum on the outside of the body in the cum tracking system, a shader is applied, or a smell is applied. This will clear all of these. You can also tell NPCs to wash.

 

There are two ways I use to know if you're interacting with water. The effect-based one detects more types of water, such as puddles, but some experience problems with it, so there's also an activator-based one you can choose in MCM.

 

8. Experience and enjoyment

 

At the beginning of an act, Spunk detects what each actor is doing in it, assigning them 'roles'.
The role strings are: Sucker, Sucked, Fucker, Fucked, Assfucker, Assfucked, Licker, Licked, Titfucker, Titfucked, Jerker, Jerked, Fingerer, Fingered, Footsier, Footsied, Tribber, Inserter, Inserted, DoggyDo, DoggyDone, MissDo, MissDone, Riding, Ridden, Tantric, Bound, Binding, Dom, Sub, Group, Whipper, Whipped. (Titfucker & Footsier are the owners of the tits/feet.)

 

The count system keeps track of how many times an actor has performed a specific role, and how often they've been with a non-human species. It does this in the form of NX variables with the following namespace:
"SO:Count:Role:Rolestring"
"SO:Count:Species:Speciesstring"
(The species strings can be found in the outdated documentation that ships with the mod.)

 

The XP system hands out experience points based on the existing experience of the actors in the act and how difficult it should be to get the other to orgasm. Experience is always increased a little for everyone, but more for whoever gets their partner(s) to orgasm.
"SO:XP:Role:Rolestring"
"SO:XP:Species:Speciesstring"
If you take the Are You Experienced? perk, sex experience gained will be added to your game xp.

 

The enjoyment system is based on the premisse that orgasming from an act increases your preference for what you did in it, and not getting to orgasm or even being raped decreases it.
"SO:Enjoy:Role:Rolestring"
"SO:Enjoy:Species:Speciesstring"
Enjoyment for a role the actor's never played usually starts at the neutral value of 1, except a few that start higher (receiving oral) and a few that start lower (receiving anal, whipping).

 

Both the XP and Enjoy system range from 0.2 to 5, as they are used as multipliers in determining arousal increase during an act. A neutral value is 1.

 

If you notice that your character's arousal increases only very slowly, generate a Spunk log before sex and check it afterwards for a line starting with "SpunkSPArousalScpt" and a bunch of numbers. "XPF" there is the experience factor, "Enjoy" gives you the enjoyment factor. Especially enjoyment may be too low for your tastes.
You can change it by opening the console, clicking on the character and typing:
Set_EVFL "SO:XP:Role:TheRoleString" somevalue
Alternatively, you can go in MCM, and turn off xp and/or enjoyment tracking. This should clear out all your enjoyment variables, giving you a fresh start. Wait in game for at least 5 seconds, then turn it back on.

 

Spunk assigns a series of up to 66 perks to the player character that depend on their enjoyment for specific roles. On their own, these perks do nothing except give you a clue how high or low your character's enjoyment for a particular act is. You should be able to derive that from the description and rank.

 

9. Troubleshooting

 

- Definitely make sure you have the correct versions of NVSE, SexoutNG and NX. If Spunk says you don't, you don't.
- Make sure you run the latest Spunk. Bugs in previous versions may've been fixed, after all.
- Use the debug tools you can access from MCM, and if you plan to report what you think is a bug, definitely use the "generate log" feature in a way that the bug is captured.
- If a character, especially the player character, doesn't seem to orgasm from sex, re-read the chapters about arousal (2) and enjoyment (8).

 

Requirements:
SexoutNG 2.10.97+, NVSE 5.1.2+, NX 16+, UIO 1.31+, JIP 53+

 

Permissions: GPL3

 

Credits

 

Jaam, mostly, for porting the fancy NVSE4 stuff I’m using in this mod, as well as fixing the fancy NVSE4 stuff that didn’t work at first, and adding some fancy stuff to nx for me. I pestered Jaam about so many things, and he always came through in record time, so I gave him co-authorship. I honestly hope more modders will start to use this stuff and make some great mods with it.
ChaseRoxand, for the orginal SexoutLust, which most of my own lust tracking is based on
A.J. for teaching me how to HUD
Zippy57 for Lust's original HUD readout addons for pHUD and oHUD.
Whoever did Lust's anyHUD addon.
Prideslayer, for a couple of tips along the way
Hal, for pitching the idea & showing patience as it grew and grew - no Doc mod without a bit of feature creep
Odessa, for a great debug dump template
QQuix, for the “DeepDump” UDF found on the TES4 modding wiki, also for several examples of nested array use in assorted posts on the Beth forums, without which I wouldn't have known if that was even possible or how to go about it.
TSS5062 for cum shaders - yowsa!
panthercom for perk names
And, well, some unknown Japanese modders who made the textures I use for the cum shaders (the LoverswithPK bukkake ones).
Anybody who ever reported a bug in a way that I could fix it