Commonwealth Moisturizer 1.05

Apply Body Cum / Apply Face Cum: These options can prevent all body cum and/or all facial cum from being applied.

Cum Duration: Amount of time, in real time, until the cum disappears. You may wash it out early with third-party mods if they're patched or otherwise written to accommodate Commonwealth Moisturizer. Cum may also be cleaned off in the MCM debug menu.

Cum Armor Slot: All body cum occupies a shared armor slot. You may select which slot you prefer. Please note that no further slot options will be added, although you are welcome to patch your own version or even release a patch for anyone else to use. Please see the note about slot 61 in the “Known Issues” section down below.

Allow Female Cum: If you want females (or actors that the game considers female) to apply cum, enable this option.

Bukkake Mode: Traditionally, you'd see one cum application per location tag (vagina, anus, mouth). Some animations have more partners than location tags. When enabled, this option causes each surplus partner to apply cum in a random location.

Combine Male Locations: Under normal circumstances, male receivers will only get oral and anal cum (assuming animations are tagged correctly). With this option enabled, front/belly cum can also appear after anal animations.

PenisToEither Tag Processing: Some female animations are tagged “PenisToEither” when it's not clear whether the animation should be anal or vaginal. You may select where cum from these animations is applied: always vaginal, always anal, or random anal/vaginal.

Semen Color Settings: This series of options lets you fine tune the color of various races and creature types. Color options include white, blue, and green. Note that you can also select “No Cum”, meaning sex with that partner will not add cum to the player.

Whitelist NPC For Headparts: Target an NPC and click this button. Commonwealth Moisturizer will attempt to use morphing headparts on the NPC as if they were the player. Please note that this technique will not work on most vanilla and DLC actors. Unique actors added by mods, such as companions and quest givers, are good targets for this option.

Allow Situational Cum Prevention: Third party mods may sometimes send scene info that would prevent cum from being applied in a certain way. For example, the receiver could be swallowing during an oral scene, and so a facial wouldn’t look right. The user may choose to allow these situations or to apply the usual cum under all circumstances.

Allow Receiver to Apply Cum: When enabled, the “receiver” of sex (actor zero) will also apply cum to their partner (actor one). Only one partner will receive cum from actor zero, and actor zero still receives all cum that their partner(s) would apply. This action obeys the same global settings as all other cum application, including racial semen color and whether females can apply cum.

Q) Will this mod work with Cum Overlays?

A) 100% yes. I think the appearance of the cum overlays complements the cum meshes quite nicely.

Q) Will this mod work with mods that change the head/face mesh, like HiPoly Faces?

A) I have no idea, but my guess would be no.   Seems as if HiPoly Faces might work after all!  For similar mods, I don't know, but you'll have to test it yourself to confirm.  If facials clip badly or don't move properly, that means you'd likely have to rebuild all the facial files to fit a brand new head. That's a tremendous amount of work. I'll be happy to outline the proper steps for some enterprising modder, but it's not a task I'll be doing myself.

Q) Will this mod work with [insert custom race]?

A) The body cum probably will, assuming the body is based on FG, CBBE, BT3, or AM. The facials almost certainly won't. The headparts are specific to human race, and even if you changed that aspect, you'd have to refit all the cum to a new head shape.

Q) Why do I hear the sound of clothing being put on and off randomly?

A) You are running a version lower than 1.05.

Q) Whitelisted NPC facials don't persist through reload.

A) To fix this, I found it necessary to alter the NPC in Looksmenu at least once. Anything seems to work. Change their hair color, accept the change, exit Looksmenu, and then change the color back.

Q) The body cum doesn't fit my character.

A) Make sure to build it to your chosen preset, with morphs, in Bodyslide. Search for “semen” in Bodyslide to find the suits.

Facegen is the bane of my existence. It's possible (read: almost certain) that I'm the only modder with this explicit opinion. Surely, though, everyone who has tried to do something as simple as change an NPC's hairstyle in Looksmenu would look unkindly upon this particular bit of Bethesda “genius”. To summarize the issue, nearly every actor in the game has pre-made face/head data that you can't alter without editing the actor in Creation Kit. Yes, something something better performance, framerates this and that, blah blah I don't care. There's no way to even turn it off on the fly and its presence made twice as much work for me. I'm bitter. That aside, you can work around it in a couple ways.

First, most unique actors added by mods don't use facegen. Thus they can use headparts just like the player, if you use this mod's MCM function to whitelist them. Second, you can turn off facegen for individual actors via CK/xEdit. Find the character you want and check the “Is CharGen Face Preset” flag.

The CK wiki description of this flag's function is incomplete at best. Checking the flag will force the engine to generate this NPC's face/head on the fly, and you can then change their appearance via Looksmenu or script. Be sure to whitelist them for cum headparts via MCM too.

