시스템 — 변수·판정·스크립트·화면·세이브

이 문서가 맡는 것

이야기 비트와 선택지 문구는 03 시나리오, 그림은 05 아트에 있어요. 여기서는 그 값들을 엔진이 어떻게 읽는지, 플레이어한테 뭘 보여 주고 뭘 숨기는지를 정해요.

엔진(engine.js)·화면(index.html)·스타일(style.css)은 1판 것을 그대로 써요. 1판에서 이미 끝까지 돌아가는 걸 확인했기 때문에 v2 는 상수 몇 개와 「처음부터」 흐름만 바꿔요(아래 08장). 스크립트 형식도 1판과 한 글자도 다르지 않아요. 바뀐 건 내용이에요 — 성배 해체가 해독약 재료로, 오리지널 주인공이 해리로 바뀌었어요.

서버는 없어요. 저장은 localStorage 만 쓰고, 외부 스크립트·폰트·추적 코드·measure.js 는 불러오지 않아요(바이블 8-1).

변수 넷

보이는 건 aff(하트)와 stage(해독약 재료) 둘이에요. 말포이 속을 재는 pride·honest 는 숨겨요. 자존심 수치가 화면에 뜨면 플레이어가 말포이 대사가 아니라 숫자를 보고 고르게 돼요.

① 변수표 (바이블 3-1)

값을 바꾸는 규칙은 하나예요. set 줄과 선택지 vars 의 숫자는 더하는 양(+n/−n)이고, 한 번 적용할 때마다 범위 안으로 잘라요(clamp). pride 가 0에 붙어 있을 때 −4를 받으면 0에 머물고, 그다음 +2를 받으면 2가 돼요. 그래서 누적합과 실제 값이 다를 수 있어요.

증감 숫자는 1판 최종값과 같은 자리, 같은 값이에요(바이블 3-1). 선택지 문구와 의미만 해리 시점으로 바꿨어요. 숫자를 그대로 둔 덕분에 1판에서 맞춰 둔 엔딩 비율이 출발점이 돼요.

해독약 재료 일곱 칸

수첩에는 아래 이름이 들어간 순서대로 찍혀요. 엔진 상수 STAGES 와 같은 순서예요.

재료 2는 ch1 에 불에 올려 둔 걸 ch2 에 건지는 흐름이라, 1화 날짜(9월 3일)와 2화 날짜(10월 24일) 사이가 21일보다 길어요. 날짜끼리 어긋나지 않아요.

하트 다섯 칸과 판정 문턱

하트는 20점마다 한 칸이에요. 시작값 10이면 빈 하트로 시작해요. 판정 문턱이 하트 칸 경계와 일부러 어긋나 있어서, 하트만 보고 엔딩을 정확히 맞히긴 어려워요.

② 챕터별 증감 범위표 (바이블 4-6)

챕터마다 고를 수 있는 선택지를 전부 한쪽으로 몰았을 때의 범위예요. 자르기 전 합이에요.

lost_brew 경로에서 선택지가 하나 줄어드는 건 5-4(젓는 손이 떨리는 말포이)가 해독약이 있는 천문탑 씬(ch5_s6)에만 있기 때문이에요. 해독약이 성 뭉고로 간 경로는 ch5_s6x 로 빠져서 그 선택이 안 나와요.

중간 판정 문턱

챕터 안의 if 분기는 다섯 곳이에요. 앞 챕터까지 쌓인 값으로 「이번 장면이 열리나」를 정해요.

엔딩 판정

엔딩은 ch5_judge 씬의 if 여섯 줄로만 정해요. 위에서부터 처음 맞는 줄로 가요. meta.json 의 cond 는 갤러리와 검사기가 읽는 사본이고, 엔진이 판정에 쓰지는 않아요(바이블 6-2).

③ 판정 순서표 (바이블 3-3)

왜 이 순서인가

• 배드가 맨 앞 — 자존심이 높고 마음이 안 열린 말포이(E5)는 해독약이 있든 없든 어머니 서류에 서명하고 떠나요. 해독약이 성 뭉고로 간 경로(E6)도 같은 이유로 먼저 걸러요. 둘 다 aff<50 이 붙어 있어서, 하트를 두 칸 넘게 채운 플레이어는 배드로 안 빠져요.
• E1 이 E3·E2 보다 앞 — E1 은 조건이 제일 많아요. 뒤에 두면 더 넓은 E2 가 먼저 잡아먹어요.
• E3 가 E2 보다 앞 — 해독약을 만들었어도 마지막에 「안 서둘러도 돼. 지금도 너야」(said_stay)를 고르고 관계가 충분하면, 말포이가 지금 몸으로 졸업하는 쪽을 골라요. 플레이어의 마지막 말이 해독약 유무보다 먼저 읽혀요.
• E4 가 바닥 — 어떤 조합이 와도 엔딩이 하나는 나오게 하는 줄이에요. 이 저장소의 「결 潔」 게임에서 판정이 null 을 돌려 아무것도 안 고르고 진행된 적이 있어서, 엔진이 시작할 때 이 줄이 있는지 검사해요(04장 검사 7).

