Fighting Game · Guides & deep dives

V2 Dynamic Text Insertion

Rules live in V2/ue/Content/Localization/V2/Dynamic/DynamicTextRules_V2.json.

3sections1 minread
Markdown source
On this page

This document defines dynamic text insertion for TODOS.phase-72.72.11.1.8. Dynamic text uses named variables such as {count} and {item_name} and resolves count-driven grammar before rendering.

Data Files#

Rules live in V2/ue/Content/Localization/V2/Dynamic/DynamicTextRules_V2.json. Dynamic string templates live in V2/ue/Content/Localization/V2/Dynamic/DynamicTextStrings_V2.json. Sample runtime contexts live in V2/ue/Content/Localization/V2/Dynamic/DynamicTextContexts_V2.json.

The sample string is loc.system.loot.found_items.body:

text
You found {count} {item_name}.

{count} drives singular or plural grammar. {item_name} can provide singular and plural localized term forms, allowing the formatter to render Ash Saber for count 1 and Ash Sabers for count 3.

Evaluation#

V2/ue/Tools/evaluate-v2-dynamic-text.py writes V2/ue/Content/Localization/V2/Dynamic/DynamicTextEvaluation_V2.json.

Tracked expected outputs:

  • loot.ash_saber.one: You found 1 Ash Saber.
  • loot.ash_saber.many: You found 3 Ash Sabers.
  • loot.health_potion.zero: You found 0 Health Potions.

Missing variables use the block_build policy.

Verification#

Run this gate after changing rules, templates, contexts, evaluator logic, generated output, docs, or CI wiring:

bash
python3 V2/ue/Tools/check-v2-dynamic-text.py

Required release gates:

  • localization-dynamic-text-contract
  • localization-dynamic-text-variable-substitution
  • localization-dynamic-text-singular-term
  • localization-dynamic-text-plural-term
  • localization-dynamic-text-missing-variable-guard
  • localization-dynamic-text-ci-wired