리소스: 게임 세계 관리
리소스는 이야기에 반복해서 등장하는 아이템, 퀘스트, 장소를 설명합니다. 한 번 만들면 게임 액션에서 선택해 재사용할 수 있습니다. 리소스는 대상이 무엇인지 설명하고, 액션은 그 대상으로 무엇을 할지 게임에 요청합니다.
예제로 시작하기
The Harbour Key를 다운로드해 압축을 풀고 VNLE에서 project 폴더를 엽니다. 어떤 인터페이스 언어에서도 같은 항목을 찾도록 예제 이름은 영어로 유지됩니다. 리소스를 열면 아이템에는 Warehouse key, 퀘스트에는 Open the warehouse, 장소에는 Old warehouse가 있습니다.
리소스 만들고 설명하기
- 리소스에서 아이템, 퀘스트, 장소 중 하나를 선택하고 새 리소스를 만듭니다.
- 이름을 입력해 확인한 뒤 왼쪽 목록에서 항목을 선택합니다.
- 오른쪽에서 이름과 설명을 편집합니다.
- 아이템과 장소에는 갤러리 이미지를 지정하거나 이미지를 가져올 수 있습니다.
- 이 이미지는 VNLE 안에서 정리를 돕는 용도이며, 자동으로 게임 배경이나 인벤토리 아이콘이 되지는 않습니다.
아이템: 창고 열쇠
아이템은 반복해서 참조할 수 있는 물건의 설명입니다. Harbour의 Receive the key 노드는 Warehouse key를 Give item에 전달합니다. 인벤토리가 이를 받을 수 있는지는 게임이 결정합니다. Received는 구매를 계속하고 Declined는 골드를 돌려줍니다. 아이템을 만들기만 해서는 인벤토리에 추가되지 않습니다.
퀘스트: 목표와 진행 상황
퀘스트는 할 일과 목표를 설명합니다. Open the warehouse를 열면 Get the warehouse key와 Open the warehouse 목표가 있습니다. 목표를 추가하고, 글과 설명을 편집하거나 순서를 바꾸고 삭제할 수 있습니다. 이것은 목표 설명이며 자동 완료 판정은 아닙니다.
예제에서는 HasKey와 QuestComplete가 참/거짓 값으로 진행 상황을 기억합니다. 조건 노드는 값을 읽고 변수 변경 노드는 값을 바꿉니다. QuestAccepted는 구매 수락을 기록하며 전달이 거절되면 다시 거짓이 됩니다. 게임에서 이 값이나 게임 액션을 퀘스트 일지에 연결합니다.
장소: 이동 요청하기
장소는 Old warehouse처럼 무대가 되는 곳을 나타냅니다. 비주얼 노벨에서는 게임 액션으로 그 장소를 보여 달라고 요청할 수 있습니다. 배경, 음악, 전환 효과는 엔진이 결정합니다. 점프 노드는 이야기가 이어질 위치를 바꾸며, 화면에 보이는 게임 장면을 직접 바꾸지는 않습니다.
장면에서 리소스 사용하기
- Old warehouse를 선택하고 스토리에서 사용하기를 누릅니다.
- 장소 입력이 있는 기존 액션을 선택하거나 재사용할 새 액션을 만들어 이름을 붙입니다.
- 장면을 선택하고 추가하면, VNLE가 장소가 지정된 액션 노드를 만듭니다.
- 모든 결과를 다음 노드 또는 종료에 연결하고 액션을 이야기 흐름에 연결합니다.
준비된 장소 연습하기
- Location practice를 열고 Enter the warehouse를 선택해 그 노드에서 플레이를 시작합니다.
- Enter location과 입력 Location: Old warehouse가 표시됩니다.
- Completed를 선택하면 도착 대사가 나옵니다.
- 다시 시작해 Cancelled를 선택하면 항구에 머뭅니다.
- 두 경로 모두 종료됩니다.
- 미리보기는 요청과 결과를 시험할 뿐 엔진 배경을 바꾸지 않습니다.
입력과 결과 이해하기
게임 액션에서 Enter location을 선택합니다. Location 입력은 장소 참조를 받고, Completed와 Cancelled가 두 결과입니다. 재사용 액션은 가능한 요청을 정의합니다. 각 액션 노드는 실제 장소와 결과별 다음 경로를 선택합니다. 같은 종료 노드로 이어지더라도 두 경로를 모두 연결하세요.
번역하고 안전하게 재사용하기
리소스의 언어 막대에서 이름과 설명의 번역을 편집합니다. 퀘스트 목표도 번역할 수 있습니다. 원문을 수정한 뒤에는 번역을 확인하세요. 이름을 바꿔도 리소스 ID는 유지되므로 참조는 같은 항목을 가리킵니다.
사용 위치 찾기와 삭제
전체, 사용 중, 미사용 필터로 목록을 좁힙니다. 사용 위치에는 참조하는 노드와 액션 기본값이 표시되며 열어서 확인할 수 있습니다. 참조 중인 리소스를 삭제하려면 먼저 참조를 바꾸거나 제거해야 합니다. 미사용 리소스가 항상 오류는 아닙니다. 나중에 쓰려고 준비한 것일 수도 있습니다.
게임으로 전달되는 내용
스토리 내보내기에는 리소스 ID와 텍스트가 포함됩니다. VNLE 미리보기 이미지는 엔진 에셋에 자동으로 연결되지 않습니다. 게임 연동 안내에 따라 ID를 자신의 배경이나 인벤토리에 연결하세요. 아래의 별도 location-practice.story.json은 연습 장면의 내보내기이며, Harbour의 기존 구매 흐름은 유지됩니다.