stellarframework

StellarFramework는 인디 개발자 프로젝트를 위한 Unity 기반 개발 프레임워크로, 아키텍처 계층화, UI, 리소스 로딩, 설정, 이벤트, 세팅, 핫 업데이트 및 관련 에디터 도구를 포괄합니다. 프로젝트에는 프레임워크 소스 코드, Kit 내보내기 도구, Tools Hub, 샘플, 검증 콘텐츠가 포함되어 있으며, 비즈니스 프로젝트는 내보내기 패키지를 통해 필요한 기능을 선택적으로 연동합니다. 실행 환경은 Unity 2022.3 LTS와 Unity 6000.x이며, 주요 개발 기준선은 Unity 2022.3.62f3c1입니다. 프로젝트를 처음 열면 UniTask, Addressables, HybridCLR 등의 UPM 의존성을 해석합니다. 아키텍처는 Architecture를 기반 계층으로 하여 Model이 상태와 데이터를, Service가 비즈니스 로직과 시스템 기능을, View가 표현 계층 상호작용을 담당하는 방식으로 구성됩니다. UIKit, ResKit, SettingsKit 등의 Kit는 필요에 따라 런타임에 연동할 수 있으며, Addressables와 YooAsset은 ResKit의 선택적 리소스 백엔드이고, HybridCLRKit은 독립적인 코드 핫 업데이트 확장입니다. 전체는 Architecture, Runtime Kits, Editor Modules / Tools Hub의 세 계층으로 나뉩니다. 배포 방식은 StellarFramework -> Export를 통해 이루어지며, 내보내기 도구가 선택한 Kit의 의존성을 자동으로 병합하고 의존성 설명을 생성합니다. 독립적으로 선택할 수 있는 기능으로는 UIKit.Core, ResKit 각 백엔드, GridKit, SpatialKit, SimulationKit, PathKit, FlowKit, LocalizationKit.Core, WorldKit.Core, WorldGenKit의 Core/Builtins/Authoring/Resources/Feature, PlacementKit.Core, Streaming 및 독립적인 Unity 표현 어댑터가 있습니다. 내보내기 창은 전달 시나리오에 따라 기본 기능, 전체 기능, 확장 기능으로 구분되며, Localization Complete는 UGUI와 TMP 스캔 바인딩 및 JSON/CSV 외부 번역 교환을 포함하고, UIKit Complete는 ResKit과 UIKit.Adaptation을 조합하며, Hot Update Full은 조합 확장에 속합니다. 이들은 검증된 조합 프리셋이며 새로운 런타임 모듈을 생성하지 않습니다. 전체 프레임워크는 StellarFramework.unitypackage를 통해 원클릭 설치도 가능하며, Bootstrap 설치 창이 자동으로 표시됩니다. 런타임 Kit는 ActionKit, AudioKit, BindableKit, ConfigKit, EventKit, FSMKit, HttpKit, UIKit, ResKit, HybridCLRKit, SettingsKit, LogKit, PoolKit, SingletonKit, TimeKit, SaveKit, GridKit, SpatialKit, SimulationKit, PathKit, FlowKit, LocalizationKit, WorldKit, WorldGenKit, PlacementKit 및 해당 명시적 어댑터를 포함합니다. 월드 관련 책임은 분리되어 유지됩니다. WorldKit은 월드/Chunk/데이터 구성을, WorldGenKit은 강타입 결정적 데이터를 생성하고, PlacementKit은 범용 배치 규칙을 평가하며, Unity 어댑터는 데이터를 텍스처, 메시, Tilemap, Terrain 또는 플로팅 원점 씬 좌표로 투영합니다. 에디터 측에서는 Tools Hub(빠른 시작, 리소스 빌드, HybridCLR 산출물 내보내기, 진단 도구), Addressables 구성 및 빌드, ResKit 리소스 빌드 및 감사, UIKit 바인딩 생성 및 적응 검사, Localization 스캔 바인딩 및 번역 매트릭스, FlowKit Graph 검증 창, 그리고 Editor-only World Framework 프로덕션 Authoring 및 진단을 제공합니다. 샘플 및 검증 측면에서 Assets/StellarFramework/Samples는 사용자용 실행 가능 샘플이고, Assets/StellarFramework/Tests는 자동화된 Behavior, Performance 및 Framework Policy 검증이며, Assets/StellarFrameworkVerification은 유지보수자 전용 Integration, Player 및 Release 검증 영역으로 사용자에게 배포되지 않습니다. GameHotUpdate는 런타임 전달 예시 및 검증 픽스처로 처리됩니다. 빠른 시작 절차는 다음과 같습니다. StellarFramework -> Tools Hub를 열고 Start Here -> Quick Start로 이동하여 샘플 빌드를 실행한 후 UIKit_Playable.unity 또는 ResKit_Playable.unity 등의 씬을 실행합니다. 공식 문서는 Assets/StellarFramework/FrameworkDoc에 위치하며, 각 Kit의 설명과 소스 문서, Kit 아키텍처 계층화 및 의존성 규칙, Kit 배포 매트릭스 및 프로덕션 인수 기준 등을 포함합니다.