Fighting Game · Guides & deep dives

V2 Colorblind-Safe Palette System

The palette system lives in V2UI:

5sections1 minread
Markdown source
On this page

This runbook covers TODOS.phase-72.72.13.1.2: the V2UI colorblind-safe palette system that provides accessibility-verified color alternatives for all UI indicators.

Runtime Surface#

The palette system lives in V2UI:

  • C++ header: V2/ue/Source/V2UI/Public/V2ColorblindSafePalette.h
  • C++ source: V2/ue/Source/V2UI/Private/V2ColorblindSafePalette.cpp
  • automation spec: V2/ue/Source/V2Tests/Private/UI/ColorblindSafePalette.spec.cpp
  • contract: V2/ue/Content/V2/UI/Accessibility/ColorblindSafePalette_V2_Contract.json
  • focused checker: V2/ue/Tools/check-v2-colorblind-safe-palette.py

FV2ColorblindSafePalette::BuildDefaultCatalog returns Accessibility.ColorblindSafePalette.V2, a catalog of UI color tokens with Default, Protanope, Deuteranope, Tritanope, and Monochromacy alternatives. FV2ColorblindSafePaletteCatalog::ResolveColor maps a token and EV2UIColorPaletteMode to the active color.

Indicator Coverage#

The catalog treats these roles as the required set of all UI indicators for V2 runtime signoff:

  • Health
  • Guard
  • Stamina
  • Super
  • Warning
  • Danger
  • Success
  • Objective
  • QuestPrimary
  • QuestOptional
  • Interact
  • Focus
  • PingExcellent
  • PingGood
  • PingPoor
  • TeamAlly
  • TeamEnemy

Each FV2ColorblindSafePaletteEntry includes a stable UI.Color.* token, a mode-specific color for each supported palette, a NonColorShapeTokenId, a TextFallbackTokenId, and a verified minimum contrast ratio of at least 4.5:1.

Non-Color Policy#

Color is never the only state carrier. Every indicator must also expose a non-color fallback shape and a text fallback token so HUD bars, warnings, quest markers, pings, team identity, and focus states remain readable in monochromacy and under simulated protanopia, deuteranopia, and tritanopia.

The catalog validation rejects:

  • duplicate color tokens;
  • duplicate indicator roles;
  • missing non-color fallback or text fallback tokens;
  • unverified entries;
  • normalized RGBA values outside 0-1;
  • entries below 4.5:1 minimum contrast;
  • entries that reuse the default color for a colorblind-safe alternative.

Verification#

Run these checks after changing the palette:

bash
python3 V2/ue/Tools/check-v2-colorblind-safe-palette.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-colorblind-safe-palette.py V2/ue/Tools/check-v2-ci-workflow.py
python3 -m json.tool V2/ue/Content/V2/UI/Accessibility/ColorblindSafePalette_V2_Contract.json

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

Horde Gates#

  • colorblind-safe-palette-source
  • colorblind-safe-palette-indicators
  • colorblind-safe-palette-alternatives
  • colorblind-safe-palette-non-color-fallbacks
  • colorblind-safe-palette-automation
  • colorblind-safe-palette-ci-wired