백과사전

ZScripter 4.2.0 참고 자료

support@zscripter.com

지원 요청 시 앱 버전, iOS 또는 iPadOS 버전, 기기 모델, 게임 제목과 문제 재현 방법을 알려 주세요.

가져오기

게임 폴더, 압축 파일 또는 실행 파일을 선택하세요. 형식은 자동으로 감지됩니다.

+를 탭하면 파일에서 가져오기, 웹 가져오기, 가져오기 도움말을 선택할 수 있습니다. 분할 RAR 또는 7z 파일은 모든 부분을 같은 폴더에 모은 뒤 해당 폴더를 선택하세요.

폴더 가져오기

NScripter 계열

인식되는 루트 마커

0.txt
00.txt
0.u
00.u
0.utf
0.utf.txt
00.utf
00.utf.txt
nscr_sec.dat
nscript.___
nscript.dat
pscript.dat

인식 가능한 스크립트 마커를 게임 루트에 두세요. 개별 리소스와 NSA 또는 SAR 리소스 압축 파일은 같은 위치에 둘 수 있습니다.

일반적인 구조
Game/
├── 0.txt
├── arc.nsa
├── arc1.nsa
└── default.ttf
대체 구조
Game/
├── 0.utf
├── pscript.dat
└── arc.sar

RealLive

인식되는 루트 마커

Gameexe.ini + Seen.txt
KINETICDATA/
REALLIVEDATA/

루트 또는 바로 아래 KINETICDATA/REALLIVEDATA 폴더에 Gameexe.ini와 Seen.txt가 필요합니다. 이름은 대소문자를 구분하지 않습니다. 참조 리소스와 상대 경로를 유지하세요. AVG32, Siglus, .ezk/.ezs 래퍼만 있는 패키지는 지원하지 않습니다.

일반적인 구조
Game/
├── Gameexe.ini
├── Seen.txt
├── G00/
├── BGM/
├── WAV/
└── KOE/
대체 구조
Game/
└── KINETICDATA/ (or REALLIVEDATA/)
    ├── Gameexe.ini
    ├── Seen.txt
    └── … resources

Ren’Py

인식되는 루트 마커

game/ → *.rpy
game/ → *.rpyc
game/ → *.rpa
game/ → RPA data.bin
data/ + renpy/__init__.py

스크립트 또는 RPA 데이터가 포함된 game 디렉터리를 사용하세요. 기존 data 디렉터리에는 같은 위치의 Ren’Py 엔진 마커가 필요하며, 패키징된 Mac 앱 구조는 자동으로 검색됩니다.

일반적인 구조
Game/
├── game/
│   ├── script.rpyc
│   └── archive.rpa
└── renpy/
패키징된 Mac 구조
Game.app/
└── Contents/Resources/autorun/
    ├── game/
    └── renpy/

엔진 패키지 가져오기

베타 엔진 참고 자료입니다. App Store 배포판에서는 KiriKiri를 가져올 수 없습니다.

KiriKiri

startup.tjs
System/Initialize.tjs
XP3 기반 루트
실행 파일 뒤에 추가된 XP3
ZIP 기반 루트
TAR 기반 루트
7-Zip 기반 루트

느슨한 루트, XP3 기반 루트, 실행 파일에 추가된 XP3 및 하나의 명확한 내장 시작 루트를 가진 검증된 일반 컨테이너를 지원합니다.

압축 파일 가져오기

ZIP

.aab
.apk
.apkm
.apks
.ipa
.xapk
.zip

ZIP 및 ZIP64와 APK, AAB, APKS, XAPK, APKM, IPA 게임 패키지를 지원합니다. 무압축, Deflate 및 지원되는 LZMA 항목을 읽을 수 있습니다. 암호화된 항목은 지원하지 않습니다.

RAR

.rar

RAR 4 및 RAR 5를 지원하며, 지원되는 자동 압축 해제 파일, .partNN.rar 분할 파일 및 기존 .rar + .r00 분할 파일도 포함합니다.

7-Zip

.7z

LZMA 또는 LZMA2 데이터가 포함된 7z 압축 파일과 원시 분할 .7z.001 멀티파트 세트를 지원합니다.

