문제 해결

문제와 가장 비슷한 증상부터 확인하세요. 뒤따르는 경고보다 첫 CAT 관련 오류를 먼저 확인합니다.

설치 문제

에디터에 CAT가 표시되지 않음

• 플러그인이 <Project>/Plugins/CAT 또는 엔진 플러그인 디렉터리에 있는지 확인합니다.
• 프로젝트가 Unreal Engine 5.7로 실행되는지 확인합니다.
• Edit > Plugins에서 Customizable Assembly Toolkit을 활성화합니다.
• 플러그인을 활성화하거나 컴파일한 뒤 Unreal Editor를 다시 시작합니다.

프로젝트 컴파일 실패

• 엔진 버전이 플러그인 지원 버전과 일치하는지 확인합니다.
• 플러그인을 추가한 뒤 프로젝트를 다시 빌드합니다.
• 빌드 로그의 첫 CAT 관련 컴파일 오류를 확인합니다. 이후 오류는 첫 오류로 인해 발생하는 경우가 많습니다.

Assembly가 초기화되지 않음

• Source Asset이 지정되었는지 확인합니다.
• 지정된 오브젝트가 유효한 CAT Part Model 또는 Assembly 소스 에셋인지 확인합니다.
• 소스 에셋을 열고 검증 오류를 해결합니다.
• 네트워크 프로젝트에서는 서버에서 먼저 테스트합니다.
• 플레이 시작 후 Output Log의 CAT 메시지를 확인합니다.

물리가 시작되지 않음

• Enter Simulation 호출 전에 초기화가 성공했는지 확인합니다.
• CAT Assembly Actor의 Auto Enter Simulation을 확인합니다.
• Part Model에 유효한 메시, 콜리전, 바디, 질량 설정이 있는지 확인합니다.
• Assembly 검증 패널에서 잘못된 커넥터나 액추에이터 참조를 확인합니다.

Grab이 대상을 찾지 못함

• 플레이어가 활성 CAT Grab Component를 소유하는지 확인합니다.
• 대상 Assembly가 Grab을 허용하고 Grabbable Component를 가지는지 확인합니다.
• 트레이스 거리, 콜리전 채널, 시선 방향을 확인합니다.
• 활성 Control Session이 상호작용을 막고 있지 않은지 확인합니다.

커넥터가 스냅되지 않음

• 잡은 Part와 대상에 점유되지 않은 커넥터가 있는지 확인합니다.
• 커넥터 거리와 각도 허용치를 확인합니다.
• Part Model Editor에서 커넥터 프레임과 정렬 모드를 확인합니다.
• 놓기 전에 배치 고스트의 유효 상태를 확인합니다.

Controller 입력이 동작하지 않음

• Control Station이 의도한 Controller 클래스를 선택하는지 확인합니다.
• 필요한 각 Controller 입력 슬롯에 Input Action을 지정합니다.
• Input Action 값 타입을 슬롯 타입과 일치시킵니다.
• Controller 출력에는 일반 Event Tick이 아니라 On Controller Update를 사용합니다.
• 구조 변경 후 액추에이터 핸들을 다시 가져옵니다.

부력이 동작하지 않음

• Unreal Engine Water 플러그인을 활성화합니다.
• 테스트 레벨에 유효한 Water Body가 있는지 확인합니다.
• 어셈블리가 초기화되고 시뮬레이션에 진입했는지 확인합니다.

클라이언트가 갱신을 받지 못함

• 구조 변경은 클라이언트가 아니라 서버에서 수행합니다.
• 액터가 대상 클라이언트에 복제되는지 확인합니다.
• 서버에서 어셈블리를 만든 뒤 새 클라이언트 연결로 테스트합니다.
• 클라이언트 명령은 플레이어 소유 Assembly Interactor Component를 통해 제출합니다.
• 초기 연결과 중도 참가를 각각 테스트합니다.

문제 보고

지원 요청에 다음 정보를 포함하세요.

• CAT 버전과 Unreal Engine 버전
• standalone, listen server, dedicated server 중 문제가 발생하는 환경
• 재현 절차
• Output Log 메시지와 필요한 경우 스크린샷 또는 짧은 영상
• 영향을 받는 Part Model 또는 Assembly 검증 결과