Feature compatibility
One table instead of version notes scattered across every page. “Parsed”
means the game accepts the syntax without complaint; “acts” means a shipped
system actually reads it during play. Declare the highest version you rely on
as RequiresEngine in package.xml so the validator checks against it, and
say it in your README, because the game itself does not warn players.
A version marked (unreleased) is not in any public build yet. The syntax is finished and the engine acts on it, but nothing a player has installed reads it, so a pack relying on it waits for that version to ship.
Pack structure
Section titled “Pack structure”From 1.23, the in-game Content Manager is under Menu in the top bar. Settings opens the settings screen. In 1.22 and earlier, open Settings → Content Manager. This changes navigation only, not the pack format.
| Feature | Needs | Parsed | Acts | Content Editor |
|---|---|---|---|---|
Structured packs under resources/packages/ with package.xml |
1.12 | yes | yes | create, edit metadata |
Lowercase resources/ tree (resources/packages/, resources/characters/) |
1.17.1 | yes | yes | follows the game’s layout |
| Drag-and-drop pack install in the Content Manager | 1.16 | n/a | yes | n/a |
Jobs-only packs (manifest plus jobs/) |
1.17.2 | yes | yes | create pack jobs |
ArtStyle= on <Package> and Style= on images (genai included) |
1.17.2 | yes | shown when browsing | edit |
Type="Defaults" packs under packages/defaults/, Type="Addon" reach rules, installer role checks |
1.20 | yes | yes | no (read-only) |
Pack-root image-fallback.xml overlay |
1.20 | yes | yes | no |
RandomGirlNaming / NamePool |
1.15 | yes | yes | shown in the random-template form |
Pack resources (*.resourcesx at the pack root, qualified <pack>/<id>) |
1.17.2 | yes | yes (<Stock> gates, Lua reads and adjusts) |
no |
StorageScope on a resource (estate / building) |
1.20.3 | yes | yes | no |
Characters and images
Section titled “Characters and images”| Feature | Needs | Parsed | Acts | Content Editor |
|---|---|---|---|---|
Typed <Stat> / <Skill> / <Trait> / <Gold> children in .girlsx |
1.15 | yes | yes | edit |
Level 0-30 and Exp as progress within the level, below (Level + 1) × 100 (larger values lowered on load) |
1.23 | yes | yes | edit; Level up to 30, Exp checked against the Level the game reads for her (a <Stat name="Level"> child wins over the attribute, the last of several wins, its name in any case); a stat declared twice or spelled in another case is not edited, nor gold given both as Gold= and <Gold> |
<Inventory> starting items |
1.15 | yes | yes | no |
Virgin= attribute replacing the Virgin trait |
1.15 | yes | yes | edit |
Multi-token filename inference (preg_foot_01.jpg) |
1.15.5 | yes | yes | shown as inferred tags |
Digits split off words in filenames (Oral1.jpg) |
1.15.7 | yes | yes | n/a |
images.xml manifest (Type, Participants, Pregnant, Futa, TiedUp, Style) |
1.15 | yes | yes | edit |
| Lesbian and group scenes only use participants-tagged art | 1.18.1 | n/a | yes | tag participants |
Interact-menu scenes request act tags (masturbate, spanking, rape, torture…) |
1.19 | n/a | yes | tag types |
Every ImageTypes.xml type requestable by name; own art before a substitute (farm, bake, milk) |
1.23 | n/a | yes | tag types |
wm.girl.week_change in Lua: what changed in her stats and skills since the last week began (read-only) |
1.23 | n/a | yes | no |
Walk Around script functions in Lua: wm.stage, wm.street_fight, wm.gangs, wm.player_adjust, wm.game_date, wm.girl_traits, wm.walk_seen, wm.use; enabled and reason on wm.menu options |
1.24 (unreleased) | n/a | yes | no |
Trait InheritChance honoured at birth |
1.18.1 | yes | yes | edit |
| Feature | Needs | Parsed | Acts | Content Editor |
|---|---|---|---|---|
| `<Effect What=“Stat | Skill | Trait | PregAdvance“>` | 1.12 |
<Effect What="GirlStatus">, Controlled with unequip semantics |
1.18.1 | yes | yes | preserved, not editable |
<When> on a single <Effect> |
1.15.5 | yes | yes | preserved, not editable |
Consumable <use> block, Charges=, <auto_use>, <refusal>, <on_use_count> |
1.12 | yes | yes | preserved, not editable |
<auto_use phase="turn_end" source="either" priority=...>, <HasTrait>, remove_trait |
1.15.6 | yes | yes | preserved, not editable |
<on_use_script> running a pack Lua script |
1.15.6 | yes | yes | preserved, not editable |
<Tag> children read by <HasItemTag> |
1.15.6 | yes | yes | preserved, not editable |
Traits
Section titled “Traits”| Feature | Needs | Parsed | Acts | Content Editor |
|---|---|---|---|---|
.traitsx definitions shipped in a pack |
1.12 | yes | yes | create, edit, move |
<effects> types stat, skill, skill_cap, enjoyment, modifier, delta_cap, preg_duration |
1.12 | yes | yes | edit (modifier and delta_cap preserved) |
<Excludes>, <Implies>, <Categories> |
1.15 | yes | yes | edit excludes and implies |
<MutexGroup> |
1.15 | yes | yes | preserved, not editable |
<OnGenerate> / <Periodic> StateFlag rules |
1.15 | yes | yes | preserved, not editable |
| Feature | Needs | Parsed | Acts | Content Editor |
|---|---|---|---|---|
Job data directories (job.xml, effects.xml, performance.xml, wage.xml, gains.xml, messages) |
1.15 | yes | yes | metadata fields and pay settings |
Pack jobs under <pack>/jobs/ with <pack>:<folder> ids; message overlays |
1.17.1 | yes | yes | create, metadata, pay, delete |
Slash spelling for job ids (core/barmaid, <pack>/<folder>); the colon spelling stays accepted |
1.21 | yes | yes | no |
Eleven more skill names (Farming, AnimalHandling, Crafting, Herbalism, Brewing, Cooking, Medicine, OralSex, TittySex, Handjob, Footjob) in characters, templates, job conditions, factors and gains, trait and item effects, and Lua |
1.21 | yes | the four act skills are weighed by Escort; the seven occupational ones are not read yet | no |
Per-building <Settings> the player answers, read by jobs with <BuildingSetting> |
1.21 | yes | yes | switch and number settings, with the game’s refusals |
<Setting type="number" min max default>, read by jobs as setting(<id>) in a <Bind> |
1.21 | yes | yes | the setting yes; setting(<id>) in expressions is not read, so a renamed id is not traced |
<Group observe="...">, <ProductionScale outcome="...">, reason= on a <When> condition |
1.21 | yes | yes (report line and measurement record) | preserved, not shown |
<Counter name add> and counter(<name>) in a <Bind>: a per-shift limit shared across the estate; an observed group with no effects is kept |
1.21 | yes | yes | preserved, not shown |
Once="true" on an <Item>: a consumable that changes a character once |
1.21 | yes | yes | read and written (a checkbox beside Infinite; off removes the attribute); both flags are read as the game reads them, and a value other than true or false is a validator error |
| Trait gains reported: the flip with its cause, one practice line a week | 1.21 | no change to the format | yes | no |
<BrothelStat key="filthiness">, <RandomChance bind="...">, message on <Resource>; an empty ${pick:} inserts nothing |
1.21 | yes | yes | preserved, not checked |
state(<key>) in a <Bind>; scale="false" on <Resource>; message-line binds computed with the shift’s sources; a withheld line’s <Enjoyment> and <SetBrothel> withheld with it |
1.21 | yes | yes | preserved, not checked |
picked(<text id or prefix>) in a <Bind>: 1 when the shift’s picked line has that id prefix |
1.21 | yes | yes | preserved, not checked (bind expressions are not parsed) |
<Resource> inside a <RandomChoice><Option> (no sale); <SetStat target="brothel.others" temporary="true">; message <When> reading an effects.xml bind |
1.21 | yes | yes | preserved, not checked (the editor does not write job effects or messages) |
<Resource reduce="N">; <SetStat delta_min delta_max> inside an <Option>; <Text weight="$bind"> on work lines; setting(<switch>) reading 1 or 0 |
1.21 | yes | yes | preserved, not checked (the editor does not write job effects or messages) |
<Gear>combat</Gear> in job.xml; <Action> and <Records> documented |
1.21 (<Action> and <Records> are older, only now on this page) |
yes | yes | job.xml: the seven metadata fields are edited; <Action>, <Records> and <Gear> are preserved untouched, not checked |
<TradeForWorker>: give stored resource, receive a worker |
1.21 | yes | yes | no |
value on a sale="true" consume, for per-stock takings in Accounting |
1.21 | yes | yes | no |
<When> on a <RandomChoice> option |
1.21 | yes | yes | no |
<DefaultImage> and per-<Text> Image= |
1.15.5 | yes | yes | DefaultImage only |
Participants= on <Text> |
1.18.1 | yes | yes | no |
<Filter> and <Phase> |
1.17.1 | yes | yes | edit |
wage.xml channel="earnings" and <Salary> |
1.19 | yes | yes | edit |
messages/refuses.xml, <RefusalReason>, <Dignity> / <Fear> / <Obedience> |
1.17.1 | yes | yes | no |
messages/banks.xml fragment composition (${pick:...}) |
1.15.6 | yes | yes | no |
<RandomChoice> event branches and <Outcome> in a work bank |
1.20 | yes | yes (arena jobs for <Outcome>) |
no |
<Stock>, <BrothelStat>, <HasItemTag>, <HasStateFlag>, <BrothelScratch> leaves |
1.15.6 | yes | yes | no |
<JobState scope="customer"> |
1.15.6 | yes | no shipped job establishes a customer scope yet | no |
<Mod name="work.*"> synergy hooks |
1.15.6 | yes | most are placeholders (see the effects reference) | no |
<GainTrait> / <LoseTrait> with <Curve> and minShifts |
1.15.6 | yes | yes | no |
gains.xml: an attribute the game does not read on <Gains>, <Skill> or <Stat> (such as Max for max) is named in gamelog.txt with its line; the job still loads |
1.23 | no change to the format | yes | no |
| Job expectations model (requirements, fit, preparedness) | not shipped | no | no | no |
Scripts and tools
Section titled “Scripts and tools”| Feature | Needs | Parsed | Acts | Content Editor |
|---|---|---|---|---|
triggers.xml with Type="Meet" / Type="Talk" and a per-character .lua |
1.12 | yes | yes | no |
wm.create_named_girl, wm.give_player_random_special_item |
1.15.6 | n/a | yes | n/a |
wm.is_tortured / wm.mark_tortured |
1.18.1 | n/a | yes | n/a |
Pack validator on every platform, --autofix, VS Code tasks, scaffold-new-pack.py |
1.15.6 | n/a | n/a | n/a |
WhoreMasterRenewal --video-probe |
after 1.20.0 | n/a | n/a | n/a |
| Gang mission outcome tables | core only | n/a | n/a | no |
Building packs (buildings/<folder>/building.xml: for sale, rooms, upkeep, jobs, flows) |
1.21 | yes | yes | no |
If a feature you rely on is missing from this table, it has not been verified against a version and should be treated as undocumented.