# Scenario Studio — 게임 실행 중에 시나리오를 디버그하고 편집하기

Scenario Studio는 실행 중인 게임 옆에 열리는 도크로, 지금 어떤 시나리오가 재생되고 어떤 줄이 화면에 있는지 보여 줍니다. 대화를 일시 정지하고, 한 줄씩 진행하고, 중단점에서 멈추고, 다음 줄을 옮기고, 게임 상태를 되돌려 시나리오를 다시 시작하고, 그 자리에서 시나리오를 바꿀 수 있습니다 — 그리고 변경은 곧바로 게임에 나타납니다.

모드는 두 가지입니다. **초보자** 모드는 이야기 장면을 단순한 블록으로 보여 주고, **작성자** 모드는 줄 번호가 붙은 시나리오 텍스트를 보여 줍니다.

## 열기

Developer Tools 도구 모음이 들어 있는 게임(메커니즘 *Scenario Studio*)에는 도구 모음에 **스튜디오** 버튼 — 깃펜 — 이 있습니다. 실행 플래그 `--studio`를 붙이면 시작할 때 도크가 열립니다. 아래의 그림은 Cthangover의 주방에서 찍은 것으로, 편집은 테스트 레이어에 기록되었고 게임 자체 파일은 건드리지 않았습니다.

## 초보자 모드

![주방과 오른쪽의 초보자 모드 스튜디오 도크: 장면 home_kitchen, 시나리오 home_kitchen_cooking, 레이어 배지. "지금 화면에" 아래에 줄 "새 줄"과 질문 "주방으로 꾸며진 방", 답변으로 나가기(장면 home_vestibule로), 요리하기(동작 toggle_cooking_workbench), 새 답변이 있고 각각에 갈 곳 선택과 편집이 붙어 있습니다. "+ 질문 앞에 줄"과 "+ 답변" 버튼, 아래쪽에 "이 변경이 영향을 주는 곳"(대상 레이어)과 적용.](assets/studio-novice.jpg)

**지금** 탭은 화면의 장면을 보여 줍니다: 줄, 질문, 그리고 각 답변이 어디로 이어지는지. **편집**은 텍스트를 바꾸고, **갈 곳 선택**은 답변의 행선지(레이블, 다른 장면, 끝)를 바꾸며, **+ 줄**과 **+ 답변**은 그 장면에 더합니다. 변경마다 **이 변경이 영향을 주는 곳**에 어느 모드나 레이어에 기록될지 표시됩니다.

## 작성자 모드, 일시 정지, 중단점

![작성자 모드의 도크: 전송 막대에 일시 정지, 한 단계, 계속, 리소스, 다시 시작. home_kitchen의 시나리오 텍스트에서 6번째 줄 — select "주방으로 꾸며진 방" — 에 빨간 중단점과 현재 줄의 ▶ 표시가 있습니다. 그 아래 "9번째 줄 뒤"에 + 줄, + 선택지, + 장면으로 이동, 그리고 대상 레이어 my_studio.](assets/dock-breakpoint.jpg)

- **일시 정지**는 다음 줄 앞에서 대화를 멈추고, **한 단계**는 한 줄만 실행하며, **계속**은 계속 진행합니다.
- 여백을 클릭하면 **중단점**이 생깁니다: 대화가 그 줄 앞에서 멈춥니다.
- **▶** 표시를 다른 줄로 끌면 그 줄이 다음에 실행됩니다.
- **+ 줄**, **+ 선택지**, **+ 장면으로 이동**은 현재 줄 뒤에 더하고, **텍스트 편집**은 시나리오 전체를 편집합니다.

## 적용과 다시 시작

**적용**은 변경을 기록하고 시나리오를 다시 시작합니다. 여기서는 질문 앞에 "새 줄"을 추가했습니다. 적용 후 화면에 나타납니다:

![적용 후의 도크: 화면에는 "새 줄", 상태는 ""my_studio"에 적용, 되돌려서 시나리오를 다시 시작함".](assets/dock-applied.jpg)

**다시 시작**은 선택지를 제공합니다: 되돌리지 않고 시나리오 다시, **상태를 되돌려** 다시(플래그, 아이템, 시계 등이 시나리오가 시작했을 때의 상태로 돌아갑니다), 장면 다시, 현재 레이블에서 계속하기.

## 상태 살펴보기

![상태 탭: "값을 바꿔 다른 분기를 시험할 수 있습니다", 시계는 24일 23:00.](assets/dock-state.jpg)

**상태** 탭은 게임 상태를 소유자별로 보여 줍니다: 시계, 진행 중인 대화의 변수, 시나리오가 참조하는 퀘스트, 인벤토리, 그리고 어떤 시나리오가 이미 실행됐는지. 변수, 아이템 개수, 퀘스트 상태는 바꿀 수 있고(Enter가 게임에 기록합니다), 이를 통해 다른 분기를 시험할 수 있습니다. **장면** 탭은 현재 장면의 시나리오를, **지도** 탭은 장면과 그 사이의 길(그리고 새 배경을 놓을 곳)을 보여 주고, **로그**는 무슨 일이 있었는지 기록합니다:

![로그 탭: home_kitchen에 들어감, home_kitchen_cooking 시작, 편집 "+6 → my_studio", 다시 시작들, "중단점, 6번째 줄", "다음 줄을 5로 이동", "home_kitchen의 체크포인트".](assets/dock-log.jpg)

## 변경이 기록되는 곳

- 폴더로 설치된 모드는 그 자리에서 바꿀 수 있습니다.
- 그 외의 변경은 게임의 **스튜디오 레이어**(`user://studio/<game>`)로 갑니다. 레이어는 모든 모드보다 우선하며 모드 자체는 건드리지 않습니다. 레이어는 새 모드로 내보낼 수 있고, 이를 게임 컬렉션에 추가하면 됩니다.
- **리소스**는 게임이 실행되는 동안 모드나 레이어의 `backgrounds/` 폴더에 넣은 배경을 다시 읽습니다. 그런 배경 위로는 지도 탭에서 바로 새 장면을 만들 수 있습니다.

## 문제가 생겼을 때

1. **스튜디오 버튼이 없습니다.** 게임 컬렉션에 스튜디오가 들어 있지 않습니다. Developer Tools 도구 모음을 추가하거나 `--studio`로 실행하세요.
2. **한 단계가 아무것도 하지 않습니다.** 대화가 답변을 기다리고 있습니다: 먼저 하나 고르세요.
3. **다른 플레이어에게 변경이 보이지 않습니다.** 스튜디오 레이어의 변경은 이 컴퓨터의 이 게임에만 남습니다. 공유하려면 레이어를 모드로 내보내세요.