Localization feature of ue4

Localization feature of UE4
Epic Games Japan / Support Engineer
Ken Kuwano

#UE4DD | @UNREALENGINE
Contents
● Overview
● Basic Features
● Speciﬁed Features
● Misc

Localization of the game
● Localize the game
● Goal ：Release to many regions
● How ：Implementation to many regions

Assets needing localization
● Text
● Content
● Font
● Asset
● Texture
● Voice,Sound
● Movie, Media
● Cutscene, Sequencer
● Animation

Localization of the game
● Localize the game
● Goal ：Release to many regions
● How ：Implementation to many regions
● Localize the game made using UE4
● How do we localize using UE4?
● Asset ：management, sharing
● Efficiency ：workflow, implementation
● Effect ：memory, performance
Focus of this slide

Localize？
Localization (L10N)
● Localization is the process of adapting internationalized
software for a speciﬁc region or language by translating
text and adding locale speciﬁc components.
Internationalization (I18N)
● Internationalization is the process of designing a software
application so that it can be adapted to various languages
and regions without engineering changes.

https://docs.unrealengine.com/en-US/Gameplay/Localization/index.html
Localization of UE4

Basic Features
● Text Localization Process
● Asset Localization Process

Text Localization Process
Editor (en) Package game (ja)

Gather
Source
Text
Package
Switch
Language
Translate
Source
Text

Gather
Source
Text
Package
Switch
Language
Translate
Source
Text
Gather source text
from asset what we’d
like to localize.
OPTIONS
QUIT

Gather
Source
Text
Package
Switch
Language
Translate
Source
Text
Make translation text
with reference to
gathered text.
OPTIONS
QUIT
オプション
終了

Gather
Source
Text
Package
Switch
Lauguage
Translate
Source
Text
Make package game
including translation
text.
Package
OPTIONS
QUIT
オプション
終了

Gather
Source
Text
Package
Switch
Language
Translate
Source
Text
Display text depending
on required language.
Package
OPTIONS
QUIT
オプション
終了

Gather
Source
Text
Package
Switch
Language
Translate
Source
Text
Package
OPTIONS
QUIT
オプション
終了
Package
OPTIONS
QUIT
オプション
終了
OPTIONS
QUIT
オプション
終了
OPTIONS
QUIT
Localization Dashboard

Gathering Text

Gather and Localize Text
Blue
Print
C++
① Gather text ② Create text
Loc
Res
③ Show text
Display on Editor Display on Game

Which text is gathered?
● Blueprint：FText, STextBlock
● C++/.ini：LOCTEXT, NSLOCTEXT

Unique Text (namespace/key/value)

● Using FormatText for loacalization
● Blackbox
”Discard <Item Name>”
● Number
“Got <Number> Items”
● Numeric
“1Hit”, ”2Hits”, etc...
● Unit
“USD”, ”yard”, etc...
Displaying text

There {NumCats}|plural(one=is,other=are) {NumCats} {NumCats}|plural(one=cat,other=cats)
one=”is”, other=”are” number one=”cat”, other=”cats”
Plural Forms (en)

There is 1 cat
There are 2 cats
(en)
Input translation text with
1匹の猫がいる
2匹の猫がいる
(ja)
Plural Forms (en→ja)

Auto formatting text
Text is converted for the culture original format
automatically.
1) Number：12345.67
● ja ： 12,345.67 ⇒ Grouping = ”,” , Decimal = ”.”
● de ： 12.345,67 ⇒ Grouping = ”.” , Decimal = ”,”
● fr ： 12 345,67 ⇒ Grouping = ” ” , Decimal = ”,”
2) Date：2020年10月31日
● ja ： 2019/10/31 ⇒ yyyy/mm/dd
● en ： Oct 31, 2019 ⇒ mm/dd/yyyy
● fr ： 31 oct. 2019 ⇒ dd-mm-yyyy

Language Plural Rules
http://www.unicode.org/cldr/charts/latest/supplemental/language_plural_rules.html

Gather
Source
Text
Package
Switch
Language
Translate
Source
Text
Package
OPTIONS
QUIT
オプション
終了
Package
OPTIONS
QUIT
オプション
終了
OPTIONS
QUIT
オプション
終了
OPTIONS
QUIT
Localization Dashboard .ini ﬁle/Console Command

