Puppet Master Swallow - Elimination enhancement for Puppet Master 1.2b

Puppet Master Swallow is intended to provide, within the limits of the resources available, as thorough a watersports / scat experience as possible. Probably moreso than any mod for any game so far. That said, I am no animator, and certainly the biggest blank that would have needed filling for a proper job is custom-made animations. Nevertheless, I was inspired by the elimination-themed options already made available by Puppet Master, and said mod was the first I know of to cover that ground in any capacity. I took it upon myself, at first, to attempt to fix some bugs with those options, but ultimately that exploded into Puppet Master Swallow.

Puppet Master Swallow enables:

Compatibility. These affect the player only.

• Private Needs. v2.11 and v3.0 are supported. Bladder and bowel volume is referenced and adjusted when they are emptied. Optionally, actual bladder and bowel volumes are adhered to even when they are zero, which will prevent said acts. Hygiene is referenced and adjusted when unclean acts are performed. In v3.0, eating and drinking affect the new digestion system. If Private Needs 3.0 is not in use, a simple, internally-calculated digestion system will be used instead.
• Realistic Needs and Diseases. Hunger and thirst are referenced and adjusted based on the Puppet Master Swallow settings.
• Drink, Eat, Sleep and Bathe. Hunger and thirst are referenced and adjusted based on the Puppet Master Swallow settings. Hygiene is referenced and adjusted when unclean acts are performed.
• iNeed. Hunger and thirst are referenced and adjusted based on the Puppet Master Swallow settings.
  

New masturbation options. What this specifically means is that one gains the option to urinate and / or defecate during masturbation, or to tell any or all of their puppets to. The elimination acts will occur at randomized moments, lending variety to the effect.

Manual elimination keys for both the player and puppets. This is more or less the landmark feature of this mod. Hit a key during any circumstance and the player or puppet (or puppets) will eliminate, with or without first undressing. Should this occur during sex, orifices may be hindered depending on what's going on, and if there are oral activities taking place, consumption will be the result.

New sounds. Specifically, swallowing sounds, and some subtle defecation sounds. Nothing over the top.

New visuals.

• Poop animates out of the body.
• Splash effects for the various orifices. Affected by things like oral activities, wearing a strapon, etc.
• Adjustable urine stream size / visuals, as well as the option to force their origin to actors' urethras.
• Urine pool positioning. They'll appear in locations more appropriate than simply beneath the actor.
• Optional lighter yellow urine pool.
  

Better physics. Poop doesn't appear out of thin air, fall to the ground like a feather dropped on the moon, or wedge two-thirds of itself under the ground. If you move it, it does basically what you expect. (For the player, however, many sacrifices were made in order to achieve this result, and it is still, unavoidably, a little dodgy.)

Elimination animation selection (urinating and defecating). You can pick any animation you want, or combination of animations, and one will be randomly chosen from your selections.

Facial expression selection (player and puppets). You can pick any expression you want, or combination of expressions, and one will be randomly chosen from your selections.

Full control over what to undress when either eliminating or consuming. The menu for this option also features a display of every armor slot, showing everything being worn by the player.

Those are the major points, without going into all the nitty-gritty.

• As the menu warns, the new visual effects, when applied to the player character, will almost certainly not work while in free-camera mode, thanks to a Skyrim bug related to said mode which will clearly never get corrected. NPCs are unaffected.
  

• One of my earliest goals in tampering with Puppet Master was to fix the drinking sequence, which played the wrong pose. This quirk was probably due to a change in SexLab which broke the method Puppet Master was using to call the correct stage. SexLab still has not reintroduced a method for immediately calling the desired stage, so the next best thing was to call it as soon as possible, which means after about one second.
  

• If something doesn't seem to work the way you expect, check the menus (for both Puppet Master Swallow and Puppet Master itself) and make sure there isn't an option preventing it from working.
  

• Just as with Puppet Master itself, this is a very script-heavy mod, with all the caveats that implies.
  

• The new sound effects were sourced hither and thither, and painstakingly remastered for usability. They are not personal recordings. They are also not, in my opinion, needlessly obtrusive or over the top.
  

• Because properly-aligned paired animation in Skyrim is effectively more theoretical than actual, the same thing goes for the new visual effects in Puppet Master Swallow. Everything was coordinated to fit idealized alignment which I personally never saw even once.
  

• Many of the new visual effects absolutely require the use of armor slot 60 or 61. The mod assumes slot 60 is free by default, but this can be changed to slot 61.
  

• Not specifically related to Puppet Master Swallow, but if you make use of puppets who are clones of one another (for example, you have spawned in two+ copies of a particular follower), SexLab will probably get confused and cause one or more actors to get stuck in their sequence, among other interesting phenomena. Puppet Master uses a similar system of record-keeping and so can also exhibit some unexpected anomalies.
  