-To call this mod's cleaning function, add the following to your script.  ActorRef is used in the example, but you can use any name as long as it's a human actor.

If Game.IsPluginInstalled("ComMoisturizer.esp")
	ScriptObject CMkz = Game.GetFormFromFile(0x00000F99, "ComMoisturizer.esp").CastAs("CMkz:CMkz_LibScript")
	Var[] params = new Var[1]
	params[0] = ActorRef as Actor
	CMkz.CallFunctionNoWait("ClearAllCumFromActor", params)
EndIf

-In addition to whitelisting NPCs for headparts via the MCM debug menu, you can also add them to the formlist named “CMkz_TheseActorsCanUseHeadparts” in advance.

-Three formlists are available for setting cum color of custom races: CMkz_CustomSemenColorBlue, CMkz_CustomSemenColorGreen, and CMkz_CustomSemenColorWhite. Simply add your race to the appropriate list.  A demo patch for Animated Tentacles (version 0.9) is available in the main thread.

-For anyone who wants to make their own headparts, instructions and reference heads for Outfit Studio are posted in this very thread.

-This mod sends two custom events. One when cum is applied to an actor, and another when cum is removed from an actor. Here’s an example of how to register and listen for these events:

CMkz:CMkz_LibScript CMkz_Lib	; place this with your script properties

Function LoadCMkz()
	if Game.IsPluginInstalled("ComMoisturizer.esp")
		CMkz_Lib = (Game.GetFormFromFile(0x00000F99, "ComMoisturizer.esp") as Quest) as CMkz:CMkz_LibScript
		RegisterForCustomEvent(CMkz_Lib, "OnCMkzCumApplied")
		RegisterForCustomEvent(CMkz_Lib, "OnCMkzCumCleaned")
	EndIf
EndFunction

Event CMkz:CMkz_LibScript.OnCMkzCumApplied(CMkz:CMkz_LibScript akSender, Var[] akArgs)
	; akArgs[0] = actor akActor			(actor who had cum applied)
	; akArgs[1] = bool AppliedFacial	(oral cum specifically on the face)
	; akArgs[2] = bool AppliedFront		(vag/belly)
	; akArgs[3] = bool AppliedOral		(face/chest)
	; akArgs[4] = bool AppliedRear		(anal/back)
	; akArgs[5] = int SemenColor		(0 = white, 1 = blue, 2 = green, 3 = none)
EndEvent

Event CMkz:CMkz_LibScript.OnCMkzCumCleaned(CMkz:CMkz_LibScript akSender, Var[] akArgs)
	; akArgs[0] = actor akActor		(actor who had cum removed)
EndEvent

-The API function “ForceRandomFacial(actor akActor, int SemenColor, bool ForceHeadpartsEligible)” will apply a facial to the specified actor. Setting ForceHeadpartsEligible true will apply the CMkz_KW_ActorCanUseHeadparts keyword to the actor, thus forcing an attempt to use headparts cum instead of head armor cum.

-The FormID List “CMkz_FlistCondoms” may be populated with armor items such as condoms. When worn, any item on this list will prevent the wearer from applying cum.

-The following XML tags may be used to specify where actor zero will apply cum to actor one: “ActorOneReceiveFront” for vaginal/belly, “ActorOneReceiveOral” for face/chest, and “ActorOneReceiveRear” for anal/back.

-The “OralSwallow” XML tag may be used to prevent oral cum, while still allowing other mods to process PenisToMouth for other uses like oral wear.

-The following meta strings are used to prevent application of cum, either entirely, or just at specific body locations. They may be included in your AAF settings struct when calling a scene: CMkz_MetaNoCumAll, CMkz_MetaNoCumAnal, CMkz_MetaNoCumOral, and CMkz_MetaNoCumVag.

Body cum is an armor item, with all attendant pros and cons. Every slot will conflict with something. Hence, the choice of slot is yours to make in MCM. Slot 61 is the least likely to conflict with other clothing. Mods that ignore AAF protected equipment keywords also usually won't strip a slot that high. The downside is that armor at slot 61 won't automatically update morphs while worn. It only conforms to the body on equip. So if your body suddenly changes shape while the armor is worn (e.g. you go from pregnant to not pregnant), the cum suit's shape won't update until the suit is unequipped and re-equipped.

To compensate, Commonwealth Moisturizer has internal mechanisms to cycle (un- & re-equip) the suit automatically when you sleep, wait, change locations, load the game, or have sex. These aren't strictly necessary if you're using any other armor slot, or if your body shape usually stays the same, or if you keep cum on a short timer. You can unregister for these cycling events in the MCM debug menu.