Procedural Penis Animations/Collision [Beta] 0.0.34

# ───────────────────────────────────────────────────────────────────────────────
#                               SOUND EFFECTS
# ───────────────────────────────────────────────────────────────────────────────
#
# Controls the procedural sound generation during animations.
# Sounds are triggered based on penetration depth and velocity tracking.
#
[SoundEffects]
Enabled = true

# ─── CLAP SOUNDS ───
# "Clap" sounds play at the moment of impact (when bodies collide at max depth)
# Minimum seconds between clap sounds. Increase to reduce sound frequency.
# Range: 0.05 - 0.5 | Default: 0.10
ClapMinInterval = 0.15

# Minimum thrust velocity required during a stroke to trigger a clap.
# Higher = only fast/hard thrusts make sound. Lower = gentler motion triggers.
# Range: 5.0 - 30.0 | Default: 10.0
ClapThrustVelocity = 8.0

# Minimum penetration depth required to play a clap sound.
# Prevents sounds when barely inserted. Increase if getting unwanted sounds.
# Range: 0.5 - 5.0 | Default: 2.0
ClapMinDepth = 2.0

# ─── WET SOUNDS ───
# "Wet" sounds loop/play continuously during active motion
# Minimum seconds between starting new wet sounds.
# Range: 0.05 - 0.3 | Default: 0.08
WetMinInterval = 0.08

# Velocity threshold to START playing wet sounds.
# Lower = sounds play during slower movement.
# Range: 3.0 - 15.0 | Default: 7.0
WetVelocityThreshold = 3.0

# Velocity threshold to STOP wet sounds (with grace period).
# Should be lower than WetVelocityThreshold to prevent start/stop flickering.
# Range: 0.5 - 5.0 | Default: 1.0
WetStopVelocity = 1.0

# ─── VELOCITY TRACKING ───
# Controls how motion is analyzed to trigger sounds
# Smoothing factor for velocity calculation (0-1).
# Lower = smoother/slower response, Higher = more reactive/jittery.
# Range: 0.1 - 0.5 | Default: 0.3
VelocitySmoothFactor = 0.3

# ─── AUDIO PROPERTIES ─────────────────────────────────────────────────────────
# Controls pitch and volume variation based on movement speed
# Frequency (pitch) multiplier range. 1.0 = normal pitch.
# Faster movement = higher pitch within this range.
MinFrequency = 0.85
MaxFrequency = 1.35

# Volume range (0.0 - 1.0). Faster movement = louder within this range.
MinVolume = 0.6
MaxVolume = 1.0

# Velocity value that maps to maximum frequency/volume.
# Velocities above this are clamped. Lower = reaches max sooner.
# Range: 50.0 - 200.0 | Default: 150.0
SpeedScaleMax = 150.0

# ─── SOUND FILES ──────────────────────────────────────────────────────────────
# Paths support wildcards (*) to randomly select from matching files.
# Paths are relative to Skyrim's Data folder.
# You can make a LIST of these! The [] thing defines a LIST. Ok?
[SoundEffects.Vagina]
ClapSounds = ["Sound\\Fx\\ppa\\vagina\\clap*.wav"]
WetSounds = ["Sound\\Fx\\ppa\\vagina\\FFFM - *.wav"]
ClapSoundVolumeScale = 0.8
WetSoundVolumeScale = 0.6

[SoundEffects.Anus]
ClapSounds = ["Sound\\Fx\\ppa\\anus\\plap (*.wav"]
WetSounds = ["Sound\\Fx\\ppa\\anus\\Slime (Set E)-*.wav"]
ClapSoundVolumeScale = 1.0
WetSoundVolumeScale = 0.5

[SoundEffects.Mouth]
ClapSounds = ["Sound\\Fx\\ppa\\mouth\\squelch_*.wav"]
WetSounds = ["Sound\\Fx\\ppa\\mouth\\suck_*.wav"]
ClapSoundVolumeScale = 0.25
WetSoundVolumeScale = 1.95

# Hands only use the wet sounds.
[SoundEffects.Hands]
WetSounds = ["Sound\\Fx\\ppa\\hands\\Squish - Handjob Normal-*.wav"]
WetSoundVolumeScale = 0.6

 

