Sửa lỗi tệp tin Mojibake

Mục lục

  1. Mô tả lỗi
  2. Ví dụ tiêu biểu
  3. Sửa lỗi
    1. Phát hiện định dạng mã hóa của mojibake
      1. Thông qua EasyRPG
      2. Thủ công
    2. Bắt đầu đổi tên

Mô tả lỗi

Có một số trường hợp khi người dịch hay nhà phát triển nén và giải nén game bằng máy tính vẫn chưa để vùng là Nhật Bản, và sau khi nén/giải nén thì tên của các tệp tin tài nguyên sẽ bị hỏng và chứa các kí tự vô nghĩa như hình ở bên dưới:

Khi bạn sao chép tên của tệp tin và đưa lên Google Dịch thì nó không hề có nghĩa gì cả:

Nếu bạn bắt gặp quá nhiều tệp tin như thế này thì game đó đã bị lỗi tệp tin Mojibake.

Ví dụ tiêu biểu

  • Một nhà phát triển tạo ra một game bằng tiếng Nhật, và chứa các tệp tin với ngôn ngữ là Nhật Bản. Nhà phát triển đó nén tệp tin lại và tải lên web.
    Lúc này tên của các tệp tin trong tệp tin nén vẫn bình thường vì máy của người đó đã để vùng là Nhật Bản.

  • Một dịch giả muốn dịch game sang tiếng Việt, và để vùng của máy tính là Hoa Kỳ (US) hoặc Việt Nam.
    Dịch giả này tải bản game gốc và giải nén ra máy tính, lúc này tên của các tệp tin đã giải nén trong máy sẽ bị hỏng do cách mã hóa của hai vùng khác nhau.

  • Dịch giả dịch xong game, nén lại thư mục đã dịch và tải lên web. Lúc này tệp tin nén đã được tạo với tên các tệp tin đã bị hỏng.
    Cho dù người chơi bản dịch có để ở vùng nào đi nữa thì tên của các tệp tin kia sẽ không thể khôi phục lại được như trước, và lỗi không tìm thấy tệp tin sẽ có thể xảy ra.

Sửa lỗi

Cách này chỉ hỗ trợ trên máy tính, và bạn cần cài Python trước khi bắt đầu sửa lỗi.

Đối với Linux thì có thể Python đã được cài sẵn; nhưng nếu không có thì hãy tham khảo hướng dẫn cho distro của bạn.

Phát hiện định dạng mã hóa của mojibake

Những dữ liệu này là do mình tự nghiên cứu được và có thể không đúng hoặc không đầy đủ. Nếu bạn có dữ liệu tốt hơn, cứ thoải mái đóng góp cho hướng dẫn này với dữ liệu của bạn.

Thông qua EasyRPG

Nếu game bạn đang chơi được dựa trên RPG Maker 2000/2003, bạn có thể thử chạy game thông qua EasyRPG. Phần mềm này sẽ tự động phát hiện định dạng mã hóa của các tệp tin.

  • Chạy game thông qua EasyRPG như mình đã hướng dẫn ở phần Tải và chạy game cho hệ điều hành của bạn.

  • Khi chạy game và xác định game đã chạy được, hãy mở tệp tin easyrpg-log.txt trong thư mục game. Tìm đến dòng có chữ Detected encoding và mã đằng sau nó sẽ là định dạng mã hóa của các tệp tin trong game. Ở đây sẽ là windows-936-2000.

  • Sau đó xét theo bảng này, bạn cần chuyển định dạng encoding mà EasyRPG in ra thành giá trị dưới đây để chuẩn bị cho script đổi tên tệp tin:
Giá trị EasyRPG in ra Giá trị trên Python
ibm-943_P15A-2003 cp932
windows-949-2000 cp949
windows-936-2000 gbk
ibm-5348_P100-1997 cp1252
ibm-5346_P100-1998 cp1250
ibm-5347_P100-1998 cp1251
ibm-9448_X100-2005 cp1256
ibm-5349_P100-1998 cp1253
ibm-9447_P100-2002 cp1255
  • Khi đối chiếu windows-936-2000 với bảng trên, chúng ta có được giá trị trên Python là gbk.

Thủ công

  • Sao chép đoạn script sau đây và lưu nó với tên detect_encoding.py:

Trong trường hợp tên tệp tin gốc trước khi bị hỏng có ngôn ngữ khác tiếng Nhật, bạn cần thay đổi shift-jis ở dòng 19 thành định dạng mã hóa của ngôn ngữ đó, ví dụ như gbk với tệp tin tiếng Trung Quốc.

import os
import sys
import pkgutil
import encodings

