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:
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.