변주 판정

E3·E4 는 해독약이 제대로 나왔는지(flag:brewed && stage>=6)에 따라 앞 장면만 바뀌고 뒤는 같아요.

E2 는 said_* 셋 중 뭘 골랐어도 나올 수 있어요. 그래서 E2 대사는 「말포이가 스스로 마시기로 했다」로 쓰고, 해리의 마지막 말을 깔고 가지 않아요.

비율 — v2 실측 (2026-10-14)

node tools/validate.mjs(시드 20031014, 선택지 균등 무작위 10,000회)로 v2 스크립트를 쟀어요. 오류 0건 · 경고 2건으로 통과했고, 씬 83개 모두 어떤 경로로든 들러요. 결과는 E5 27.0% · E6 9.4% · E1 0.2%(10,000회 중 20회) · E3 18.4% · E2 12.6% · E4 32.5% 예요. 목표 대비로는 E5 +12.0%p · E6 −0.6%p · E1 −7.8%p · E3 +0.4%p · E2 −9.4%p · E4 +5.5%p 라서 E5 가 ±10%p 를 넘어요. validate 가 이걸 경고로 띄우고, 문턱을 바꿀지는 메인이 정해요(바이블 3-3). 1판 실측(E5 21.3% · E6 10.7% · E1 0.1% · E3 19.5% · E2 12.8% · E4 35.5%)과도 크게 다르지 않아요. 같은 값을 03 시나리오의 「v2 실측」 칸에도 적었어요.

E1 은 0.2%로 바이블 3-3 목표 「무작위 1% 안팎」보다 낮아요. 그런데 바이블 3-3 이 1순위 안으로 든 honest>=45 → honest>=40 은 지금 meta 의 E1 cond 에 이미 honest>=40 으로 들어가 있어요. 다음 조정안은 메인이 정해요.

무작위로 고르면 E1 이 거의 안 나오는 건 정상이에요. 트루 엔딩은 말포이한테 계속 솔직하게 굴고, 사과와 고백 장면을 다 열어야 나와요.

스크립트 형식과 엔진 검사

챕터 파일 하나가 씬 배열이고, 씬 하나가 줄 배열이에요. 엔진은 줄을 하나씩 읽어 실행해요. 형식은 1판과 같고 바이블 6-1 원문 그대로예요.

story/meta.json: {"title","vars":{"이름":{"min","max","start"}},"flags":[...],"chars":{"id":{"name","color","faces":[...]}},"endings":{"E1":{"name","kind","cond","cg"}},"chapters":["ch1",...,"ch5"]}
story/chN.json: {"id":"chN","title":"...","scenes":[{"id":"chN_s1","bg":"bg_x","lines":[ 줄... ]}]}

④ 스크립트 줄 종류표 (바이블 6-1)

흐름 규칙

• cond 문법은 변수 비교(>= <= > < == !=, 정수만), flag:이름, &&, ||, ! 이에요. 괄호는 없어요. 이 게임의 cond 는 전부 && 만 써요.
• 씬 끝에 goto 가 없으면 배열의 다음 씬으로 가요. 그래서 씬 순서는 바이블 4장 표 순서와 같아야 해요.
• goto·if 는 같은 챕터 안에서만 움직여요. 챕터를 건너는 점프는 없어요.
• 씬이 바뀌면 인물 카드를 모두 숨겨요. 새 씬에서 show 를 다시 써야 보여요.
• {name} 치환은 엔진에 남아 있지만 이 게임에선 늘 「해리」예요. 집필에선 {name} 대신 「해리」를 직접 써요(바이블 6-1 v2 덧붙임).
• 판정만 하는 씬(ch3_s3b · ch4_s2b · ch4_s6m · ch5_judge · ch5_e3 · ch5_e4)은 대사 0줄이에요. 플레이어 눈에는 안 보이고 바로 다음 씬 배경이 깔려요.

엔진 시작 검사 (바이블 9-2)

