콘텐츠로 이동

요구 사항

지원 기준

  • OverAnim 플러그인 버전: 0.1.0 Beta
  • 문서 검증 환경: Unreal Engine 5.8
  • 대상: Skeletal Mesh와 해당 Mesh의 Skeleton

호환성 표기

이 문서는 UE 5.8에서 테스트한 절차를 설명합니다. 다른 엔진 버전이나 프로젝트별 Skeletal Mesh 설정은 별도로 검증하세요.

필수 에셋

첫 에셋을 확인하려면 다음이 필요합니다.

  • Target Skeleton
  • Skeleton과 일치하는 Preview Mesh
  • 선택 사항인 Preview Animation

Preview는 Editor 전용 상태입니다. Validate는 Preview Mesh가 있어야 전체 계약 검증을 실행합니다.

런타임 적용 조건

Apply OverAnim이 성공하려면 다음 조건이 필요합니다.

  1. Over Anim Component가 유효한 Skeletal Mesh를 찾을 수 있어야 합니다.
  2. Deformer Asset의 Target Skeleton과 대상 Mesh Skeleton이 일치해야 합니다.
  3. 에셋 계약 검증이 오류 없이 통과해야 합니다.
  4. 같은 Skeletal Mesh를 다른 UOverAnimComponent가 소유하고 있지 않아야 합니다.

Target Mesh를 비워두면 Component는 Character의 GetMesh()를 우선 사용하고, 없으면 Owner에서 유효한 Skeletal Mesh Component를 찾습니다. 여러 Skeletal Mesh가 있는 Actor는 Target Mesh를 명시하는 편이 안전합니다.

문서 사이트 요구 사항

문서를 수정하거나 로컬에서 보는 경우에는 Python과 PowerShell이 필요합니다.

문서 원본은 OverAnimDocs 저장소에 있습니다. 저장소를 clone한 뒤 저장소 루트에서 다음 스크립트를 실행합니다.

  • install-docs.ps1: requirements.txt의 고정 의존성 설치
  • serve-docs.ps1: 로컬 개발 서버 실행
  • build-docs.ps1: strict 정적 사이트 빌드

빌드 결과는 저장소의 site/에 생성되며 플러그인 내부에 오프라인 문서를 만들지 않습니다. 배포된 문서는 OverAnim Documentation에서 확인할 수 있습니다.