Setting current language of text
● Startup game
● Launch argument
● Conﬁguration (.ini)
● System Language (OS)
● Runtime
● Console Command
● Call culture switching function

Switch display of the language API
Switch displaying text

Switch content display language
Culture
Language
Locale
Asset Group
Texts and Assets
Format display (Number/Date/Time)
Speciﬁc Assets and Classes
Text

Switch culture
● Accoding to set many priority rules, there are several
ways to specify the language of the game at launch
game
● Priority (Top is highest)
● “-culture” value with launch argument
● ”culture” value on xxxGame.ini
● ”culture” value on xxxEngine.ini

Gather
Source
Text
Package
Switch
Language
Translate
Source
Text
Display in editor in English
→ Display package in Japanese

Asset Localization Process

Package
Switch
Language
Placed
Asset

Package
Switch
Language
Placed
Asset
Placed target asset in
speciﬁed path.
Img (en)
Img (ja)

Package
Switch
Language
Placed
Asset
Make package game
including translation
text.
Package
Img (en)
Img (ja)

Package
Switch
Language
Placed
Asset
Package
Img (en)
Img (ja)
Display text depending
on required language.

Package
Switch
Language
Placed
Asset
Package
Img (en)
Img (ja)
Package
Img (en)
Img (ja)
Img (en)
Img (ja)
Editor

Placed Asset
● Apply Asset Localization
● Placed asset under”Content/L10N/[language]”
Source Texture Path
Content/UI/Texture/Logo/LogoBk
Localization Texture Path (ja)
Content/L10N/ja/UI/Texture/Logo/LogoBk

Placed Asset
● Apply Asset Localization
● Select Asset Localization in Content Browser

Package
Switch
Language
Placed
Asset
Package
Img (en)
Img (ja)
Package
Img (en)
Img (ja)
Img (en)
Img (ja)
Editor .ini ﬁle/Console Command

Setting current language of asset
● Startup game
● Launch argument
● Conﬁguration (.ini)
● Runtime
● Console Command
● Call culture switching function
Same as the text

Switch display of the language API
Switch displaying
asset

Switch content display language
Culture
Language
Locale
Asset Group
Texts and Assets
Format display (Number/Date/Time)
Speciﬁc Assets and Classes
Asset

Switching Asset Group
● Group assets and reuse them across languages
● Case where only some assets are used in diﬀerent languages.
● The text display is “ja”, but some of Audio wants to use “en”.
● Setting on xxxGame.ini and xxxEngine.ini

Asset Group
● Not using Asset Group
If we are setting the current culture is ja,
all texts and assets are displayed in ja
Text (ja) Asset (ja)

Asset Group
Audio (it)
Sound Wave
Sound Cue
● Using Asset Group
Text (ja)
Other
Asset (ja)
If we’re grouping ”Sound Wave” and ”Sound Cue” during the current culture is in ja,
”Sound Wave” and ”Sound Cue” are using in it language’s assets.
Class
Asset Group

● Setting the class to be linked to Asset Group
● Setting the language to which Asset Group is applied
Switching Asset Group
If the above settings are made,
Sound Wave and Sound Cue use “en” assets from startup.

Package
Switch
Language
Placed
Asset
Display in editor in English
→ Display package in Japanese

Speciﬁed Features
● Font
● Subtitle and Voice
● Subtitle of Media Framework

Localization for Font asset
● What about text localization?
● Want to change the font by language...
● Want to change the font size by language...
● How do we localize font asset?
● Use Asset Localization
● Use Sub Culture, and Sub Font Family

Apply Font Localization (1)
● Apply fonts by language with Asset Localization
Font (common)
Font (th)Font (ja)

Apply Font Localization (2)
● Use SubCulture and SubFont with Font Asset
Font
(common) Font Face
Fallback Font Family
Font Face
Sub Font Family
(ja)
Font Face
Sub Font Family
(th)
Font Face
Default Font Family

Font
Sub Font
Default Font
Fallback Font

Font
Applying language
Character range
Applying font

Subtitle and Voice localization
● Build dialogue system using dialogue assets
This message is
a subtitle test.
https://docs.unrealengine.com/en-US/Engine/Audio/Dialogue/index.html