게임을 열면 엔진이 스크립트 전체를 한 번 훑어요. 하나라도 틀리면 콘솔에 오류를 남기고 타이틀에 빨간 줄 하나를 띄워요. 플레이어가 중간에 멈춰 버리는 것보다 시작 화면에서 바로 보이는 쪽이 고치기 쉬워요.

검사기 tools/validate.mjs 가 v2 를 읽으려면 인물 접두사 정규식과 금지어 목록을 고쳐야 해요(바이블 9-3). 그건 메인 몫이에요.

화면 목록

게임은 game/index.html 한 페이지 안에서 화면을 바꿔 가며 보여 줘요. 페이지 이동이 없어서 뒤로 가기를 눌러도 게임이 안 끊겨요. 1판에 있던 이름 입력 화면과 타이틀 고지 창은 없앴어요.

⑤ 화면 목록표

갤러리 잠금은 저장 키를 늘리지 않고 판정해요. cg 줄의 「씬id:순번」이 dracots2_read 에 있으면 그 CG 가 열리고, E4·E6 카드는 dracots2_endings 로 봐요(1판 방식 그대로, 이 문서 제안).

본편 화면 배치 (바이블 5-4)

해리가 말할 때는 카드가 없어요. 이름표만 「해리」로 바뀌고, 말포이 카드가 떠 있으면 말포이가 70% 밝기로 내려가요. 해리 얼굴은 CG 에만 나오고, 거기서도 뒷모습·옆모습·손 위주예요(바이블 5-3). 플레이어가 해리 눈으로 보는 게임이라 정면 얼굴을 자주 보여 줄 이유가 없어요.

조작

진행 입력(탭·Space·Enter)은 바이블에서 정했고, 나머지 키는 1판 engine.js 의 onKey() 에 이미 들어 있는 걸 2026-10-14 코드로 확인해 옮겼어요. 키보드가 없어도 화면 버튼으로 같은 일을 할 수 있어요.

⑥ 조작표

• 한글 입력 중 무시 — e.isComposing 이면 키를 안 받아요. 설정 창의 세이브 붙여넣기 칸에서 한글을 치다가 게임이 넘어가는 일을 막아요.
• 메뉴 탭이 대사로 새지 않게 — 화면 전체가 진행 버튼이라, 메뉴 버튼은 누를 때 이벤트 전파를 막아요(vn-design.md 4장).
• 이미 고른 선택지 — 지난 회차에 고른 적 있는 보기 앞에 ✓ 를 붙여요. 기록은 dracots2_read 에 있어요. 엔딩 여섯 개를 다 보려면 2회차부터 이 표시가 길잡이가 돼요.

저장 — localStorage

같은 도메인의 다른 페이지와 저장소를 나눠 쓰니까 이 게임 키는 모두 dracots2_ 로 시작해요. 1판은 dracots_ 였어요. 씬 id 는 1판과 같은데 플래그 이름이 달라서, 1판 세이브를 읽으면 변수·플래그가 엉켜요. 그래서 접두사를 바꾸고 1판 세이브는 아예 안 읽어요(바이블 8-3).

⑦ localStorage 키표 (바이블 8-3)

세이브 한 칸

형식은 1판과 같아요: {"v":1,"ch","scene","idx","vars","flags","name","shown","bg","cg","at"}

위 예의 vars 숫자는 설명용으로 지은 값이에요(어떤 경로에서 정확히 이 값이 나오는지는 계산하지 않았어요). stage 4는 고정 재료 둘에 붐슬랭 껍질과 머리카락 한 올이 들어간 상태라는 뜻이에요. ch3_s6a 의 set 줄을 지나면 5가 되고 scar_told 가 켜져요.

name 칸은 이름 입력이 없어져서 쓸모가 줄었지만 지우지 않아요. 형식을 1판과 똑같이 두는 쪽이 엔진을 안 건드려도 돼서예요.

깨지지 않게

• 줄 번호 대신 씬 id + 순번 — 집필 중에 줄이 늘고 줄어도 다른 씬 위치는 안 흔들려요. 같은 씬에서 순번이 넘치면 그 씬 처음으로 돌려요(이 문서 제안).
• 모든 저장은 try/catch — 한도를 넘거나 iOS Safari 사생활 보호 모드에서 쓰기가 실패하면 「저장이 안 됐어요」를 띄우고 게임은 계속 가요.
• 7일 삭제 대비 — Safari 13.1 / iOS 13.4 부터 7일 동안 그 사이트를 안 쓰면 스크립트 저장소를 지워요(홈 화면에 추가한 웹 앱은 예외). 지워져도 오류 없이 빈 칸으로 보여서, 설정 화면에 경고 한 줄과 세이브 내보내기/불러오기를 둬요. 1판은 이 경고가 타이틀에 있었는데, v2 는 타이틀을 비우기로 해서 설정 화면으로 옮겼어요.
• 불러오기 검사 — 붙여넣은 JSON 은 키가 dracots2_ 로 시작하는 것만 받아요. 세이브의 scene 이 스크립트에 없으면 그 칸은 버리고 알려 줘요(이 문서 제안).