available_encodings = set(
    [modname for importer, modname, ispkg in pkgutil.iter_modules(encodings.__path__)]
)

if len(sys.argv) < 2:
    print("Usage: python detect_encoding.py <text>")
    sys.exit(1)

text = sys.argv[1]

for encoding in sorted(available_encodings):
    try:
        encoded = text.encode(encoding, errors="replace")
        decoded = encoded.decode("shift-jis")
        print(f"✅ {encoding}: {decoded}")
    except Exception:
        continue

  • Lấy tên đã bị hỏng của một tệp tin nào đó trong thư mục game, ví dụ như mình lấy tên 僞僀儔儞僩塃岦偒孁巋偟2.

  • Sau đó chạy script bằng lệnh sau, chú ý:

    • Thay /path/to/detect_encoding.py thành đường dẫn của tệp tin detect_encoding.py bạn vừa lưu.
    • Thay text thành tên của tệp tin bị hỏng bạn đã sao chép ở bước vừa rồi.
python "/path/to/detect_encoding.py" text

Ví dụ như:

python "/home/hyacine/detect_encoding.py" "僞僀儔儞僩塃岦偒孁巋偟2"
  • Sau khi chạy script, nó sẽ in ra toàn bộ các định dạng mã hóa và kết quả sau khi đã chuyển đổi.

  • Chúng ta có thể thấy chỉ có gb18030 và gbk là có chữ tiếng Nhật có nghĩa. Bạn có thể lấy 1 trong 2, nhưng mình sẽ lấy gbk. Đây sẽ là giá trị bạn cần dùng khi sử dụng script Python tiếp theo.

Bắt đầu đổi tên

  • Sao chép đoạn script sau đây và lưu nó với tên rename.py:

Trong trường hợp tên tệp tin gốc trước khi bị hỏng có ngôn ngữ khác tiếng Nhật, bạn cần thay đổi shift-jis ở dòng 7 thành định dạng mã hóa của ngôn ngữ đó, ví dụ như gbk với tệp tin tiếng Trung Quốc.

import os
import sys

def decode_filename(name: str, source_encoding: str) -> str | None:
    try:
        source_bytes = name.encode(source_encoding, errors="replace")
        return source_bytes.decode("shift_jis")
    except Exception:
        return None

def bulk_rename_files(root_folder: str, source_encoding: str):
    for dirpath, _, filenames in os.walk(root_folder):
        for name in filenames:
            new_name = decode_filename(name, source_encoding)
            if new_name and new_name != name:
                old_path = os.path.join(dirpath, name)
                new_path = os.path.join(dirpath, new_name)
                try:
                    os.rename(old_path, new_path)
                    print(f"✅ Renamed: {old_path} -> {new_path}")
                except Exception as e:
                    print(f"❌ Failed to rename: {old_path} ({e})")

if __name__ == "__main__":
    if len(sys.argv) != 3:
        print("Usage: python rename.py <root_folder> <source_encoding>")
        sys.exit(1)

    root = sys.argv[1]
    encoding = sys.argv[2]
    bulk_rename_files(root, encoding)
  • Sau đó chạy script bằng lệnh sau, chú ý:
    • Thay /path/to/rename.py thành đường dẫn của tệp tin rename.py bạn vừa lưu.
    • Thay /path/to/game/folder thành đường dẫn của thư mục game.
    • Thay encoding thành giá trị trên Python mà bạn đã tìm được từ một trong hai cách trên.
python "/path/to/rename.py" "/path/to/game/folder" encoding

Ví dụ như:

python "/home/hyacine/rename.py" "/home/hyacine/Nobihaza/MudaiNiKaizouban" gbk
  • Nếu script in ra dòng chữ Renamed với tên gốc thì tức là bạn đã tìm đúng định dạng mã hóa, và script đã đổi được tên về lại tiếng Nhật bình thường. Còn nếu script không in ra bất kì dòng nào (hay hiển thị lỗi Failed to rename) thì bạn cần xem lại định dạng mã hóa.

  • Lúc này nếu bạn quay trở lại thư mục game, bạn cũng sẽ thấy tên các tệp tin tài nguyên đã được khôi phục lại như ban đầu.

Back to top

Made with <3 in 2025 by Serena1432 and Nobihaza Vietnam Community.
Facebook Group / Discord Group

Trang web này có sử dụng một số ảnh từ Seekicons, Wikimedia Commons và một số trang web khác. Các thương hiệu và tên hãng được sử dụng trong hướng dẫn thuộc về các công ty chủ quản và các công ty khác có liên quan, và những người tạo ra hướng dẫn này sẽ không sở hữu bất kì thương hiệu, nhãn hiệu, hãng hay tổ chức nào.

Edit this page on GitHub.