LHA/LZH

.lha
.lzh

LHA/LZH 헤더 레벨 0–3, LH0–LH7, LHD, LZS, LZ4, LZ5 방식 및 일본어 CP932 파일명을 지원합니다. 자동 압축 해제 패키지는 헤더 레벨 0 또는 1을 지원합니다.

TAR

.tar

v7, ustar, pax 및 GNU 변형을 포함한 무압축 TAR를 지원합니다.

TAR.XZ

.tar.xz
.txz
.xz

XZ로 필터링된 TAR 스트림입니다.

TAR.GZ

.gz
.tar.gz
.tgz

GZip/DEFLATE로 필터링된 TAR 스트림입니다.

TAR.BZ2

.bz2
.tar.bz2
.tbz
.tbz2

BZip2로 필터링된 TAR 스트림입니다.

실행 파일 가져오기

자동 압축 해제 게임 파일

ZIP
RAR
LHA/LZH

지원되는 ZIP, RAR 및 LHA/LZH 자동 압축 해제 패키지를 직접 선택할 수 있습니다. 실행 파일을 실행하지 않고 게임 데이터를 추출합니다.

Inno Setup

5.1.2
5.3.9
5.3.10
5.4.2
5.5.0
5.5.6
6.0.0
6.1.0
6.7.0

ANSI 레이아웃은 5.5.6까지, Unicode 레이아웃은 5.3.9 이상을 지원합니다. 무압축, zlib, bzip2, LZMA1 및 LZMA2 페이로드를 처리합니다.

NSIS

NSIS 2.x 형식 헤더 레이아웃

ANSI 및 Unicode 파일명과 비솔리드 및 솔리드 Deflate 또는 LZMA 데이터를 지원합니다. 솔리드 bzip2와 BCJ 필터를 사용하는 LZMA는 지원하지 않습니다.

Enigma Virtual Box

내장 VFS
무압축 페이로드

파일이 압축되지 않은 상태로 저장된 내장 파일 시스템을 지원합니다.

섹션으로 돌아가기
지원 엔진

NScripter / ONScripter / PONScripter

런타임 방언

NScripter
ONScripter
PONScripter

ONScripter 포크

ONScripter
ONScripter-EN

PONScripter 포크 프로필

Original / Mion(2011)
Sekai Project Steam
Witch Hunt(1x)
Witch Hunt(2x)
07th-Mod v3
07th-Mod v4

기본값은 자동 감지입니다. 포크 동작을 안정적으로 추론할 수 없을 때 게임별로 프로필을 선택할 수 있습니다.

스크립트 형식

0.txt
00.txt
0.utf
00.utf
nscript.dat
nscript.___
nscr_sec.dat
pscript.dat

KiriKiri

베타 엔진 참고 자료입니다. App Store 배포판에서는 KiriKiri를 가져올 수 없습니다.

런타임 계열

KiriKiri 2
KiriKiri Z
혼합/알 수 없는 호환성 프로필

RealLive

게임 파일

Gameexe.ini + Seen.txt
Seen.txt: 10002 · 110002 · 1110002
CP932 · CP936 · Windows-1252 · CP949

리소스 형식

G00 · PDT · ANM · GAN · HIK
WAV · NWA · Ogg Vorbis
KOE · NWK · OVK

세이브 형식

saveNNN.sav.gz
global.sav.gz
세이브 폴더
ZIP 압축 파일(.zip)
ZScripter 세이브 번들(.json)

Ren’Py

Ren’Py 6.15

정확한 릴리스 2개

6.15.4
6.15.7

Ren’Py 6.17

정확한 릴리스 4개

6.17.3
6.17.4
6.17.6
6.17.7

Ren’Py 6.18

정확한 릴리스 1개

6.18.3

Ren’Py 6.99

정확한 릴리스 19개

6.99.1
6.99.3
6.99.4
6.99.5
6.99.6
6.99.7
6.99.8
6.99.9
6.99.10
6.99.11
6.99.12
6.99.12.2
6.99.12.3
6.99.12.4
6.99.13
6.99.14
6.99.14.1
6.99.14.2
6.99.14.3

Ren’Py 7.0

