Skip to content

Mod Events API

CEE integrates with other mods through SKSE mod events. You can suspend it during your own scenes, or feed it arousal modifiers.

Events CEE listens for

dhlp-Suspend / dhlp-Resume

The standard "device hider / scene" suspend protocol. Send dhlp-Suspend to pause CEE's expressions for the duration of your scene, and dhlp-Resume to release it. Any mod already using dhlp events works automatically.

; Pause Conditional Expressions during your scene
SendModEvent("dhlp-Suspend")
; ... your scene ...
SendModEvent("dhlp-Resume")

ostim_start / ostim_end

OStim's scene events. CEE maps these internally to suspend/resume, so OStim scenes pause expressions without any patch.

CondiExp_SLAEvent

Arousal-modifier event. CEE both listens for and emits this. Payload (as used internally):

Arg Meaning
Number arg Arousal threshold
(decrease) Amount to decrease arousal by
String arg Notification text / effect name
Form arg The actor

Use it to apply your own arousal modifier the same way CEE's built-in rain/pain/swim/headache modifiers do.

Events CEE emits

CondiExp_SLAEvent

Sent by CEE to itself (via SendSLAModEvent()) for arousal-cap processing. If you build on the SexLab Aroused exposure/cap pipeline, this is the hook CEE uses.

Voice mods: telling CEE the player is speaking

CEE does not define an event for this, and a voice mod does not need CEE support. With Keep expressions during dialogue on, CEE asks AudioUtil one question before it writes phonemes as part of an expression:

AudioUtil.IsMouthBusy(PlayerRef)

That already covers ordinary NPC dialogue, AudioUtil's own lines, and player-voice mods that hand their lines to the game (DBVO speaks through Player.SpeakSound, so the engine allocates dialogue data as usual). Nothing to do in those cases.

The one case it cannot see on its own is a mod that plays the dialogue audio itself — which is what a dialogue camera forces, since the engine plays nothing unless the player's head is rendered. Such a mod announces the line, and it appears in IsMouthBusy for CEE and every other consumer:

AudioUtil.ClaimMouth(PlayerRef, fLineLengthSeconds, "MyVoiceMod")
; ... play the line, drive the mouth from its .lip ...
AudioUtil.ReleaseMouth(PlayerRef, "MyVoiceMod")

The claim is a deadline (capped at 30 s), so a line that is skipped or a mod that dies mid-line cannot leave the mouth stuck; SKSE plugins can call the same thing in C++ via AudioUtil_ClaimMouth. Requires AudioUtil 0.9.19+ (Papyrus API v8).

Status globals

Beyond events, CEE exposes global variables you can read or override from your own scripts/console:

Global Purpose
Condiexp_CurrentlyCold Current cold status
Condiexp_CurrentlyTrauma Current trauma status
Condiexp_CurrentlyDirty Current dirtiness status
Condiexp_CurrentlyAroused Current arousal status
Condiexp_ModSuspended 1 while the mod is suspended
Condiexp_MinAroused / Condiexp_MinDirty / Condiexp_MinTrauma Thresholds (see Console Commands)

Tip

Reading these is the lightest way to know what CEE currently thinks about the player without parsing facial state.