Subtitle and Voice localization
● Dialogue System (for each sentence)
● Dialogue Wave ：Dialogue Data
● Dialogue Voice ：Talker Data
● Sound Wave ：Voice Sound
Dialogue Wave Dialogue Voice

Dialogue Wave
Subtitle text
Talker info
Voice asset

Localization of dialogue .wav
Apply text localization
Apply asset localization

Localization for subtitle of Media framework
● Switch media player subtitles by language
● Unreleased Features
● If you want to use then, need to modify the engine code.
● It’s necessary to add subtitle data playback process.

● Subtitle data
● Editable on editor
● Crate assets by language
● Capable of importing .srt ﬁle
Basic Overlays
Localized Overlays
Subtitles table
Basic Overlays
Subtitle data (ja)
Basic Overlays
Subtitle data (en)

● Assets that manage subtitles by language
● Set Basic Overlays for each language
Localized Overlays
Localized Overlays
Subtitles table
Basic Overlays
Subtitle data (ja)
Basic Overlays
Subtitle data (en)

Change to Return true, so it can be displayed on media
asset.
Unlock overlay features

Subtitle Data
Project
Engine
Widget
Playback media
Subtitle
Manager
Control subtitles
Subtitle Player
Playback subtitles
Localized
Overlays
Sutitiles for localization
Basic Overlays
Subtitle data (ja)
Basic Overlays
Subtitle data (en)
Basic Overlays
Subtitle data (fr)
Overlay and related classes

Subtitle Player Implementation Example
void UMyMediaSubtitlesPlayer::Play()
{
bEnabled = true;
}
void UMyMediaSubtitlesPlayer::Stop()
{
bEnabled = false;
FSubtitleManager::GetSubtitleManager()->SetMovieSubtitle(this, TArray<FString>());
}

Subtitle Player Implementation Example
void UMyMediaSubtitlesPlayer::Tick(float DeltaSeconds)
{
if (bEnabled && SourceSubtitles)
{
UMediaPlayer* MediaPlayerPtr = MediaPlayer.Get();
if (MediaPlayerPtr)
{
FTimespan CurrentTime = MediaPlayerPtr->GetTime();
TArray<FOverlayItem> CurrentSubtitles;
SourceSubtitles->GetOverlaysForTime(CurrentTime, CurrentSubtitles);
TArray<FString> SubtitlesText;
for (const FOverlayItem& Subtitle : CurrentSubtitles)
{
SubtitlesText.Add(Subtitle.Text);
}
FSubtitleManager::GetSubtitleManager()->SetMovieSubtitle(this, SubtitlesText);
}
else
{
Stop();
}
}
}

Misc
● Localization Preview
● Translation Picker
● String Table

Localization Preview
● Feature to preview Localization Text on UMG Designer
● Not compatiable with Localization Asset

Preview text updates after switching language
Comparison of localization preview
Update text
(en→ja)
Applu preview

● Preview Game Language (Editor Preference)
● If Preview language is selected, it’s aﬀected as default
Aﬀect from Editor Preferences

● Need to localize the text before using this feature.
localizing text... can select preview languages

Translation Picker
● Feature to extract text localization info from editor
● Can edit localization text without accesing dashboard

Translation Picker
● Enable picker
● Enable Translation Picker in Editor Preferences (Experimental)
● Show picker window
● From Window or select icon in translation editor

Translation Picker
Can edit translation text directly in PIE

String Table
● Registering ﬁxed phrases and strings
● Can import/export from .csv ﬁle

String Table
● Value can be referenced by specifying Key and Text
Set Table and Key
Aﬀect Value

String Table
● Note
● Conﬂict editng table
● Hard reference to assets

Project Settings
● The settings are required when Packaging
● Localizations to Package
● Languages for Cook/Stage/Package
● Internationalization Support
● Language set for internationalized data

Project Settings
● Localizations to Packages
● Settings that specify the language to be localized
● When not selected, it doesn’t include localization asset to package
Select from localized languages...Select target languages manually...

Project Settings
● How to speciﬁy a language for each platform
● Override language speciﬁcation in xxxGame.ini
● Following example, only “en” and “ja” assets and texts are
included when Packaging

