Bộ Chọn Phiên Bản

Spark bao gồm nhiều phiên bản engine Ren’Py và cho phép bạn chọn phiên bản nào sử dụng cho mỗi trò chơi.

Spark đi kèm các phiên bản engine Ren’Py sau:

Khi bạn nhập trò chơi, Spark phát hiện phiên bản Ren’Py được đóng gói cùng file lưu trữ trò chơi (từ các file phiên bản engine như vc_version.py, __init__.py, hoặc các phiên bản biên dịch tương đương) và sử dụng nó để đề xuất engine tương thích.

File script_version.txt của trò chơi là file riêng biệt được Ren’Py sử dụng nội bộ để đặt cờ tương thích cho lớp script — không giống với phiên bản engine.

Spark cung cấp hai chiến lược đề xuất engine (có thể cấu hình trong Settings):

• Accurate (mặc định) — Đề xuất engine khớp cùng phiên bản minor (ví dụ: trò chơi 7.5.x nhận engine 7.5.3)
• Latest — Đề xuất engine mới nhất trong cùng phiên bản major (ví dụ: trò chơi 7.x nhận engine 7.x mới nhất, trò chơi 8.x nhận engine 8.x mới nhất)

Phiên bản engine runtime được hiển thị bên dưới nút Launch Game trên màn hình chi tiết trò chơi. Có hai cài đặt phiên bản bạn có thể thay đổi:

Điều này kiểm soát engine Ren’Py đi kèm nào Spark sử dụng để chạy trò chơi.

1. Nhấn Modify bên cạnh phiên bản engine trên màn hình chi tiết trò chơi
2. Chọn từ bộ chọn phiên bản
3. Nhấn Confirm

Nếu bạn đã thay đổi engine và gặp vấn đề, bạn có thể hoàn về:

• Phiên bản gốc được lưu tự động
• Sử dụng nút Revert trong bộ chọn phiên bản để quay lại

Cập nhật script_version.txt của trò chơi, kiểm soát cách logic tương thích nội bộ của Ren’Py được áp dụng. Ren’Py sử dụng giá trị này để bật hoặc tắt hành vi tương thích ngược cho trò chơi cũ.

Thay đổi này có thể giải quyết vấn đề khi trò chơi mong đợi một số hành vi kế thừa nhất định đã được sửa đổi trong phiên bản engine mới hơn. Xem tài liệu thay đổi không tương thích của Ren’Py để biết chi tiết về những thay đổi giữa các phiên bản.

• Trò chơi bị sập khi khởi chạy — Thử phiên bản engine khác
• Thiếu tính năng — Một số trò chơi yêu cầu phiên bản Ren’Py cụ thể
• Vấn đề hiệu suất — Engine mới hơn có thể hoạt động tốt hơn
• Tương thích — Trò chơi cũ có thể cần engine cũ

Mỗi trò chơi trong Spark có ba chế độ khởi chạy tùy chọn kiểm soát mức độ vá và tích hợp runtime của Spark đang hoạt động. Chúng nằm trong Game Settings (nhấn giữ trò chơi trong thư viện).

Safe Mode khởi chạy trò chơi sử dụng engine Ren’Py nguyên bản, không sửa đổi thay vì bản build tùy chỉnh của Spark. Các sửa đổi engine và chèn script của Spark bị tắt, nhưng lớp phủ và tính năng runtime vẫn có sẵn.

Nút khởi chạy chuyển sang màu xanh lá và đọc “Safe Launch” khi chế độ này đang hoạt động.

Khi nào sử dụng: Trò chơi bị sập hoặc hoạt động sai và bạn nghi ngờ bản vá engine của Spark là nguyên nhân.

Advanced Mode được thiết kế cho trò chơi mà nhà phát triển đã thay đổi trực tiếp lớp Python của engine Ren’Py. Một số trò chơi đi kèm với thư mục renpy/ đã sửa đổi chứa mã engine tùy chỉnh — nếu không có những sửa đổi này, trò chơi có thể sập hoặc hoạt động không đúng. Khi bật:

• Spark tìm thư mục advanced/renpy bên trong thư mục trò chơi
• Bất kỳ file nguồn Python nào tìm thấy ở đó sẽ ghi đè nguồn Ren’Py tích hợp của engine
• Bộ chọn phiên bản engine riêng xuất hiện, độc lập với bộ chọn phiên bản bình thường

Nút khởi chạy chuyển sang màu hồng và đọc “Advanced Launch” khi chế độ này đang hoạt động.

Khi nào sử dụng: Trò chơi bao gồm sửa đổi tùy chỉnh cho mã nguồn Python của Ren’Py (thư mục renpy/ đã sửa đổi). Điều này không phổ biến nhưng một số trò chơi dựa vào thay đổi ở cấp engine cho tính năng tùy chỉnh, framework UI, hoặc giải pháp tương thích.

Chế độ này loại bỏ hoàn toàn lớp runtime của Spark khỏi phiên trò chơi. Khi bật:

• Giao diện lớp phủ Spark (điều khiển trò chơi, quick menu, trợ giúp bàn phím, nút ẩn UI) không bao giờ xuất hiện
• Tất cả chèn Python runtime bị bỏ qua — theo dõi đối thoại, mở khóa thư viện ảnh, cấu hình cử chỉ, đồng bộ âm lượng, hệ thống dịch, và ghi đè keymap đều bị tắt
• Trò chơi chạy với không có sửa đổi runtime Spark nào
• Cài đặt dựa trên RPY (developer mode, console, textbox trong suốt) vẫn hoạt động vì Ren’Py tự tải chúng thay vì Spark chèn

Khi nào sử dụng: Trò chơi xung đột với tính năng runtime của Spark và Safe Mode riêng không giải quyết được vấn đề. Điều này cung cấp tương thích và cách ly tối đa với chi phí là mất tất cả chức năng lớp phủ Spark.