노트가 게임 화면이 됩니다 — 비주얼노블 뷰

보통15분전 플랫폼

프론트매터에 view: visualnovel 한 줄. 그러면 이 노트가 배경이 깔리고 캐릭터가 서는 무대가 됩니다.

해질녘 거리에 선 두 캐릭터

0. 예제부터 받으세요 — 1분

압축을 풀어 폴더째 볼트에 넣으면 끝입니다. 대본 두 편, 캐릭터·배경 노트 다섯 개, 그림과 배경음이 다 들어 있어요. 아래는 전부 이 예제 화면입니다.

비주얼노블 뷰 예제를 열면 상단 도구바에 ▶ 버튼이 나타납니다. view: 값이 있는 노트에서만 보이는 버튼이에요.

무대에 선 캐릭터와 대사창

클릭이나 Space로 한 대사씩, ←로 되감기.

에디터에서 본 원문

<<옵시코코:옵시코코.png-->> 안녕하세요! 이 화면이 바로 비주얼노블 뷰에요.

<<이름:이미지>> 한 줄이 한 대사. 이름 뒤에 놓는 위치를 붙입니다 — |--는 왼쪽, --|는 오른쪽, 없으면 가운데. 토큰이 없는 줄은 그대로 내레이션이 되고요.

캐릭터 노트의 프론트매터

type: character 와 portrait: 목록. 그게 전부입니다. color: 를 넣으면 무대의 이름표 색이 되고, 노트 제목줄도 같은 색으로 물들어요.

배경은 type: background 에 background: 목록. 그래서 <<사무실:사무실_밤.png>> 한 줄이면 장면이 바뀝니다.

본문에 << 만 치면 볼트의 캐릭터가 목록으로 뜹니다.

캐릭터 이름 자동완성

이름을 고르고 : 를 치면 이번엔 그 캐릭터의 그림 목록이 뜹니다. 파일명을 외울 일이 없어요.

두 사람이 선 무대 — 말하는 쪽만 밝다

무대에 여럿이 서 있으면 말하는 캐릭터만 앞으로, 나머지는 물러나며 어두워집니다. 직접 지시하지 않아도 대본만 보고 알아서 해요.

같은 캐릭터라도 다른 그림을 쓰면 크로스페이드로 슥 바뀝니다 — 표정 연출이 그렇게 됩니다.

밤으로 바뀐 사무실

선택지 버튼이 뜬 화면

내레이션 줄에 [[#효과음과 화면 연출은 이렇게]] 처럼 링크를 두 개 이상 적으면 그대로 선택지 버튼이 됩니다. 새 문법이 없어요.

[[#소제목]] 은 문서 안에서 점프하고, [[다른 노트]] 는 아예 다른 에피소드로 이어집니다.

도감 — 캐릭터와 배경 목록

type: character · type: background 노트를 앱이 모아서 보여 줍니다. 따로 등록하는 곳은 없어요 — 노트를 만들면 그게 곧 등록입니다.

view: 값만 webnovel 로 바꾸면 똑같은 대본이 소설이 됩니다.

같은 대본을 소설처럼 읽는 화면

messenger 로 바꾸면 채팅 드라마가 되고요. 대본은 하나뿐입니다.

쉽죠?

▶ 버튼이 안 보임 → 프론트매터 view: visualnovel 을 확인하세요. 캔버스(.canvas)나 표(.base)에서는 안 나옵니다.
그림이 안 뜸 → 캐릭터 노트의 portrait: 경로와 실제 파일 이름이 같은지 보세요. 같은 이름 파일이 볼트에 있으면 폴더가 달라도 찾아 줍니다.
%%흔들림%% 이 에디터에서 사라짐 → %%…%% 는 주석이라 화면에서 감춰집니다. 오른쪽 위 <>(원본 보기)를 누르면 그대로 있어요.
선택지가 안 뜸 → 링크가 내레이션 줄(캐릭터 토큰이 없는 줄)에 있어야 합니다.
소리가 안 남 → 화면을 한 번 클릭한 뒤부터 재생됩니다(브라우저·앱 공통 규칙). 오른쪽 위 ♪ 로 음소거를 확인하세요.