One language setting; localized in-memory speech per language

docs/decisions.md

@@ -92,6 +92,13 @@ tables): high risk for little gain, not done.
   file is rebuilt from its original copy + the applied edits (sound and text edits combine in one package).
 - Keys (`SUB:<LANG>:<speech>:<line>`, `MENU:<LANG>:<File>:<Section>:<Key>`) are stable and used in mod packages.
 
+## 4d. One language setting
+The editor has a single *Language* list (top bar) for voices, subtitles and menu text, starting at the language
+the game is set to on every launch (not remembered: the game's setting is what the player hears). The game
+has voices in 5 languages and texts in 11; for the other 6 it plays the INT voices, so the editor loads the INT
+voice lines with that language's texts and says so next to the list. Localized in-memory speech (one bank
+copy per voice language) is filtered the same way, so the sound list never mixes languages.
+
 ## 5. Catalog
 - Shipped CSVs per archive (names, categories, characters, original size + checksum) make loading instant and
   enable change detection; any other build is scanned at runtime (header reads only, cached).

docs/formats/banks.md

@@ -19,8 +19,9 @@ BKPK tables in the packages reference 2,543 WAD entries, all of them in the cata
 
 Embedded WEMs by bank name prefix: `Speech` 7,872, `CHR` (character foley, combat, bosses) 3,896, `PSO` 781,
 `WPN` 664, `NPC` 475, `OBJ` 439, `SEQ` 265, `GUI` 208, `PSA` 203, `MTN` 196, `PX` 195, `DVC` 100, `GEN` 80,
-`PHY` 73, `AMB` 65, `SBJ` 50, others < 30. The `Speech_` banks (e.g. `Speech_EMOTE_Batman`, `..._GRUNT`) are
-probably efforts/grunts rather than dialogue (there are no per-language packages); not verified by listening.
+`PHY` 73, `AMB` 65, `SBJ` 50, others < 30. The `Speech_` banks (e.g. `Speech_EMOTE_Batman`, `..._GRUNT`) hold
+speech: grunts and efforts (language-neutral, 165) and **localized lines** (about 1,460 per language, see
+*Localized banks*).
 All WEMs seen are Vorbis (format tag 0xFFFF), the same codec as the WADs: the footsteps are mono (4 stereo),
 the embedded ones mono or stereo (~22 % stereo in a 2,533-WEM sample).
 
@@ -49,6 +50,14 @@ with bank id 0 whose media is not in the same bank (loaded by another bank); 133
 streamed WEM (its size = the source's size), which the game plays while the rest is read from the WAD. 396
 WAD sounds have such heads (2,101 copies); replacing one of them must rewrite the heads too.
 
+## Localized banks
+Speech banks are localized inside the (language-neutral) packages: one `AkBank` export starts with a language
+list (FStrings `INT FRA ITA DEU ESN`) and then holds one complete bank per language, in that order, all with
+the same bank ID; each language's copy has its own media IDs (checked on 215 banks against the WAD languages
+of their streamed lines). ackit labels every in-memory media with its language (`BANK.csv` column `language`):
+8,098 language-neutral sounds, ~1,460 per voice language. A catalog shows the neutral sounds plus the loaded
+language's lines; names are unique per language.
+
 ## Banks inside packages
 - The packages are LZO-compressed UE3 packages (`upk.md`); ackit decompresses them itself and searches the
   uncompressed data for `BKHD` (banks) and `BKPK` (WAD indexes). (The first survey used Gildor's

docs/formats/subtitles.md

@@ -33,8 +33,9 @@ The speech event name is hashed (FNV-1) to the Wwise event ID, followed through
 action -> containers -> Sound) to the streamed media, and that media ID is looked up in the per-language
 BKPK tables (`banks.md`) to find the WAD entry and variation of each language. This is exact; the `_NN`
 suffix of the event name does **not** match the variation order inside the WAD entry (WEMs are stored in
-media-ID order). Linked: ~92 % of the strings (e.g. INT 8,637 / 9,379); the rest have no event that reaches a
-streamed media (unused or placeholder lines such as `..._TEMP_29`) and stay editable without a sound link.
+media-ID order). Lines kept in memory link to the localized BANK sound of their language. Linked: ~99 % of
+the strings (e.g. INT 9,265 / 9,379); the rest have no event that reaches a sound (unused or placeholder
+lines such as `..._TEMP_29`) and stay editable without a sound link.
 Event names with a number (`Speech_X_04`) exist only as export names, not in the name table.
 
 ## How ackit writes them

docs/user-guide.md

@@ -16,6 +16,16 @@ City (PC, Steam)**. Everything you change can be put back with one click.
 
 ![Main window](img/main.png)
 
+## Language
+There is **one language setting**: the **Language** list at the top of the window. It starts at the language the
+game is set to (Steam > game properties > Language) and applies to everything you edit:
+- **Sounds**: the voice lines of that language, plus the sounds every language shares (music, ambience,
+  effects). The game has voices in English (INT), French, Italian, German and Spanish; for the other languages
+  (Latin American Spanish, Polish, Portuguese, Russian, Japanese, Korean) it plays the English voices, so the
+  editor shows those and says *voices: INT* next to the list.
+- **Subtitles** and **Menu text**: the texts of that language.
+Changing it reloads the lists; the next start is again in the game's language.
+
 ## Find a sound
 - Type in the **search box** (Ctrl+F): words can be parts of the name, a category, a character, your own
   notes or tags, or an ID like `b49cdf48`. All words must match.
@@ -26,11 +36,10 @@ City (PC, Steam)**. Everything you change can be put back with one click.
   sound's name (useful hints for the many unlabelled lines); tick *Include characters mentioned in names*
   to filter on them too.
 - Click a column header to sort (length, size, status, ...). Ctrl/Shift-click selects several rows.
-- Archive **BANK** holds the ~15,400 short effects stored inside soundbanks (footsteps, foley, combat,
+- Archive **BANK** holds the short sounds stored inside soundbanks (footsteps, foley, combat,
   weapons, menu sounds, grunts). Many are named after the game event that plays them (`Play_...`), the
   rest after their bank (`CHR_Bane_3`). The editor shows the bank and how many copies the game keeps of
   the sound; a replacement is written into every copy.
-- **Language** (top left) switches the speech language. Speech is read from the language the game is set to.
 
 ![Browsing by category](img/browse.png)
 
@@ -66,7 +75,7 @@ than the original, since the game may cut it off.
   changes** or **Forget them**. Do not use "verify" to undo mods; use Revert all.
 
 ## Subtitles
-The **Subtitles** tab lists the subtitle of every speech line (11 languages; choose one with *Language*).
+The **Subtitles** tab lists the subtitle of every speech line in the selected language (see *Language*).
 - Search by text or line name, filter by **Character** and **Category** (taken from the linked speech sound),
   or show **Modified only**. Select a row to edit its text below and press **Apply** (or Enter).
 - Each subtitle replaces the original *in place*, so it can be at most as long as the original (the counter
@@ -80,7 +89,7 @@ The **Subtitles** tab lists the subtitle of every speech line (11 languages; cho
 - About 8 % of the subtitles belong to lines the game never plays (placeholders); they have no linked sound.
 
 ## Menu text
-The **Menu text** tab lists every menu, HUD, bio, riddle and credits string of the chosen language (about
+The **Menu text** tab lists every menu, HUD, bio, riddle and credits string of the selected language (about
 7,000), grouped by **File** (e.g. `FRONTEND`, `GFxUI`, `Bios`). Search, edit, apply and revert work like
 subtitles; menu texts can be of any length but cannot contain line breaks (keep the game's own markers such
 as `\n` as they are).