---
title: 제페토 스튜디오에 .zepetopackage 파일 업로드 시 9999 에러가 발생합니다
slug: world-sdk-guide-kr/zepetopackage-9999
docTags: 
createdAt: 2025-01-20T05:37:40.742Z
---

월드 제작 완료 후, 빌드 결과물인 .zepetopackage 파일을 제페토 스튜디오에 업로드 할 때 아래와 같이 9999 에러가 발생한다면 아래 세 가지 방법으로 해결해 보세요.

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/XWh4zf28K8FyvlKDHtLk1_image.png "오류 화면 예시")

## Case 1. 유니티 설치시 필수 모듈 설치를 누락한 경우

**Unity Hub > Installs > 2022.3.34f1 > Add Modules**에서 필요한 모듈이 모두 설치되어 있는지 확인해주세요.

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/3eOCDYvRhZz_Yyz3Bn69n_image.png)

필수 모듈은 다음과 같습니다.

- Android Build Support
- iOS Build Support
- Mac Build Support (Mono) - Windows를 사용 중인 경우에만 설치
- Windows Build Support (Mono) - Mac을 사용 중인 경우에만 설치



**Mac**

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/mBI8Vz48s4OFOdhCqF5Cf_image.png)

**Windows**

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/q9dJzc1Q4ZwuxX8ubMJCn_image.png)

또한 Publish 버튼 옆 로그인 메뉴에 있는 Target Platforms 항목이 'All'로 설정되어 있는지 확인해주세요.


![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/bR-5NddfXq8mWAqy-gxn7_image.png)

필수 모듈을 모두 설치했다면, Publish 버튼을 눌러 월드를 다시 빌드해 보세요.&#x20;

빌드가 완료되면 **프로젝트 폴더 > Build > ZEPETO.Script&#x20;**&#xD3F4;더를 열어 각 플랫폼 파일이 모두 생성되었는지 확인합니다.&#x20;

필요한 플랫폼 파일은 다음과 같습니다.

- android
- ios
- osx
- windows

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/xWzWMOa3H4-hMybsFyFgE_group-21.png)

생성된 .zepetopackage 파일을 제페토 스튜디오에 업로드합니다.

자세한 내용은 아래 가이드를 참고해주세요.

- [월드 개발 시작하기](docId:5D92yBP4JSvcrl-TDMJkF)&#x20;
- [월드 설정하고 출시하기](docId\:SdkHXi65WRhL8y62XikIo)&#x20;



## Case 2. 윈도우 사용자 - 파일 또는 폴더 이름이 지나치게 긴 경우

Windows 환경에서는 패키지 빌드를 할 때 경로명의 길이에 영향을 받습니다.&#x20;

Assets 폴더 내에 **이름이 너무 긴 파일 또는 폴더**가 포함된 상태에서 빌드를 하면, 스튜디오에 올릴 때 9999 에러가 발생할 수 있습니다.

특히 이름 내에 공백이나 특수문자가 포함되어 있지 않도록 주의해 주세요.

파일 이름을 "abc.jpg" 등으로 간결하게 수정한 후 프로젝트를 다시 빌드해 주세요.

유니티 에셋 스토어에서 받아서 자동으로 생성된 폴더 이름이라도 해도, 폴더 이름을 직접 rename하여 간결하게 수정해 주세요.&#x20;



## Case 3 . 필수 모듈 설치 후에도 9999 에러가 발생할 경우

필수 모듈을 모두 설치했음에도 9999 에러가 발생한다면, 다음 방법을 시도해 보세요.

::::WorkflowBlock
:::WorkflowBlockItem
프로젝트 폴더에 있는 **Build** 폴더를 삭제합니다.

::Image[]{src="https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/-k2K6bZHY6SD_AbaN7jfo_group-18.png" size="52" width="1292" height="1656" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
ZEPETO.World 패키지를 업데이트합니다.

(1) 유니티에서 **Window > Package Manager**를 열고, **Packages**에서 **My Registries** 또는 **In Project**를 선택합니다. 

(2) 패키지 목록에서 ZEPETO.World를 선택한 후, **Version History** 탭을 클릭합니다.

(3) 최신 버전으로 업데이트 합니다.

![](https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/HH0HQUKu123a530rCkBcs_group-19-1.png)
:::

:::WorkflowBlockItem
**Publish** 버튼을 눌러 프로젝트를 다시 빌드합니다.
:::

:::WorkflowBlockItem
빌드가 완료되면 **프로젝트 폴더 > Build > ZEPETO.Script** 폴더를 열어 각 플랫폼 파일이 모두 생성되었는지 확인합니다. 

필요한 플랫폼 파일은 다음과 같습니다.

- android
- ios
- osx
- windows

::Image[]{src="https://api.archbee.com/api/optimize/xv-TGeWVTX2GDZMFGOf1Y/xWzWMOa3H4-hMybsFyFgE_group-21.png" size="70" width="1853" height="1003" position="center" showCaption="false"}
:::

:::WorkflowBlockItem
생성된 .zepetopackage 파일을 제페토 스튜디오에 업로드합니다.
:::
::::

