The World developed in Unity can be tested in the ZEPETO app (mobile) through a QR code.
Please refer to the following guide. [QR mobile test]
If the QR test is unstable, please try to solve the issue according to the following types.
The QR code has been recognized, but the error message appears.

- Error Accessing ZEPETO world. please try again
- Failed to get world metadata
Please check your network settings if the World does not run with the above message after the QR code recognition.
On PC
- You must not be connected to a VPN service.
- Deactivate all firewall settings.
- (When using Wi-Fi on Windows PC) Go to Network & Internet > Ethernet and select 'Private network.'
- (When using Wi-Fi on Windows PC) Go to Network & Internet > Advanced network settings and disable all adapters except Wi-Fi.
On Mobile
- Connect to the same network as your PC.
- (iOS devices) Grant permission to access the ZEPETO app's local network.
The modifications in the World will not be reflected in the ZEPETO app.
If you execute the World on the ZEPETO app but discover that your development modifications have not been reflected, please check the following.
- The Scene you worked on must be in the File > Build Settings > Scenes In Build list and ticked.
- Your ZEPETO app must be the latest version.
The generated QR code image is corrupted.
Go to Edit > Project Settings > Quality > Rendering > Texture Quality and change the setting to "Full Res."
"Could not resolve host" error appears while running the build.
SocketException: Could not resolve host {PC Name}.
If the above error message appears while running the build for the QR test on a macOS PC, please try the following method.
- Execute the terminal
- Copy and paste the below command.
- Change the
{PC Name}
to the PC name of the error message (e.g.,My-Computer.local
). - If a password is required, enter the password of the macOS account.
- Change the
sudo -- sh -c "echo '127.0.0.1 {PC Name}' >> /private/etc/hosts" && sudo dscacheutil -flushcache