• Despite my considerable efforts at contingency, it is theoretically possible for something to go awry, especially if one goes out of their way in trying to break things. Should this seem to happen, one may make use of the cleaning function available in the menu.
  

• As it happens, a thoroughly unexpected limitation of Skyrim and the Creation Kit caused the initial release of this mod to be almost completely nonfunctional. But at least, in the process of skirting that limitation, I found and corrected a handful more unrelated bugs. Considering the complexity of this mod, it is entirely possible - perhaps even probable - that some minor issues may remain. I'll probably keep tabs.
  

• Added SexLab 1.57 compatibility.
• Fixed bad urine pool positioning for medium-sized male stream.
• Changed some of the code dictating pool positioning during sex.
• Fixed some internal confusion over whose thirst is being affected.
• Fixed a bug that would prevent future elimination if no animation was selected.
• Fixed the problem of informal speech options not triggering events.
• Fixed the problem of the armor tally not cleaning up slots.
• Fixed many other minor bugs.
• Addressed the papyrus log; footprint in the log is now perhaps zero.
• Added a menu option to do as thorough a job as possible of disabling the mod.
  

1: Compatibility with the latest Private Needs (4.0) is now functional.
2: Code updated to the SexLab 1.61b standard. No guarantees that things still work well with SexLab 1.59.
3: Several newer Leito animations have been added to the urinating / defecating lists. These are the ones I now use by preference. These are not packaged with Puppet Master Swallow! You must install Alive Peeing's assets and run FNIS. (You do not need to enable Alive Peeing's .esp.)
4: Animations can be forced to be used with the "manual urinating / defecating" hotkeys, both for the player and for puppets. This eliminates the need for menus and makes the process more real and spontaneous.
5: Animations can be forced to be chosen based on whether the actor was standing or crouching at the time of activation.
6: Leito animations come packaged with beginning animation components by default, which happen to be ill-suited for crouching actors. These beginning components can be disabled for crouching actors.
7a: In Puppet Master's menu, the duration for both urination and defecation can be extended as far as two minutes ("120sec Elimination" download is now redundant).
7b: For urination, this setting affects the menu-driven duration, the manual duration, the automated urinating-while-masturbating duration and the urinate-in-mouth duration.
7c: For defecation, this setting affects menu-driven durations. However, menu options are provided to force this setting to also affect manual and automated defecating-while-masturbating durations. In any case, what the duration affects is how long the actor spends producing excrement, so while anything longer than a handful of seconds is not precisely realistic, it may nonetheless be an altogether agreeable effect.
8: Both manual urination and manual defecation, for player and/or puppets, can be shut off prematurely by pressing the hotkey again.
9: SexLab 1.60+ arbitrarily replaced the original stage 1 Arrok Anal animation (butt-wagging) with an alternative that both animates differently and offsets the two actors to dramatically incompatible positions. In order to combat this and restore the correct animation to Puppet Master Swallow, I have taken advantage of the SexLab Anim Loader mod. Said mod will need to be installed if it is not already. FNIS must be run. And then, from within SL Anim Loader, the original Arrok Animation must be registered with SexLab. The end result is the correct animation with the correct actor positions when using poop-in-mouth, without needing to revert SexLab's odd change to Arrok Anal.
10: The poop texture was made darker so that it wouldn't be tan-colored in ENBs, or at least not the ENB I use. It still can be a bit, when in direct sunlight. Close enough.
11: Fixed inconsistencies in poop meshes.
12a: The necro function in Puppet Master is processed better, and properly takes advantage of "Necro"-tagged animations rather than a basic default. Done so one can have a straightforward necro option without, for example, having to install and configure the entire Defeat mod.
12b: The necro function does not forcibly strip the "armors" used by Namira's Goat, even if the chest slot is flagged in SexLab for stripping.

I am currently giving Skyrim my much-belated and final playthrough before moving on to Fallout 4 or whatever else comes. Part of the process of "playing" the game is updating and tweaking the mods I had originally made for myself, naturally including the first one I made, Puppet Master Swallow. This is not meant or guaranteed to be a fully bugchecked release. That said, it works well enough for my purposes, so some folks will likely get some use out of it.

As far as I can gather, Puppet Master Swallow v1.3 did not work for anyone but myself, and it is essentially impossible for me to discern what is causing SkyUI to choke, especially as I am unable to reproduce the issue for myself under any circumstance. I do not have time to continue to troubleshoot an impossible issue, so I have decided to redact v1.3 and avoid the trouble it causes. Outside of updating things to work with SexLab 1.61b, the changes were generally cosmetic. If using SexLab 1.59, sticking with v1.2b gets one the majority of the package.

If you are a modder and think you can nail down the reason why v1.3 evidently doesn't function correctly on any PC but my own, PM me for a copy and I may forward it.