파일 올리기 · OasisW 매뉴얼

내 컴퓨터에 있는 소리·글꼴·그림·모델 파일을 프로젝트 에셋으로 올립니다. 올린 파일은 ASSETS에 에셋으로 생기고, 엔티티의 컴포넌트 칸에 끌어다 놓아 씁니다.

이 페이지의 실측은 2026-10-29 oasisw.ai 에디터(판 표시 OasisW 7e2aa65, macOS Chrome)에서 한 것이고, .mp3·.glb, 여러 파일 한 번에 올리기, 끌어다 놓기는 2026-10-30에 같은 판에서 확인했습니다. 별도 표시가 없는 동작은 1회 확인했습니다.

시작하기 전에

올릴 파일을 쓸 권리가 있는지 확인합니다. 공개한 게임에 들어가는 파일은 누구나 받아 갈 수 있습니다.
올린 파일은 워크스페이스의 저장 공간을 씁니다. 실측 시점 개인 워크스페이스의 무료 한도는 1 GB였습니다(워크스페이스).
3D 모델이 필요하면 먼저 에셋 스토어를 찾아봅니다. 스토어 에셋은 출처 표기 없이 쓸 수 있습니다.

에디터에서 직접 하기

ASSETS 왼쪽 폴더 나무에서 파일을 넣을 폴더를 엽니다. 올린 파일은 지금 열린 폴더에 생깁니다.
ASSETS 오른쪽 위 Upload를 누릅니다. + → Upload도 같습니다.
파일 고르기 창에서 파일을 고릅니다. 여러 파일을 한 번에 고를 수 있습니다. 실측에서 beep.mp3와 testcube.glb를 함께 골라 둘 다 에셋이 됐습니다.
잠시 뒤 ASSETS에 에셋이 생깁니다. 오른쪽 위 에셋 수가 늘어납니다.

Upload를 누르지 않고 파일을 ASSETS의 에셋 목록 칸으로 끌어다 놓아도 올라갑니다. 실측에서 red.png를 끌어다 놓자 텍스처 에셋이 생겼습니다.

종류별 결과

파일	결과	쓰는 곳
`.wav`	지금 폴더에 소리 에셋(음표 아이콘) 하나	Sound 컴포넌트 슬롯의 Asset — 소리 넣기
`.ttf`	파일 이름 폴더 안에 원본 파일과 글꼴 에셋(Aa)	Text Element의 Font — 점수·안내 글자 바꾸기
`.mp3`	지금 폴더에 소리 에셋(음표 아이콘) 하나(`Type` `audio`). 오른쪽 AUDIO 칸에 길이(Duration, 예: `0.30s`)와 재생 버튼이 나옵니다	`.wav`와 같음
`.ogg`	작성 대기 현재 판 실측	소리
`.png`	지금 폴더에 그림이 미리 보이는 텍스처 에셋 하나(`Type` `texture`). 오른쪽에 Width·Height, Filtering(`Linear`), Address U·V(`Repeat`), 압축(COMPRESSION) 칸이 나옵니다	머티리얼의 텍스처 칸, Image Element의 Texture
`.glb`	파일 이름 폴더(`testcube.glb`) 안에 에셋 네 개: 컨테이너(`testcube.glb`), 머티리얼(glTF 안의 머티리얼 이름, 예: `Orange`), 렌더(메시 이름, 예: `TestCube`), 템플릿(`testcube`). 에셋 수는 폴더까지 5 늘어납니다	템플릿 에셋을 뷰포트로 끌어다 놓아 엔티티 만들기. 놓은 자리에 템플릿 인스턴스가 생기고, 자식 엔티티에 RENDER(Type `Asset`)가 붙습니다(Render 컴포넌트)
`.fbx`	작성 대기 현재 판 실측	뷰포트로 끌어다 놓아 엔티티 만들기

모델·텍스처를 올릴 때의 처리 방식은 SETTINGS의 ASSET IMPORT에서 정합니다(예: Convert to GLB, Textures POT). 씬 설정과 에디터 설정에 칸 목록이 있습니다.

한글 파일 이름

파일 이름이 그대로 에셋 이름이 됩니다. 실측에서 체커.png는 이름이 깨지지 않고 체커.png로 올라갔습니다(1회). 다만 스크립트에서 에셋을 이름으로 찾거나 AI 요청문에 이름을 적을 때를 생각하면 영문 이름이 다루기 쉽습니다.

AI에게 맡기기

파일 올리기는 손으로 합니다. AI는 내 컴퓨터의 파일을 올릴 수 없습니다. 올려 둔 에셋을 쓰게 하려면 요청문에 에셋 이름을 적습니다. 예: ASSETS의 hit.wav를 써서. 소리와 글꼴의 요청 예는 소리 넣기와 점수·안내 글자 바꾸기에 있습니다.

막혔을 때

증상	원인	해결
올린 파일이 안 보인다	다른 폴더가 열려 있었습니다	위 경로 줄에서 폴더를 오가며 찾거나 Search에 이름을 넣습니다
글꼴을 연결했는데 한글이 안 나온다	글꼴 에셋에 한글 글자가 없습니다	점수·안내 글자 바꾸기 3단계