dayz-workdrive
Mounts or unmounts P:\ as the DayZ work drive without opening the DayZ Tools GUI. Windows-only and idempotent. Use when P:\ is not mounted (usually after a reboot) before any other DayZ skill, or when
SKILL.mdskills/dayz-workdrive/SKILL.md
GitHub<!-- skill-dir-note -->
Path note:
<skill-dir>in commands below is the absolute path of this skill's folder. When the agent loads this skill the harness exposes the skill's base directory; substitute it before running. Sibling skills are reached via<skill-dir>\..\dayz-X\.
/dayz-workdrive
Mount P:\ for DayZ modding without DayZ Tools' GUI.
Follow skills/_shared/dayz-conventions.md. This skill does not gate on /dayz-preflight, because preflight fails until P:\ is mounted and this skill is what mounts it.
How to run
python "<skill-dir>\mount.py" # resolve and mount
python "<skill-dir>\mount.py" --path "C:\Path\To\WorkDrive" # explicit folder
python "<skill-dir>\mount.py" --unmount
python "<skill-dir>\mount.py" --unmount --force # unmount even while DayZ Tools or DayZDiag runs
scripts\setup\workdrive.bat takes the same arguments for users running it outside Claude Code.
What it does
Off Windows it exits 1 with [FAIL] Windows-only: ... and runs nothing. On Windows:
If
P:\is already mounted, prints[OK]with the folder it points to and exits 0. If--pathnames a different folder, it also prints a[WARN]: the mount is left alone, so run--unmountfirst to switch folders. WhenP:\is a volume or network drive rather than a folder mapping, any--pathgets the same[WARN], because the skill cannot tell whereP:\points. IfP:\is not visible but the letter is still taken, it exits 1 before resolving anything. The skill reads the letter's mapping withQueryDosDeviceW("P:"), not just whetherP:\opens. A folder mapping whose folder was renamed, deleted or sits on an unplugged disk prints[FAIL] P: is mapped to a missing folder <folder>; run --unmount to remove the stale mapping, then mount again.An unreachable volume or network drive onP:prints the device and says to free the letter in Disk Management or withnet use P: /delete.Resolves the work-drive folder, taking the first candidate that exists:
--path(fails if it is not a directory). A relative--pathis made absolute against the current folder first, so the folder that is mounted and cached is the same one from any later run$DAYZ_WORK_DRIVE, made absolute against the current folder like--path. If it is set but is not a folder (for example a typo), the skill prints[WARN] $DAYZ_WORK_DRIVE is set to <value>, which is not a folder; ignoring it.and tries the next source- The path cached by a previous successful run in
<project>\.claude\local-memory\dayz-work-drive.json(a cache file that is not valid JSON, or not a{"work_drive_path": "<folder>"}object, counts as no cache), where<project>is$CLAUDE_PROJECT_DIR, else the nearest folder at or above the current directory whose.claude\local-memory\holds the/dayz-initproject cache, else the clone that holds the skill scripts when that clone has the cache, else the current directory (the same rule/dayz-inituses, so a plugin install caches per project and a run fromscripts\setup\orworkspace\<mod>\still finds the project) [ProjectDrive] path=in<DayZ Tools>\settings.ini. A value that is not a folder gets the same kind of[WARN], namingsettings.iniand the path
The
[INFO] Mounting P: -> <folder> (from <source>)line names the source that won:--path,$DAYZ_WORK_DRIVE,cache <file>or thesettings.inifile. If none of these exists the skill exits 1 and asks for--path. It never falls back to<DayZ Tools>\Bin\WorkDrive: that folder holdsWorkDrive.exeitself, not a project drive. The DayZ Tools registry keys are not a source: they hold the install path, not the work drive folder.Prints and runs
WorkDrive.exe /Mount "<folder>". WorkDrive.exe gets 60 seconds; if it is still running (stuck at its "press any key" prompt) it is stopped. IfP:\still is not visible (or WorkDrive.exe is missing or was stopped), falls back tosubst P: "<folder>". When[ProjectDrive] Letter=insettings.iniis notP, WorkDrive.exe would mount that letter instead, so the skill prints[WARN] DayZ Tools' settings.ini sets [ProjectDrive] Letter=<X>, so WorkDrive.exe would mount <X>: instead of P:\. Using subst P: instead.and goes straight tosubst P:.--unmountthen skips WorkDrive.exe the same way.Checks that
P:now maps to the requested folder (read withQueryDosDeviceW, compared ignoring case, separators and a trailing backslash). If it shows another folder or device, it prints[FAIL] P:\ is mounted but points to <other>, not <folder>; nothing was cached.with a hint to run--unmountand mount again, and exits 1 without caching.On success, prints
[OK]and caches the folder for the next run. If the cache file cannot be written (for example.claude\local-memory\is read-only), it prints[WARN] P:\ is mounted, but the folder was not cached at <file>: <error>and still exits 0, becauseP:\is mounted.
DayZ Tools is located with the shared find_dayz_tools() resolver from dayz-preflight/preflight.py.
--unmount runs WorkDrive.exe /Dismount, falling back to subst P: /D if P:\ is still visible; it is a no-op when nothing holds the P: letter. A stale folder mapping (its folder is missing, so P:\ is not visible) is removed with subst P: /D and no process check, since nothing can be working from an invisible P:\. When P: is a volume or network drive rather than a folder mapping made by WorkDrive.exe or subst, --unmount refuses (exit 1, even with --force), names the device and says to free the letter in Disk Management or with net use P: /delete. Before unmounting a folder mapping it lists running processes with tasklist and refuses (exit 1, nothing unmounted) while any of WorkbenchApp.exe, ObjectBuilder.exe, AddonBuilder.exe, binarize.exe or DayZDiag_x64.exe is running, because pulling P:\ out from under them breaks those open sessions. Close them first (/dayz-stop-test stops DayZDiag), or pass --force to unmount anyway with a [WARN] naming them. If tasklist cannot start, exits non-zero or prints nothing, the running processes are unknown, so --unmount refuses the same way (exit 1, [FAIL] Not unmounting: tasklist failed ...); --force unmounts anyway with a [WARN] that nothing was checked.
--force is accepted only with --unmount, and --path only without it; either mismatch exits 2 with an argparse error instead of being silently ignored.
Output
DayZ P:\ mount
[INFO] Mounting P: -> C:\P Drives\Vanilla (from --path)
[CMD] "C:\...\DayZ Tools\Bin\WorkDrive\WorkDrive.exe" /Mount "C:\P Drives\Vanilla"
[OK] P:\ mounted -> C:\P Drives\Vanilla
[INFO] Cached for future runs at <project>\.claude\local-memory\dayz-work-drive.json
When nothing resolves it prints, on stderr:
[FAIL] Could not resolve a work drive folder.
Tried: $DAYZ_WORK_DRIVE, cached path, settings.ini.
Pass --path "C:\path\to\workdrive" with the folder P:\ should show (it is cached for later runs).
When already mounted it prints [OK] P:\ already mounted -> <folder> and runs nothing.
Exit codes
| Code | Meaning |
|---|---|
| 0 | P:\ is mounted to the requested folder, even if caching it failed (or, with --unmount, unmounted, a stale mapping removed, or already absent) |
| 1 | Not running on Windows, P: is held by a stale mapping or an unreachable device when mounting, --unmount found a volume or network drive on P: or could not remove a stale mapping, no work-drive folder could be resolved, --path is not a directory, both WorkDrive.exe and subst failed (the subst exit code is printed), P:\ came up mapped to a folder other than the requested one, --unmount left P:\ mounted, or --unmount without --force found DayZ Tools or DayZDiag running or could not list processes |
| 2 | Bad argument, such as an unknown option, --path with no folder, --force without --unmount, or --path with --unmount (argparse prints the usage) |