# Voice Acting Manager

Opens via Editors › Voice Acting Manager.

A tool for generating voice acting scripts and programmatically assigning voice file paths across all spoken lines in a mission. It covers messages created in the Mission Events editor, briefing stages, command briefing stages, and debriefing stages.

## Abbreviations

Abbreviations define how voice filenames are automatically constructed. The Example box shows a live preview as you fill in the fields.

Field | Description
--- | ---
Campaign abbreviation | Short code identifying the campaign. Placed at the start of every filename, combined with the mission abbreviation.
Mission abbreviation | Short code identifying the mission. Combined with the campaign abbreviation at the start of the filename.
Cmd. Briefing | String inserted into filenames for command briefing lines.
Briefing | String inserted into filenames for briefing lines.
Debriefing | String inserted into filenames for debriefing lines.
Message | String inserted into filenames for in-mission message lines.
Extension | Preferred audio file extension: `.wav` or `.ogg`.
Include sender name | When checked, the name of the sending ship or persona is included in the filename for message lines.

## Generating filenames

Replace existing filenames - when checked, the generator will overwrite voice file assignments that are already set. When unchecked, only lines with no assignment are filled in.

Generate filenames applies the abbreviation rules to every line in the mission, setting voice file paths according to the options above.

## Script options

Controls how the exported script document is formatted and what it contains.

Field | Description
--- | ---
Format | A free-form template defining how each line appears in the exported script. The available substitution tokens are listed in the dialog itself.
Export | Radio buttons selecting which source to include in the script: everything, messages only, briefing stages only, command briefing stages only, or debriefing stages only.
Group sent-message-list messages together | When checked, messages in the script are reordered to match the sequence they appear in mission events (send-message-list, send-message-chain, and send-random-message operations), rather than the default message index order. Any messages not referenced in events are appended at the end. This is useful for voice directors who want to work through the script in mission flow order.

Generate script writes the script file to disk using the format and export settings above.

## Sync Personas

Tools for keeping persona assignments consistent between ships and the messages they send. The persona filter drop-down scopes all operations in this section to a specific set of personas: wingman personas only, non-wingman personas only, or a single named persona.

Button | Description
--- | ---
Copy message personas to ships | For each mission message that has a persona assigned, finds the ship that sends it and sets that ship's persona to match.
Copy ship personas to messages | Reverse of the above; for each ship with a persona set, updates the messages it sends to use that same persona.
Clear personas from ships that don't send messages | Removes the persona assignment from any ship that has one but does not send any messages. Useful for cleaning up personas that were set by mistake or are no longer needed.
Set head ANIs using personas in messages.tbl | For each message with a persona assigned, looks up a matching built-in message in `messages.tbl` with the same persona and copies its head animation assignment.
Check if messages sent by <any wingman> have at least one ship with that persona | Validates that every message addressed to `<any wingman>` has a wingman persona assigned and that at least one ship in the mission carries that persona. Reports any discrepancies.