Godot 4에 애니메이션 가져오기

패키지 구성

godot_pack을 내보내면 이름 있는 루트 폴더에 spritesheet.png, animation.tres, animation.tscn, animgen-manifest.json, README가 제공됩니다.

.tres는 AtlasTexture 사각형으로 구성한 Godot 4 SpriteFrames입니다. .tscn에는 이 리소스를 사용하는 AnimatedSprite2D, 자동 재생, 피벗 관련 오프셋이 있습니다. Godot 3 AnimatedSprite 리소스가 아닙니다.

루트 경로 유지

압축을 풀고 이름 있는 루트 폴더를 Godot 프로젝트 루트에 복사하세요. README에 필요한 res://<exported-folder>/ 경로가 있습니다.

생성 파일의 리소스 경로는 그 폴더 이름을 사용합니다. 참조를 갱신하지 않고 animation.tres만 옮기거나 폴더 이름을 바꾸거나 다른 폴더 아래에 넣으면 텍스처·리소스가 누락될 수 있습니다.

Godot의 PNG 가져오기를 기다린 뒤 animation.tscn을 열거나 작은 테스트 장면에 인스턴스화하세요.

제공된 장면 또는 기존 노드 선택

가장 간단하게는 제공 장면을 사용하세요. 기존 AnimatedSprite2D에는 Sprite Frames에 animation.tres를 할당하고 내보낸 애니메이션을 선택해 재생을 설정하세요.

Godot의 2D 스프라이트 애니메이션 가이드는 AnimatedSprite2D, SpriteFrames, 재생, FPS를 설명합니다. AnimGen 리소스에는 프레임, 루프, 속도가 이미 있으므로 PNG를 다시 자를 필요가 없습니다.

SpriteFrames 할당만으로 생성 장면의 오프셋이 복사되지는 않습니다. 중앙이 아닌 피벗을 유지하려면 장면 오프셋도 옮기거나 기존 노드의 원점을 대응되게 설정하세요.

타이밍 및 정렬 검증

프레임 수·FPS를 animgen-manifest.json과 비교하세요. 부모 변환이나 프로젝트 스크립트가 재생 속도·위치를 바꾸지 않는지 확인하세요. 전체 루프를 재생하고 고정 선에 대해 지면 자세를 비교하세요.

아무것도 보이지 않으면 리소스 누락 메시지, 텍스처 가져오기, 선택 애니메이션, 가시성, 장면 배치를 먼저 확인하세요. 프레임이 틀리면 서로 다른 내보내기의 텍스처와 .tres를 섞지 않았는지 보세요.

스튜디오와 가장자리가 다르면 같은 PNG를 기준으로 필터·렌더링 설정을 확인하세요. 투명 형식을 참고하세요.

안전한 재사용

가능하면 패키지의 이름·경로를 유지하세요. 재정리하면 animation.tres의 텍스처 경로와 animation.tscn의 리소스 경로를 함께 바꾼 뒤 다시 열어 테스트하세요.

패키지 생성 테스트 통과가 Godot 프로젝트 런타임 검증은 아닙니다. 게임 로직 통합이나 대상 기기 빌드 전에 작은 프로젝트로 가져오기를 완료하세요.

실측 예제 재현

Godot 4 가져오기 실측 가이드는 실제 Godot 4.7.2 가져오기·재생 검사를 기록합니다. 공개 패키지, 최소 프로젝트, 실행 캡처, 테스트 한계를 제공합니다. 예제로 활용하되 자신의 내보내기와 대상 환경에서 다시 검증하세요.