Skip to content
Game Project Docs

Tagging walkthrough

“I have a folder of images and I don’t know what to name them.” This is the most common first-pack problem. Work through it image by image.

The questions to ask each image

Section titled “The questions to ask each image”

For every image, in order:

  1. Is she visibly pregnant? If yes, the category name needs a preg prefix.
  2. What act is happening? That’s your base category.
  3. Who else is in the image? Solo, with a male, with another girl, with multiple people.
  4. Is she bound or restrained? If yes and the image isn’t already BDSM, you may want a manifest entry.
  5. What clothing state? Dressed, stripping, nude. If it’s not mid-act, this matters.

Most images only need question 1 and 2 answered. You can get to a shippable pack on those alone.

Worked examples

Section titled “Worked examples”

Example 1: a portrait

Section titled “Example 1: a portrait”

A headshot of the girl smiling in normal clothes.

  • Not pregnant.
  • No act happening.
  • Solo.

Category: profile. Name it profile01.jpg or put it in Profile/.

Example 2: vaginal sex scene

Section titled “Example 2: vaginal sex scene”

Image of her mid-sex with a male partner, fully nude, not pregnant.

  • Not pregnant.
  • Sex act is vaginal.
  • With a male (the default, not notable).

Category: sex. Name it sex01.jpg or put it in Sex/.

Example 3: same girl, pregnant, nude

Section titled “Example 3: same girl, pregnant, nude”

Standalone pregnant nude.

  • Pregnant.
  • No act; she’s alone.

Category: pregnant (the pregnant-specific profile category). Name it preg01.jpg or put it in Pregnant/.

If you want it specifically flagged as nude-with-belly (not a profile substitute), use prenud or a manifest entry with types="nude" pregnant="yes".

Example 4: pregnant sex scene

Section titled “Example 4: pregnant sex scene”

Mid-sex image where her belly is showing.

  • Pregnant.
  • Sex act is vaginal.

Category: pregsex. Name it pregsex01.jpg or put it in PregSex/.

Example 5: BDSM, tied up

Section titled “Example 5: BDSM, tied up”

She’s bound and being spanked.

  • Not pregnant.
  • BDSM act (spanking specifically, but BDSM is the parent).
  • Tied up is an extra tag.

Simplest: name it bdsm01.jpg or put it in BDSM/. The engine picks it up.

If you have both tied and untied BDSM variants and want the engine to prefer the right one contextually, add an images.xml manifest:

<Image File="BDSM/tied01.jpg"   types="bdsm" tied="yes" />
<Image File="BDSM/untied01.jpg" types="bdsm" tied="no" />

Example 6: lesbian scene

Section titled “Example 6: lesbian scene”

Two girls, no males.

  • Not pregnant.
  • Sex act, but between two women.
  • Participants: lesbian.

Category: lesbian. Name it lesbian01.jpg / les01.jpg or put it in Lesbian/.

The engine routes Lesbian/ folders to sex images with participants=lesbian, so the lesbian scene picker finds them automatically.

Where it shows up in the Gallery: under the Sex row, not under a separate Lesbian row. To verify the image was tagged correctly, open the Sex row and cycle the Participants filter at the top of the gallery from Any to Lesbian. The image should appear. If it shows up under the <UNMATCHED> row instead, the folder name wasn’t recognised; check spelling.

For finer participant shapes (FFM / MMF / orgy), use an images.xml manifest.

Example 7: footjob, handjob, masturbation

Section titled “Example 7: footjob, handjob, masturbation”

Hand-only or foot-only stimulation, or a solo masturbation shot.

  • Not pregnant.
  • Catalog has foot, hand, and finger, but no footjob, handjob, masturbation, or fingersolo.

Folder names: use Foot/, Hand/, Finger/. Filenames: foot01.jpg, hand01.jpg, finger01.jpg.

If you specifically want a solo masturbation tag (no partner), add an images.xml entry:

<Image File="Finger/solo01.jpg" types="finger" participants="solo" />

Folders named FootJob/, HandJob/, Masturbation/, FingerSolo/ are not recognised; files inside go to <UNMATCHED>.

Example 8: strip tease

Section titled “Example 8: strip tease”

She’s mid-strip, partially clothed, no partner.

  • Not pregnant.
  • Strip is its own type in the 86-entry catalog.

Category: strip. Name it strip01.jpg or put it in Strip/.

Pre-1.11, strip wasn’t recognised by the engine and got dumped into Other or Profile. From 1.11 onward it’s auto-detected.

Example 9: bedroom, clothed, no partner

Section titled “Example 9: bedroom, clothed, no partner”

Dressed, lying on a bed, looking at camera.

  • Not pregnant.
  • No active act; context is bedroom.

Category: bed (if it’s bedroom-specific intimacy) or profile (if it’s just a pose). Use your judgement. bed is in the 86-entry catalog for intimate-but-not-act bedroom shots.

Example 10: dungeon / jail cell

Section titled “Example 10: dungeon / jail cell”

She’s locked up, fully clothed, looking miserable.

Category: jail. Name it jail01.jpg or put it in Jail/. The dungeon screen pulls from this category specifically.

Example 11: combat pose

Section titled “Example 11: combat pose”

She’s mid-fight, weapon drawn.

Category: combat. Name it combat01.jpg or put it in Combat/.

Combat images show up in gang-fight and catacomb scenes.

When to reach for the manifest

Section titled “When to reach for the manifest”

Filename and folder conventions cover 90% of packs. Use images.xml when:

  • You need tied="yes"/"no" variants and both share a category.
  • You have mixed participants within a single folder (a Sex/ folder with solo, lesbian, and group images).
  • Your source material has filenames that can’t be renamed (e.g. you’re wrapping a photoset with fixed names).

If you’re unsure, start with filenames. Add a manifest only when you hit something filenames can’t express.

Validate as you go

Section titled “Validate as you go”

Every few images, run the pack validator and load in-game to spot-check the Gallery. The sooner you catch a bad category, the less renaming you’ll do later.