시각적 연결 (Visual Link): 모든 세계를 관통하는 '빛의 파편'. 장르에 따라 형태는 변하지만 본연의 색과 문양을 유지하여 목적성을 부여합니다.
기술적 연결 (Technical Link): 장르 전환 시 발생하는 카메라 워킹과 조작감의 심리스(Seamless)한 변화. (예: TPS 줌인 → 액션 어드벤처 3인칭 전환)
청각적 연결 (Audio Link): 하나의 **메인 테마(Main Theme)**를 각 장르에 맞춰 편곡(오케스트라, 일렉트로닉, 국악 등)하여 감성적 통일감을 부여합니다.

아키텍처 전제

9장르 전체를 구속하는 기술 계약.

최종 산출물 = 유튜브 쇼케이스 영상 시리즈(첫 쇼케이스 = 로드맵 M5 · 2027-06, MRQ 4K 렌더링). 출시 라이브게임 아님 → 시네마틱·심리스 전환 = Critical, 풀 멀티플레이 서버 = Out-of-scope.
9장르: 무쌍(첫 쇼케이스) / TPS / 소울라이크 / 해상전투 / 레이싱 / 플랫포머 / 턴제RPG / 액션어드벤처(연결축) / 스텔스(9번째 추정).
빛의 파편 3대 연결고리: 시각(파편 색/문양 유지) / 기술(심리스 카메라·조작 전환) / 청각(메인테마 장르별 편곡).
고정 아키텍처: GAS + Modular Gameplay / 이동 = Mover + GASP 모션매칭 / ASC 하이브리드(Player=PlayerState, NPC=Pawn) / 어빌리티 이동 = Mover Layered Move 큐잉(SetActorLocation 금지) / 언리얼 prefix + H.

교차 R&D (미해결)

여러 에픽을 동시에 막는 기술 질문.

Mover 동적 movable base 추적 — 해상 에픽의 함선 갑판 · 플랫포머 에픽의 이동 플랫폼 공통. UE 5.8 based movement 로 풀릴 가능성 — 확인 전.
ChaosMover 플러그인 평가 — 부력·차량(Chaos) ↔ Mover(sim) 권위 이원화 브릿지. 미설치. 해상 · 레이싱 에픽 선행.
GASP 임포트 정리 — 삭제예정 콘텐츠에 Aim카메라·Foley·위젯 묶임 → 삭제 전 네이티브 이관 목록 확정(카메라 · 오디오 에픽 회귀 위험 · 로코모션 에픽 종료 뒤 남은 항목 재확인 필요).

UE 5.8 이관 — 2026-08-30 완료 · 회귀 없음 (아래는 이관 전 조사 기록)

현재 소스 엔진 5.7. UE 5.8은 2026-06-17 정식 릴리스이며 UE5의 마지막 메이저(UE6 얼리액세스 2027 말). 상세 근거는 git 메모리 ue-58-upgrade-assessment.

얻는 것

Mover 대폭 개선 — layered move 사전 스케줄링(우리 T7 브릿지가 노리던 것) · root motion·몽타주 처리 개선 · NavWalking + Detour Crowd(WP-13 군중 블로커) · based movement(움직이는 배·플랫폼 → WP-19·21 교차 R&D 해소)
GASP 5.8 갱신 — blendstack 재작업(State Machine → Chooser + Pose Match Column) · 복수 Pose Search DB · 래그돌→모션매칭 getup · ★다중 캐릭터 모션매칭(밀치기·태클·테이크다운, 무쌍 직결)
MetaHuman Markerless MoCap 무료·전량 로컬(영상 한 대로 얼굴·몸·손) — 애니 조달 대체 후보였으나 2026-09-23 애니 자작 폐기(구매 전환)로 보류
공식 MCP(엔진 인박스, :8000) — 서드파티 :8090과 포트 달라 공존 가능. GASToolsets 공식 제공, Python ToolsetDefinition으로 프로젝트 전용 툴 제작 가능

※ 에디터 내장 AI 어시스턴트 EDA는 5.8이 아니라 5.7부터 이미 있음(F1). 문서 Q&A + C++ 생성이지 편집 에이전트는 아님.

리스크 (우리 고유)

