VNLE 사용 설명서
예제: 항구의 열쇠

미라는 잠긴 창고를 지키고 있습니다. 미라에게 골드 5개를 내고 열쇠를 살 수 있습니다. 게임이 아이템을 받으면 대화는 창고로 이어지고 퀘스트가 완료됩니다. 예제에는 장면 네 개와 아홉 가지 노드 유형이 모두 들어 있습니다.
1 · 프로젝트 열기
- 예제 프로젝트를 다운로드하고 ZIP 압축을 푸세요.
- VNLE를 실행하세요. Open project를 선택하고 project.vnle.json이 들어 있는 압축 해제된 프로젝트 폴더를 선택합니다.
- 왼쪽 사이드바에서 Harbour를 선택하세요. 노드를 선택하면 오른쪽에 내용이 표시됩니다. 이 가이드는 영어 조작 이름을 사용합니다. 앱 언어는 Settings에서 바꿀 수 있습니다.
2 · 캐릭터, 값, 아이템
Characters를 여세요. 미라에게는 이름과 초상화가 있습니다. 대화 노드가 미라를 화자로 선택하므로 게임에서 대사 옆에 이름과 이미지를 표시할 수 있습니다.
Variables에는 Gold = 10과 값이 false인 HasKey, QuestAccepted, QuestComplete가 있습니다. 정수로 골드 수를 세고 세 개의 불리언 값으로 진행 상황을 기억합니다.
Resources에는 Warehouse key 아이템, Open the warehouse 퀘스트, Old warehouse 장소가 있습니다. 게임은 이러한 항목을 안정적인 ID로 참조할 수 있습니다. 함께 제공되는 게임 예제가 화면의 인벤토리를 관리합니다.
3 · 대화 흐름 따라가기
- Welcome에서 인사가 표시됩니다. Ask Mira는 Mira’s request를 호출합니다. 다른 대화가 창고를 설명한 다음 Return으로 주 대화에 돌아옵니다.
- Already have the key?는 HasKey를 확인합니다. 열쇠가 없으면 Choose a reply가 표시됩니다. 구매하거나 Maybe later를 선택하세요.
- Enough gold?는 Gold ≥ 5를 확인합니다. 골드가 부족하면 미라가 구매를 거절합니다. 충분하면 Pay five gold가 골드 5개를 차감하고 QuestAccepted를 true로 설정합니다.
- Receive the key는 give_item을 요청합니다. 게임은 인벤토리에 열쇠를 추가하고 Received 결과를 반환합니다. Remember the key는 HasKey를 true로 설정합니다.
- Your remaining gold는 현재 골드를 대사에 표시합니다. Go to the warehouse는 Warehouse로 이동합니다. Check the warehouse key는 열쇠를 확인하고 QuestComplete를 설정한 다음 마지막 대화를 표시합니다.
- Return to the game은 End 노드입니다. 게임이 대화창을 닫고 플레이어에게 조작을 돌려줍니다.
4 · 모든 경로 시험하기
- Play in your browser를 여세요. Talk to Mira를 선택하고 Continue를 두 번 누른 뒤 열쇠를 사세요. Gold 5, 인벤토리의 열쇠, 마지막의 Quest complete를 확인하세요.
- Start with 2 gold로 다시 시작하세요. 구매가 거절되고 인벤토리는 비어 있어야 합니다. 다음에는 Maybe later를 시험하세요.
- 대사 도중 English와 Deutsch를 전환하세요. 같은 대사가 유지되어야 합니다. 구매 후 Save game으로 저장하고 진행한 뒤 Load game으로 돌아오세요.
게임 액션을 추가할 때는 취소 결과도 연결하세요. 예제에서는 인벤토리가 아이템을 거절하면 Refund the payment가 골드 5개를 돌려주고 QuestAccepted를 초기화합니다. 그다음 작별 대사가 표시됩니다.