💡 Thêm tiếng Việt vào game UE5: mở Localization Dashboard, thêm mã vi vào Cultures, đánh dấu chuỗi hiển thị bằng NSLOCTEXT, xuất PO để dịch, nhập lại và biên dịch sang LocRes. Hai điểm cần lưu ý đặc biệt cho tiếng Việt: font chữ phải hỗ trợ 134 ký tự dấu, và văn bản từ người dùng cần chuẩn hóa NFC.
Điểm chính
- Mở Tools > Localization Dashboard, thêm mã văn hóa
vivào mục Cultures, đặt ngôn ngữ gốc (thường làen). - Đánh dấu mọi chuỗi hiển thị cho người chơi bằng
NSLOCTEXT("NS","Key","Source")trong C++ hoặc dùng String Table trong Blueprint. - Xuất file PO, dịch với Poedit hoặc công cụ CAT, nhập lại, rồi nhấn Compile để tạo LocRes trước khi đóng gói.
- Dùng font có đủ khối Latin Extended Additional (U+1E00-U+1EFF): Noto Sans, Source Sans 3 hoặc Roboto đều hoạt động tốt trong UE5.
- Chuẩn hóa mọi văn bản tiếng Việt từ người dùng về NFC trước khi hiển thị hoặc so sánh - các phương thức nhập khác nhau tạo ra chuỗi Unicode khác nhau cho cùng một ký tự.
Vì sao thị trường game Việt Nam đáng để bản địa hóa?
Việt Nam có 79,8 triệu người dùng internet tính đến đầu năm 2025, với hơn 127 triệu kết nối di động trong dân số khoảng 100 triệu người (nguồn: DataReportal Digital 2025 Việt Nam). Người dùng Việt Nam tiếp cận game chủ yếu qua thiết bị di động. Gaming là một trong những danh mục có thời gian sử dụng cao nhất trên Android và iOS. Phần lớn các tựa game quốc tế vào thị trường Việt Nam hiện vẫn ở ngôn ngữ tiếng Anh hoặc tiếng Trung giản thể. Người chơi Việt Nam khi gặp một tựa game đã được bản địa hóa sang tiếng Việt có xu hướng gắn bó lâu hơn và chi tiêu nhiều hơn trong game.
Về mặt ngôn ngữ, tiếng Việt không có giới tính ngữ pháp và không biến hình danh từ theo số lượng - hai yếu tố này giúp giảm thời gian dịch so với các ngôn ngữ biến hình như tiếng Pháp hay tiếng Đức. Thách thức kỹ thuật chính là font chữ và chuẩn hóa Unicode, cả hai đều được hướng dẫn trong bài này.
Mở Localization Dashboard và thêm tiếng Việt
Trong UE5 Editor, mở Tools > Localization Dashboard. Nếu chưa có localization target, nhấn Add New Target và đặt tên (thường là "Game"). Trong tab Cultures, nhấn + và nhập vi - đây là thẻ ngôn ngữ BCP 47 cho tiếng Việt. Mã vi-VN cũng hợp lệ nhưng không có lợi thực tế trừ khi bạn cần build riêng cho cộng đồng người Việt hải ngoại. Đặt ngôn ngữ nguồn làm Native culture.
Trong mục Gather, trỏ bộ thu thập vào thư mục source code và content. Chạy Gather Text để quét toàn bộ macro NSLOCTEXT, text pin trong Blueprint và String Table vào file manifest. Sau đó dùng Export để tạo file .po cho culture vi và gửi cho người dịch.
Khi nhận bản dịch về, dùng Import để nạp lại PO vào archive. Chạy Compile để tạo file nhị phân .locres và .locmeta mà runtime đọc lúc chạy game. Bật vi trong Project Settings > Packaging > Localizations to Package trước khi build cuối cùng.
Chuỗi nào cần NSLOCTEXT và chuỗi nào không cần?
Mọi văn bản mà người chơi đọc trong game đều cần dùng FText tạo bằng NSLOCTEXT hoặc LOCTEXT. Điều này bao gồm nhãn nút, lời thoại NPC, hướng dẫn, thông báo lỗi, mô tả tooltip, tên thành tích và mục tiêu nhiệm vụ. String Table là lựa chọn thay thế hướng dữ liệu: tạo asset ST_Game.csv và tham chiếu các hàng bằng LOCTABLE. Text pin trong Blueprint tự động bọc FText và được thu thập mà không cần thao tác thêm.
Những chuỗi không nên bản địa hóa bao gồm: thông báo log debug, khóa API và đường dẫn endpoint, tên sự kiện analytics, đường dẫn tham chiếu asset, và bất kỳ chuỗi nào không hiển thị cho người chơi. Dùng INVTEXT hoặc FString thông thường cho những trường hợp đó. Đánh dấu nhầm một định danh nội bộ bằng NSLOCTEXT chỉ làm phình manifest và tạo nhiễu cho người dịch khi xem xét hàng nghìn chuỗi.
Định dạng số, tiền tệ và tham số FText trong tiếng Việt
Dùng FText::Format() với tham số đặt tên cho chuỗi thay đổi lúc runtime. Đồng Việt Nam (VND) không có đơn vị nhỏ hơn, vì vậy luôn định dạng tiền tệ với số chữ số thập phân bằng 0. FText::AsCurrencyBase() áp dụng quy tắc văn hóa ICU: với culture vi, nó dùng dấu chấm ngăn cách hàng nghìn và không có số thập phân. FText::AsDate() xuất thứ tự ngày trước (dd/MM/yyyy) đúng như người đọc Việt Nam mong đợi.
Modifier plural {Count}|plural(one=item,other=items) có sẵn trong Unreal, nhưng tiếng Việt không có hình thức số nhiều ngữ pháp. Người dịch giỏi sẽ cơ cấu lại câu để tránh hoàn toàn hình thức số nhiều thay vì dùng modifier này. Tiếng Việt dùng từ phân loại (cái, con, chiếc, cuốn) thay cho biến hình, và những từ này thay đổi theo loại danh từ theo cách không thể mã hóa trong một quy tắc plural đơn giản.
Văn bản tiếng Việt có dài hơn tiếng Anh trong giao diện không?
Chuỗi tiếng Việt thường có độ dài từ gần tương đương tiếng Anh, nhưng mỗi ký tự mang dấu chồng. Một ký tự như ộ (o + mũ + chấm dưới) hiển thị cao hơn một chữ ASCII thuần túy. Điều này có nghĩa là văn bản tiếng Việt cần chiều cao dòng lớn hơn khoảng 10-20% so với văn bản Latin không có dấu. Các nút được thiết kế vừa nhãn tiếng Anh có thể bị cắt văn bản tiếng Việt ở trên và dưới thay vì ở hai bên.
Hãy kiểm thử các layout giao diện bị ràng buộc nhất với chuỗi tiếng Việt thực tế từ sớm. Cách ước lượng nhanh: thêm ký tự "g" hoặc "y" vào cuối mỗi từ tiếng Anh để xấp xỉ độ tràn theo chiều dọc. Về chiều dài dòng, tiếng Việt thường tương đương tiếng Anh vì các từ Việt ngắn hơn bù cho dấu diacritic. Rủi ro UI trong tiếng Việt là theo chiều dọc, không phải ngang.
Những gì nhóm có thể tự làm và khi nào cần chuyên gia bản địa hóa tiếng Việt
Nhóm kỹ thuật của bạn có thể tự xử lý toàn bộ pipeline trong hướng dẫn này: thiết lập Dashboard, xuất/nhập PO, chọn font, chuẩn hóa NFC và kiểm thử với -culture=vi. Các công cụ dịch máy như DeepL và Google Translate tạo ra bản nháp đầu tiên sử dụng được cho các chuỗi UI đơn giản - nhãn nút, mục menu, thông báo hệ thống với ngữ cảnh tối thiểu.
Chuyên gia tiếng Việt bản ngữ thực sự đáng đầu tư cho:
- Lời thoại và cốt truyện game: lời NPC dịch máy nghe đơn điệu hoặc gượng gạo, phá vỡ sự đắm chìm ngay lập tức.
- Metadata cửa hàng ứng dụng: tiêu đề, mô tả ngắn và mô tả đầy đủ là ấn tượng đầu tiên và ảnh hưởng trực tiếp đến khả năng khám phá trên Google Play và App Store tại Việt Nam.
- Tên nhân vật và trò hài có yếu tố văn hóa: người chơi Việt Nam nhận ra ngay khi tên nhân vật có nghĩa không mong muốn trong tiếng Việt.
- Giọng văn Bắc/Nam: tiếng Việt viết chuẩn được hiểu ở mọi vùng miền, nhưng cách dùng từ như "xe máy" (Nam) hay "xe gắn máy" (Bắc) tiết lộ nguồn gốc văn bản với người đọc bản ngữ.
Một lượt review của chuyên gia bản địa hóa game tiếng Việt bản ngữ sau bản nháp dịch máy sẽ bắt được hầu hết các vấn đề trên với chi phí chỉ bằng một phần so với dịch toàn bộ.
Mã văn hóa nào nên dùng cho tiếng Việt trong Unreal Engine?
Dùng vi làm thẻ ngôn ngữ BCP 47. Mã vùng vi-VN hợp lệ về mặt kỹ thuật nhưng không có lợi thực tế trừ khi bạn cần build riêng cho cộng đồng người Việt hải ngoại như Việt kiều Mỹ.
Có thể dùng DeepL hoặc Google Translate để tự động tạo file PO tiếng Việt không?
Dịch máy xử lý tốt các chuỗi ngắn, rõ ngữ cảnh như nhãn nút và mục menu. Nó gặp khó khăn với lời thoại dài, thành ngữ và nội dung đặc thù văn hóa. Dùng dịch máy làm bản nháp đầu cho chuỗi UI, sau đó nhờ người nói tiếng Việt bản ngữ review lời thoại, văn bản marketing và metadata cửa hàng trước khi phát hành.
Người chơi miền Bắc và miền Nam có cần bản địa hóa riêng không?
Không. Tiếng Việt viết chuẩn được hiểu ở mọi vùng miền. Tiếng địa phương khác nhau về từ vựng và phát âm, nhưng game phát hành đều dùng ngôn ngữ viết chuẩn. Ngoại lệ duy nhất là lồng tiếng: giọng Bắc (Hà Nội) và giọng Nam (TP.HCM) đều chấp nhận được, nhưng chọn một giọng có thể ảnh hưởng đến cảm nhận của đối tượng vùng miền còn lại.
Làm thế nào để kiểm thử bản địa hóa tiếng Việt khi không có đội QA người Việt?
Chạy game với culture ép sang vi bằng flag dòng lệnh -culture=vi, hoặc thay đổi preview culture trong Localization Dashboard. Kiểm tra văn bản bị cắt, glyph font thiếu hiển thị dưới dạng ô vuông và layout tràn. Nhờ người bản ngữ review một mẫu chuỗi - đặc biệt là lời thoại và metadata cửa hàng - trước khi QA toàn diện.
Xử lý văn bản tiếng Việt do người chơi nhập như thế nào?
Chuẩn hóa toàn bộ văn bản tiếng Việt do người chơi nhập về Unicode NFC trước khi lưu trữ hoặc hiển thị. Các phương thức nhập tiếng Việt tạo ra chuỗi codepoint khác nhau cho cùng một ký tự. Nếu không chuẩn hóa, hai người chơi nhập cùng một tên có thể tạo ra các chuỗi so sánh không bằng nhau trong hệ thống tìm kiếm hoặc ghép đội.
Nguồn tham khảo
- Unreal Engine Localization Overview - định dạng file, quy trình, thư viện ICU. Đã xác minh tháng 11 năm 2026.
- Unreal Engine Text Localization - FText, NSLOCTEXT, modifier format, String Table. Đã xác minh tháng 11 năm 2026.
- W3C: Unicode Migration - Chuẩn hóa tiếng Việt - yêu cầu NFC cho tiếng Việt. Đã xác minh tháng 11 năm 2026.
- DataReportal: Digital 2025 Việt Nam - 79,8 triệu người dùng internet, 127 triệu kết nối di động. Đã xác minh tháng 11 năm 2026.

Bài viết bởi Đào Huy (Lucas), biên dịch viên và chuyên viên bản địa hóa tiếng Việt (Anh, Trung, Pháp sang Việt). See translation services →