정확한 릴리스 1개

7.0.0

Ren’Py 7.1

정확한 릴리스 3개

7.1.0
7.1.1
7.1.3

Ren’Py 7.2

정확한 릴리스 3개

7.2.0
7.2.1
7.2.2

Ren’Py 7.3

정확한 릴리스 5개

7.3.0
7.3.2
7.3.3
7.3.4
7.3.5

Ren’Py 7.4

정확한 릴리스 12개

7.4.0
7.4.1
7.4.2
7.4.3
7.4.4
7.4.5
7.4.6
7.4.7
7.4.8
7.4.9
7.4.10.2178
7.4.11.2266

Ren’Py 7.5

정확한 릴리스 5개

7.5.0.22043001
7.5.0.22051201
7.5.0.22062402
7.5.1.22070801
7.5.3.22090809

Ren’Py 7.6

정확한 릴리스 3개

7.6.0.23051307
7.6.1.23060707
7.6.3.23091805

Ren’Py 7.7

정확한 릴리스 2개

7.7.0.24012702
7.7.1.24030407

Ren’Py 7.8

정확한 릴리스 2개

7.8.2.24090902
7.8.4.24120703

Ren’Py 8.0

정확한 릴리스 7개

8.0.0.22052902
8.0.0.22062402
8.0.1.22070801
8.0.2.22081402
8.0.3.22083102
8.0.3.22090405
8.0.3.22090809

Ren’Py 8.1

정확한 릴리스 8개

8.1.0.23042213
8.1.0.23050201
8.1.0.23051307
8.1.1.23060707
8.1.2.23072301
8.1.2.23081503
8.1.2.23090503
8.1.3.23091805

Ren’Py 8.2

정확한 릴리스 7개

8.2.0.23100201
8.2.0.23121803
8.2.0.24012702
8.2.1.24030407
8.2.2.24060703
8.2.2.24061201
8.2.3.24061702

Ren’Py 8.3

정확한 릴리스 10개

8.3.0.24071306
8.3.0.24082114
8.3.1.24090601
8.3.2.24090902
8.3.3.24111502
8.3.4.24120703
8.3.6.25022803
8.3.7.25031702
8.3.8.25042301
8.3.8.25051901

Ren’Py 8.4

정확한 릴리스 8개

8.4.0.25052403
8.4.0.25071206
8.4.1.25071908
8.4.1.25072401
8.4.2.25073104
8.4.2.25082401
8.4.2.25111201
8.4.2.25111701

Ren’Py 8.5

정확한 릴리스 12개

8.5.0.25110801
8.5.0.25111603
8.5.1.25122301
8.5.1.25123106
8.5.2.26010301
8.5.3.26012801
8.5.3.26021801
8.5.3.26031801
8.5.3.26032401
8.5.3.26043002
8.5.3.26051504
8.5.4.26061901

Ren’Py 8.6

정확한 릴리스 1개

8.6.0.25112601
섹션으로 돌아가기
호환성

RealLive

호환됨

AIR스탠더드 에디션 · +Voice1.02
CLANNADPC 원본
Kanon스탠더드 에디션 · 전연령
planetarian ~작은 별의 꿈~planetarian ~ちいさなほしのゆめ~ · 패키지판
리틀 버스터즈!リトルバスターズ! · PC 원본

NScripter 계열

호환됨

