Fighting Game · Guides & deep dives

V2 High-Contrast Mode

The high-contrast mode lives in V2UI:

5sections1 minread
Markdown source
On this page

This runbook covers TODOS.phase-72.72.13.1.3: the V2UI high-contrast mode that increases contrast of game elements, outlines interactive objects, and simplifies backgrounds.

Runtime Surface#

The high-contrast mode lives in V2UI:

  • C++ header: V2/ue/Source/V2UI/Public/V2HighContrastMode.h
  • C++ source: V2/ue/Source/V2UI/Private/V2HighContrastMode.cpp
  • automation spec: V2/ue/Source/V2Tests/Private/UI/HighContrastMode.spec.cpp
  • contract: V2/ue/Content/V2/UI/Accessibility/HighContrastMode_V2_Contract.json
  • focused checker: V2/ue/Tools/check-v2-high-contrast-mode.py

FV2HighContrastMode::BuildHighContrastProfile returns an FV2HighContrastModeProfile named Accessibility.HighContrastMode.V2, bound to EV2UIContrastMode::High, HUD.Theme.HighContrast, and UI.Accessibility.HighContrast.PostProcess.

Target Coverage#

The profile must include high-contrast rules for:

  • HUDText
  • HUDMeters
  • FighterSilhouette
  • OpponentOutline
  • HitZone
  • InteractiveObject
  • Pickup
  • WorldObjective
  • DangerWarning
  • FocusCursor
  • SubtitlePanel
  • BackgroundSimplification

Each FV2HighContrastModeRule carries foreground, background, and outline colors, a verified 7.0:1-or-better contrast ratio, outline thickness metadata, and background simplification controls where needed.

Release Policy#

High-contrast mode is valid only when it:

  • increases contrast of game elements and HUD readouts;
  • outlines interactive objects, pickups, objectives, focus cursors, hit zones, opponents, and fighter silhouettes;
  • simplifies backgrounds with scene dimming and desaturation;
  • suppresses decorative background noise while preserving hit-confirmation readability;
  • blocks color-only states.

Verification#

Run these checks after changing high-contrast mode:

bash
python3 V2/ue/Tools/check-v2-high-contrast-mode.py
python3 V2/ue/Tools/check-v2-ui-module.py
python3 V2/ue/Tools/check-v2-ci-workflow.py
python3 V2/tools/validate-v2-docs.py
python3 -m py_compile V2/ue/Tools/check-v2-high-contrast-mode.py V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/UI/Accessibility/HighContrastMode_V2_Contract.json

Automation test name: V2.UI.Accessibility.HighContrastMode.AssetContract.

Horde Gates#

  • high-contrast-mode-source
  • high-contrast-mode-game-elements
  • high-contrast-mode-interactive-outlines
  • high-contrast-mode-background-simplification
  • high-contrast-mode-automation
  • high-contrast-mode-ci-wired