Custom Expression JSON¶
Every emotion's look is data. Profiles live in:
Bundled profiles: Expression_aroused.json, Expression_trauma.json, Expression_dirty.json, Expression_pain.json, Expression_Random.json. Edit these or ship your own — they're loaded at runtime via PapyrusUtil, no recompile required.
File shape¶
{
"floatList": {
"female1": [0, 0, 0, 0, 0, 0.3, 0.1, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 10, 0],
"female2": [ ... ],
"...": [ ... ],
"male1": [ ... ],
"...": [ ... ]
},
"string": {
"name": "aroused"
}
}
- Up to 7 phases per gender:
male1–male7andfemale1–female7. Phase selection is driven by emotion intensity, so phase 1 is the mildest and higher phases are stronger. - Each phase is a 32-float array.
The 32-float array¶
| Index | Group | Meaning | Range |
|---|---|---|---|
| 0–15 | Phonemes | Aah, BigAah, BMP, ChJSh, DST, Eee, Eh, FV, I, K, N, Oh, OohQ, R, Th, W | 0.0–1.0 |
| 16–29 | Modifiers | BlinkL/R, BrowDownL/R, BrowInL/R, BrowUpL/R, LookDown, LookLeft, LookRight, LookUp, SquintL/R | 0.0–1.0 |
| 30 | Expression | Base expression ID (see below) | 0–16 (whole number) |
| 31 | Strength | Strength of the index-30 expression | 0.0–1.0 |
All values are floats in 0.0–1.0, except index 30, which is a whole number 0–16.
Index 31 = 0 means dynamic
If index 31 (strength) is set to 0, CEE applies a dynamic strength based on the current condition instead of a fixed value.
Expression IDs (index 30)¶
| ID | Expression | ID | Expression |
|---|---|---|---|
| 0 | Dialogue Anger | 9 | Mood Fear |
| 1 | Dialogue Fear | 10 | Mood Happy |
| 2 | Dialogue Happy | 11 | Mood Sad |
| 3 | Dialogue Sad | 12 | Mood Surprise |
| 4 | Dialogue Surprise | 13 | Mood Puzzled |
| 5 | Dialogue Puzzled | 14 | Mood Disgusted |
| 6 | Dialogue Disgusted | 15 | Combat Anger |
| 7 | Mood Neutral | 16 | Combat Shout |
| 8 | Mood Anger |
Avoid ID 16 (Combat Shout)
Combat Shout opens the mouth like a phoneme. Don't use it unless you have a specific reason.
Paired modifiers¶
Brow and eye modifiers come in left/right pairs (e.g. SquintLeft + SquintRight, BrowUpLeft + BrowUpRight). If both halves of a pair use the same value, they're applied simultaneously for a symmetric result.
These modifiers stop the eyes blinking
BlinkLeft, BlinkRight, LookDown, LookLeft, LookRight, and LookUp will hold the eye and prevent natural blinking while active. Use sparingly.
Worked example¶
"female3": [0, 0, 0, 0, 0, 0.5, 0, 0, 0, 0, 0, 0.6, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0, 0.8, 0.8, 2, 0.8]
This phase reads as:
- index 5
Eeephoneme @ 50% - index 11
Ohphoneme @ 60% - index 28/29
SquintLeft/SquintRight@ 80% (applied together) - index 30 =
2(Dialogue Happy), index 31 =0.8strength
Visual reference
The MFG phoneme/modifier set is documented with pictures here: Steam guide 187155077.
Testing your preset¶
Use the Maintenance MCM page: the test expression tool lets you pick a type and a specific phase and play it on demand, so you can iterate on a phase without waiting for the in-game condition to occur.