40 Days and 40 Nights of Rain
A Dream of Summer
A Happy Valentine
A Midsummer Day’s Resonance
A Winter’s Tale
Agnus Dei
At Summer’s Endなつのおわりに
Ballad of an Evening Butterfly
Bluebird’s Illusion
Eternity永遠
Exile Gear Raynar
FLOOD OF TEARS
From the Bottom of the Heart
Instant Death! Panda Samurai
Its your last chance in new school
Kagetsu Tohya
Kira ~snowdrop~
LEAVEs
May Sky
Moonshine
My Black Cat私の黒猫
Narcissu
Night of the Forget-Me-Nots
OMGWTFOTL
Plain Song
Plumerai
Pray [Apocripha/0 온천편]Pray [Apocripha/0 溫泉物]
Red Shift常世の星空
SALAMANDER
Shooting Star Hill
The Boy I Like? 2すきなおとこのこ?
The Caged Vagrant
The Letter
The Little Prince
The Moon to the East, the Sun to the West ~Operation Sanctuary~月は東に日は西に ~Operation Sanctuary~
The noose
The world to reverse.
Wanderers in the Sky空の迷い人
~Plain Song~ Christmas Special
괭이갈매기 울 적에うみねこのなく頃に
괭이갈매기 울 적에 산うみねこのなく頃に散
불쌍한 작은 새かわいそうな小鳥
블랙 블러드黑血
신경 쓰이는 남자아이?きになるおとこのこ?
쓰르라미 울 적에ひぐらしのなく頃に
아르카디아Arcadia -阿卡迪亞-
월희月姫
태양을 향한 꿈向日の夢
텐시노오시고토 -their wishes afterward-天使のお仕事 -their wishes afterward-
히토카조에人数え
섹션으로 돌아가기
세이브 스냅샷

세이브 스냅샷은 영구 데이터를 포함한 해당 게임의 모든 세이브 데이터 사본입니다. 게임에서 이미 저장한 진행 상황을 기록합니다.

스냅샷 만들기

라이브러리 도구 모음에서 저장 공간을 열고 게임을 선택합니다. 지금 세이브 스냅샷을 누르면 수동 스냅샷이 만들어집니다. 저장 공간 메뉴에서 모든 게임을 한 번에 스냅샷할 수도 있습니다. 스냅샷을 만들거나 복원하기 전에 게임에서 저장한 뒤 게임을 종료하세요.

세이브 기록 예시 보기
세이브 기록에 있는 스냅샷의 작업 메뉴. 원본 크기 이미지 열기

자동 스냅샷

자동 스냅샷은 기본으로 켜져 있으며, 게임 실행 전에 만들어 게임마다 10개씩 보관합니다. 다른 실행 조건을 선택하면 앱을 열거나 앱으로 돌아올 때 게임마다 24시간에 한 번까지 확인합니다. 세이브가 없거나 내용이 바뀌지 않았으면 건너뜁니다.

저장 공간 메뉴의 세이브 스냅샷 기본 설정에서 실행 조건과 게임별 자동 스냅샷 보관 개수를 1~100개로 정할 수 있습니다. 자동 스냅샷을 끌 수도 있습니다. 각 게임의 세이브 스냅샷 설정에서 기본값을 바꿀 수 있습니다. 한도를 넘으면 가장 오래된 자동 스냅샷부터 삭제됩니다. 수동 스냅샷과 복구용 스냅샷은 직접 삭제할 때까지 남습니다.

세이브 복원

게임의 세이브 기록에서 스냅샷 메뉴를 열고 이 스냅샷으로 복원을 선택합니다. 현재 세이브 전체가 교체되며, 해당 스냅샷 이후에 추가된 세이브 파일도 제거됩니다. 앱은 먼저 현재 세이브를 복원 전 스냅샷으로 보관합니다. 이 스냅샷으로 복원하면 이전 상태로 돌아갈 수 있습니다.

스냅샷 관리

기록에는 스냅샷의 날짜, 생성 이유, 파일 수, 크기가 표시됩니다. 날짜나 크기순으로 정렬할 수 있습니다. 스냅샷 메뉴에서 ZIP으로 내보내거나 스냅샷을 삭제할 수 있습니다. 스냅샷을 삭제해도 현재 세이브는 남습니다.

스냅샷은 이 기기에 저장됩니다. 다른 곳에도 보관하려면 사본을 내보내세요. 게임을 삭제한 뒤에도 저장 공간 메뉴의 모든 스냅샷 및 아카이브에 스냅샷이 남습니다.

섹션으로 돌아가기
세이브 편집기

세이브 편집기는 Ren'Py의 세이브 슬롯과 회차 간에 공유되는 갤러리 해금 기록 같은 영구 데이터를 수정합니다.

파일 선택

게임을 종료하고 게임 옵션에서 저장 공간을 연 다음, 오른쪽 위 메뉴에서 세이브 편집기를 선택합니다. .save 슬롯이나 persistent 파일을 선택하세요. 목록이 비어 있다면 게임에서 한 번 저장하거나 세이브를 가져오세요.

