Localizing a Chinese Game into Vietnamese: The Complete Guide
💡 Vietnamese is one of Southeast Asia's fastest-growing mobile gaming markets and a natural fit for Chinese game studios: Sino-Vietnamese vocabulary shares roots with Chinese, Android dominates, and Google Play supports the
vilocale natively. The two hurdles most teams hit are font coverage for Vietnamese diacritics and UI string expansion: both are solvable before store submission.
Key takeaways
- Use BCP 47 locale code
viorvi-VNin your engine, store listings, and HTML meta tags. Vietnamese is left-to-right, not RTL. - Your Chinese game font almost certainly lacks Unicode Latin Extended Additional (U+1E00-U+1EFF): the block where Vietnamese precomposed characters (ề, ổ, ắ, ữ) live.
- Leverage Sino-Vietnamese vocabulary: 武器 = vũ khí, 技能 = kỹ năng, 任务 = nhiệm vụ. A native Vietnamese reviewer confirms dialect register.
- Vietnamese UI strings are 3-5 times longer in character count than Chinese source labels. Reserve 30-60% extra horizontal space for buttons and HUD containers.
- Localize both in-game text and your Google Play and App Store product page to rank in Vietnamese app search.
Why is Vietnam a priority market for Chinese mobile game studios?
Vietnam has 79.8 million internet users (78.8% of the population) and 127 million active cellular connections, according to the DataReportal Digital 2025 Vietnam report. Mobile is the primary gaming device across the country. Vietnamese players are already familiar with Chinese-developed RPG, MOBA, and idle game titles. Cultural proximity through shared Sino-Vietnamese vocabulary, Buddhist mythology, and Three Kingdoms history means narrative content requires far less creative rewriting than Western markets.
The market runs largely on Android, making Google Play localization the first priority. The App Store matters for the premium urban iOS segment in cities like Hanoi and Ho Chi Minh City.
Does your Chinese game font cover Vietnamese diacritics?
Vietnamese uses Chữ Quốc Ngữ, a Latin-based script with extensive tone and vowel diacritics. The relevant Unicode block is Latin Extended Additional (U+1E00-U+1EFF), which contains precomposed characters like ề, ổ, ắ, ữ. Custom CJK fonts optimized for Chinese glyphs almost always skip this block, causing Vietnamese text to render as boxes or question marks.
Check your font file before writing any localization code. If coverage is missing, use one of these approaches:
- Bundle a Vietnamese-capable font such as Noto Sans, Be Vietnam Pro, or Source Han Sans as a per-locale fallback font asset in your engine.
- Extend your existing font through a professional type foundry if brand consistency across Chinese and Vietnamese matters to the studio.
One additional gotcha: the W3C language tag documentation notes that the Windows Vietnamese keyboard produces a different Unicode normalization than most third-party Vietnamese IME software. Always normalize Vietnamese strings to NFC (composed form) in your text pipeline to avoid sorting and comparison bugs.
How to handle Sino-Vietnamese terminology in game UI?
Chinese and Vietnamese share a large vocabulary layer borrowed from Classical Chinese, called Sino-Vietnamese (từ Hán Việt). For a Chinese game studio, this is a genuine localization advantage: many core game terms map almost directly through the Sino-Vietnamese path.
Common game UI term mappings from Chinese to Vietnamese:
- 武器 (weapon) = vũ khí
- 技能 (skill) = kỹ năng
- 装备 (equipment) = trang bị
- 任务 (quest or mission) = nhiệm vụ
- 战斗 (battle) = chiến đấu
- 商店 (shop) = cửa hàng (everyday) or thương điếm (formal Sino-Vietnamese)
The risk is register. Sino-Vietnamese terms can sound formal or archaic compared to everyday speech. For casual mobile games, Vietnamese players often prefer simpler pure-Vietnamese alternatives. Build a glossary of your game's 80-100 core terms in Chinese before translation begins. Have a native Vietnamese game localizer review term choices for tone.
Setting up vi-VN in Unity and Android
Unity Localization package (1.5+) steps for Vietnamese:
- Go to Edit > Project Settings > Localization and click Locale Generator.
- Check Vietnamese (vi-VN) and click Create Locales.
- Open Window > Asset Management > Localization Tables, click New Table Collection, select vi-VN, choose String Table Collection, and name the collection.
- Add Vietnamese string entries. Use Smart Strings for plural forms and variable substitution.
- Right-click any UI Text component, select Localize, and attach a Localize String component pointing to your table.
Android resource setup for Vietnamese:
- Create
res/values-vi/strings.xmlfor generic Vietnamese orres/values-vi-VN/strings.xmlfor Vietnam-specific strings, per the Android localization guide. - Wrap non-translatable content such as product names and promo codes in
<xliff:g>tags to protect them from translation tools. - Test on an emulator:
adb -e shell setprop persist.sys.locale vi-VN;stop;sleep 5;start
What you can localize in-house and when a native Vietnamese specialist is worth it
Tasks you can handle in-house or with MT tools:
- Font audit and Unicode NFC normalization: one-time technical setup requiring no translation work.
- Machine translation first pass for UI strings and store metadata using a game-specialized MT engine.
- Layout QA: verifying Vietnamese strings fit button and HUD containers after MT expansion.
- ADB locale testing on Android emulators and Unity Editor locale switching.
A native Vietnamese specialist adds real value when:
- Narrative dialogue and character names need cultural adaptation, not literal translation.
- Terminology must stay consistent across 10,000+ strings for player immersion.
- Monetization and payment flow copy must read naturally to convert Vietnamese players.
- Independent LQA (Localization Quality Assurance) by a Vietnamese reviewer is required before store submission.
On dialect: Standard Northern Vietnamese (tiêu chuẩn) covers all of Vietnam for written copy. One vi-VN locale reviewed by a native speaker familiar with both North and South registers serves the full market. Only voiced dialogue benefits from a Southern Vietnamese check if your game targets Ho Chi Minh City audiences specifically.
The Vietnamese game translation service on this site covers narrative copy, UI strings, and App Store and Google Play listing localization end to end.
FAQ
What locale code should I use for Vietnamese in my game engine and store listings?
Use vi (BCP 47 primary subtag) for a generic Vietnamese build, or vi-VN for the Vietnam regional variant. Both Google Play Store Listings and Apple App Store Connect accept vi. Unity's Locale Generator lists it as "Vietnamese (vi-VN)". Android uses res/values-vi/ or res/values-vi-VN/ resource directories.
Why does Vietnamese text show boxes or question marks in my Chinese game build?
The most common cause is a font lacking Unicode Latin Extended Additional (U+1E00-U+1EFF) coverage. Vietnamese diacritics such as ề, ổ, ắ live in that block. A secondary cause is Unicode normalization mismatch: Vietnamese IME software may produce NFD (decomposed form) strings, causing display and search failures. Normalize all Vietnamese text to NFC at import and bundle a font with full Latin Extended Additional coverage.
How much longer are Vietnamese UI strings than Chinese source labels?
Vietnamese strings are typically 3-5 times longer in character count than Chinese equivalents. For example, 战斗 (2 chars) becomes chiến đấu (9 chars). Rendered pixel widths expand less dramatically because Chinese glyphs are wider, but button and HUD containers often need roughly 30-60% more horizontal space. Test with the longest plausible Vietnamese strings in every screen layout before the final QA build.
Do I need separate Northern and Southern Vietnamese versions of my game?
No. Standard Northern Vietnamese (tiêu chuẩn) is the publishing norm across all of Vietnam for written content. A single vi-VN locale reviewed by a native speaker familiar with both registers serves the whole market. Only voiceover lines benefit from a Southern Vietnamese review if the game specifically targets a Ho Chi Minh City audience.
Can I use my existing Chinese-English TM for Chinese-to-Vietnamese localization?
Not directly. Your Chinese source strings are the correct starting point, but a Chinese-English TM is not reusable as Chinese-Vietnamese. Import your Chinese source into a CAT tool such as Trados, memoQ, Crowdin, or Smartcat with a dedicated Chinese-Vietnamese language pair. A Vietnamese translation memory built through successive game updates compounds in value as terminology becomes consistent across patches and DLC.
Sources
Official sources consulted for this guide:
- W3C International: Language tags in HTML and XML - BCP 47 locale code guidance including
viandvi-VN. Verified September 2026. - Google Play Console: Localize your app - Vietnamese (vi) store listing localization via Store Listings > Manage translations. Verified September 2026.
- Apple Developer: App Localization - App Store Connect for 175 regions and 50 languages including Vietnamese. Verified September 2026.
- DataReportal: Digital 2025 Vietnam - 79.8M internet users, 78.8% penetration, 127M cellular connections. Verified September 2026.
Written by Dao Huy (Lucas), Vietnamese translator & localization specialist (EN · ZH · FR → Vietnamese). See translation services →
