---
title: 업데이트 노트
slug: world-sdk-guide-kr/hhjysqnag37erckzvbu1s
docTags: 
createdAt: 2024-09-02T08:34:13.134Z
---

:::hint{type="info"}
**📘 **다음 가이드를 참조하십시오. **[패키지 업데이트 중](#)** 
:::

#

# 2026년 3월

## ZEPETO World 1.22.18

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 4.19.000 이상            | 2026-03-25 |

- `Added` : 변신 아이템이 월드에서 동작하도록 기능 추가.
- `Fixed` : PC월드 내부 시스템 버그 수정.

#

# 2025년 12월

## ZEPETO World 1.22.17

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 4.1.000 이상             | 2025-12-17 |

- `Fixed` : 내부 시스템 개선.

#

# 2025년 6월

## ZEPETO World 1.22.16

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 4.1.000 이상             | 2025-06-09 |

- `Updated` : 제페토 월드 PC버전 플랫폼 호환성 개선.

#

# 2025년 5월

## ZEPETO World 1.22.15

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 4.0.000 이상             | 2025-05-21 |

- `Fixed` : Internal system improvement.

#

# 2025년 3월

## ZEPETO World 1.22.14

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.75.0 이상              | 2025-03-20 |

- `Fixed` : 유니티 에디터에서 ProductService.OnPurchaseCompleted 및 ProductService.OnPurchaseFailed 이벤트 핸들링 호출 타이밍 수정

## ZEPETO World 1.22.13

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.74.0 이상              | 2025-03-07 |

- `Fixed` : 빌드잇 유니티 플러그인의 Reward Chest 오브젝트가 낮은 제페토 앱 버전에서 보여지는 버그 수정
- `Fixed` : 간헐적으로 리더보드 로그인이 안되던 버그 수정 
- `Fixed` : 유니티 에디터에서 Publish 했을 때, 제페토 스튜디오로 바로 제페토 패키지 파일 업로드가 불가능하던 오류 수정

# 2025년 2월

## ZEPETO World 1.22.12

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.73.0 이상              | 2025-02-21 |

- `Fixed` : 특정 아이템을 착용했을 때 ZEPETO 카메라가 수평이 맞지 않는 문제를 수정했습니다.

## ZEPETO World 1.22.11

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.72.0 이상              | 2025-02-07 |

- `Fixed` : 내부 시스템 개선.

#

# 2025년 1월

## ZEPETO World 1.22.10

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.65.0 이상              | 2025-01-20 |

- `Fixed` : 내부 시스템 개선.

## ZEPETO World 1.22.09

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.65.0 이상              | 2025-01-13 |

- `Fixed` : 내부 시스템 개선.

#

# 2024년 11월

## ZEPETO World 1.22.6

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.64.0 이상              | 2024-11-14 |

- `Fixed` : QR 코드 로그인이 작동하지 않는 문제를 해결했습니다.

## ZEPETO World 1.22.5

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.64.0 이상              | 2024-11-04 |

- `Fixed` : 내부 시스템 개선.

# 2024년 9월

## ZEPETO World 1.22.4

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.63.0 이상              | 2024-09-27 |

- `Fixed` : 내부 시스템 개선.

## ZEPETO World 1.22.3

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.62.0 이상              | 2024-09-05 |

- `Fixed` : Unity 2022에서 Inspector에 값을 추가하려고 할 때 InvalidCastException 오류가 발생하는 문제를 수정했습니다.
- `Fixed` : Unity 2022에서 GetProductsAsync() OnFailed Warning이 발생하는 문제를 수정했습니다.

# 2024년 8월

## ZEPETO 월드 1.22.2

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.59.0 이상              | 2024-08-09 |

- `수정됨` : Unity 2022 문제 수정
  - TypeScript로 만든 클래스와 함께 AddComponent를 사용할 때 "Component 유형에서 필수" 오류가 발생하는 문제를 수정했습니다.
  - 멀티플레이어 서버 스크립트와 스키마가 초기화되는 문제를 수정했습니다.

# 2024년 7월

## ZEPETO 월드 1.22.1

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.59.0 이상              | 2024-07-24 |

- `업데이트됨` : Unity 지원을 버전으로 업그레이드** 2022.3.34f1**
  - 버전 3.59.000부터 ZEPETO 앱은 공식적으로 Unity 2022를 지원합니다. 따라서 ZEPETO World 개발도 Unity 2022를 지원합니다.
    - 현재 버전: 2020.3.9f
    - 업데이트된 버전: 2022.3.34f1

:::hint{type="danger"}
❗️ **중요 공지사항**

- World SDK 버전 1.22.00부터 개발은 Unity 버전 2022.3.34를 사용하여 진행해야 합니다.
- 따라서 공식적으로 지원되는 최소 버전은 Unity 2022.3.34 및 ZEPETO World 1.22.1입니다.
- 권장 버전을 사용하지 않으면 ZEPETO 앱 내에서 World가 제대로 작동하지 않을 수 있습니다.
:::

:::hint{type="info"}
**📘 **다음 문서를 참조하십시오

- **[Unity 2022로 업그레이드하는 방법](#)** 
- **[Unity 2022 버전 업그레이드 후 문제 해결](#)** 
:::

## ZEPETO.Buildit.Loader

- `전용`: Buildit.Loader 패키지의 사용이 중단되었습니다.

:::hint{type="danger"}
❗️ **중요 공지사항**

- Buildit로 생성된 맵을 Unity 프로젝트로 전송할 수 없습니다.
- Unity 프로젝트에서 **[ZEPETO 자산 패키지 사용](#)** 을 사용하여 새로운 맵을 생성해 주세요.
- 우리는 계속해서 **[ZEPETO 월드 메이드 이지: 모두를 위한 초보자 가이드 튜토리얼!](#)** Unity에서 맵을 편리하게 생성할 수 있도록 도와드리겠습니다.
:::

# 2024년 6월

## ZEPETO 월드 1.21.22

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.56.0 이상              | 2024-06-11 |

- `추가됨` : 마네킹 API - 모든 항목이 완전히 로드된 후 호출되는 콜백을 추가했습니다. **[ZEPETO Mannequin](#)** 
- `수정됨` : ZEPETO Studio에 등록된 제품이 Unity Editor에 실시간으로 반영되지 않는 문제를 개선했습니다.

# 2024년 5월

## ZEPETO 월드 1.21.21, ZEPETO 모듈 1.0.11

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.53.0 이상              | 2024-05-03 |

- `추가됨` : 방 멤버 목록 화면에서 다음 상태가 변경될 때 알림을 받을 수 있는 콜백을 추가했습니다. **[방 멤버 목록 화면에서 팔로잉 상태 콜백 가져오기](#)** 

# 2024년 3월

## ZEPETO 월드 1.21.20

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.51.0 이상              | 2024-03-26 |

- `수정됨` : 내부 시스템 개선.

## ZEPETO 월드 1.21.19

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.50.0 이상              | 2024-03-19 |

- `수정됨` : V-pad가 특정 방향으로 고정되는 문제를 수정했습니다.

## ZEPETO 월드 1.21.18

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.49.0 이상              | 2024-03-04 |

- `수정됨` : 내부 시스템 개선.

## ZEPETO 월드 1.21.17

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.49.0 이상              | 2024-03-04 |

- `수정됨` : 내부 시스템 개선.

# 2024년 2월

## ZEPETO 월드 1.21.16

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.48.0 이상              | 2024-02-23 |

- `수정됨` : CLI 빌드를 Zepeto Studio에 업로드할 수 없는 문제를 수정했습니다.
  - CLI 명령이 수정되었습니다. 다음 가이드를 참조하십시오.**[CLI로 패키지 빌드하기](#)** 

## ZEPETO 모듈 1.0.9

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.48.0 이상              | 2024-02-23 |

- `수정됨` : `FollowScrollView` 프리팹의 로딩 속도가 개선되었습니다.
- `수정됨` : 언팔로우 기능이 작동하지 않는 문제를 수정했습니다.`FollowScrollView` 프리팹.
- `수정됨` : "불변 폴더에 프리팹을 저장할 수 없습니다"라는 오류가 발생하는 문제를 수정했습니다.`FollowScrollView` 프리팹이 적용되었습니다.

## ZEPETO 월드 1.21.15

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.47.0 이상              | 2024-02-08 |

- `수정됨` : 동일한 UserID를 가진 플레이어가 존재할 경우 ZepetoCharacterCreator로 캐릭터를 생성할 수 없는 문제를 수정했습니다.

## ZEPETO 모듈 1.0.8

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.47.0 이상              | 2024-02-08 |

- `업데이트됨` : ZEPETO.Mannequin 패키지가 ZEPETO.Module 패키지로 이동되었습니다.
  - 이전에 ZEPETO.Mannequin 패키지를 별도로 설치한 경우, 삭제하고 ZEPETO.Module 패키지를 업데이트하는 것이 충돌을 피하기 위해 강력히 권장됩니다.

## ZEPETO 마네킹

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.47.0 이상              | 2024-02-08 |

- `이전 위치` : 성능 개선의 일환으로, 독립형 패키지가 ZEPETO.Module 1.0.8 및 이후 버전 패키지에 통합되었습니다.
  - 이전에 설치된 ZEPETO.Mannequin 패키지를 삭제해 주십시오.
  - 기존 패키지를 제거한 후, ZEPETO.Module 패키지 버전 1.0.8 이상을 설치해 주십시오. **[ZEPETO Mannequin](#)** 

:::hint{type="danger"}
* 일부 OpenAPI는 더 나은 사용 방법을 제공하기 위해 일시적으로 사용 중단될 것입니다.
  사용 시 이를 고려해 주십시오.
  - "월드 콘텐츠 목록" 및 "선물 주기" 기능은 영향을 받지 않습니다.
:::

# 2024년 1월

## ZEPETO 월드 1.21.14

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.46.0 이상              | 2024-01-24 |

- `업데이트됨` : 편집기 로그인 UI 프로세스가 프로젝트 설정 > ZEPETO 서비스로 이동했습니다. **[설치 및 설정](#)** 
- `업데이트됨`: 프로세스가 `프로젝트 설정 > ZEPETO 서비스`, 따라서 `월드 ID` 입력 필드가 월드 설정 UI에서 제거되었습니다.
  - 월드 링크가 설정되지 않으면, 패키지 파일을 게시한 후 월드 업로드가 실패합니다.

:::hint{type="danger"}
* 월드 SDK 버전 1.21.14가 이제부터 ZEPETO 스튜디오에서 지원하는 최소 버전이 됩니다.
* 월드 SDK 1.21.14보다 낮은 버전으로 개발된 패키지 파일은 결국 ZEPETO 스튜디오에 업로드할 수 없게 되므로, 월드 제작자라면 이 점을 유의하시기 바랍니다.
  - 이행은 몇 달 내에 이루어질 것으로 예상됩니다.
:::

## ZEPETO 모듈 1.0.7

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.46.0 이상              | 2024-01-24 |

- `수정됨` : 의 유형이 변경되었습니다 `ErrorCode`, 의 속성 `ProductBaseResponse`. \[**[관련 링크](https://developer.zepeto.me/docs/product/classes/ZEPETO_Product.ProductBaseResponse)**]
- `수정됨`: 다음을 호출한 후 `responseData.isExist` 값이 항상 false로 반환되는 문제를 수정했습니다 `InventoryService.HasAsync`.

## ZEPETO 월드 1.21.13

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.45.0 이상              | 2024-01-10 |

- `업데이트됨` : 편집기에서 ZEPETO 계정으로 로그인할 때, 닉네임 필드가 비어 있으면 UserId가 표시됩니다.

## ZEPETO 스크립트.리더보드 1.1.11

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.45.0 이상              | 2024-01-10 |

- `수정됨` : 리더보드에서 100개 이상의 순위 데이터를 호출할 때 사용자 닉네임이 Null로 나타나는 문제를 수정했습니다.
- `수정됨` : `순위` 및 `구성원` 필드가 RankInfo에서 제거되었습니다.
  - 이 필드를 사용하고 있었다면, 리더보드 패키지를 업데이트한 후 잠재적인 컴파일 오류에 유의하시기 바랍니다.

## ZEPETO 모듈 1.0.6

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.45.0 이상              | 2024-01-10 |

- `업데이트됨` : 에디터 초기화/재컴파일 과정에서 불필요한 시간 소모가 개선되었습니다.
- `업데이트됨` : ZEPETO.World.Gui 및 ZEPETO.Product 패키지가 ZEPETO.Module 패키지에 포함되도록 이동되었습니다.

:::hint{type="danger"}
* 이 두 패키지를 별도로 설치한 적이 있다면 충돌이 발생할 수 있으므로 기존의 `ZEPETO.World.Gui` 및 `ZEPETO.Product` 패키지를 삭제한 후 ZEPETO.Module 패키지를 업데이트하십시오.
:::

## ZEPETO 월드. GUI

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.45.0 이상              | 2024-01-10 |

- `이전됨` : 성능 개선 노력의 일환으로, 독립 패키지에서 ZEPETO.Module 패키지 버전 1.0.6 이상에 포함되도록 이동되었습니다.
  - 이전에 설치된 ZEPETO.World.Gui 패키지를 삭제하십시오.
  - ZEPETO.Module 패키지의 버전 1.0.6 이상을 설치하십시오.

## ZEPETO 제품

| **호환 가능한 ZEPETO 앱 버전** | **출시 날짜**  |
| ---------------------- | ---------- |
| 3.45.0 이상              | 2024-01-10 |

- `이전됨` : 성능 개선 노력의 일환으로, 독립 패키지에서 ZEPETO.Module 패키지 버전 1.0.6 이상에 포함되도록 이동되었습니다.
  - 이전에 설치된 ZEPETO.Product 패키지를 삭제하십시오.
  - ZEPETO.Module 패키지의 버전 1.0.6 이상을 설치하십시오.