Filename cheatsheet

The one-page “what do I name this image” lookup. Print it, pin it, keep it open.

Two formats, both fine

Subfolder: the folder name is the category. Filenames inside don’t matter.

Characters/Jane/Sex/whatever.jpg

Prefix: the filename starts with the category.

Characters/Jane/sex01.jpg

Use whichever you prefer. You can mix them in the same girl folder.

Base categories

Categories the engine recognises as folder names and filename prefixes. Each maps to a gameplay situation.

Category	Prefix / Folder	When it’s used
Profile	profile / Profile	Character list, dialogue, girl details
Sex	sex / Sex	Vaginal scenes, whore job, customer events
Anal	anal / Anal	Anal scenes
Oral	oral / Oral	Oral scenes (accepts bj / blowjob aliases)
Lesbian	lesbian / Lesbian	Same-sex scenes (accepts les alias)
Group	group / Group	Threesome or larger
BDSM	bdsm / BDSM	Any bondage / punishment scene
Beast	beast / Beast	Bestiality
Torture	torture / Torture	Dungeon torturing
Jail	jail / Jail	Dungeon / prison cell (accepts prison alias)
Death	death / Death	Death screen
Pregnant	pregnant / Pregnant	Profile slot when she’s visibly pregnant (accepts preg alias)

Any other catalog type works the same way. Named folders like Strip/, Nude/, Bed/, Combat/, Milk/, Swim/, Ecchi/, Kiss/, Dance/, Maid/, etc. are all auto-recognised because they’re in the catalog.

Folders you’d expect, but the engine doesn’t know

These look like they should work but don’t, because the catalog uses different names:

You wrote	Use this instead
FootJob/	Foot/ (catalog name is foot)
HandJob/	Hand/ (catalog name is hand)
FingerSolo/	Finger/ + manifest entry with Participants="solo"
Masturbation/	Finger/ + manifest entry with Participants="solo"

Files in unrecognised folders are tagged <UNMATCHED> and don’t show up in scenes. If you want one of these names to keep working, add an images.xml manifest entry per file (see image-types.md).

Lesbian and Group: how they appear in-game

Lesbian and Group are not catalog types. They’re participant tags on sex images. The engine resolves Lesbian/, Les/, Group/, BJ/, Blowjob/ folder names to the right base type plus the right participants tag.

This means the in-game Gallery shows lesbian and group images under the Sex row, not as separate Lesbian / Group rows. To filter to just lesbian or group images, use the Participants cycler at the top of the gallery (the < > arrows next to the participants label).

Scene picking works correctly without any extra effort: when the game asks for a lesbian or group image, the participant filter does its job behind the scenes.

For finer control (FFM / MMF / Orgy / Solo, etc.), use an images.xml manifest; see image-types.md.

Pregnant variants

Add preg in front of any base category to tag the pregnant version of that scene.

Folder / Prefix	Meaning
PregSex	Sex scene, girl is pregnant
PregAnal	Anal scene, girl is pregnant
PregOral	Oral scene, girl is pregnant
PregBDSM	BDSM scene, girl is pregnant
PregBeast	Beast scene, girl is pregnant
PregLesbian	Lesbian scene, girl is pregnant (accepts PregLes alias)
PregGroup	Group scene, girl is pregnant
Pregnant	Pregnant profile portrait (bare preg / pregnant also works)

The engine uses these to swap in pregnant art when the girl is showing, and to keep pregnant images out of rotation when she isn’t.

The full 88 types

The categories above are the common ones and cover most packs. The full set lives in resources/data/ImageTypes.xml and includes 88 named types (strip, nude, titty, foot, hand, cowgirl, missionary, doggy, deepthroat, dildo, fisting, ecchi, swim, bed, combat, milk, and many more).

The game auto-recognises every type in that catalog as a folder name and filename prefix. If you drop a folder named Milk/ into a girl’s directory, the engine finds it.

Heads up — not every catalog type triggers in-game image requests. Roughly 36 of the 88 are wired all the way through to shift events, dungeon panels, gallery rows, etc. The other ~50 (positions like cowgirl/missionary/doggy, acts like deepthroat/fisting/dildo, and other authoring-surface entries) are gallery-only today: the engine finds your art and lists it as a gallery row, but no shipped job or message bag requests them by name during gameplay. So a Cowgirl/ folder will show as a gallery row but won’t paint shift portraits. See image-types.md – “What the engine actually requests” – for the exact wired-vs-catalog-only split.

For the full list and fallback graph (what happens when a category has no images), see image-types.md.

Stacking tokens

Filenames are split on _, -, ., and whitespace, and every token is matched against the catalog. So preg_foot_cumshot.jpg is tagged foot, cumshot, and pregnant=yes all at once. You can lean on this instead of writing manifests for common combinations. See image-types.md for the exact rule and when a manifest is still preferred.

Aliases

The engine recognises these shorthand aliases:

Category	Primary	Aliases
Oral	oral	bj, blowjob
Lesbian	lesbian	les
Group	group	(none; routes to sex + Gangbang participants)
Jail	jail	prison
Pregnant	pregnant	preg

Pregnant-prefixed versions of the aliases (pregles, pregbj, pregblowjob, preggroup) also work. Everything else matches the catalog names directly. There are no -job aliases: use the bare catalog names foot, hand, finger.

Rules

• Matching is case-insensitive. PROFILE/, Profile/, and profile/ are the same folder.
• Subfolder takes priority over prefix. If a file is in Sex/ but named profile01.jpg, the engine treats it as Sex.
• Files with an unrecognised prefix and no known subfolder are tagged <UNMATCHED> (visible as a row in the Gallery). They don’t participate in scene picking. Earlier versions silently dumped these into the profile pool, which polluted portraits with stray scene art; the new behaviour is intentional.
• Depth is 1 level. Images inside Profile/subfolder/ are found, but Profile/sub/subsub/ isn’t.

Recognised file extensions

.jpg, .jpeg, .png, .gif, .webp, .mp4, .webm, .avi, .mkv, .mov

All case-insensitive.