OasisW매뉴얼 English
섹션 11. 협업과 버전 관리 방법 작성 대기 1

프로젝트 가져오기와 내보내기

프로젝트 전체를 파일 하나로 내보내 보관하거나, 내보낸 파일을 다시 새 프로젝트로 가져옵니다. 엔티티 하나만 3D 모델 파일로 내보낼 수도 있습니다. 2026-10-29 oasisw.ai에서 씬 2개·에셋 14개짜리 프로젝트(physics-1029)를 내보낸 뒤 그 파일을 다시 가져와 확인했습니다(1회).

내보내기

프로젝트 전체: .zip

  1. oasisw.ai 대시보드의 프로젝트 목록에서 프로젝트 카드 오른쪽 아래 ⋯를 누릅니다.
  2. 메뉴에서 내보내기 (.zip)를 누릅니다. 같은 메뉴에는 에디터 열기, 참여자, 프로젝트 설정, 복제, 공개로 전환, 소유권 넘기기, 삭제가 있습니다.
  3. 잠시 뒤 화면 아래에 내보냈습니다.가 뜨고 프로젝트 이름.oasisw.zip(실측 physics-1029.oasisw.zip, 약 5.4 MB)이 내려받아집니다.

zip 안에는 다음이 들어 있었습니다.

들어 있는 것빠진 것
프로젝트 이름·설명, 프로젝트 설정 일부(project.json)
모든 씬과 씬 이름(scenes.json)
에셋 목록과 폴더 구조(assets.json)
에셋 원본 파일: 스크립트, 그림, 소리, 글꼴, 물리 엔진 파일(files/)
체크포인트와 브랜치 기록. 가져온 프로젝트는 main 브랜치 하나에 체크포인트가 없었습니다
공개한 빌드

같은 워크스페이스 안에서 사본이 필요할 뿐이면 복제가 빠릅니다. 작성 대기 복제 결과 실측

엔티티 하나: GLB·USDZ

HIERARCHY에서 엔티티를 오른쪽 클릭 → Export As...를 누르면 GLB와 USDZ가 나옵니다. 엔티티의 모양을 다른 3D 프로그램이나 AR 보기에서 쓸 수 있는 모델 파일로 내보냅니다. 스크립트와 물리는 들어가지 않습니다.

항목을 누르면 확인 창 없이 바로 내려받아집니다. 2026-10-30에 기본 씬의 Box를 내보내자 Box.glb(2,416 B)와 Box.usdz(4,027 B)가 받아졌습니다. GLB 안에는 노드 Box, 메시 1개, 머티리얼 Default Material이 들어 있었습니다(1회).

가져오기

  1. 대시보드 오른쪽 위 가져오기를 누릅니다. 프로젝트 가져오기 창이 열립니다.
  2. 위쪽에서 파일에서 가져오기를 고릅니다. 빈 프로젝트를 고르면 새 프로젝트 만들기와 같습니다.
  3. 가져올 파일 칸에 파일을 끌어다 놓거나 파일 고르기를 누릅니다.
  4. 파일을 고르면 칸에 파일 이름과 다른 파일 고르기가 나오고, 아래에 에셋과 씬, 프로젝트 이름을 파일에서 가져옵니다.가 보입니다.
  5. 가져오기를 누릅니다. 올리는 중… 100% 진행 막대가 찬 뒤, 새 프로젝트의 에디터가 열리고 SCENES 창이 뜹니다. 실측에서 5.4 MB 파일이 20초 안에 끝났습니다(1회).

실측에서 가져온 프로젝트는 원래와 같은 이름 physics-1029로 목록에 하나 더 생겼고(프로젝트 수 10 → 11), 공개 범위는 비공개였습니다. 씬 2개와 씬 이름, 엔티티 배치, 에셋 14개가 그대로였고, ▶ Launch에서 물리(떨어지는 상자)와 스크립트(부딪히면 색이 바뀜)도 원래처럼 동작했습니다. 이름이 같아 헷갈리므로 가져온 뒤 프로젝트 이름을 바꿉니다.

창의 설명에 따르면 받는 파일은 두 가지입니다.

파일결과
내보낸 프로젝트(.zip)에셋과 씬을 모두 가져오고, 프로젝트 이름도 파일 안의 것을 씁니다. OasisW에서 내보낸 zip과 같은 엔진 기반의 다른 에디터에서 내보낸 zip을 받습니다
씬 파일(.json)씬 하나를 새 프로젝트로 만듭니다

다른 엔진의 프로젝트

Unity·Unreal·Godot 프로젝트를 그대로 가져오는 기능은 없습니다. 모델은 .glb·.fbx로 내보낸 뒤 파일 올리기로 올리고, 스크립트는 OasisW 형식으로 다시 씁니다(스크립트 개요와 엔진 API).

다음으로

원고 collaboration/import-export.html