HELP
Development FAQ

I get a 9999 error when uploading .zepetopackage file in Zepeto Studio.

6min

If you get a 9999 error in ZEPETO Studio when uploading the .zepetopackage file generated after building your World, try the following three methods.

Error screen example
Error screen example


Case 1. When required modules are not installed during Unity installation

Go to Unity Hub > Installs > 2022.3.34f1 > Add Modules and check if all the required modules are installed.

Document image


The required modules are the following:

  • Android Build Support
  • iOS Build Support
  • Mac Build Support (Mono) - Install if your PC is running on Windows.
  • Windows Build Support (Mono) - Install if your PC is running on Mac.



Mac

Document image


Windows

Document image


Also, click the login menu next to the 'Publish' button and make sure that 'Target Platforms' is set to 'All'.

Document image


If all required modules are installed, click the Publish button to rebuild your world.

Once the build is complete, open the project folder > Build > ZEPETO.Script folder to verify that all platform files have been generated.

The required platform files are:

  • android
  • ios
  • osx
  • windows
Document image


Upload the generated .zepetopackage file to ZEPETO Studio.

For more details, please refer to the guide below:



Case 2. Windows Users – File or Folder Names Are Too Long

In Windows environments, the length of the path name can affect package builds.

If there are files or folders with excessively long names within the Assets folder, a 9999 error may occur when uploading to ZEPETO Studio.

Ensure that file names do not contain spaces or special characters.

Rename files to concise names like “abc.jpg” and rebuild the project.

Even if the folder names are automatically generated from the Unity Asset Store, please rename them to shorter names.



Case 3. You get a 9999 error even after installing the required modules

If you get a 9999 error even though you have installed all the required modules, try the following method.

1

Delete the Build folder in the project folder.

Document image

2

Update the ZEPETO.World package.

(1) Open Window > Package Manager in Unity and select My Registries or In Project in Packages

(2) Select ZEPETO.World from the package list, and then click the Version History tab.

(3) Update to the latest version.

Document image

3

Press the Publish button to rebuild the project.

4

When the build is complete, open the project folder > Build > ZEPETO.Script folder to verify that each platform file has been created.

The required platform files are as follows.

  • android
  • ios
  • osx
  • windows
Document image

5

Upload the generated .zepetopackage file to ZEPETO Studio.