Correct dgVoodoo2 guidance: never ship it, XP pods must not have it

Two corrections from the project owner.

1. dgVoodoo2 must NEVER be added to the repo or the deploy script.

The pod fleet is mixed. XP pods use native DirectDraw and need nothing extra --
installing dgVoodoo2 on them BREAKS them. Only Windows 10/11 pods need it, and
only for the MFD modes. It is therefore an installed-per-machine, OS-dependent
prerequisite that the pod owner sets up, not a build artifact.

This reverses the recommendation added in the previous commit, which suggested
versioning the working dgVoodoo.conf and having deploy-mw4.ps1 place it. That
advice was wrong: it would have pushed a Win10-only dependency onto every XP
machine. dgVoodoo.conf and dgVoodooCpl.exe were removed in 0ceba9c7 deliberately
and must stay out.

- CLAUDE.md STEP 10: the "TODO: commit it" note is replaced with the reasoning,
  flagged so nobody re-adds the files later thinking it was an oversight.
- CLAUDE.md Next steps: that TODO is removed. The borderless-windowed item now
  notes it is the only route that removes the dgVoodoo2 prerequisite WITHOUT
  breaking the XP pods, since it needs no external DLL on either OS.
- Release notes gain an explicit warning callout: dgVoodoo2 is not part of the
  build and must not be installed on XP pods, with the advice to configure it per
  machine rather than inside the game folder that gets copied around. Without this
  an owner with a mixed fleet could reasonably have copied a working Win10 install
  onto an XP pod and broken it.

2. Version numbering is intentional, not a mismatch.

V5.1.0b<n> denotes beta build n; these are handed out as release candidates for
testing. The "b" is dropped and it becomes 5.1.0 when the release is final. So the
console string V5.1.0b1 alongside a release named V5.1.0b_RC1 is expected, and the
earlier suggestion to reconcile them is withdrawn.

Both release-notes formats regenerated; the XP warning renders as a warning
callout in the HTML. Both remain plain ASCII with CRLF.

Co-authored-by: Claude Opus 5 (Anthropic) <noreply@anthropic.com>
Co-authored-by: GitHub Copilot <copilot@github.com>
This commit is contained in:
2026-07-25 19:47:26 -05:00
co-authored by Claude Opus 5 GitHub Copilot
parent 10dab8f2d5
commit 1b931d5fb8
3 changed files with 23 additions and 6 deletions
+12 -6
View File
@@ -1050,9 +1050,15 @@ fullscreen.** The main display takes it; every secondary panel is refused. XP al
- Device index → physical monitor is **1:1** on this bench (colour test confirmed): main=0,
radar=1, mfd-left=2, mfd-right=3, so `-tmon 1,2,3,4` is identical to auto-detection.
- **Confirmed working end-to-end: all three secondary panels present, full mission played.**
- ⚠️ **The working `dgVoodoo.conf` is NOT versioned in the repo** (it was removed in `0ceba9c7`).
A fresh deploy will reproduce the silent MFD failure. TODO: commit it + have `deploy-mw4.ps1`
place it.
- ⚠️ **dgVoodoo2 is deliberately NOT in the repo and must NOT be — it breaks Windows XP
deployments.** The pod fleet is mixed: XP pods need native DirectDraw and nothing else, while
Win10/11 pods need dgVoodoo2 for any MFD mode. Shipping it in the build (or having
`deploy-mw4.ps1` place it) would push a Win10-only dependency onto XP machines and break them.
It stays an **installed-per-machine, OS-dependent prerequisite** set up by the pod owner on
Win10/11 only. `dgVoodoo.conf`/`dgVoodooCpl.exe` were removed in `0ceba9c7` for this reason —
do not "fix" that by re-adding them. The required setting (Scaling mode
`Stretched, Keep Aspect Ratio`, on the **General** tab) is documented in the pod-owner release
notes instead.
### 📐 Engine is 4:3 ONLY (relevant to every display decision)
`ImageHlp.cpp:~464` asserts the complete supported resolution set: **640x480, 512x384, 800x600,
@@ -1101,10 +1107,10 @@ Smaller than it sounds because the mechanisms already exist:
DISPLAY AND VIDEO).
## Next steps (proposed)
- [ ] **Commit the working `dgVoodoo.conf`** and have `deploy-mw4.ps1` place it — without it a
fresh 4-monitor deploy silently fails (see STEP 10).
- [ ] (Decision pending) Borderless-windowed migration — see the staged assessment in STEP 10.
Step 2 (one panel) is the cheap, decisive experiment.
Step 2 (one panel) is the cheap, decisive experiment. Note this is the only route that would
remove the dgVoodoo2 prerequisite **without** breaking the XP pods, since it needs no external
DLL on either OS.
- [ ] Test a **full mission windowed** (only the console/shell has been verified windowed).
- [x] ~~Windowed 3D viewport on Win11~~ — DONE via DDrawCompat (see STEP 8 viewport section).
- [ ] (Optional) Curate remaining WIP content as features are exercised (editor loads dev `Content\`).
+5
View File
@@ -139,6 +139,11 @@ spanned display (<code>-tmfds 1</code> and <code>-tmfds 3</code>), not only the
<p>If your pod drives any MFD or radar panel at all, this applies to you. It is not specific to
the new split-MFD feature: the underlying Windows limitation affects every mode that lights up
a second display. On Windows XP none of this was needed.</p>
<div class="warn"><p><strong>dgVoodoo2 is not part of the build, and must NOT be installed on Windows XP pods.</strong>
XP uses the graphics support built into Windows and needs nothing extra -- adding dgVoodoo2
there will break it. It is a per-machine prerequisite that you install yourself, on
<strong>Windows 10 and 11 pods only</strong>. If your fleet is mixed, set it up per machine, not as part
of the game folder you copy around.</p></div>
<p>In the dgVoodoo2 control panel, on the <strong>General</strong> tab, set:</p>
<div class="note"><p><strong>Scaling mode: <code>Stretched, Keep Aspect Ratio</code></strong></p></div>
<p>This is not optional and not cosmetic.</p>
+6
View File
@@ -146,6 +146,12 @@ If your pod drives any MFD or radar panel at all, this applies to you. It is not
the new split-MFD feature: the underlying Windows limitation affects every mode that lights up
a second display. On Windows XP none of this was needed.
> **dgVoodoo2 is not part of the build, and must NOT be installed on Windows XP pods.**
> XP uses the graphics support built into Windows and needs nothing extra -- adding dgVoodoo2
> there will break it. It is a per-machine prerequisite that you install yourself, on
> **Windows 10 and 11 pods only**. If your fleet is mixed, set it up per machine, not as part
> of the game folder you copy around.
In the dgVoodoo2 control panel, on the **General** tab, set:
> **Scaling mode: `Stretched, Keep Aspect Ratio`**