세이브 에디터

세이브 에디터를 사용하면 게임을 실행하지 않고 Ren’Py 세이브 파일과 persistent 데이터의 내용을 보고 수정할 수 있습니다. 캐릭터 이름을 변경하고, 스탯을 조정하고, 플래그를 전환하고, 세이브의 전체 내부 상태를 탐색할 수 있습니다.

세이브 에디터 접근

게임의 세이브 관리자를 엽니다
세이브 슬롯을 탭하여 상세 보기를 엽니다
Edit Save Data를 탭하여 세이브 에디터를 엽니다

인터페이스

세이브 에디터에는 두 개의 탭이 있습니다:

Browse 탭

세이브 파일 내 모든 데이터의 트리 기반 뷰입니다. 딕셔너리, 리스트, 클래스 인스턴스와 같은 중첩 구조로 탐색할 수 있습니다.

검색 — 키 또는 값 이름으로 항목 필터링
경로 표시 — 데이터 트리에서 현재 위치를 표시합니다; 세그먼트를 탭하면 해당 위치로 이동
숨겨진 변수 — 내부 Ren’Py 키(_로 시작하는 키와 rollback_log와 같은 엔진 내부)는 기본적으로 숨겨집니다. 눈 아이콘을 탭하여 가시성을 전환하세요.
색상 코드 유형 — 각 값 유형에 구분을 위한 고유한 색상 배지가 있습니다

Changes 탭

이전 값과 새 값과 함께 수행한 모든 편집 내용을 나열합니다. 개별 변경 사항을 되돌리거나 Revert All을 사용하여 모두 취소할 수 있습니다.

편집 가능한 유형

유형	편집 가능	입력
String	예	텍스트 필드
Integer	예	숫자 패드
Float	예	소수점 패드
Boolean	예	True / False 선택기
Dict	탐색	키로 드릴다운
List	탐색	항목으로 드릴다운
Tuple	탐색	항목으로 드릴다운
Set / Frozenset	탐색	항목으로 드릴다운
Object (class)	탐색	`__state__`와 `__args__` 보기
None	보기만	—
Bytes	보기만	—

변경 사항 저장

편집이 완료되면 두 가지 옵션이 있습니다:

Overwrite Save — 원본 세이브 파일을 변경 사항으로 교체
Save as New Slot — 원본을 보존하면서 새 세이브 슬롯 생성

에디터는 Ren’Py의 예상 서명 형식에 맞게 세이브 파일의 재서명을 자동으로 처리합니다. 게임이 세이브 파일 서명을 사용하는 경우 편집된 세이브가 올바르게 서명됩니다.

Persistent 데이터 편집

persistent 데이터(모든 세이브 슬롯에 걸쳐 진행 상황, 잠금 해제 및 환경설정을 저장하는 persistent 파일)도 편집할 수 있습니다. persistent 데이터를 편집할 때:

모든 변수가 기본적으로 표시됩니다 (숨겨진 변수 포함)
제목이 **“Edit Persistent”**로 변경됩니다
“Overwrite”만 사용 가능합니다 (“Save as New Slot” 없음)

실용적 용도

캐릭터 이름 변경 — 세이브의 문자열 변수 편집
통화 또는 스탯 조정 — 인게임 리소스의 정수/실수 값 수정
스토리 플래그 전환 — 불리언 값을 뒤집어 루트를 잠금 해제하거나 선택 변경
손상된 세이브 수정 — 손상되거나 잘못 설정된 변수 수정
콘텐츠 잠금 해제 — persistent 플래그를 설정하여 콘텐츠를 조회된 것으로 표시

라이브 변수 에디터 (인게임)

Spark에는 게임 실행 중 인게임 오버레이에서 접근할 수 있는 별도의 변수 에디터도 있습니다. 디스크의 파일을 작업하는 세이브 에디터와 달리, 라이브 변수 에디터는 실행 중인 Ren’Py 세션에 직접 변경 사항을 주입합니다. 자세한 내용은 변수 에디터 가이드를 참조하세요.