For simple editing, you can just use the in-game editor! I only recommend this tutorial for finding different bones to attach nodes to, if you only want to EDIT the hole position slightly use: Backspace (Opens action menu) -> Edit Hole Positions -> Whatever

 

Manual tutorial:

To change a hole position on a body, you need to adjust the offsets in the config.

We'll be using Nifscope to find our offsets, since it's easier. 

 

You can specify a spline of "DepthWaypoints", or you can specify a single "DepthOffset". You can't do both - so pick one or the other. You want a simple tunnel (DepthOffset), or a more elaborate tube for the penis to follow (DepthWaypoints)?

 

Tips:

- The pelvis is the most stable bone to use. Others are skinned, and may shift around in-game

- I recommend you keep the "tunnels" - or in other words, DepthOffset - away from each-other. Like you don't want to cross the anus and the vagina nodes since other physics mods will pick that up and assume double penetration. Unless you're using all of this mods features!

- You should keep the collision cylinder as a perfect shape of the anus/vagina tunnel. No sense in making it larger then it needs to be since we already force the penis to penetrate properly.

 

This tutorial assumes you're just specifying a simple DepthOffset. The procedure for DepthWaypoints is virtually the same though, just obviously more points to draw a shape rather than a straight line. 

 

Nifskope: 

1) Load up your body, usually named Femalebody_1.nif or something. Then expand the first NiNode (Usually named Scene Root).

2) Now scroll down and find a good bone to use. Pelvis is my favorite because it's solid. 

3) Select that NiNode (Pelvis in my case)
4) Right click it, and select Node>Attach Node. 
5) That'll open a small UI, select 'NiNode' from it. This is where we want our penis to ENTER/bend

6) Now you've got a fake bone to work off! We can now translate this NEW bone by selecting it 

7) Then Right click, and go to Transform->Edit. 
8 ) In this menu, you ONLY want to change the Translation: X,Y,Z. Move the fake bone to where you want the penis to enter. You should end up with something like this: 
9) Now copy those translation coordinates, and put them in your config. Replacing the "Offset" coordinates. And press "Accept".
10) Now you need a DepthOffset. Click your new node, and once again attach an 'NiNode' to it.  

11) Basically repeat those steps, and get your canal mapped out. Should look something like this:

12) Now take those new translation coordinates, and put them in the "DepthOffset"
13) Perfect, you're done. That was easy? 

 

Here's some other user's posts on messing with these configs for further help/context:

 

 

# ═══════════════════════════════════════════════════════════════════════════════
#                            PPA MOD CONFIGURATION
# ═══════════════════════════════════════════════════════════════════════════════
#
#   This file controls physics behavior, collision detection, and animation
#   settings. Most values can be overridden per-actor using override configs (/ppa-override-configs folder).
#
#   TIP: Use the in-game debug options to visualize bones and collision
#        cylinders while tweaking these values.
#
# View the mod page for more advanced configuration tips: https://www.loverslab.com/files/file/46320-procedural-penis-animationscollision-beta/
#
# ⚠️ IMPORTANT NOTE: If a value has decimal places, like 1.0 - you MUST have a decimal.⚠️
# ⚠️ No decimal means it may be read wrong. Same with non-decimal numbers              ⚠️
#
# ───────────────────────────────────────────────────────────────────────────────
#                                   GENERAL
# ───────────────────────────────────────────────────────────────────────────────
[General]

# Decides when physics calculations occur in the game loop.
# Affects compatibility with other physics mods (like FSMP).
#
#   0 = Wrap tick stack (DEFAULT)
#       Runs first, applies morph targets last. Gets priority over SMP/UNBC.
#       Best for ensuring changes stick and don't get overwritten.
#
#   1 = Pre-Update (Early)
#       Runs at the start, before standard player update logic.
#       Mostly for testing. Generally worse than 0 or 2.
#
#   2 = FSMP Injection (Compatibility Mode)
#       Hooks directly into Faster-SMP. Use this if you get clipping
#       with FSMP butt/thigh physics. Try this if other physics mods
#       aren't recognizing collisions properly.
#
#  WARNING: Requires game restart to take effect!
#
HookPosition = 0

