Planet Asset과 식별자
UPlanetXPlanetAsset은 행성의 물리·좌표·Section·Level Pair·Proxy Bake·생성 비주얼·환경 제작 상태를 연결하는 Primary Data Asset입니다.
#세 가지 핵심 ID
| ID | 역할 | 선택 규칙 |
|---|---|---|
| Planet ID | 행성 계약의 프로젝트 전역 식별자 | Planet Asset 사이에서 고유 |
| Planet Binding ID | 동일 Planet ID를 가진 런타임 인스턴스 구분 | 여러 Planet Actor가 있을 때 명시 |
| Section ID | 행성 표면의 제작·조회 구역 | Asset 안에서 비어 있지 않고 고유 |
Level Pair ID는 Section과 Orbit/Ground/Runtime Preview World 묶음을 찾는 키입니다. Journey ID와 Capture ID는 Travel 한 번의 수명 주기를 식별합니다.
#Asset이 소유하는 계약
Planet Asset에는 Radius, Coordinate Convention, Sections, Level Pairs, Completion/Padding 설정, Environment 설정, Surface Preset, Proxy Bake 링크와 revision 상태가 들어 있습니다. 생성된 Payload나 Material은 Asset이 직접 제작하지 않고 Editor workflow가 게시하고 링크합니다.
IsProxyBakeStale, IsVisualBuildStale, IsVisualPreviewStale은 현재 authoring revision과 마지막 성공 결과를 비교합니다. stale 결과는 자동 삭제 신호가 아니라 재검증·재생성이 필요하다는 신호입니다.
#여러 World와 여러 인스턴스
같은 Planet Asset이 Orbit World와 Ground World에 사용될 수 있습니다. 동일 Planet ID의 Planet Actor가 한 World에 여러 개면 자동 선택은 모호해질 수 있으므로 API의 AdvancedDisplay에 있는 Planet Binding ID를 전달하세요.
#변경 원칙
ID 변경은 저장 좌표, Level Pair, Bake 링크, Travel route에 영향을 줍니다. 표시 이름 변경과 달리 migration으로 취급하고 Full Validate와 재 Bake를 수행하세요.