The script importer window allows you to import scripts in spreadsheet format, and use them to automatically create and assign all the individual information to their corresponding audio assets.
1.- Export your excel/google sheets script.
Export the script as Tab Separated Values, or TSV.
| Excel: Text (Tab delimited) | Google Sheets: Tab Separted Values |
 |  |
2.- Import the TSV file by creating a new SoundWave.
After creating a new SoundWave, you will be prompted to import a .txt or .tsv file. (This option can be disabled in “Editor Settings | Plugins | VoiceCrafter”.
3.- Map the values
Since there’s no universal format and order of columns for game scripts, the importer uses a generic mapping approach that after importing the file, allows you to select which columns correspond to which type of value.
The value mapping section displays all the values of the first row to help with the mapping.
- Script Text: This is the main value that holds the text itself for the script. This is the only mandatory field.
- File Name (Optional): If available, it retrieves the pre-defined file names to use for each line of dialog.
- Group (Optional): If available, it will use this value to create MetaSoundSources with all available sounds for each group. Can be used for example to group all variations of greetings in a single MetaSound that will play a random phrase from the group each time.
- Character (Optional): If available, can be used to help generate automatic file names, folders and MetaSounds.
4.- Filtering Section
The filtering section allows you to filter the lines to import.
You can choose the first and last spreadsheet lines to import, as well as importing only the lines that have a particular text within the given column. This can be used for example to filter only the lines of a given character or group.
The window gets updated with the selection and displays all current lines that fulfill the filtering criteria.
5.- Assignment
The assignment window is yet anoter huge time saver and workflow enhancer, and allows you to perform in batch all the following actions to your soon-to-be-created new SoundWaves.
- Assign Script as Subtitles: This will assign the individual script lines as subtitles to their corresponding SoundWave in order to be displayed In-Game.
- Create Folders: Create folders and/or subfolders for all the sounds corresponding to each character and/or group.
- Create MetaSounds: Create MetaSounds and automatically assign the corresponding SoundWaves to it. This option requires both Character and Group fields, since it will create a MetaSound for each Group within each Character. Depending on the playback behaviour, the MetaSounds can be either User-Defined or Random.
- Submix: Assign a Submix asset to all SoundWaves.
- Sound Class: Assign a Sound Class asset to all SoundWaves.
6.- Finish
Click the “Accept” button and continue working with your newly created Sound assets!