# Enable vaginal/anus opening and closing during scenes. Disable this if you want CBPC/SMP to do it
HandleOpeningPhysics = true

# Redirect futa characters to use the anus instead.
FutasUseAnus = true

# Skip physics processing for scenes with more than this many actors.
IgnoredSceneActorCount = 6

# Skip applying hole physics to male actors. Also disables animating their masturbation
# Disable this for male support (May have slight bugs you'll need to solve with "SelectActor")
IgnoreMaleActors = false


# ───────────────────────────────────────────────────────────────────────────────
#                                   HOTKEYS
# ───────────────────────────────────────────────────────────────────────────────
[Hotkeys]

# Only allow hotkeys while the console is open (Only for Reload, and Pause)
ConsoleOnly = false

# Key codes (default: F2=60, F5=63, 0=11)
# Find codes at: https://www.nexusmods.com/skyrimspecialedition/articles/7704
Pause       = 60    # Pauses the mod
Reload      = 63    # Reload configuration
SelectActor = 14    # Select actor to edit their penis target + Much more

# Should we REQUIRE holding shift to use these hotkeys? So like Shift+F2 = pauses the mod. (Recommended)
HotkeyWhileHoldingShiftOnly = false

# ───────────────────────────────────────────────────────────────────────────────
#                                    DEBUG
# ───────────────────────────────────────────────────────────────────────────────
# You WILL need to use this while trying to figure out where to put offsets/waypoints
[Debug]

# Print verbose logs to the console.
Logging = false

# Display your vagina/anus/mouth entrances and splines in-game
Bones = false

# Display collision cylinders in-game.
Collision = false

# Display penis collision bones in-game.
Penis = false


# ───────────────────────────────────────────────────────────────────────────────
#                                    PENIS
# ───────────────────────────────────────────────────────────────────────────────
[Penis]

# Skeleton bones to manage (in order from base to tip).
Bones = [
    "NPC GenitalsBase [GenBase]",
    "NPC Genitals01 [Gen01]",
    "NPC Genitals02 [Gen02]",
    "NPC Genitals03 [Gen03]",
    "NPC Genitals04 [Gen04]",
    "NPC Genitals05 [Gen05]",
    "NPC Genitals06 [Gen06]",
]

# Forward axis of the penis. Don't change unless you know what you're doing.
LocalForwardAxis = [0.0, 1.0, 0.0]

# Offset for curve projection casting.
# Slightly lower than the base to reduce initial bend.
# Use NifSkope to determine correct values for non-human actors.
BaseOffset = [0.0, 1.206299, 1.206299]

# Rotate the base bone along with the rest.
# Enable for smoother appearance; disable for more rigid realism.
RotateBase = true

# Use exact HAVOK state for the penis.
# Ensures length stays precise but disables some animation features.
PreserveHavokState = false

# Hide the penis when it exceeds HideDepthOffset inside a hole. (Shouldn't be needed)
ClipFix = false
HideDepthOffset = 2.0 # How deep past the hole entrance to start cutting the cock off

# Global detection range multiplier for collision cylinders.
# Example: 1.5 means 50% larger than the actual cylinder.
ActivationRange = 3.5

# Average width of the penis.
Girth = 0.9

# Length of the tip segment.
TipExtension = 2.9

# Minimum distance from penis base to hole.
# Simulates "bottoming out" at the end of the canal.
# 0 = no limit (full insertion allowed).
MinProjectionDistance = 0.0


# ───────────────────────────────────────────────────────────────────────────────
#                                   VAGINA
# ───────────────────────────────────────────────────────────────────────────────
[Vagina]

# Bone names for controlling gape.
NodeL    = "NPC L Pussy02"
NodeR    = "NPC R Pussy02"
NodeBack = "VaginaB1"
NodeTop  = "Clitoral1"

# Base opening distance.
Scale = 1.5

# Max opening distance.
ScaleMax = 3.0

# How strongly the opening grips during penetration. (Animation)
GripStrength = 5.0

# Clamps how far forward (into the body) the grip animation can pull the orifice mesh.
GripClampForward = 6.0

# Clamps how far backward (out of the body) the grip animation can pull the orifice mesh.
GripClampBackward = 5.0

