Install
The game ships as a portable build: no installer, no registry entries, no admin rights. You download an archive, extract it, and run it from the extracted folder.
1. Install and first launch
Section titled “1. Install and first launch”Download the build for your system from the downloads page, then follow your system’s tab. The quirks below are the real reasons first launches fail; none of them are bugs in your download.
-
Extract the zip into its own folder anywhere you like. Extract it fully. Running the exe from inside the zip preview window will not work.
-
Run
WhoreMasterRenewal.exe. -
If SmartScreen shows “Windows protected your PC”, click More info, then Run anyway. The build is not signed, so this appears once and then never again.
-
Extract the zip and move the whole extracted folder somewhere outside Downloads, Desktop, Documents and iCloud Drive. Your home folder or a Games folder are fine. macOS restricts what apps can read in those protected places, and the game needs to read its own files.
-
Clear the download-quarantine flag once:
- From 1.18.1: double-click
Fix macOS quarantine.commandin the game folder. If macOS complains about it, right-click it and choose Open. It repairs the whole folder and starts the game. - On 1.18.0 and older: open Terminal, type
xattr -dr com.apple.quarantinewith a trailing space, drag the game folder onto the window, press Return.
- From 1.18.1: double-click
-
From then on, double-click
WhoreMasterRenewal.applike any app.
-
Extract the tarball:
Terminal window tar -xzf wmcrossgate-*-linux-*.tar.gz -
Start the game with the launcher script from the extracted folder:
Terminal window ./run.shNot the bare binary: the launcher points the game at its bundled libraries; the binary alone will pick up whatever your distro has and may not start.
2. Sample content
Section titled “2. Sample content”From 1.21 the game ships without test characters. resources/characters/ is
empty and is yours to fill. A small Base Roster pack of random characters,
drawn with the default images, gives a new game people to meet, buy and find
before you install anything. The example packs for pack makers sit in
examples/packs/, next to resources/, and the game does not load them.
Unpacking 1.21 over an older version cleans up by itself: at startup the game
removes the sample files older versions shipped. A file you edited is moved
to a retired-files/ folder instead of being deleted. In an existing save,
anyone working for you stays, characters from the removed files leave the
market, and items and traits from the sample packs disappear, along with the
stat bonuses those items gave.
On 1.20 or older, the sample content is still live. To clear it by hand,
delete everything inside resources/characters/ and the Sample_* folders
under resources/packages/.
3. Add character packs
Section titled “3. Add character packs”Character content loads from two places, and both are live at the same time:
| Location | Format | Use it for |
|---|---|---|
resources/characters/ |
Legacy: loose .girlsx / .rgirlsx files + a folder per unique girl |
Most Collection drops today |
resources/packages/ |
Structured pack: one folder per pack with package.xml at its root |
New packs; can also carry traits, items, jobs and scripts, declare dependencies, and be toggled per pack |
Legacy packs (loose .girlsx / .rgirlsx)
Section titled “Legacy packs (loose .girlsx / .rgirlsx)”Legacy packs have no package.xml, so the in-game drag-and-drop installer
can’t take them; they go in by hand. Extract so the files land directly
in resources/characters/, not
inside a subfolder (anything one folder deeper is silently ignored):
resources/characters/ RandomJobs.rgirlsx RandomFantasyGirls.rgirlsx <girl-name folder for each unique the packs ship>Everything at this top level acts as one big pack. Two legacy packs defining the same girl name will collide, and you’ll have to pick one.
Structured packs (folder with package.xml)
Section titled “Structured packs (folder with package.xml)”The easy way: drag and drop, in-game. From 1.23, open Menu → Content Manager (the screen inside the game; the separate Content Editor app is for making packs, not installing them). In 1.22 and earlier, use Settings → Content Manager. Then drag the pack onto the game window: the downloaded .zip as-is, or the extracted folder, both work. The game checks the pack before installing, puts it in the right place itself, and tells you on screen what happened. It won’t overwrite a pack you already have. Drops are only accepted while the Content Manager is open; anywhere else in the game they’re ignored on purpose.
The manual way does the same thing by hand: drop the whole pack
folder into resources/packages/. Don’t unpack it further, don’t merge it
with another pack:
resources/packages/ MyPack/ package.xml Girls.girlsx Characters/ Jane/ Profile/ ...If the pack requires another pack (declared in its package.xml), install
that one the same way; missing dependencies are reported in the Content
Manager instead of girls silently vanishing.
Mixing both layouts is fine and expected. For the full breakdown, see Where packs go.
4. Verify
Section titled “4. Verify”-
Launch the game.
-
Load a save or start a new game.
-
Open Menu → Content Manager from 1.23, or Settings → Content Manager in 1.22 and earlier.
The Content Manager lists every loaded character with a status. Every row
should be OK. If a row isn’t, the right-hand panel explains why: usually a
missing image folder, a Name that doesn’t match its folder, a malformed
XML block, or an unmet dependency. Fix the pack on disk and restart; the
Content Manager re-reads on every game load.
1.24 (unreleased) rebuilds the Content Manager. The left side lists All content, Packs, then Characters, Items, Traits, Jobs and Buildings, and Problems. A row’s status is a small icon; hold the pointer over it for the reason. Open Problems to see everything that failed in one list: a folder no pack owns, a pack that needs another one that is not installed, a job that did not load. Select a pack and press Enter to open its own page. A pack installed while the game is running may show Restart to apply: save, close the game and start it again.
The Content Manager shows what is installed and lets you install more. It
does not edit packs, and in 1.24 it cannot yet switch a pack off or remove
one: to remove a pack, delete its folder from resources/packages/ while the
game is closed.