drives.md

Custom Wine Drive Mappings

RipperMoonToolKit lets each user expose as many host folders as they want inside Wine. The mappings are controlled by GPTK_DRIVE_MAPS.

Format

Use a semicolon-separated list:

export GPTK_DRIVE_MAPS="LETTER=/host/path;LETTER=/another/host/path"

Examples:

export GPTK_DRIVE_MAPS="S=$GPTK_STEAM_LIBRARY;X=$GPTK_EXTERNAL_ROOT/Games;I=$GPTK_EXTERNAL_ROOT/Installers"
export GPTK_DRIVE_MAPS="D=/Volumes/FastSSD;E=/Volumes/Archive;G=/Volumes/GameDrive/Games"
export GPTK_DRIVE_MAPS="S=/Volumes/GameCoreApp/SteamLibrary;X=/Volumes/GameCoreApp/Games;M=$HOME/Mods"

Letters are case-insensitive. d=/Volumes/FastSSD and D=/Volumes/FastSSD both create D:.

If the same letter appears more than once, the later mapping wins because the launcher refreshes symlink-based mappings each time it prepares a prefix.

C: Is Reserved

Do not map C:.

Wine owns C: inside each prefix:

$GPTK_PREFIX_ROOT/<PrefixName>/drive_c

The toolkit refuses C= or C:= style mappings so users cannot accidentally replace the prefix's own Windows drive.

Missing Folders

Mappings are applied only when the target folder exists. This allows one config file to work across machines where not every external drive is mounted all the time.

Example:

export GPTK_DRIVE_MAPS="D=/Volumes/FastSSD;E=/Volumes/Archive"

If /Volumes/Archive is not mounted, E: is skipped for that launch.

When Mappings Apply

Mappings are refreshed when a launcher prepares a prefix:

gptk-launch --prefix MyGame -- ./Game.exe
gptk-launch --prefix MyGame --init
gptk-steam --log

If you change GPTK_DRIVE_MAPS, stop running processes in that prefix and launch again.