# Intensity of rubbing effects. (Animation)
RubIntensity = 3.5

# Position & Collision
# ─────────────────────
# The collision cylinder is used for detection (not actual physics collision).
# It determines which hole the penis should target.
[Vagina.Position]

# Bone to attach the entry point to.
Anchor = "NPC Pelvis [Pelv]"

# Local offset from the anchor bone (X, Y, Z).
Offset = [0.0999999, -2.05005, -3.27]
CollisionCylinderRadius = 1.2
CollisionCylinderHeightModifier = 1.0


# Depth Waypoints
# ───────────────
# Define a path (tunnel) for the penis to follow during penetration.
# Each waypoint creates a curve point. The penis bends to follow this path.
#               !You can define UNLIMITED of these!
#
#   Anchor         = Bone to attach to (optional; defaults to previous waypoint)
#   Offset         = Position offset from anchor (X, Y, Z)
#   CornerSmoothing = Smooths transition to next waypoint (0.0–1.9)
#                     ⚠️  Don't exceed 1.9 on sharp angles or it will bug out!
[[Vagina.Position.DepthWaypoints]]
Offset = [0.0, 0.0, 6.0]
CornerSmoothing = 1.0
CollisionRadius = 4.0

[[Vagina.Position.DepthWaypoints]]
Anchor = "NPC Spine1 [Spn1]"
Offset = [0.10003, 3.39997, -3.25]
CornerSmoothing = 0.5
CollisionRadius = 1.0


# ───────────────────────────────────────────────────────────────────────────────
#                                    ANUS
# ───────────────────────────────────────────────────────────────────────────────
[Anus]

# Bone names for controlling gape (4 corners).
NodeLB = "NPC LB Anus2"
NodeRB = "NPC RB Anus2"
NodeRT = "NPC RT Anus2"
NodeLT = "NPC LT Anus2"

# Base opening distance.
Scale = 2.0

# Max opening distance.
ScaleMax = 4.5

# How strongly the opening grips during penetration. (Animation)
GripStrength = 2.0

# Clamps how far forward (into the body) the grip animation can pull the orifice mesh.
GripClampForward = 1.0

# Clamps how far backward (out of the body) the grip animation can pull the orifice mesh.
GripClampBackward = 1.0

# Intensity of rubbing effects. (Animation)
RubIntensity = 2.4

[Anus.Position]
Anchor                          = "NPC Pelvis [Pelv]"
Offset                          = [0.0, -5.8, -1.0]
CollisionCylinderRadius         = 1.2
CollisionCylinderHeightModifier = 1.0

[[Anus.Position.DepthWaypoints]]
Offset          = [0.0, 3.0, 6.0]
CornerSmoothing = 1.0

[[Anus.Position.DepthWaypoints]]
Anchor          = "NPC Spine1 [Spn1]"
Offset          = [0.0, 4.0, 0.0]
CornerSmoothing = 1.0


# ───────────────────────────────────────────────────────────────────────────────
#                                    MOUTH
# ───────────────────────────────────────────────────────────────────────────────
[Mouth.Position]
Anchor                          = "NPC Head [Head]"
Offset                          = [0.0, 1.0, -1.15]
CollisionCylinderRadius         = 1.5
CollisionCylinderHeightModifier = 1.2

[[Mouth.Position.DepthWaypoints]]
Offset          = [0.0, -5.0, 2.0]
CornerSmoothing = 1.0

[[Mouth.Position.DepthWaypoints]]
Anchor          = "NPC Neck [Neck]"
Offset          = [0.0, 1.0, 1.0]
CornerSmoothing = 0.5

[[Mouth.Position.DepthWaypoints]]
Anchor          = "NPC Spine2 [Spn2]"
Offset          = [0.0, 4.0, 0.0]
CornerSmoothing = 0.0

# -> [DELETE THIS TO DISABLE ORAL MOUTH OPENINGS] <-
# ─────────────────────────
# Mouth Opening Animation
# ─────────────────────────
# Controls facial expressions during blowjob scenes.
# Presets are matched by target orifice and scene context.
# When multiple presets match, the highest Priority wins.
#
# This mouth preset is optional since SexLab already handles mouth opening.
#
[[FacialPreset]]
# Activates when mouth is penetrated
Targets = ["Mouth"]
# Very high priority to make sure it's selected before other presets (If you have others)..)
Priority = 99999
OverrideExpressions = false
OverrideModifiers = false
# Zero out other phonemes that we aren't using
OverridePhonemes = true
Smoothing = 8.0

