Vấn đề Nhập

Triệu chứng: Khi cố nhập, tệp trò chơi bị xám hoặc không hiển thị.

Nguyên nhân: Bộ lọc phần mở rộng tệp của Spark chỉ hiển thị các định dạng được nhận diện theo mặc định.

Giải pháp:

1. Vào Settings > Game Library
2. Tắt File Extension Filter
3. Thử nhập lại

Điều này đặc biệt phổ biến với tệp APK.

Triệu chứng: Nhập có vẻ hoàn thành, nhưng không có trò chơi nào xuất hiện trong thư viện.

Nguyên nhân có thể:

1. Cấu trúc trò chơi không hợp lệ — Kho lưu trữ không chứa trò chơi Ren’Py hợp lệ

   • Giải pháp: Xác minh kho lưu trữ chứa thư mục game/ với các tệp .rpy hoặc .rpa

2. Thư mục lồng nhau — Trò chơi nằm quá sâu trong kho lưu trữ

   • Giải pháp: Giải nén kho lưu trữ trên PC trước, sau đó chỉ chuyển thư mục trò chơi

3. Kho lưu trữ bị hỏng — Tệp bị hư hại

   • Giải pháp: Tải lại kho lưu trữ

Triệu chứng: Nhập thất bại với lỗi “Unable to find the ‘game’ folder. Is this a Ren’Py title? It is possible that the game was packaged in an unknown way.”

Nguyên nhân: Spark quét kho lưu trữ đã giải nén để tìm thư mục game/, đây là cấu trúc tiêu chuẩn cho trò chơi Ren’Py. Nếu không tìm thấy, việc nhập không thể tiếp tục. Điều này có thể xảy ra khi:

• Kho lưu trữ không phải là trò chơi Ren’Py
• Trò chơi được đóng gói theo cách không chuẩn (đóng gói lại không chính thức, cấu trúc thư mục tùy chỉnh)
• Kho lưu trữ được đóng gói hai lần và phát hiện tự động của Spark không tìm thấy trò chơi bên trong

Giải pháp:

1. Xác minh kho lưu trữ thực sự là trò chơi Ren’Py chứa thư mục game/
2. Thử sử dụng kho lưu trữ trò chơi chính thức từ nhà phát triển gốc thay vì phiên bản đóng gói lại
3. Nếu kho lưu trữ chứa trò chơi Ren’Py hợp lệ nhưng Spark không thể phát hiện, hãy báo cáo cho đội hỗ trợ trên Discord hoặc qua email

Triệu chứng: Nhập thất bại với lỗi “Legacy Method — Unable to find game folder.”

Nguyên nhân: Sau khi phát hiện thư mục trò chơi chính thất bại, Spark thử phương thức dự phòng quét legacy tìm kiếm đệ quy toàn bộ kho lưu trữ đã giải nén để tìm thư mục game/. Lỗi này có nghĩa là ngay cả phát hiện legacy cũng không thể xác định trò chơi hợp lệ.

Giải pháp:

• Cấu trúc kho lưu trữ có thể không tương thích. Thử phiên bản hoặc kho lưu trữ nền tảng khác của trò chơi
• Giải nén kho lưu trữ trên PC, xác minh cấu trúc thư mục và đóng gói lại thành ZIP tiêu chuẩn với thư mục game/ ở cấp mong đợi
• Báo cáo vấn đề cho đội hỗ trợ kèm tên trò chơi

Triệu chứng: Trò chơi không khởi chạy với thông báo “Unable to determine Ren’Py Version. Aborting Launch.” hoặc yêu cầu bạn chỉ định phiên bản engine.

Nguyên nhân: Spark không thể tự động phát hiện phiên bản Ren’Py mà trò chơi yêu cầu.

Giải pháp: Mở Game Settings (nhấn giữ trò chơi), chạm Modify bên cạnh phiên bản Ren’Py và chọn thủ công phiên bản engine đúng. Nếu bạn không chắc, hãy thử phiên bản 7.x mới nhất cho trò chơi cũ hoặc phiên bản 8.x mới nhất cho trò chơi mới.

Triệu chứng: Khởi chạy thất bại với lỗi “The requested engine version was not found.”

Nguyên nhân: Phiên bản engine được chọn cho trò chơi không khả dụng trên thiết bị.

Giải pháp: Mở Game Settings và chọn phiên bản engine khả dụng khác.

Triệu chứng: Nhập thất bại với lỗi hiển thị kích thước giải nén ước tính và dung lượng khả dụng.

Nguyên nhân: Thiết bị của bạn không có đủ dung lượng trống để giải nén kho lưu trữ. Bạn thường cần ít nhất 2 lần kích thước kho lưu trữ (kho lưu trữ cộng với các tệp đã giải nén).

Giải pháp: Giải phóng dung lượng trên thiết bị và thử lại. Sử dụng Trình quản lý Lưu trữ để xác định trò chơi hoặc bản sao lưu bạn có thể xóa.

Triệu chứng: Nhập thất bại với “Unable to determine the uncompressed archive size. Is the archive corrupt?”

Nguyên nhân: Spark không thể đọc metadata của kho lưu trữ để tính kích thước giải nén. Tệp có thể bị hỏng hoặc ở biến thể định dạng không được hỗ trợ.

Giải pháp: Tải lại kho lưu trữ và thử lại. Nếu vấn đề vẫn tiếp diễn, kho lưu trữ có thể sử dụng định dạng không chuẩn — báo cáo cho đội hỗ trợ.

Triệu chứng: Nhập thất bại với “Unable to obtain file permission from the operating system.”

Nguyên nhân: iOS không cấp quyền cho Spark truy cập tệp đã chọn. Điều này có thể xảy ra với tệp từ một số nhà cung cấp lưu trữ đám mây hoặc vị trí bên ngoài.

Giải pháp: Thử sao chép kho lưu trữ vào phần On My iPhone/iPad trong ứng dụng Files trước, sau đó nhập từ đó.

Triệu chứng: Thanh tiến trình bị đóng băng hoặc lỗi không được liệt kê xuất hiện trong quá trình nhập.

Giải pháp:

• Đảm bảo bạn có đủ dung lượng trống (ít nhất 2 lần kích thước kho lưu trữ)
• Đối với kho lưu trữ rất lớn (2 GB+), nhập có thể mất vài phút — hãy kiên nhẫn
• Một số định dạng kho lưu trữ như 7z có thể cực kỳ chậm với hàng nghìn tệp rời
• Nếu lỗi vẫn tiếp diễn, báo cáo cho đội hỗ trợ kèm thông báo lỗi và tên trò chơi

Triệu chứng: Sau khi nhập APK, trò chơi có tên không chính xác hoặc tên chung.

Nguyên nhân: Tên trò chơi không thể xác định từ metadata APK.

Giải pháp: Nhấn giữ trò chơi trong thư viện và đổi tên thủ công.