- \n
- First add the languages you need in the Project Tree<\/em> under the Language Settings<\/em> folder.<\/li>\n
- Once they are configured, select a WorkUnit<\/em> and right-click on the Material Root Folder<\/em>. Select Create a folder for Localization<\/em>. Atom Craft will automatically create a dedicated hierarchy to manage the localized assets.<\/li>\n
- Drag & drop your assets in their respective folders.<\/li>\n
- Then, create your dialogue Cues.<\/li>\n<\/ul>\n
\n
![\"01](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/08\/01-Atom-Craft-Loc-Setup.png\")
\n<\/p>\nWith your Cues ready you can build your ACB files:<\/p>\n
- \n
- Right-click on the CueSheet containing your dialogue Cues.<\/li>\n
- Click on Build Atom CueSheet Binary.<\/em><\/li>\n
- In the build window, select the language for which you want to build.<\/li>\n
- Once the build completed, you will have one ACB for each language.<\/li>\n<\/ul>\n
\n
![\"02](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/08\/02-Build-ACB.png\")
<\/p>\nLocalization in Unreal Engine<\/h2>\n
You can now open your Unreal project. The first thing is to setup our languages for the localization.<\/p>\n
- \n
- Open the Localization Dashboard <\/em>via the Window<\/em> menu.<\/li>\n
- Scroll to the bottom of the dashboard and, in the Cultures<\/em> section, click on Add New Culture<\/em>.<\/li>\n
- Add the same languages than in your AtomCraft project.<\/li>\n
- Finally, click on Compile Text<\/em> to update the list of languages internally.<\/li>\n<\/ul>\n
\n
![\"03](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/08\/03-Loc-Dashboard.png\")
\n<\/p>\nWith our languages ready, it is time to import the ACB.<\/p>\n
- \n
- In the Content browser, create a folder for your audio assets.<\/li>\n
- Import the localized ACB that will be used for your reference language (e.g., English) and create the assets for the corresponding Cues.<\/li>\n
- Right-click on your ACB asset, select Asset Localization<\/em>, Create Localized Asset<\/em>, English<\/em>.<\/li>\n
- Repeat the last operation for each language.<\/li>\n<\/ul>\n
\n
![\"04](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/08\/04-Asset-Loc.png\")
\n<\/p>\nYou will notice that this creates a new folder hierarchy under Content\/L10N\/ with subfolders for each language, each mirroring the organization of your audio assets.<\/p>\n
\n
![\"05](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/08\/05-L10N-Folder.png\")
\n<\/p>\n- \n
- In the last folder of this hierarchy, you will find your ACB file, which was copied during the process.<\/li>\n
- Delete this ACB file for every language, as it is unnecessary.<\/li>\n<\/ul>\n
The purpose of the workflow above is to create all the appropriate folders, but you could also create them manually.<\/p>\n
- \n
- Now you can drag and drop each of your localized ACB files in their respective folders to create the localized assets.<\/li>\n<\/ul>\n
\n
![\"06](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/08\/06-Localized-Assets.png\")
\n<\/p>\nFrom this point on, when using Cue assets and Cue Sheet assets, you must use the assets created in the audio asset folder you originally created (which only contains your reference language assets). When an asset is loaded, the appropriate localised version will be loaded according to the language setting. Note that if you were to accidentally use the assets in the L10N folder directly, the language of the asset would not change when switching between languages.<\/p>\n
Finally, in Unreal, to change the language setting you can:<\/p>\n
- \n
- Use the Set Current Culture<\/em> node in Blueprints.<\/li>\n
- Or call the SetCurrentCulture<\/em> function in C++.<\/li>\n<\/ul>\n
The assets loaded after this operation will be the localized asset corresponding to the language specified earlier.<\/p>\n
Here is an example in Blueprint, where clicking on a button sets our language, and reloads the current level:<\/p>\n
\n
![\"07](\"https:\/\/blog.criware.com\/wp-content\/uploads\/2023\/08\/07-BP.png\")
\n<\/p>\n<\/p>\n
Note that one limitation of this system is that it will not change assets already loaded, and it will only change the language when running a packaged game.<\/p>\n
The advantage of this pipeline is that it works automatically out-of-the-box. However if it is too restrictive for your needs, it will be relatively easy to build a custom solution since Atom Craft exports individual ACB in each language.<\/p>\n","protected":false},"excerpt":{"rendered":"
ADX\u2019s authoring tool comes with useful features to manage localization. Assets with prefix and\/or suffix are supported, multi-lingual Cues are<\/p>\n","protected":false},"author":2,"featured_media":5402,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"colormag_page_container_layout":"default_layout","colormag_page_sidebar_layout":"default_layout","footnotes":""},"categories":[5,7],"tags":[],"class_list":["post-4541","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-adx","category-tutorials"],"aioseo_notices":[],"_links":{"self":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/4541","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/comments?post=4541"}],"version-history":[{"count":7,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/4541\/revisions"}],"predecessor-version":[{"id":5401,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/posts\/4541\/revisions\/5401"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media\/5402"}],"wp:attachment":[{"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/media?parent=4541"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/categories?post=4541"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/blog.criware.com\/index.php\/wp-json\/wp\/v2\/tags?post=4541"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
- Or call the SetCurrentCulture<\/em> function in C++.<\/li>\n<\/ul>\n
- Use the Set Current Culture<\/em> node in Blueprints.<\/li>\n
- Now you can drag and drop each of your localized ACB files in their respective folders to create the localized assets.<\/li>\n<\/ul>\n
- Repeat the last operation for each language.<\/li>\n<\/ul>\n
- Scroll to the bottom of the dashboard and, in the Cultures<\/em> section, click on Add New Culture<\/em>.<\/li>\n
- Once they are configured, select a WorkUnit<\/em> and right-click on the Material Root Folder<\/em>. Select Create a folder for Localization<\/em>. Atom Craft will automatically create a dedicated hierarchy to manage the localized assets.<\/li>\n