# Phoneme/Expression/Modifier Effects
# ────────────────────────────────────
# Each effect controls a facial morph target.
#
#   Type        = Effect type ("Phoneme", "Expression", "Modifier", "MFEE")
#   Index       = Morph index number
#   TargetValue = Target blend value (0.0–1.0 for vanilla, higher for MFEE)
#   MinTargetValue      = (Optional) Minimum value when using depth scaling
#   MinPenetrationDepth = (Optional) Depth at which effect starts
#   MaxPenetrationDepth = (Optional) Depth at which effect reaches TargetValue
#
# View the mod page for more advanced configuration options.
#       !You can define UNLIMITED effects per preset!
[[FacialPreset.Effects]]
Type = "Phoneme"
Index = 0
TargetValue = 0.75

[[FacialPreset.Effects]]
Type = "Phoneme"
Index = 1
TargetValue = 0.75

[[FacialPreset.Effects]]
Type = "Phoneme"
Index = 5
TargetValue = 1.0

[[FacialPreset.Effects]]
Type = "Phoneme"
Index = 6
TargetValue = 1.0

[[FacialPreset.Effects]]
Type = "Phoneme"
Index = 7
TargetValue = 1.0

[[FacialPreset.Effects]]
Type = "Phoneme"
Index = 9
TargetValue = 0.68

# ───────────────────────────────────────────────────────────────────────────────
#                                    HANDS
# ───────────────────────────────────────────────────────────────────────────────
#
# Configure handjob detection and grip behavior for each hand.
[Hands.Left]
Enabled              = true
DetectionRadius      = 15.0             # How close the hand must be to activate
GripLength           = 2.0              # Effective hand length
GripOffsetAdjustment = [0.0, 0.0, 1.0]  # Fine-tune grip position (X, Y, Z)

[Hands.Right]
Enabled              = true
DetectionRadius      = 15.0
GripLength           = 2.0
GripOffsetAdjustment = [0.0, 0.0, 1.0]


# ───────────────────────────────────────────────────────────────────────────────
#                                  ANIMATION
# ───────────────────────────────────────────────────────────────────────────────
[Animation]
# How much animation speed affects physics response.
SpeedSensitivity = 1.0

# Smoothing strength for animations (higher = smoother but less responsive).
SmoothStrength = 0.5

# These will push your hips/head back if the penetrator's penis base goes too deep (Clips)
# This is mostly just a random ass feature I added because why not, I doubt it'll look perfect. Go wild. 
# (Head physics is very much NOT recommended. It's not natural looking at all)
HipPhysics = false
HeadPhysics = false

# Smoother for the animations so they don't snap back and fourth. Higher = smooother
HipPhysicsSmoothTime = 0.05
HeadPhysicsSmoothTime = 0.07

# ───────────────────────────────────────────────────────────────────────────────
#                                   SOLVER
# ───────────────────────────────────────────────────────────────────────────────
#
# Controls bending limits for the physics solver.
#
# ⚠️  NOT RECOMMENDED: Changing these makes the solver less accurate.
#     Only modify if you need to restrict extreme bending.
[Solver]

# Base limit (in degrees) for penis bending.
BendConeBase = 999.0

# Extra range per segment.
# Each segment from base to tip gets progressively more flexibility.
# Tip range = BendConeBase + BendConeRange
BendConeRange = 999.01

# ───────────────────────────────────────────────────────────────────────────────
#                               SOUND EFFECTS
# ───────────────────────────────────────────────────────────────────────────────
#
# Controls the procedural sound generation during animations.
# Sounds are triggered based on penetration depth and velocity tracking.
#
[SoundEffects]
Enabled = true

# ─── CLAP SOUNDS ───
# "Clap" sounds play at the moment of impact (when bodies collide at max depth)
# Minimum seconds between clap sounds. Increase to reduce sound frequency.
# Range: 0.05 - 0.5 | Default: 0.10
ClapMinInterval = 0.15