Mover는 5.8에서도 여전히 Experimental.
우리 로코모션은 엔진 내부 우회 3개에 의존한다 — USmoothWalkingMode reflection 파라미터 주입 / ProcessGeneratedMovement 델리게이트 훅 / enum shadow reflection-write. 5.8이 root motion·몽타주·layered move를 손봤으므로 조용히 깨질 수 있다.
우리 C++ 포트는 구 GASP 설계의 1:1 이식이라, 새 Chooser 설계와 어긋난다 → "충실 이식" 원칙 자체를 재확인해야 함(감독 결정).
소스 엔진이라 5.8 브랜치 재빌드 비용 별도.

판단 — 세 작업을 분리한다: (a) 엔진 5.7→5.8 / (b) GASP 콘텐츠 교체 / (c) 우리 포트 재이식. (a)가 진짜 상품이고 (c) 없이도 얻는다. (c)는 선택이자 가장 비싸다(WP-00 재개봉).

시점 = 무쌍 슬라이스 완료 직후, Phase 2 팬아웃 전. 지금(슬라이스 중)은 최악, 9장르가 올라탄 뒤는 회귀 표면적이 9배.

선행 = 리스크 스파이크 — 브랜치 따서 5.8 빌드 → 우리 모듈 컴파일 → 리플렉션 훅 3개 생존 확인 → PIE 스모크.

공용 시스템 인덱스

9장르가 공유하는 척추. 각 시스템의 상세 구현·진행 상태는 git 메모리가 정본이고, 여기엔 계약(무엇을 보장하는가)만 적는다.

로코모션 (로코모션 에픽)

GASP(Game Animation Sample) Mover 모션매칭을 C++로 폰 충실 이식 완료(GASP 5.8 이관은 2026-09-21 종료). UHCharacterMoverComponent가 Gait/RotationMode/MovementDirection/AimOffset/under-rotation 클램프를 소유하고, ABP는 권위값을 읽기만 한다. 계약 = 어빌리티는 SetActorLocation·속도 직접 수정 금지, 이동은 전부 Mover를 통한다.

Mover ↔ GAS 브릿지 (이동 연결 에픽)

어빌리티의 이동은 Layered Move 큐잉으로만. 3요소 = QueueAbilityLayeredMove / Status.Movement.Locked 태그(이동입력 0클리어) / UHAbilityTask_MoverLayeredMove(큐+완료 await). 대시·넉백·런치·필살기 이동이 전부 이 위에 얹힌다.

전투 공용 파이프 (전투 공용 에픽)

모든 데미지는 UHCombatStatics::ApplyDamage 단일 지점을 통과한다 → i-frame 체크 → DamageGE(SetByCaller) → UHAttributeSet Damage meta → Health 환산. Health 0이면 Event.Death, 포이즈 0이면 Event.PoiseBroken 발화. 피아식별은 TeamId(uint8) 기반 CanCauseDamage.

어빌리티 시스템 (GAS)

ASC 부착 = 하이브리드. 플레이어 → AHPlayerState, 단명 NPC/몹 → Pawn(AHAICharacter). IAbilitySystemInterface는 Pawn에만 구현하고 PawnExt가 위임한다. 입력은 Lyra식 InputTag 라우팅(활성 중 재입력은 InputPressed() 오버라이드로 받아야 한다 — WaitInputPress는 태그 라우팅에서 발화하지 않는다).

Experience / 장르 모듈화 (장르 런타임 · 장르 부착 · 장르 전환 에픽)

장르 = Experience. ExperienceDefinition + ActionSet이 능력·적·카메라·입력을 묶어 격리 경계를 만든다. GameFeature는 1:1이 아니라 큰 묶음 2~3개. 장르 전환은 Experience 교체로 이뤄진다.

세이브 / 빛의 파편 (저장 에픽)

"빛의 파편"은 런타임 attribute가 아니라 SaveGame 기반 메타 진행이다.

애니메이션 블렌딩

상체 몽타주 × 하체 로코모션 = LBPB + Blend Mask(UpperBody). ★함정 = Mesh Space Rotation Blend 체크 필수(미체크 시 진폭 30~40% 축소). 배선 = AimOffset → LocomotionPose 캐시 → Slot → LBPB → Offset Root Bone.

입력 시스템

입력 시스템 구조

E-mail : [email protected] Phone number : (+82) 010 3902 8624