• 홈
  • 블로그
  • 갤러리
  • 가격
  • 홈
  • 블로그
  • 갤러리
  • 가격
창작 시작

만들고.플레이하세요.

크리에이터 블로그

홈/블로그/제품 워크플로

대본을 프로그램이 읽을 수 있는 데이터로 바꾸는 방법: 노드, 선택지, 조건과 결과

대본을 프로그램에 연결할 때 핵심은 Word 파일을 JSON에 복사하는 것이 아니라 안정적인 서사 데이터 계약을 만드는 것입니다. 각 노드는 무엇을 재생하고 언제 상호작용을 표시할지 설명합니다. 각 선택지는 표시 조건, 플레이어의 의도, 상태 변화 결과와 대상 노드를 설명합니다. 텍스트, 미디어, 로직은 서로 참조하면서도 각각 추적 가능한 버전을 갖습니다.

D
DramaFork Editorial Team인터랙티브 스토리텔링과 AI 제작
2026.08.26예상 읽기 시간: 6분
「대본을 프로그램이 읽을 수 있는 데이터로 바꾸는 방법: 노드, 선택지, 조건과 결과」 블로그 글 표지
목차
크리에이터 블로그
  1. 01들어가며
  2. 02안정적인 ID부터 시작하기
  3. 03노드 구조의 각 부분에는 하나의 책임만 부여하기
  4. 04선택지에는 표시 방식과 결과를 함께 기록하기
  5. 05조건은 검증하고 설명할 수 있어야 합니다
  6. 06미디어 목록과 서사 데이터 분리하기
  7. 07명확한 실행 순서 설계하기
  8. 08데이터 검증과 읽기 쉬운 로그 구축하기
  9. 09프로그래머가 아닌 사람도 검토할 수 있게 하기
글 맨 위로

들어가며

대본을 프로그램에 연결할 때 핵심은 Word 파일을 JSON에 복사하는 것이 아니라 안정적인 서사 데이터 계약을 만드는 것입니다. 각 노드는 무엇을 재생하고 언제 상호작용을 표시할지 설명합니다. 각 선택지는 표시 조건, 플레이어의 의도, 상태 변화 결과와 대상 노드를 설명합니다. 텍스트, 미디어, 로직은 서로 참조하면서도 각각 추적 가능한 버전을 갖습니다.

안정적인 ID부터 시작하기

챕터, 장면, 노드, 선택지, 에셋에는 모두 고유한 ID가 필요합니다. 표시 제목은 바꿀 수 있지만, 제작에 사용되기 시작한 ID는 재사용하지 않습니다. 예를 들어 노드는 C02_S04_N030, 선택지는 C02_S04_N030_O2, 영상은 C02_S04_N030_main_v07.mp4로 지정할 수 있습니다. 프로그램, 자막, 이벤트 계측, 결함 보고서는 모두 같은 식별자를 사용합니다.

ID에는 배우 이름, 감정, 최종 대사를 포함하지 않습니다. 이런 정보는 바뀔 수 있기 때문입니다. 폐기한 ID는 변경 기록에 남겨 이전 저장 데이터나 로그가 새 콘텐츠를 잘못 가리키지 않도록 합니다.

노드 구조의 각 부분에는 하나의 책임만 부여하기

노드 데이터에는 id, media, entryConditions, onEnter, interactions, onExit, fallback, tags가 포함될 수 있습니다. 미디어 필드는 에셋 목록을 참조하며 로컬 절대 경로를 직접 섞어 넣지 않습니다. 조건은 상태를 읽기만 하고, 효과는 허용된 상태에만 값을 씁니다.

{
  "id": "C02_S04_N030",
  "media": "VID_C02_S04_N030_MAIN",
  "entryConditions": ["evidence_recording == true"],
  "interactions": ["C02_S04_N030_O1", "C02_S04_N030_O2"],
  "fallback": "C02_S04_N040"
}

이 예시는 역할의 경계만 보여 줍니다. 실제 형식은 JSON, 스프레드시트 내보내기 파일 또는 서사 스크립트를 사용할 수 있습니다. 중요한 것은 같은 사실을 관리하는 기준 위치가 하나뿐이어야 한다는 점입니다.

선택지에는 표시 방식과 결과를 함께 기록하기

선택지에는 문구 키, 표시 조건, 선택 가능 조건, 시간 제한 규칙, 상태 효과, 대상 노드가 필요합니다. 보이지만 선택할 수 없다면 플레이어에게 이유를 알려야 합니다. 완전히 숨긴다면 빈 버튼을 남겨서는 안 됩니다. 문구에는 현지화 키를 사용하고, 중국어 원문을 로직 판단 기준으로 삼지 않습니다.

효과에는 불리언 값 설정, 자원 추가, 관계 단계 변경처럼 제한된 연산을 사용하는 것이 좋습니다. 각 선택지 안에 임의의 스크립트를 숨길 수 있게 하면 작가의 데이터가 검토할 수 없는 프로그램으로 바뀝니다. 복잡한 동작은 이름이 있는 명령을 통해 런타임에서 구현하도록 합니다.

