Voices and the heroes × languages matrix

Français · Type: how-to · Audience: author · Context: local Studio · Status: ready · Applies from: 4.4.0

The local Studio · contract: stable · verified by CI (support matrix of 4.4.0, 2026-10-23): Chromium end to end (the Studio's checks); Windows: the unit suite only · automated checks: jobs e2e, windows; CI plan e2e, windows; 2 test files · people's passes: studio-hero-matrix not run (#238) · known limits: table-dev-server, matrix-bounds

Voices and music · contract: stable · verified by CI (support matrix of 4.4.0, 2026-10-23): The music director in Chromium and WebKit · automated checks: jobs e2e; CI plan e2e; 2 test files · people's passes: voices-listening not run (#87) · known limits: table-dev-server, matrix-bounds

The Voices tab holds the voice recording table, per language, and its second view, Heroes × languages: every line that depends on the hero, the text each hero reads in each language and the clip that plays, with what is missing.

What you get

A recording table the actors can work from (CSV out, CSV back in), and a matrix that shows at a glance which hero lacks a translation, a clip, or a choice the source language makes.

Context and versions

The local Studio, engine repository or created project. The matrix is from 4.4.0, read-only, and works on every backend: the dev server, a hosted Studio and the demo Studio. The recording table needs the dev server. How voices and hero choice are written in the game: Voices: per language and per hero, Heroes: several characters and hero choice.

Prerequisites

The Studio running (overview).
Lines with stable ids (Voices); the matrix lists only lines with an id that depend on the hero.

Where to run the commands

In the browser, on the Voices tab. npm run voices runs in the engine repository.

Steps

The recording table

Open the Voices tab, view Recording table, and pick the Language. Each line with a stable id is a row: who says it, its text in that language, its clip, and its status (draft, record, recorded, approved), with the actor and a note. A change is saved at once, into games/<id>/voices.json, and is undoable. "Find a line…" filters the rows; Status filters by status.

Export CSV hands the table to the actors. Bring theirs back from the command line:
```
# in the engine repository
npm run voices -- import <file>
```

Limit · table-dev-server The recording table needs the dev server (npm run studio): elsewhere the tab says "The voice table needs the dev server (npm run studio)." The matrix still works there.

Heroes × languages

Switch the view to Heroes × languages. A row per line with an id that depends on the hero (a text switch or {hero}, in any language). A column per hero, that is per combination of the values the switched flags take, headed by the variant's portrait and name, and per language. Each cell: the text that hero reads and the clip that plays, or the clip that is missing (the plain id is named when it plays instead).

Show "lines with a problem" keeps the rows that flag one:
- untranslated: a language has no text for the line;
- agreement: a translation drops a choice the source makes (a switch the source has, the translation lacks);
- unlisted: a value of a flag that no switch lists, without a *= default;
- a clip that is missing for a hero.
Language narrows to one language; "Find a line…" searches. The bar counts the lines, those with a problem, the heroes and the languages.

Limit · matrix-bounds The matrix shows 24 hero combinations at most; the bar says how many more were left out. The table shows 200 rows at most: "N more: narrow the search."

Expected result, and how to check it

With "lines with a problem", an empty matrix: every hero has every line in every language, and a clip where one is expected. npm run voices -- check agrees on the command line.

Common errors

Symptom	Cause	Fix
"The hero matrix is not available on this backend."	A backend without the route	Use the dev server, a hosted Studio or a recent demo
A cell names a plain id	The hero's clip is missing; the plain line's clip plays instead	Record the clip for that hero
A row is flagged `agreement`	The translation lost a switch	Put the switch back in the translation

Files or data changed

games/<id>/voices.json (the recording table). The matrix writes nothing.

Recovery or going back

A status, actor or note change is undoable from the header during the session; otherwise git.

References

src/studio/voices.ts, src/studio/hero-matrix.ts, src/engine/tools/hero-matrix.ts, tools/voices.ts.
The routes GET voices[/:lang], PUT voices/:lang/:id, GET voices/:lang/csv and GET hero-matrix ({ langs, flags, columns, rows, truncated? }): Studio API.

Edit the source of this page · Report an error