Skip to content
quest'n'click

StudioHow-toFor authorsApplies from 4.4.0

Voices and the heroes × languages matrix

Cette page en françaisThis page on the GitHub wiki

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

  1. 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.

  1. Export CSV hands the table to the actors. Bring theirs back from the command line:

    # in the engine repository
npm run voices -- import <file>

Heroes × languages

  1. 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).

  1. 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.

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

SymptomCauseFix
"The hero matrix is not available on this backend."A backend without the routeUse the dev server, a hosted Studio or a recent demo
A cell names a plain idThe hero's clip is missing; the plain line's clip plays insteadRecord the clip for that hero
A row is flagged agreementThe translation lost a switchPut 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