유니티 에셋/Magica Cloth 2

설치 방법

스크립팅하는애님 2025. 2. 28. 23:57

설치 방법

MagicaCloth2를 실행하려면 Unity 2021.3.16(LTS) 이상 버전이 필요합니다.
에셋을 구매한 후 패키지 매니저에서 설치할 수 있습니다.

  1. Unity 에디터 메뉴에서 Window > Package Manager를 엽니다.
  2. My Assets에서 MagicaCloth2를 선택한 후 Import를 클릭합니다.

 

MagicaCloth2의 실행을 위해 Burst 및 Collections 패키지가 필요하지만, MagicaCloth를 가져오면 자동으로 설치됩니다.
따라서 Ver.1과 달리 패키지를 수동으로 설치할 필요가 없습니다.

설치 중 아래와 같은 대화 상자가 나타나면, 설치 완료 후 Unity 에디터를 한 번 재시작하세요.

 

 

 

샘플 실행 테스트

임포트가 완료된 후, 정상적으로 작동하는지 확인해 봅니다.
DemoScene 폴더에서 UnityChanKAGURA_??? 씬을 불러옵니다.

 

샘플은 렌더 파이프라인별로 구분되어 있으므로, 현재 사용 중인 렌더 파이프라인(CoreRP/URP/HDRP)의 폴더에서 선택하세요.
각 렌더 파이프라인별로 씬이 나뉘어 있는 이유는 렌더 셰이더를 전환하기 위함이며, MagicaCloth의 동작과는 무관합니다.

 

씬을 실행한 후 캐릭터의 소매, 머리카락, 치마 등이 물리적으로 흔들린다면 설치가 완료된 것입니다.

 

 

 

 

샘플 폴더 삭제 가능

에셋에 포함된 "Example (Can be deleted)" 폴더는 삭제할 수 있습니다.
샘플이 필요하지 않다면 해당 폴더를 삭제해도 무방합니다.

 

 

 

 

업데이트 방법

MagicaCloth는 정기적으로 업데이트됩니다.
대부분의 경우, 최신 버전을 덮어쓰기하여 가져오면 정상적으로 동작합니다.
그러나 파일 구조 등의 변경이 있는 경우, 기존 파일과 새로운 파일이 중복되어 오류가 발생할 수 있습니다.
따라서 가능하면 다음 단계를 따라 깨끗한 설치(Clean Install) 를 진행하는 것이 좋습니다.

  1. 프로젝트를 완전히 백업합니다.
  2. Unity 에디터에서 MagicaCloth2 폴더를 삭제합니다.
  3. Package Manager에서 최신 MagicaCloth2를 가져옵니다.

 

 

 

오류 발생 시 해결 방법

위의 단계를 따라 가져오거나 업데이트했음에도 오류가 발생하는 경우, 필요한 패키지가 설치되지 않았거나 버전이 오래되었을 수 있습니다.
먼저, 메뉴에서 Window > Package Manager를 열고 In Project를 선택하여 설치된 패키지 목록을 확인하세요.

 

MagicaCloth를 실행하려면 Burst 1.8.1 이상 및 Collections 1.4.0 이상이 필요합니다.
패키지 목록에 Burst와 Collections가 있는지 확인하고, 버전이 올바른지 점검하세요.

만약 패키지가 없거나 오래된 버전이라면, 다음 단계에 따라 수동으로 설치해야 합니다.

 

  1. Package Manager 상단 왼쪽의 + 버튼을 누르고 [Add package from git URL..]을 선택합니다.
  2. Burst를 설치하려면 "com.unity.burst" 를 입력하고 실행합니다.
  3. Collections를 설치하려면 "com.unity.collections" 를 입력하고 실행합니다.
  4. 이를 통해 최신 버전의 Burst 및 Collections가 설치됩니다.

오류가 계속될 경우, 지원팀에 문의하세요.
이때, 콘솔에 처음 나타나는 오류 메시지를 상세히 포함해 주시면 문제 해결에 도움이 됩니다.

 

 

 

제거 방법

MagicaCloth가 더 이상 필요하지 않은 경우, 다음 단계에 따라 제거할 수 있습니다.

  1. MagicaCloth2 폴더를 삭제합니다.
  2. Package Manager에서 Burst를 제거합니다.
  3. Package Manager에서 Collections를 제거합니다.
  4. Package Manager에서 Mathematics를 제거합니다.

패키지를 삭제할 때는 프로젝트 내 다른 에셋에서 해당 패키지를 사용하고 있을 가능성이 있으므로 주의하세요.

 

 

 

 

 

버전 확인 방법

현재 사용 중인 MagicaCloth 버전은 Tools > MagicaCloth2 > About… 메뉴에서 확인할 수 있습니다.

 

 

 

 

 

Define Symbol

MagicaCloth를 설치하면 MAGICACLOTH2 정의가 프로젝트에 자동으로 추가됩니다.
(버전 2.3.1 이상)