에디터에서 방 만들기

Youscape 룸 에디터에 오신 것을 환영합니다! 이 가이드는 몰입감 있는 방탈출 룸을 설계하고 구축하는 데 필요한 다양한 기능을 안내합니다. 에디터는 왼쪽 패널(게임 스테이지와 글로벌 단서), 가운데 3D 캔버스(시각 구성), 오른쪽 패널(에디터 컨트롤: 미션 상세, 에셋 관리, 플레이어 및 씬 설정, 미션 액션, 라이브 에셋 데이터, 이동 범위)로 나뉩니다.

I. 에디터 컨트롤(오른쪽 패널)

미션 상세

• 공개 신청: 미션을 공개할 준비가 되면 이 체크박스를 선택하세요. 방이 공개 심사에 제출되어 플레이어가 접근할 수 있게 됩니다.
• 지원 언어: 체크박스로 미션에서 지원할 언어(영어, 한국어)를 선택하세요. 최소 1개 이상 선택해야 합니다.
• 미션 이름 및 설명: 미션의 현지화된 이름과 설명을 입력하세요. ‘지원 언어’에서 선택한 언어에 따라 다국어 입력을 지원합니다.
• 미션 썸네일 URL: 에셋 선택기를 사용해 업로드한 이미지 에셋을 미션 썸네일로 지정하세요.
• 태그: 미리 정의된 목록(공포, SF, 미스터리, 어드벤처, 퍼즐 등)에서 최대 7개의 장르 태그를 선택해 미션을 분류하세요. 태그는 현지화됩니다.
• 난이도: 드롭다운에서 난이도(초보, 쉬움, 보통, 어려움, 불가능)를 선택하세요. 선택한 언어에 맞춰 현지화된 표시가 적용됩니다.

룸 템플릿

• 템플릿 선택: 사용 가능한 룸 템플릿 목록에서 선택하세요.
• 템플릿 미리보기: 선택한 템플릿의 썸네일 이미지가 표시됩니다.
• 이 템플릿 사용: 이 버튼을 클릭하면 선택한 템플릿의 GLB 모델을 현재 씬에 불러옵니다. 미션을 초기화하지 않고 기존 구조 위에 빠르게 작업을 시작할 수 있습니다.

에셋 관리

• 새 에셋 업로드 (3D 모델, 이미지, 비디오, 오디오):
  • 파일 선택: 로컬에서 3D 모델(GLB), 이미지(PNG, JPG), 비디오(MP4, WebM), 오디오(MP3, WAV, OGG) 파일을 선택하세요.
  • 선택한 에셋 업로드: 선택한 파일을 Supabase Storage에 업로드합니다. 업로드 후 GLB 모델은 씬에 배치할 수 있고, 미디어/오디오 에셋은 단서나 배경 설정에 사용할 수 있습니다.
• 업로드된 에셋 표시: 업로드한 미디어(이미지, 비디오)와 오디오 에셋 목록을 확인하세요.
• URL로 3D 모델 추가: URL을 입력해 GLB 모델을 바로 씬에 추가하세요. 모델은 3D 캔버스에 나타나며 “라이브 에셋 데이터”에 표시됩니다.

플레이어·씬 설정

• 플레이어 시작 뷰 지정: 3D 캔버스에서 원하는 시작 지점으로 카메라를 맞춘 뒤, 이 버튼을 눌러 플레이어의 시작 위치와 회전을 설정하세요. 현재 위치와 회전 값이 표시됩니다.
• 배경음악 URL: 업로드한 오디오 에셋을 선택하여 미션의 배경음악으로 사용하세요.
• 발자국 소리 URL: 업로드한 오디오 에셋을 선택하여 플레이어의 발자국 소리로 사용하세요.
• 시간 제한(분): 숫자 입력으로 미션의 시간 제한을 설정하세요.
• 변환 모드: 캔버스에서 선택한 3D 오브젝트를 조작하기 위해 ‘이동(Translate)’, ‘회전(Rotate)’, ‘스케일(Scale)’ 모드로 전환합니다. 위치·회전·스케일을 정밀하게 설정할 수 있습니다.
• 기본 오브젝트 추가: ‘인터랙티브 클루 포인트’ 또는 ‘정적 큐브’ 에셋을 빠르게 추가합니다. 이후 세부 설정이 가능합니다.

미션 액션

• 미션 불러오기: 기존 미션 ID(UUID)를 입력하여 데이터를 에디터로 불러옵니다.
• 로컬 미션 JSON 불러오기: 로컬 JSON 파일을 업로드하여 미션 데이터를 로드합니다. 오프라인 편집이나 설정 공유에 유용합니다.
• 미션 생성 및 저장 / 미션 업데이트: 현재 진행 상황을 데이터베이스에 저장합니다. 새 미션이면 생성되고, 기존이면 업데이트됩니다. 저장 상태가 표시됩니다.
• 모두 지우기: 현재 미션 데이터와 에셋을 모두 지워 빈 상태로 초기화합니다.

라이브 에셋 데이터