# Minimum thrust velocity required during a stroke to trigger a clap.
# Higher = only fast/hard thrusts make sound. Lower = gentler motion triggers.
# Range: 5.0 - 30.0 | Default: 10.0
ClapThrustVelocity = 8.0

# Minimum penetration depth required to play a clap sound.
# Prevents sounds when barely inserted. Increase if getting unwanted sounds.
# Range: 0.5 - 5.0 | Default: 2.0
ClapMinDepth = 2.0

# ─── WET SOUNDS ───
# "Wet" sounds loop/play continuously during active motion
# Minimum seconds between starting new wet sounds.
# Range: 0.05 - 0.3 | Default: 0.08
WetMinInterval = 0.08

# Velocity threshold to START playing wet sounds.
# Lower = sounds play during slower movement.
# Range: 3.0 - 15.0 | Default: 7.0
WetVelocityThreshold = 3.0

# Velocity threshold to STOP wet sounds (with grace period).
# Should be lower than WetVelocityThreshold to prevent start/stop flickering.
# Range: 0.5 - 5.0 | Default: 1.0
WetStopVelocity = 1.0

# ─── VELOCITY TRACKING ───
# Controls how motion is analyzed to trigger sounds
# Smoothing factor for velocity calculation (0-1).
# Lower = smoother/slower response, Higher = more reactive/jittery.
# Range: 0.1 - 0.5 | Default: 0.3
VelocitySmoothFactor = 0.3

# ─── AUDIO PROPERTIES ───
# Controls pitch and volume variation based on movement speed
# Frequency (pitch) multiplier range. 1.0 = normal pitch.
# Faster movement = higher pitch within this range.
MinFrequency = 0.85
MaxFrequency = 1.35

# Volume range (0.0 - 1.0). Faster movement = louder within this range.
MinVolume = 0.6
MaxVolume = 1.0

# Velocity value that maps to maximum frequency/volume.
# Velocities above this are clamped. Lower = reaches max sooner.
# Range: 50.0 - 200.0 | Default: 150.0
SpeedScaleMax = 150.0

# ─── SOUND FILES ──────────────────────────────────────────────────────────────
# Paths support wildcards (*) to randomly select from matching files.
# Paths are relative to Skyrim's Data folder.
# You can make a LIST of these! The [] thing defines a LIST. Ok?
[SoundEffects.Vagina]
ClapSounds = ["Sound\\Fx\\ppa\\vagina\\clap*.wav"]
WetSounds = ["Sound\\Fx\\ppa\\vagina\\FFFM - *.wav"]
ClapSoundVolumeScale = 0.8
WetSoundVolumeScale = 0.6

[SoundEffects.Anus]
ClapSounds = ["Sound\\Fx\\ppa\\anus\\plap (*.wav"]
WetSounds = ["Sound\\Fx\\ppa\\anus\\Slime (Set E)-*.wav"]
ClapSoundVolumeScale = 1.0
WetSoundVolumeScale = 0.5

[SoundEffects.Mouth]
ClapSounds = ["Sound\\Fx\\ppa\\mouth\\squelch_*.wav"]
WetSounds = ["Sound\\Fx\\ppa\\mouth\\suck_*.wav"]
ClapSoundVolumeScale = 0.25
WetSoundVolumeScale = 1.0

# Hands only use the wet sounds.
[SoundEffects.Hands]
WetSounds = ["Sound\\Fx\\ppa\\hands\\Squish - Handjob Normal-*.wav"]
WetSoundVolumeScale = 0.6

 

Animation Action Tags Tutorial

 

What Are Animation Action Tags?

Animation Action Tags allow you to explicitly tell the mod where each actor's genitals should be targeting during specific animation stages. By default, the mod uses heuristic detection (guessing based on scene context and tags), but this isn't always accurate. Action tags give you precise control.

 

When would you need this?

• The mod is targeting the wrong hole (e.g., vaginal when it should be anal)
• An actor's genitals are clipping through air or the wrong body part
• You want to disable tracking for a specific actor in a scene
• The automatic detection just isn't working for a particular animation

---

 

Understanding the System

 

