Nhập Trò Chơi

Spark hỗ trợ nhiều phương pháp nhập trò chơi Ren’Py vào thiết bị iOS của bạn.

• ZIP (.zip) — Phổ biến nhất
• APK (.apk) — Gói Android
• 7-Zip (.7z) — Nén cao
• RAR (.rar) — Hỗ trợ kế thừa
• TAR (.tar) — Lưu trữ không nén
• Gzip (.gz) — Lưu trữ TAR nén bằng Gzip
• BZ2 (.bz2) — Lưu trữ TAR nén bằng Bzip2
• IPA (.ipa) — Lưu trữ ứng dụng iOS
• APP (.app) — Gói ứng dụng

1. Mở Spark và nhấn nút Import trong thư viện
2. Duyệt đến file lưu trữ trò chơi bằng trình chọn file hệ thống
3. Chọn file và đợi quá trình trích xuất hoàn tất

Spark kiểm tra file lưu trữ trước khi trích xuất:

• Tính toán kích thước giải nén để xác minh bạn có đủ dung lượng trống
• Phát hiện xem file lưu trữ có được bảo vệ bằng mật khẩu không và yêu cầu bạn nhập mật khẩu nếu cần
• Quét nội dung file lưu trữ để tìm thư mục game/

Nếu tìm thấy nhiều thư mục trò chơi bên trong file lưu trữ, bạn sẽ được yêu cầu chọn thư mục nào để nhập.

File lưu trữ được trích xuất vào thư mục tạm thời. Spark theo dõi dung lượng đĩa trong quá trình trích xuất và sẽ dừng nếu bộ nhớ sắp hết. Các thư mục artifact macOS (__MACOSX) được tự động xóa.

Đối với file APK đóng gói kép (ZIP chứa APK bên trong), Spark phát hiện điều này và tự động trích xuất cả hai lớp.

Sau khi trích xuất, Spark tổ chức các file vào thư mục trò chơi cuối cùng:

• Thư mục trò chơi — Thư mục game/ chứa script, tài sản và file lưu trữ được di chuyển đến vị trí cuối cùng
• Tên trò chơi — Được xác định từ android.json (nhập APK), file .py bên cạnh thư mục trò chơi, hoặc tên file lưu trữ làm phương án dự phòng
• Đặt tên duy nhất — Nếu trò chơi cùng tên đã tồn tại, hậu tố số được thêm vào

Spark tìm kiếm trong các file đã trích xuất thư mục engine Ren’Py đi kèm (renpy/). Nếu tìm thấy:

• Engine được lưu vào thư mục advanced/renpy/ của trò chơi để sử dụng với Advanced Mode
• Phiên bản Ren’Py được đọc từ các file phiên bản bên trong thư mục engine (ví dụ: vc_version.py, __init__.py, script_version.txt, hoặc các phiên bản đã biên dịch tương đương)
• Phiên bản được phát hiện được lưu trữ trong metadata của trò chơi để khớp engine
• Đối với nhập APK Android, file đi kèm (private.mp3) được trích xuất để phục hồi engine và phát hiện phiên bản Python

• Font tùy chỉnh — Nếu engine đi kèm của trò chơi bao gồm font đã sửa đổi (khác với font mặc định của Ren’Py), chúng được sao chép vào thư mục trò chơi để trò chơi có thể sử dụng khi chạy
• Hỗ trợ Live2D — File lưu trữ được quét để tìm thư viện Live2D. Nếu tìm thấy, một đánh dấu được tạo để Spark tải framework Live2D khi trò chơi khởi chạy

• File info.json được ghi với tên trò chơi, phiên bản engine được phát hiện, tên file lưu trữ gốc, và dấu thời gian nhập
• Các thư mục tạm thời được xóa và file tạm được loại bỏ
• Thư viện trò chơi được làm mới và trò chơi mới xuất hiện trong thư viện

• Trò chơi lớn (1 GB+) có thể mất một lúc để trích xuất
• Một số định dạng lưu trữ như 7z có thể mất rất nhiều thời gian để trích xuất nếu file lưu trữ chứa hàng nghìn file rời. Trò chơi lý tưởng nên được đóng gói bằng file .rpa hoặc các định dạng gộp tương tự. Một số thư viện trích xuất không được tối ưu cho các tình huống này
• Nếu trò chơi xuất hiện nhưng không khởi chạy được, thử thay đổi phiên bản engine trong Game Settings
• File APK có thể bị ẩn bởi bộ lọc file — tắt trong Settings > Game Library