조건은 검증하고 설명할 수 있어야 합니다

조건은 변수 표의 정식 이름을 참조하고 비교 유형을 제한합니다. 불리언 값과 문자열을 혼용하지 않고, 열거형은 유효한 값만 허용하며, 숫자에는 상한과 하한을 설정합니다. 편집기나 빌드 스크립트는 내보내기 과정에서 알 수 없는 변수, 도달할 수 없는 노드, 출구 없는 순환, 누락된 대상을 검사합니다.

복잡한 조건은 이름이 있는 규칙으로 나눕니다. 예를 들어 can_publish_truth는 핵심 증거가 모두 갖춰졌는지, 기자가 여전히 협력하는지, 자원이 충분한지로 구성됩니다. 테스트 로그에는 규칙의 결과와 기초 값을 함께 출력해야 플레이어에게 특정 선택지가 보이지 않은 이유를 설명할 수 있습니다.

미디어 목록과 서사 데이터 분리하기

노드는 논리적 에셋 ID만 참조합니다. 에셋 목록은 이 ID를 플랫폼, 언어, 화질별 파일에 매핑합니다. 이렇게 하면 편집본을 v06에서 v07로 바꿔도 분기 로직을 수정할 필요가 없습니다. 모바일에서 더 낮은 비트레이트를 사용하더라도 노드 전체를 복제하지 않습니다.

목록에는 최소한 파일, 체크섬, 재생 시간, 해상도, 오디오 트랙, 자막, 버전, 검토 상태를 기록합니다. 런타임은 로딩 전에 체크섬과 재생 시간을 검증해 잘못된 영상이나 잘린 영상이 정식 배포 패키지에 들어갈 가능성을 줄일 수 있습니다.

명확한 실행 순서 설계하기

노드 진입, 미디어 준비, 재생, 선택지 표시, 선택 제출, 효과 적용, 노드 이탈의 순서를 정합니다. 상태를 먼저 기록하는지, 먼저 이동하는지에 따라 다음 노드의 진입 조건 판단이 달라집니다. 선택 제출은 원자적 트랜잭션으로 처리하는 것을 권장합니다. 여전히 선택 가능한지 검증하고, 결과를 기록하고, 로그를 남긴 다음 이동합니다. 실패하면 상태를 변경하지 않고 복구 방법을 제공합니다.

시간 초과, 건너뛰기, 저장 데이터 불러오기, 반복 클릭도 같은 상태 머신을 거쳐야 합니다. 버튼은 제출 직후 잠가 더블 클릭으로 두 번 기록되는 것을 막습니다. 나갔다가 다시 들어올 때는 제출 완료 표시에 따라 복원하며 보상을 다시 지급하지 않습니다.

데이터 검증과 읽기 쉬운 로그 구축하기

빌드할 때마다 ID의 고유성, 참조 대상의 존재, 최소 하나의 출구, 변수 유형의 정확성, 현지화 키의 완전성, 미디어를 찾을 수 있는지를 자동으로 검사합니다. 경고와 오류는 심각도에 따라 구분합니다. 선택 사항인 메모가 없으면 경고할 수 있지만, 대상 노드가 없으면 반드시 빌드를 막아야 합니다.

실행 로그는 구조화된 이벤트로 세션, 노드, 선택지, 변경 전후의 상태 요약, 시간, 버전을 기록합니다. 로그에는 불필요한 개인정보를 포함해서는 안 됩니다. 디버그 빌드는 더 자세히 기록할 수 있지만, 정식 분석 이벤트는 개인정보 보호 및 동의 요건을 준수해야 합니다.

프로그래머가 아닌 사람도 검토할 수 있게 하기

기계가 읽을 수 있다고 해서 사람이 읽기 어려워야 하는 것은 아닙니다. 같은 데이터에서 노드 표, 분기 그래프, 플레이 가능한 미리보기를 생성하면 작가는 대사를, 제작자는 에셋을, 테스터는 경로를 확인할 수 있습니다. 수작업으로 만든 모든 사본에는 원본에 다시 반영할 수 없다고 표시해 여러 사람이 서로 다른 기준 데이터를 관리하는 일을 막습니다.

다음 단계: 노드 열 개를 골라 최소 데이터 스키마를 정의하고, 올바른 예시 하나와 의도적으로 잘못 만든 예시 세 개를 작성합니다. 빌드 검사가 알 수 없는 변수, 연결 대상이 없는 출구, 누락된 미디어를 정확히 차단하는 것을 확인한 뒤 전체 대본을 가져옵니다.

제품 기능 알아보기 인터랙티브 작품 체험

수정일 2026.10.04

관련 주제 살펴보기인터랙티브 스토리텔링인터랙티브 영상 제작
PLAY / DISCOVER

관련 작품과 체험