Target Values
Each actor position (1-5) can have one of these targets:

• V (Vagina) - Target the vagina
• A (Anus) - Target the anus
• M (Mouth) - Target the mouth
• H (Hand) - Reserved for future use (placeholder, does nothing currently)
• ! (None) - Disable tracking entirely. The actor's genitals won't be pushed toward any target.
• b (Auto) - Don't specify the key at all, and the system will figure it out using default heuristics (Doesn't work in manual mode).

 

Actor Positions
Actor positions (1-5) correspond to the order actors appear in the animation framework (SexLab, OStim, etc.). Position 1 is typically the "main" actor, position 2 is the first partner, and so on.

 

Important: The target you set for an actor defines where their genitals go - not what happens to them. So if Actor 2 has target V, Actor 2's penis will target a vagina.

---

JSON File Structure

 

Animation tags are stored in JSON files within the mod's data folder. The mod loads all .json files and merges them together.

 

File Priority (Important!)
Files are loaded in reverse alphabetical order, with later-loaded files taking priority. This means:

• z_something.json - Loaded first (lowest priority)
• a_something.json - Loaded later (higher priority)
• 0_your_custom_tags.json - Loaded last (highest priority)

Your custom tags should go in 0_your_custom_tags.json - this ensures they override any bundled defaults. 0_your_custom_tags.json is used by the in-game menu, so if you want to keep it separate then don't use that file. 

Basic Format

		{
		  "AnimationName": [
		    {
		      "s": 1,
		      "1": "V",
		      "2": "!"
		    },
		    {
		      "s": 2,
		      "1": "V",
		      "2": "!"
		    },
		    {
		      "s": 3,
		      "1": "A",
		      "2": "!"
		    }
		  ],
		  "AnotherAnimation": [
		    {
		      "s": 1,
		      "2": "M"
		    }
		  ]
		}
		

 

Breaking it down:

• "AnimationName" - The exact animation ID from your framework
• "s": 1 - Stage number
• "1": "V" - Actor position 1 targets Vagina
• "2": "!" - Actor position 2 has no target (disabled)

 

Extended Format with Manual Flag

		{
		  "AnimationName": {
		    "manual": true,
		    "stg": [
		      {
		        "s": 1,
		        "1": "V",
		        "2": "!"
		      },
		      {
		        "s": 2,
		        "1": "A",
		        "2": "!"
		      }
		    ]
		  }
		}
		

The "manual": true flag tells the system this animation is fully manually tagged. When set:

• Any actor position not explicitly defined will default to None (disabled) instead of Auto
• Useful when you want complete control and don't want the system guessing

 

---

 

Method 1: In-Game Editing (Recommended)

 

The easiest way to tag animations is using the in-game menu during an active scene.

Steps:

1. Start an animation scene
2. Open the target menu (check your keybinds - by default '0')
3. Look at the actor you want to modify (crosshair targeting)
4. Select the appropriate target (Vagina, Anus, Mouth, None, or Auto)
5. Repeat for other actors/stages as needed
6. Select "Save Changes" to write to your custom file

Note: Changes are applied immediately for testing, but won't persist across game sessions until you save them. The save function writes to 0_your_custom_tags.json.

---

 

Method 2: Manual JSON Editing

 

For bulk edits or when you can't test in-game.

 

Step 1: Find the Animation Name
Enable debug logging in the mod settings. The log will show entries like:

		Status for ActorName: Context:[Anal] Stage:2 ...
		

Or check your animation framework's documentation/tools for animation IDs.

Step 2: Create/Edit Your Custom File
Open 0_your_custom_tags.json in a text editor (create it if it doesn't exist).

Step 3: Add Your Entries

		{
		  "SexLabAnimation_Missionary_A1": [
		    {
		      "s": 1,
		      "1": "!",
		      "2": "V"
		    },
		    {
		      "s": 2,
		      "1": "!",
		      "2": "V"
		    },
		    {
		      "s": 3,
		      "1": "!",
		      "2": "V"
		    },
		    {
		      "s": 4,
		      "1": "!",
		      "2": "V"
		    },
		    {
		      "s": 5,
		      "1": "!",
		      "2": "V"
		    }
		  ]
		}