버전 선택기

Spark에는 여러 Ren’Py 엔진 버전이 포함되어 있으며 각 게임에 사용할 버전을 선택할 수 있습니다.

Spark에 번들된 Ren’Py 엔진 버전:

게임을 가져올 때, Spark는 게임 아카이브에 패키징된 Ren’Py 버전(엔진 버전 파일 vc_version.py, __init__.py 등에서)을 감지하고 호환 가능한 엔진을 추천합니다.

게임의 script_version.txt는 스크립팅 레이어의 호환성 플래그를 설정하기 위해 Ren’Py가 내부적으로 사용하는 별도의 파일입니다 — 엔진 버전과는 다릅니다.

Spark는 두 가지 엔진 추천 전략을 제공합니다(설정에서 구성 가능):

• Accurate (기본값) — 같은 마이너 버전에 맞는 엔진을 추천합니다 (예: 7.5.x 게임은 7.5.3 엔진을 받음)
• Latest — 같은 메이저 버전 내에서 최신 엔진을 추천합니다 (예: 7.x 게임은 최신 7.x 엔진, 8.x 게임은 최신 8.x 엔진을 받음)

엔진 런타임 버전은 게임 상세 화면의 Launch Game 버튼 아래에 표시됩니다. 두 가지 버전 설정을 변경할 수 있습니다:

이것은 Spark가 게임을 실행하는 데 사용하는 번들된 Ren’Py 엔진을 제어합니다.

1. 게임 상세 화면에서 엔진 버전 옆의 Modify를 탭
2. 버전 선택기에서 선택
3. Confirm 탭

엔진을 변경한 후 문제가 발생하면 되돌릴 수 있습니다:

• 원본 버전은 자동으로 저장됩니다
• 버전 선택기에서 Revert 버튼을 사용하여 되돌립니다

이것은 게임의 script_version.txt를 업데이트하며, Ren’Py의 내부 호환성 로직이 적용되는 방식을 제어합니다. Ren’Py는 이 값을 사용하여 오래된 게임에 대한 하위 호환 동작을 활성화하거나 비활성화합니다.

이를 변경하면 게임이 최신 엔진 버전에서 수정된 특정 레거시 동작을 기대하는 문제를 해결할 수 있습니다. 버전 간 변경 사항에 대한 자세한 내용은 Ren’Py 비호환 변경 문서를 참조하세요.

• 게임 실행 시 충돌 — 다른 엔진 버전을 시도
• 누락된 기능 — 일부 게임은 특정 Ren’Py 버전이 필요
• 성능 문제 — 새로운 엔진이 더 나은 성능을 제공할 수 있음
• 호환성 — 오래된 게임은 오래된 엔진이 필요할 수 있음

Spark의 각 게임에는 Spark의 엔진 패칭 및 런타임 통합이 얼마나 활성화되는지 제어하는 세 가지 선택적 실행 모드가 있습니다. 이것은 게임 설정에서 찾을 수 있습니다 (라이브러리에서 게임을 길게 누름).

Safe Mode는 Spark의 커스텀 패치 빌드 대신 바닐라, 수정되지 않은 Ren’Py 엔진을 사용하여 게임을 실행합니다. Spark의 엔진 수정 및 스크립트 인젝션은 비활성화되지만 오버레이 및 런타임 기능은 사용 가능합니다.

이 모드가 활성화되면 실행 버튼이 녹색으로 변하고 **“Safe Launch”**로 표시됩니다.

사용 시기: 게임이 충돌하거나 잘못 동작하며 Spark의 엔진 패치가 원인이라고 의심될 때.

Advanced Mode는 개발자가 Ren’Py 엔진의 Python 레이어를 직접 수정한 게임을 위해 설계되었습니다. 일부 게임은 커스텀 엔진 코드가 포함된 수정된 renpy/ 디렉토리와 함께 배포됩니다 — 이러한 수정 없이는 게임이 충돌하거나 잘못 동작할 수 있습니다. 활성화하면:

• Spark가 게임 폴더 내의 advanced/renpy 디렉토리를 찾습니다
• 발견된 모든 Python 소스 파일이 엔진의 내장 Ren’Py 소스를 오버라이드합니다
• 일반 버전 선택기와 독립적인 별도의 엔진 버전 선택기가 나타납니다

이 모드가 활성화되면 실행 버튼이 핑크색으로 변하고 **“Advanced Launch”**로 표시됩니다.

사용 시기: 게임에 Ren’Py의 Python 소스 코드에 대한 커스텀 수정(수정된 renpy/ 디렉토리)이 포함된 경우. 이것은 드물지만 일부 게임은 커스텀 기능, UI 프레임워크 또는 호환성 해결 방법을 위해 엔진 레벨 변경에 의존합니다.

이 모드는 게임 세션에서 Spark의 런타임 레이어를 완전히 제거합니다. 활성화하면:

• Spark 오버레이 UI(게임 컨트롤, 빠른 메뉴, 키보드 헬퍼, UI 숨기기 버튼)가 나타나지 않습니다
• 모든 런타임 Python 인젝션이 건너뛰어집니다 — 대사 추적, 갤러리 잠금 해제, 제스처 구성, 볼륨 동기화, 번역 시스템 및 키맵 오버라이드가 모두 비활성화됩니다
• 게임이 Spark 런타임 수정 없이 실행됩니다
• RPY 기반 설정(developer mode, console, transparent textbox)은 Spark가 인젝션하는 것이 아니라 Ren’Py가 자체적으로 로드하므로 여전히 작동합니다

사용 시기: 게임이 Spark의 런타임 기능과 충돌하고 Safe Mode만으로는 문제가 해결되지 않을 때. 모든 Spark 오버레이 기능을 잃는 대신 최대 호환성과 격리를 제공합니다.