UX 기본값과 엔진 상수

⑧ UX 기본값표 (바이블 8-5)

속도 값을 시간으로 바꾸면

v2 의 권장 줄 길이는 15~50자, 상한 90자예요(바이블 4-0). 1판보다 권장 길이가 짧아졌어요 — 대사가 끌고 가는 웹소설 호흡으로 바꾸면서 한 줄을 짧게 끊기로 했거든요. python3 으로 계산했고, 자동 진행 대기는 글자가 다 찍힌 뒤부터 센다고 봤어요(이 문서의 해석 — 바이블은 시작 시점을 안 정했어요).

한 회차 약 45~65분은 추정이에요 — 읽는 줄 약 860줄(2026-10-14 실측 평균 862줄) × 줄당 3~4.5초(바이블 1-1). 줄당 초는 가정값이고, 한국어 비주얼 노벨을 분당 몇 자 읽는지는 찾지 못해서 미확인이에요.

엔진 상수 — v2 에서 바꾸는 것 (바이블 8-4)

5화 날짜를 숫자로 안 박는 건 1999년 6월 보름이 정확히 며칠인지 확인하지 못해서예요. 평균 삭망월로 계산하면 6월 28일 무렵이라는 추정만 있어요(바이블 1-2). 화면에는 「학기 마지막 주 보름」까지만 써요.

수첩 하트 제목이 「드레이코」가 아니라 「말포이」인 건 해리 시점이라서예요. 해리는 E1 마지막 대사 한 번 말고는 말포이를 성으로 불러요. 이름표도 같은 이유로 「말포이」예요.

타이틀 화면

1판 타이틀에는 제목 밑에 한 줄 소개, 긴 고지문 상자, 「제작:」 줄, 저장 경고가 쌓여 있었어요. 주인이 이걸 보고 반려했어요. v2 타이틀엔 제목·부제·메뉴만 둬요.

⑨ 타이틀 화면 구성표 (바이블 8-2)

탭 제목과 meta description 은 화면이 아니라 검색·공유 카드에 쓰이는 글이라 「팬 미연시」 표기를 남겨요. 고지문을 뺀 결정으로 생기는 위험은 06 위험·운영의 고지 정책표에 따로 적었어요.

모바일 세로 화면에서 제목이 두 줄을 넘지 않는지는 실제 화면으로 확인해야 해요. 제목 후보 셋 중 이걸 고른 이유 하나가 「모바일 타이틀에서 덜 꺾인다」였거든요(바이블 1-1). 확인은 미확인 — v2 타이틀을 아직 띄워 보지 않았어요.

확인 못 한 것과 출처

미확인으로 남긴 것

• 한국어 비주얼 노벨 읽기 속도 — 플레이 시간 약 45~65분이 추정인 이유예요.
• 이미지 45장 전체 용량 — v2 그림은 아직 생성 전이에요. 1판 그림 용량을 v2 값으로 옮겨 적지 않았어요.
• 실제 방문 기기의 가로·세로 비율 — 추적 코드를 안 넣어서 잴 수단이 없어요.
• v2 타이틀 제목의 모바일 줄바꿈.

출처 (모두 2026-10-14 확인)

• Ren'Py 기본값: https://www.renpy.org/doc/html/preferences.html · https://www.renpy.org/doc/html/config.html
• HTMLImageElement.decode(): https://developer.mozilla.org/en-US/docs/Web/API/HTMLImageElement/decode
• localStorage 용량·동기 API·Safari 7일 삭제: https://web.dev/articles/storage-for-the-web · https://www.theregister.com/2020/03/26/apple_relax_were_not_totally/
• iOS Safari 저장 실패 보고: https://bugnet.io/blog/fix-html5-game-localstorage-quota-exceeded-on-safari-ios
• 조작 키: 이 저장소 fangame/draco-ts/game/engine.js 의 onKey()(1판 코드, 2026-10-14 열어 확인).
• 1판 엔딩 실측: tools/validate.mjs, 시드 20031014, 무작위 10,000회(바이블 3-3 에 옮겨 둔 값).