Entity System (엔티티 시스템)

// 적 스폰 (EnemySpawner) int id = EntitySerialId.Next(); entityComponent.ShowEntity( id, typeof(Enemy), // 붙일 로직 "Zombunny", // Addressables 주소 "Enemy", // 엔티티 그룹 EnemyData.Create(id, 1, stats, position)); // OnShow 의 userData 로 도착한다

GameEntry.GetComponent<EntityComponent>().AddEntityGroup( "Player", // 그룹 이름 10f, // 인스턴스 자동 해제 주기 16, // 인스턴스 용량 60f, // 인스턴스 만료 시간 0 // 인스턴스 우선순위 );

// 기본 엔티티 생성 GameEntry.GetComponent<EntityComponent>().ShowEntity<PlayerEntity>( 1, // 엔티티 ID "Girl", // Addressables 주소 "Player" // 엔티티 그룹 이름 ); // 우선순위 및 사용자 데이터 포함 GameEntry.GetComponent<EntityComponent>().ShowEntity<PlayerEntity>( 1, "Girl", "Player", 100, userData );

// ID로 숨기기 GameEntry.GetComponent<EntityComponent>().HideEntity(1); // 참조로 숨기기 Entity entity = GameEntry.GetComponent<EntityComponent>().GetEntity(1); GameEntry.GetComponent<EntityComponent>().HideEntity(entity);

// 기본 연결 GameEntry.GetComponent<EntityComponent>().AttachEntity(childEntityId, parentEntityId); // 특정 부모 Transform 경로 지정 GameEntry.GetComponent<EntityComponent>().AttachEntity(childEntityId, parentEntityId, "Socket_RightHand"); // 특정 부모 Transform 컴포넌트 지정 GameEntry.GetComponent<EntityComponent>().AttachEntity(childEntityId, parentEntityId, parentTransform);

using UnityGameFramework.Runtime; public class PlayerEntity : EntityLogic { protected override void OnInit(object userData) { base.OnInit(userData); // 플레이어 상태, 컴포넌트 초기화 } protected override void OnShow(object userData) { base.OnShow(userData); // 플레이어 활성화 시 동작 (애니메이션, 행동 시작 등) } protected override void OnHide(bool isShutdown, object userData) { // 숨김 시 정리 (사운드 정지, 행동 비활성화 등) base.OnHide(isShutdown, userData); } protected override void OnUpdate(float elapseSeconds, float realElapseSeconds) { base.OnUpdate(elapseSeconds, realElapseSeconds); // 매 프레임 플레이어 로직 업데이트 } }

// 엔티티 사용 가능 여부 확인 bool isAvailable = entityLogic.Available; // 엔티티 가시성 확인 bool isVisible = entityLogic.Visible; // 엔티티를 보이거나 숨기기 entityLogic.Visible = true; // 또는 false

EntityComponent entityComponent = GameEntry.GetComponent<EntityComponent>(); // 엔티티 존재 여부 확인 bool hasEntity = entityComponent.HasEntity(1); // ID로 엔티티 가져오기 Entity entity = entityComponent.GetEntity(1); // 에셋 이름(Addressables 주소)으로 엔티티 가져오기 Entity[] entities = entityComponent.GetEntities("Zombunny"); // 모든 로드된 엔티티 가져오기 Entity[] allEntities = entityComponent.GetAllLoadedEntities();