● Internationalization Support
● Select preset including target language from the list
Project Settings
Preset Languages Size (MB)
English English ～1.77
EFIGS English, French, Italian, German, Spanish ～2.38
EFIGSCJK English, French, Italian, German, Spanish, Chinese, Korean, Japanese ～5.99
CJK Chinese, Korean, Japanese ～5.16
All All Languages ～15.3
Language Preset

In a nutshell
● UE4 has basic features for localization
● It’s better to use your own system or workﬂow
(depending on requirements)
● Consider localization plans early

Extra
● Localization Dashboard
● Settings

● Text Localization feature
● Gather text from assets and source code
● Export translated text and share it
● Manage and edit translated texts in languages
● Manage localization progress of translated texts
● Supporting Text Localization feature
● Can work with third-party provider service
● Can be linked with source control
● Can preview translated text and preview font
● Can check text conﬂicts

● Pros
● Localization is completed in UE4 Editor
● Immediate conﬁrmation after editing localized text
● Gather text over a wide range including source meta
● Cons
● If edit source text, aﬀects all languages content
● Experimental features (but can be used)

Localization Dashbord Overview
Target
Target DetailService Provider
Cultures
Gather Text
Misc

Target
Target Detail
Cultures
Gather Text
Service Provider
Misc

Text localize quick start ﬂow
① Add localization language
② Set target assets
③ Gather text
④Input translate text
⑤ Compile translated text
⑥ Update word count

● Linked Service Provider (XLoc, OneSky)
● Linked Source Control
Localization Service

Localization Service (One Sky)
https://www.oneskyapp.com/

Localization Service (XLoc)
http://www.xloc.com/

Editing .po ﬁle (Poedit)
https://poedit.net/

Localization Dashboard - Localization Service
Localization Service Provider
Localization Service Provider Select active service provider when using a speciﬁc localization.
Source Control
Enable Source Control If source control and service provider are available, connect to
source control during localization operations automatically.
Enable Auto Submit If source control and service providers are available, allow auto
submit during localization operations.

● Localization Target
● Classiﬁed by localization category
● Game Targets
For project code/asset
● Engine Targets
For engine code/asset
Localization Target

Localization Dashboard - Localization Target
Target
Name Specified for localization target.
Conflict Status Show conflict status of localize text.
Loading Policy Specified loading conditions for localized text of plugin and DLC.

Localization Target (Conﬂict Status)
Identify by namespace and key
(unique)

Not conflict : Texts are defined by different namespace or key

Conﬂict : Texts are assigned by same namespace and key

Conflict Status Description
Clear Clear state of gather unique to all text.
Conflicts Present It’s necessary to resolve conflict text.
Unknown State before key match check.
Update conflict status by gather text.
Check and correct from ✖ button whether there is a conflict or not

Cultures
Gather Text
Service Provider
Target
Target Detail
Misc

Gather Text
● Target of gathering text from content
(code/ﬁles/assets)
● Gather from Text Files
Text ﬁle (.cpp/.h/.ini )
● Gather from Packages
Asset (.uasset/.umap)
● Gather from Meta Data
Meta tag of UPROPERTY

Localization Dashboard - Gather Text
Gather Text
Target Dependencies Text present in these targets will not be duplicated in this target.
Additional Manifest Dependencies Text present in these manifests will not be duplicated in this
target.
Required Module Names The names of modules which must be loaded when gathering text.
Use to gather from packages or metadata sourced from a module
that isn't the primary game module.

Gather Text (Gather from Text Files)

Gather Text
Search Directories The paths of directories to be searched recursively for text files,
specified relative to the project's root, which may be parsed for
text to gather.
Exclude Path Wildcards Text files whose paths match these wildcard patterns will be
excluded from gathering.
File Extensions Text files whose names match these wildcard patterns may be
parsed for text to gather.
Should Gather from Editor Only Data If enabled, data that is specified as editor-only may be processed
for gathering.

Gather Text (Gather from Packages)

Gather Text
Include Path Wildcards Packages whose paths match these wildcard patterns, speciﬁed
relative to the project's root, may be processed for gathering.
Exclude Path Wildcards Packages whose paths match these wildcard patterns will be
File Extensions Packages whose names match these wildcard patterns may be
processed for text to gather.
Collections Packages in these collections may be processed for gathering.
for gathering.
Skip Gather Cache Should we ignore the cached text in the package header and
perform a full package load instead?

