Nhập trò chơi

Sakura nhập các trò chơi NScripter và ONScripter (bao gồm cả các trò chơi ONScripter-RU như Umineko) trực tiếp trên thiết bị của bạn — không cần máy tính. Trang này bao quát toàn bộ quy trình nhập trong ứng dụng. Nếu bạn muốn nhập từ trình duyệt trên máy tính, xem Truyền qua web thay vào đó.

• Từ Thư viện, chạm vào thẻ Nhập trò chơi (.zip, .7z, .rar, .tar, .gz, .bz2, .exe).
• Nếu thư viện của bạn đang trống, màn hình Không tìm thấy trò chơi có nút Nhập riêng.

Thao tác này mở popup Nhập trò chơi ONScripter, liệt kê các định dạng tệp được hỗ trợ và giải thích rằng thư mục gốc của trò chơi ONScripter sẽ được phát hiện tự động. Chạm Chọn tệp nén để mở bộ chọn tệp hệ thống và chọn một tệp nén duy nhất.

• zip — giải nén bằng ZIPFoundation (hoặc SSZipArchive nếu có mật khẩu bảo vệ)
• 7z — giải nén bằng PLzmaSDK
• rar — giải nén bằng UnrarKit
• tar / gz / bz2 / tgz — bộ đọc tar/gzip/bzip2 dạng streaming tích hợp sẵn
• lzh / lha — bộ giải nén LHA gốc
• exe (chỉ trình cài đặt/tệp tự giải nén) — được phát hiện theo thứ tự: trình cài đặt NSIS, trình cài đặt Inno Setup, sau đó quét 16 MB đầu tiên để tìm dữ liệu tự giải nén 7z/zip nhúng bên trong, rồi đến LHA-SFX

1. Chuẩn bị (Staging). Nếu tệp nén nằm trên iCloud Drive, Sakura sẽ tải nó về máy trước. Sau đó nó kiểm tra dung lượng trống — cần khoảng 3 lần kích thước tệp nén nếu phải tạo bản sao tạm, hoặc 2 lần nếu tệp đã có sẵn trên máy. Nếu không đủ dung lượng, bạn sẽ thấy “Insufficient Disk Space”: “Not enough free space to extract this archive. Please free up storage and try again.”

2. Kiểm tra mật khẩu. Nếu tệp nén được mã hóa (chỉ zip/rar/7z), bạn sẽ được yêu cầu: “This archive is password-protected. Please enter the password to continue.” Mật khẩu sai sẽ hiện “Incorrect password. Please try again.”

3. Quét trước. Trước khi giải nén, Sakura quét tên các mục để tìm các dấu hiệu nhận diện NScripter/ONScripter — các tập lệnh khởi động như 0.txt, 00.txt, nscript.dat, nscr_sec.dat, nscript.___, 0.utf, 00.utf, pscript.dat, hoặc script.file (định dạng tập lệnh đóng gói dùng bởi các trò chơi ONScripter-RU như Umineko), cùng các gói tệp nén như arc*.nsa, *.ns2, hoặc *.sar. Tar và các định dạng khác không thể quét trước sẽ được kiểm tra ngay sau khi giải nén.

   Nếu không có gì khớp, bạn sẽ thấy: “This archive doesn’t look like an ONScripter game. Look for archives containing 0.txt, nscript.dat, or an arc.nsa pack.”

4. Giải nén. Một đếm ngược ngắn (“Starting…”) chạy trước khi bắt đầu giải nén, cùng phần trăm trực tiếp sau đó và tùy chọn Hủy. Một vài chi tiết theo từng định dạng:

   • Tên tệp trong zip được giải mã bằng UTF-8 trước, rồi dự phòng sang Shift-JIS — điều này khắc phục lỗi ký tự lạ trong các tệp nén tiếng Nhật.
   • Việc giải nén RAR có bước kiểm tra tính toàn vẹn hậu-giải nén cho các tệp thiết yếu khi khởi động; nếu có tệp nào bị thiếu hoặc cắt cụt, bạn sẽ thấy: “RAR extraction incomplete: N essential files missing or truncated (e.g. {sample}). Re-pack the game as ZIP or 7z and import that.”
   • Các thư mục __MACOSX được tự động xóa.

5. Phát hiện thư mục gốc trò chơi. Sakura thực hiện tìm kiếm có giới hạn (tối đa 6 cấp thư mục) để tìm thư mục nông nhất chứa một trong các dấu hiệu NScripter nêu trên — vì vậy một tệp nén lồng nhau như Title 1.0/Title 1.0/game files… vẫn được xác định đúng.

6. Cài đặt. Trò chơi được cài vào thư mục riêng trong thư viện của bạn, cùng với một thư mục Patches trống dành cho mod hoặc bản vá dịch. Nếu một tệp nén cùng tên đã được nhập trước đó, một hậu tố số sẽ được thêm vào.

Nếu quá trình giải nén bị hủy, bạn sẽ thấy Cancelled cùng Close / Restart. Nếu có sự cố xảy ra, popup Fatal Error sẽ đưa ra tùy chọn Close hoặc Import Another?.

Sau khi nhập thành công, bước Customize cho phép bạn đặt Tên trò chơi (được điền sẵn từ tên phát hiện được) và chọn Biểu tượng — xem Biểu tượng trò chơi để biết cách các ứng viên biểu tượng được tìm thấy. Chạm Save để giữ lựa chọn của bạn, hoặc Skip để dùng mặc định.

Màn hình cuối cùng xác nhận “Imported ONScripter Game” cùng tên trò chơi, và đưa ra tùy chọn Close hoặc Jump to Game? để mở nó ngay.

• Thấy “Unsupported Format” hoặc “Unsupported archive format”? Xem các ghi chú định dạng ở trên — đặc biệt các trình cài đặt .exe dạng CAB cần được giải nén và đóng gói lại trên máy tính trước.
• Thấy “This archive doesn’t look like an ONScripter game”? Kiểm tra lại xem tệp nén có thực sự chứa các tệp tập lệnh của trò chơi hay không (không chỉ là một trình cài đặt bọc ngoài hoặc một thư mục chứa các tệp không liên quan).
• Để biết thêm các sự cố nhập chung, xem Sự cố khi nhập.