• 이 섹션에는 현재 씬에 있는 모든 3D 에셋의 실시간 목록이 표시됩니다.
• 각 에셋의 ID, 타입, 위치(x, y, z), 회전(x, y, z), 스케일(x, y, z)을 확인할 수 있습니다.
• 제거: 씬에서 에셋을 삭제합니다.
• 커스텀 ID: 단서와 스테이지에서 참조하기 쉽도록 에셋에 커스텀 ID를 지정하세요.

이동 범위 (XZ 평면)

• 새 범위 추가: 3D 씬 내 플레이어 이동을 제한하기 위해 XZ 평면에 직사각형 영역을 정의합니다.
• 범위 상세: 각 범위에 대해 경계를 정의하려면 Min X, Max X, Min Z, Max Z 값을 지정하세요.
• 범위 삭제: 설정된 이동 범위를 삭제합니다.

II. 게임 스테이지(왼쪽 패널)

• 새 스테이지 추가: 미션에 새 스테이지를 만듭니다. 스테이지는 보통 서로 다른 퍼즐이나 룸의 구역을 의미합니다.
• 미션 플로우: 스테이지의 진행 순서와 상호 해금 관계를 시각화하여 최종적으로 “미션 완료”에 이르는 흐름을 보여줍니다.
• 스테이지 상세:
  • 스테이지 이름 및 설명: 선택한 언어를 지원하는 스테이지 이름·설명 현지화 입력란입니다.
  • 클릭 가능한 오브젝트 ID: 플레이어가 이 스테이지를 해결하기 위해 상호작용할 씬의 오브젝트를 선택하세요(“라이브 에셋 데이터”에서 선택).
  • 단서:
    • 다양한 유형의 단서를 여러 개 추가하여 플레이어를 안내하세요:
      • 텍스트: 일반 텍스트 내용입니다.
      • 이미지 URL: URL에서 불러오는 이미지(업로드한 미디어 에셋에서 선택).
      • 비디오 URL: URL에서 불러오는 비디오(업로드한 미디어 에셋에서 선택).
      • 로컬 이미지: 게임의 public 에셋 내 로컬 경로에서 불러오는 이미지(예: /images/my_clue.png).
    • 각 단서에 현지화된 내용, URL 또는 로컬 경로를 제공하세요.
    • 단서 삭제: 스테이지에서 특정 단서를 삭제합니다.
  • 정답 입력 방식: 플레이어가 정답을 어떻게 입력할지 방식을 선택하세요.
    • 텍스트 입력: 플레이어가 텍스트로 정답을 입력합니다.
    • 숫자 패드: 숫자 패드를 사용해 숫자 정답을 입력합니다.
    • 알파벳 슬라이더: 플레이어가 알파벳 슬라이더로 글자를 선택합니다.
    • 정보형(정답 입력 없음): 이 단서는 정보를 제공하지만 진행에 정답 입력이 필요하지 않습니다.
  • 정답: 선택한 방식에 맞는 정답을 입력하세요. 이 필드는 현지화되며, ‘정보형’이 아닐 때만 표시됩니다.
  • 해금 스테이지: 이 스테이지가 해금하는 다음 스테이지를 지정하거나, 미션 종료라면 “미션 완료”로 표시하세요.
  • 스테이지 삭제: 미션에서 해당 스테이지를 삭제합니다.

III. 글로벌 단서(왼쪽 패널)

• 트리거 오브젝트 ID: 이 글로벌 단서를 트리거할 씬의 오브젝트를 선택하세요(“라이브 에셋 데이터”에서 선택).
• 단서 유형: 단서 유형(텍스트, 이미지 URL, 비디오 URL, 로컬 이미지)을 선택하세요.
• 콘텐츠/URL/경로: 유형에 따라 단서에 사용할 현지화된 콘텐츠나 URL/경로를 입력하세요.
• 글로벌 단서 추가: 설정한 글로벌 단서를 미션에 추가합니다.
• 기존 글로벌 단서: 추가된 글로벌 단서를 확인·삭제할 수 있습니다. 각 단서는 ID, 트리거 오브젝트, 유형, 콘텐츠/URL/경로를 표시합니다.

IV. 3D 캔버스(가운데 패널)

• 이곳은 방탈출을 시각적으로 조립하는 메인 작업 공간입니다.
• 3D 모델과 인터랙티브 요소를 드래그 앤 드롭하세요
• 오른쪽 패널의 ‘변환 모드’(이동·회전·스케일)로 선택한 오브젝트를 조작해 **정밀한 3D 씬 구성(위치·회전·스케일)**을 수행하세요.
• 캔버스의 카메라 뷰로 플레이어의 시작 위치를 설정할 수 있습니다.
• 업로드된 3D 모델: 캔버스 하단의 에셋 선택기에서 업로드한 GLB 모델을 선택할 수 있습니다.
• 선택한 3D 모델 미리보기: 모델 뷰어에 선택한 GLB 모델이 표시되며, 보기 편하도록 확장/축소할 수 있습니다. 업로드된 3D 모델을 손쉽게 확인할 수 있습니다.

이 가이드는 Youscape 룸 에디터를 익히고 매력적인 방탈출 경험을 만드는 데 도움을 줄 것입니다. 즐거운 제작 되세요!