Gather Text (Gather from Meta Data)

Gather Text
Include Path Wildcards Packages whose paths match these wildcard patterns, speciﬁed
relative to the project's root, may be processed for gathering.
Exclude Path Wildcards Packages whose paths match these wildcard patterns will be
for gathering.

Gather Text
Key Specifications Specifications for how to gather text from specific metadata keys.
Meta Data Key The metadata key for which values will be gathered as text.
Text Namespace The localization namespace in which the gathered text will be output.
Text Key Pattern The pattern which will be formatted to form the localization key for
the metadata value gathered as text.

Export Text / Compile Text / Import Dialogue

Export Text
Collapse Mode How should we collapse down text when exporting to PO?
Should Persist Comments on Export Should user comments in existing PO files be persisted after
export? Useful if using a third party service that stores
editor/translator notes in the PO format's comment fields.
Should Add Source Locations as Comments Should source locations be added to PO file entries as
comments? Useful if a third party service doesn't expose PO
file reference comments, which typically store the source
location.

Compile Text
Skip Source Check Should we skip the source check when compiling
translations? This will allow translations whose source no
longer matches the active source to still be used by the
game at runtime.
Validate Format Patterns Should we validate that format patterns are valid for the
culture being compiled (eg, detect invalid plural rules or
broken syntax).
Validate Safe Whitespace Should we validate that text doesn't contain any unsafe
whitespace (leading or trailing whitespace) that could get
lost during the translation process.

Import Dialogue
Raw Audio Path Path to the folder to import the audio from. This folder is
expected to contain culture sub-folders, which in turn
contain the raw WAV ﬁles to import.
Imported Dialogue Folder Folder in which to create the generated sound waves. This is
relative to the root of the L10N culture folder (or the root
content folder if importing native dialogue as source
dialogue).
Import Native as Source Should the dialogue for the native culture be imported as if
it were source audio? If false, the native culture dialogue
will be imported as localized data for the native culture.

Localization Dashbord 概要
Cultures
Gather Text
Service Provider
Target
Target Detail
Misc

Base language
Localization target languages

Control by language
Control for all languages

Localization Dashbord (Gather Text)
Gather Text Gather text info from asset and source code
Import Text Import localized text file (.po)
Export Text Export localized text file (.po)
Import Script Import dialogue script file (.csv)
Export Script Export dialogue script file (.csv)
Import Dialogue Import Sound Wave and Dialogue Wave assets
Count Word Update translated text count and affect in word count
Compile Text Compile translated text and update text data

Settings

.ini ﬁle (Engine.ini)
Internationalization
Culture Language that displays all contents from application launching.
Language Language that displays texts/assets from application launching.
Locale Language that displays format-text from application launching.

.ini file (Engine.ini)
CultureMappings It can be replaced with another language.
EnabledCultures Only languages specified in configuration can be used.
DisabledCultures All languages specified in configuration can’t be used.
PreviewGameLaguage Select preview language in PIE or standalone launching.
LockLocalization Disable localization and lock text editing (editor only).

.ini ﬁle (Game.ini)

.ini file (Game.ini)
CultureMappings It can be replaced with another language.
EnabledCultures Only languages specified in configuration can be used.
DisabledCultures All languages specified in configuration can’t be used.
LockLocalization Disable localization and lock text editing (editor only).

.ini ﬁle (EditorSettings.ini)

.ini ﬁle (EditorSettings.ini)
ShouldUseLocalizedNumericInput Display numerical values such as property in Editor Language.
ShouldUseLocalizedPropertyNames Display Property name in Editor Language.
ShouldUseLocalizedNodeAndPinNames Display Blueprint Node and Blueprint Node Pin name in Editor
Language.
DisplayTimezone Aﬀects the initial time zone value when using DataTime type.

Localization feature of ue4

More Related Content

What's hot (20)

Similar to Localization feature of ue4 (20)

More from エピック・ゲームズ・ジャパン Epic Games Japan (20)

Recently uploaded (20)

Localization feature of ue4