This document defines translator context screenshots for
TODOS.phase-72.72.11.1.9. Context screenshots show where a string appears in
game UI or dialogue and provide an auto-upload payload for the selected TMS
provider.
Capture Manifest#
V2/ue/Tools/generate-v2-context-screenshots.py reads
V2/ue/Content/Localization/V2/StringTables/StringIdRegistry_V2.json and
generates
V2/ue/Content/Localization/V2/Screenshots/ContextScreenshotManifest_V2.json.
Each manifest target includes:
- canonical string ID and TMS alias
- source text and context description
- stable screenshot reference
- capture preset for the UI surface
- viewport and highlight rectangle
- capture commandlet arguments for
V2LocalizationContextScreenshotCapture - deterministic content hash
Auto-Upload#
The same tool generates
V2/ue/Content/Localization/V2/Screenshots/ContextScreenshotUploadPayload_V2.json.
The payload targets Phrase, links every screenshot to the matching TMS alias,
and references V2_PHRASE_API_TOKEN through the request metadata. Raw
credentials must not be committed.
Run the generator after adding or changing screenshot references:
python3 V2/ue/Tools/generate-v2-context-screenshots.py
Verification#
Run this gate after changing screenshot references, capture metadata, upload payloads, docs, or CI wiring:
python3 V2/ue/Tools/check-v2-context-screenshots.py
Required release gates:
localization-context-screenshots-contractlocalization-context-screenshots-manifestlocalization-context-screenshots-capture-commandletlocalization-context-screenshots-tms-uploadlocalization-context-screenshots-deterministic-outputlocalization-context-screenshots-ci-wired