세이브 편집기 예시 보기
세이브 필드와 각 필드의 타입 및 값. 원본 크기 이미지 열기

값 찾기

필드 이름, 값, 타입, 경로로 검색할 수 있습니다. 필터로 타입을 좁히거나 내부 필드를 숨길 수 있습니다. 리스트와 딕셔너리를 열어 항목을 확인하고, 경로 버튼으로 이전 단계로 돌아갑니다. 필드 메뉴에서는 값이나 경로를 복사할 수 있습니다.

전체 Pickle 그래프에서 롤백 기록 등 추가 데이터를 볼 수 있습니다. 문서 세부 정보에는 서명 상태가 표시됩니다. 두 항목 모두 오른쪽 위 메뉴에 있습니다.

값 편집

숫자나 텍스트를 직접 편집하거나 참/거짓 값을 전환할 수 있습니다. 필드 메뉴에서 타입을 바꿀 수 있습니다. 딕셔너리 키의 이름을 바꾸거나 항목을 삭제할 수도 있습니다. 값 추가로 항목이나 빈 컨테이너를 삽입하고, 기존 객체를 참조할 수 있습니다.

실행 취소와 다시 실행으로 저장 전 편집 내용을 한 단계씩 되돌리거나 다시 적용합니다. 모든 편집 내용 취소는 이 변경 사항을 지웁니다.

변경 사항 적용

변경 사항 검토를 열고 변경 사항 저장을 선택합니다. 앱은 먼저 세이브 편집 전 스냅샷을 만듭니다. 저장한 편집을 취소하려면 세이브 기록에서 이 스냅샷을 복원하세요.

세이브를 불러오거나 게임 내 롤백을 사용하면 게임이 편집한 값을 덮어쓸 수 있습니다. 잘못된 값 때문에 세이브를 불러오지 못할 수도 있습니다. 일부 파일과 필드는 확인만 가능합니다.

섹션으로 돌아가기
컨트롤러

ZScripter는 iOS 또는 iPadOS가 인식하는 컨트롤러를 사용합니다. 사용 가능한 버튼과 동작은 컨트롤러와 게임 엔진에 따라 다릅니다.

지원 컨트롤러

제품군모델
PlayStationDualShock 4
DualSense
DualSense Edge
Xbox무선 컨트롤러(Bluetooth, 모델 1708)
Series X|S 무선 컨트롤러
Elite 무선 컨트롤러 Series 2
Adaptive Controller
Nintendo SwitchPro 컨트롤러
Joy-Con(L/R)
MFi 및 모바일Backbone One(iPhone 호환 모델)
기타 MFi 게임패드

iOS 또는 iPadOS가 게임패드로 인식하는 다른 컨트롤러도 사용할 수 있습니다. 호환성과 사용 가능한 버튼은 시스템 및 컨트롤러 펌웨어 버전에 따라 달라집니다.

컨트롤러 연결

Bluetooth로 페어링하거나 케이블로 연결합니다. 앱 설정에서 조작을 열고 엔진을 선택한 다음 하드웨어 컨트롤러를 엽니다. 연결된 컨트롤러의 입력은 그림에 초록색으로 표시되고, 사용할 수 없는 조작 요소는 흐리게 표시됩니다. 연결하지 않아도 미리보기에서 설정할 수 있습니다.

컨트롤러 설정 예시 보기
컨트롤러 그림과 선택한 버튼에 매핑된 동작. 원본 크기 이미지 열기

버튼 매핑

사용자 지정 매핑에서 그림의 버튼을 누른 다음 선택한 조작 요소 아래의 동작을 누릅니다. 모든 조작 요소에서 매핑 목록을 볼 수 있습니다. 버튼을 눌러 선택을 사용하면 컨트롤러를 직접 조작해 선택할 수 있습니다.

변경 사항은 자동으로 저장되며 같은 엔진을 사용하는 모든 게임에 적용됩니다. 터치 조작 레이아웃은 별도로 설정합니다.

Ren'Py 입력 모드

