RaceConfig Override System

Overview

accurate-penetration.toml supplies the default RaceConfig. Files in ppa-override-configs can then replace or layer fields for actors that match race and predicate rules.

Every override is evaluated as a predicate set. A race restriction is just a race predicate, and an override with no predicates matches every actor. Use that intentionally for fallback configs or broad overlays.

Main Config

The main file is loaded from:

Data/SKSE/Plugins/accurate-penetration.toml

It can contain global behavior sections plus the same RaceConfig tables documented below. Those root-level RaceConfig fields become Settings::Defaults, which is the base for normal overrides.

General

Hotkeys and Debug

Override Files

Race override files are loaded from:

Data/SKSE/Plugins/ppa-override-configs/

Files are sorted by filename in reverse alphabetical order. The first loaded file receives the lowest priority, and priority increases as loading continues. In practice, a file such as 00_high_priority.toml loads after 99_fallback.toml and wins over it.

A file can be a single root-level override or can contain multiple [[Override]] tables.

# Single override file
Races = ["Skyrim.esm|013745"]
Inherits = "default"

[Vagina]
Scale = 2.5

# Multiple overrides in one file
[[Override]]
Races = ["Skyrim.esm|0131E8"]

[Override.Penis]
Bones = ["BearD 4", "BearD 5", "BearD 6"]
LocalForwardAxis = [1, 0, 0]

[[Override]]
Races = ["Skyrim.esm|0131E7"]

[Override.Penis]
Bones = ["WolfPenis01", "WolfPenis02", "WolfPenis03"]
LocalForwardAxis = [1, 0, 0]

Inheritance

Inherits controls how an override is initialized before its own fields are applied.

Resolution

When the plugin needs a config for an actor, it walks matching overrides in priority order.

Only overlays above the selected base are applied. A lower-priority overlay below the chosen base is not considered for that actor.

FormIDs

Race restrictions can be written as Races, Race, PenetratedRaces, or PenetratedRace. Each accepts either a string or an array of strings.

Races = [
    "Skyrim.esm|013745",       # plugin-local ID, recommended
    "Dawnguard.esm|00283A",
    "0x0200C5F0",              # full runtime FormID
]

With PluginName|LocalID, the loader resolves normal and light plugins through Skyrim's data handler. Without a plugin name, strings with seven or more hex characters are treated as full runtime FormIDs; shorter strings default to Skyrim.esm.

Predicates

Predicates can live directly on the override through race keys, or under a [Predicates] table. All predicates must pass.

Races = ["Skyrim.esm|013745"]

[Predicates]
IsSex = [1]
HasAllBones = ["VaginaB1", "Clitoral1"]

[Vagina]
Scale = 2.0

Scope

Use race keys for stable per-race configs, bone predicates for skeleton-family fallbacks, and any overlays for small cross-cutting changes.

# Skeleton-family fallback for actors with a known creature schlong chain
Inherits = "default"

[Predicates]
HasOneBone = ["CreaturePenis01", "MonsterSchlong01"]

[Penis]
Bones = ["CreaturePenis01", "CreaturePenis02", "CreaturePenis03"]

Orifice Positions

[Vagina.Position], [Anus.Position], and [Mouth.Position] share the same shape.

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

[[Vagina.Position.DepthWaypoints]]
Offset = [0.0, 0.7, 6.0]
CornerSmoothing = 1.0

[[Vagina.Position.DepthWaypoints]]
Anchor = "NPC Spine1 [Spn1]"
Offset = [0.0, 6.0, 0.0]
CornerSmoothing = 0.5

Opening Physics

[Vagina] and [Anus] define opening bones and response strengths.

Penis

[Penis] defines the penetrator chain, orientation, and solver-facing behavior.

Animation

Hands

[Hands.Left] and [Hands.Right] use the same fields.

Solver

[Solver] controls the bend cone used by the penis spline solver.

Facial Presets

RaceConfig includes the facial preset list. Because the list is part of the inherited config, a default-inheriting override keeps inherited presets and appends any [[FacialPreset]] entries it defines. Use Inherits = "" when you need a completely blank facial preset list.

In an array-style override, use [[Override.FacialPreset]] and [[Override.FacialPreset.Effects]]. See Facial Expressions for the full preset format.

Example: Named Base

Inherits = "default"

[Penis]
Bones = ["CDPenis 1", "CDPenis 2", "CDPenis 3", "CDPenis 4"]
LocalForwardAxis = [1, 0, 0]
BaseOffset = [0, 0.5, 0]
PreserveHavokState = true

Inherits = "80_canine_base"
Races = ["Skyrim.esm|0131E7", "Skyrim.esm|0131E9"]

[Penis]
Girth = 0.55
TipExtension = 0.25

Example: Any Overlay

This high-priority overlay applies a small adjustment to any matching female actor after the base config is selected.

Inherits = "any"

[Predicates]
IsSex = [1]

[Animation]
HeadPhysics = true
HeadPhysicsSmoothTime = 0.10

[Vagina]
GripStrength = 4.0

Debugging

Enable config logging while setting up inheritance chains and overlays.

[Debug]
Logging = true
Bones = true
Collision = true
Penis = true

The log reports override loading, inheritance warnings, cycles, missing named bases, and loaded override counts.