작품 색인 보기
인터랙티브 영상 · 기획 소개

남은 병상 하나

중환자실 병상은 하나뿐인데 여러 환자가 기다리고 있다. 모든 의료적 판단에는 인간적인 대가가 따른다.

인터랙티브 영상 · 기획 소개

검은 장미의 목격자

마피아의 결혼과 목숨을 건 증언 사이에서, 목격자는 진실이 폭력으로 번지기 전에 누구를 믿을지 결정해야 한다.

인터랙티브 영상 · 기획 소개

13층 엘리베이터

존재하지 않아야 할 13층에 계속 멈추는 엘리베이터. 거울 속에서 사라진 사람이 반복을 빠져나갈 방법을 알고 있는 듯하다.

인터랙티브 영상 · 기획 소개

내일로 가는 막차

막차는 번영한 도시와 폐허가 된 세계라는 두 미래를 향한다. 당신의 선택이 마지막 역을 결정한다.

계속 읽기

더 많은 글 보기
선택 스위치가 두 개의 문 모형을 선으로 연결하고, 편집자가 출구 오연결 여부를 확인한다.
제품 워크플로2026.09.26 · 6분

DramaFork 상호작용 노드 검토 방법: 선택지 텍스트, 출구, 회수 결과를 쌍으로 봐야 한다

상호작용 노드를 검토할 때는 각 선택지를 하나의 '약속—이행' 쌍으로 취급해야 한다. 플레이어가 버튼에서 읽는 의도는 출구가 가리키는 노드에서 대응하는 결과를 반드시 얻어야 하며, 그 결과는 메인 라인으로 돌아가거나 명확한 마무리를 형성할 수 있어야 한다. 버튼 텍스트만 검사하거나 노드 연결만 보면 빈 출구, 잘못된 연결, 동일 의도 중복을 놓치게 된다. 아래에서는 가상 교육 예시 '온실 문 안팎'을 사용하여 반복 사용 가능한 검토표를 설명한다.

‘3막 이야기를 인터랙티브 구조로 바꾸는 방법: 고정된 골격과 가변 노드’ 블로그 글 표지
인터랙티브 서사2026.08.21 · 6분

3막 이야기를 인터랙티브 구조로 바꾸는 방법: 고정된 골격과 가변 노드

3막 구조는 인터랙티브 영화 게임에도 사용할 수 있지만, 선형 대본을 완성한 뒤 각 막 사이에 선택지를 삽입하는 방식으로는 안 된다. 더 실용적인 방법은 고정된 인과 골격을 유지하면서 플레이어가 정보를 얻는 순서, 인물 관계, 해결 수단과 최종적으로 치르는 대가를 바꾸게 하는 것이다. 골격은 이야기가 진행되도록 하고, 가변 노드는 플레이어의 행동이 기억되도록 한다.

‘1명, 3명, 10명은 각각 어느 규모의 인터랙티브 무비 게임을 만들 수 있을까’ 블로그 글 표지
제품 워크플로2026.08.17 · 6분

1명, 3명, 10명은 각각 어느 규모의 인터랙티브 무비 게임을 만들 수 있을까

팀 규모가 결정하는 것은 작품이 얼마나 ‘고급스러운가’가 아니라, 동시에 얼마나 많은 캐릭터, 장소, 개별 영상, 시스템, 재작업을 관리할 수 있는가다. 혼자서도 완성된 인터랙티브 무비 게임을 만들 수 있지만, 새로운 시도는 하나의 메커니즘에 집중해야 한다. 3명은 콘텐츠, 영상·음향, 프로그래밍을 아우르는 최소한의 완결된 작업 체계를 만들 수 있다. 여러 장소의 촬영, 복잡한 후반 작업, 정식 출시를 동시에 추진하기에는 10명 정도가 더 적합하다.

하나의 이야기에서, 플레이할 수 있는 세계로.

하나의 이야기 아이디어에서 시작해 대본, 캐릭터, 장면과 분기를 구성하고 플레이 가능한 첫 버전을 만드세요.

탐색 및 플레이

  • 탐색 광장
  • 인터랙티브 영상
  • 텍스트 게임
  • 캐릭터 IP
  • 순위
  • 작품 색인

창작과 협업

  • 내 작품
  • 영상 창작 스튜디오
  • 텍스트 게임 제작
  • 캐릭터 제작
  • 크리에이터 파트너십

창작 읽을거리

  • 크리에이터 블로그
  • 주제 컬렉션
  • 글 아카이브

주제 가이드

  • 인터랙티브 스토리텔링
  • 인터랙티브 영상 제작
  • 텍스트 게임의 입력·규칙·상태
  • 캐릭터, 관계, 세계관

요금제 및 크레딧

  • 가격
  • 크레딧

정책 및 지원

  • 개인정보 처리방침
  • 이용약관
  • 쿠키 정책
© 2026 DramaFork/AI 인터랙티브 스토리 스튜디오
Press Enter to send, or drag away and release.