네이티브 게임패드는 호환되는 Ren'Py 게임 자체의 컨트롤러 매핑을 사용합니다. 오래된 런타임에서는 저장된 사용자 지정 매핑을 사용합니다. 게임 동작을 지정하거나 스틱을 마우스로 쓰려면 사용자 지정 매핑으로 전환하세요.

스틱과 트리거 조정

스틱 및 감도에서 각 스틱을 방향 버튼, 마우스 커서, 스크롤 입력으로 설정하거나 끌 수 있습니다. 스틱이 저절로 움직이면 데드 존을 늘리세요. 속도와 응답 곡선으로 움직임을 조정하고 가로·세로 방향을 반전할 수 있습니다.

트리거 작동 지점은 트리거를 얼마나 눌러야 반응할지 정합니다. 방향 버튼을 누르고 있는 동안 반복 입력할 수 있으며, 지연 시간과 간격도 조절할 수 있습니다. 컨트롤러 기본값 복원은 선택한 엔진의 매핑과 스틱 설정을 초기화합니다.

섹션으로 돌아가기
번역

번역은 Ren'Py 게임용 베타 기능입니다. 대사와 메뉴 텍스트를 번역합니다. 이미지에 그려진 글자는 그대로 남습니다.

번역 켜기

Ren'Py 게임 상세 화면에서 번역을 엽니다. 원문과 번역 언어를 설정한 다음 게임 텍스트 번역을 켭니다. 앱 설정 사용을 켜면 앱 설정의 번역에서 선택한 제공업체를 따릅니다. 끄면 이 게임에 사용할 제공업체를 따로 선택할 수 있습니다. 플레이 중에도 게임 설정의 번역에서 조정할 수 있습니다.

제공업체 설정 예시 보기
클라우드 제공업체의 API 키와 모델 설정. 원본 크기 이미지 열기

제공업체 선택

Apple은 기기에서 번역하며 iOS 18 이상을 사용하는 실제 iPhone 또는 iPad가 필요합니다. 게임 내 언어 모델 다운로드로 두 언어를 준비하세요. 설치 후에는 지원되는 언어 쌍을 오프라인으로 번역할 수 있습니다.

Gemini, OpenAI, DeepSeek 및 OpenRouter에는 인터넷 연결과 본인의 API 키가 필요하며, 키는 앱 설정의 번역에서 입력합니다. 클라우드 번역을 허용하면 제공업체에 게임 텍스트와 대화 맥락이 전송되며 사용 요금이 적용됩니다. 게임 내 패널에서 번역 문체를 선택하고 직접 지침을 추가할 수 있습니다. 권한은 번역 설정에서 철회할 수 있습니다.

원문과 비교

원문은 원래 텍스트를, 번역문은 게임 안에 번역된 텍스트를 표시합니다. 비교를 선택하면 두 텍스트를 함께 보여 주는 패널이 추가됩니다. 패널 위쪽을 드래그해 옮기고 아래쪽 가장자리를 드래그해 크기를 조절할 수 있습니다.

미리 번역은 다음 대사를 준비해 대기 시간을 줄입니다. 클라우드 제공업체에도 해당 텍스트가 전송되므로 사용량이 늘어날 수 있습니다. 번역에 실패하면 원문이 계속 표시됩니다. 번역 다시 시도로 재시도할 수 있습니다.

저장된 번역 지우기

번역 캐시 지우기는 이 게임에 저장된 번역을 삭제합니다. 이후 플레이하면서 다시 생성됩니다. 언어 설정과 Apple의 다운로드된 모델은 유지됩니다.

섹션으로 돌아가기
패치

KiriKiri

베타 엔진 참고 자료입니다. App Store 배포판에서는 KiriKiri를 가져올 수 없습니다.

패치 번들 파일

.tjs — 시작, 필터, 부트스트랩 및 재정의 스크립트
.xp3 — 패치 아카이브
.cf / .key / .cfg / .ksc — 필터 및 보조 데이터
.zip / .7z — 카탈로그 번들 내부의 보조 아카이브

플러그인 요청 파일

*.dll — 요청 별칭으로만 사용
plugin-catalog/catalog.json — 별칭-대상 매핑
섹션으로 돌아가기