레퍼런스¶
이 페이지는 Wormhole Portal이 제공하는 주요 속성, Blueprint 노드, C++ 인터페이스, 프로젝트 설정 및 진단 기능을 정리합니다.
기본값과 프로젝트 오버라이드
이 페이지의 값은 플러그인 코드 기본값입니다.
Config/DefaultEngine.ini 또는 Console Variable 설정에 저장된 값이
있으면 해당 프로젝트 값이 우선합니다.
Portal Actor¶
AWormholePortalActor는 웜홀의 한쪽 끝을 나타냅니다. 한 액터에서
Linked Portal을 지정하면 반대 방향 연결이 자동으로 만들어지고, 시작
포털의 Metric 값이 두 끝점에 동기화됩니다.
포털 스케일을 1로 유지
Metric 계산은 Actor Scale (1, 1, 1)을 전제로 합니다. Actor를
스케일링하지 말고 Portal Radius, Throat Half Length,
Transition Length로 크기를 조절하세요.
주요 속성¶
| 속성 | 코드 기본값 | 제약 및 역할 |
|---|---|---|
| Linked Portal | 없음 | 목적지 끝점입니다. 자기 자신과 연결할 수 없습니다. |
Portal Radius (ρ) |
50 cm |
Seam 및 물리 통과 반지름입니다. 최소 1 cm이며 T > 0일 때 활성 LUT Domain에 맞게 제한됩니다. |
Throat Half Length (a) |
100 cm |
Seam에서 Mouth까지의 거리입니다. 최소 0입니다. |
Transition Length (T) |
200 cm |
Mouth에서 평탄 공간까지의 거리입니다. 최소 0이며 활성 LUT Domain에 맞게 제한됩니다. 0이면 전이가 없는 경로를 사용합니다. |
| LUT Asset Override | 없음 | 프로젝트 LUT Catalog 대신 사용할 인스턴스별 LUT입니다. |
| Streaming Preload Distance | 15,000 cm |
World Partition 목적지 로딩을 시작합니다. |
| Streaming Release Distance | 20,000 cm |
로딩을 유지하는 바깥 거리입니다. Preload Distance 이상으로 제한됩니다. |
| Streaming Query Interval | 0.2 s |
근접 수요를 다시 검사하는 간격입니다. 최소 0.01 s입니다. |
| Draw Portal Debug | Editor에서 켜짐 | Seam, Mouth, Transition 경계를 표시합니다. PIE 시작 시 강제로 꺼집니다. |
| Uniform Physical Metric Scale | 1.0 |
초기화된 Metric 전체를 균일하게 확대합니다. Collision, Bounds, Visibility와 Capture 정책도 바뀝니다. |
| Portal Visual Scale | 1.0 |
Compositor가 표시하는 크기만 바꿉니다. 물리 Metric과 Collision은 바뀌지 않습니다. |
Metric 경계는 다음과 같습니다.
Mouth Radius = Portal Radius + Throat Half Length
Transition Radius = Mouth Radius + Transition Length
LUT 비율 = Transition Length / Portal Radius
Blueprint API¶
| 노드 | 종류 | 설명 |
|---|---|---|
Set Linked Portal |
Callable | 양방향 연결을 만들거나 교체하고 Metric을 동기화합니다. |
Clear Linked Portal |
Callable | 양방향 연결을 해제합니다. |
Get Linked Portal / Has Linked Portal |
Pure | 연결 상태를 읽습니다. |
Is Linked Portal Area Ready |
Pure | 일반 레벨에서는 항상 true이며, World Partition에서는 목적지 스트리밍 준비 상태를 반환합니다. |
Set Portal Radius |
Callable | 제작 단계에서 ρ를 설정합니다. BeginPlay 이후의 독립 변경은 거부됩니다. |
Set Throat Half Length |
Callable | 제작 단계에서 a를 설정합니다. BeginPlay 이후의 독립 변경은 거부됩니다. |
Set Transition Length |
Callable | 제작 단계에서 T를 설정합니다. BeginPlay 이후의 독립 변경은 거부됩니다. |
Initialize Physical Metric |
Callable | 최종 ρ, a, T를 한 번에 초기화합니다. 런타임 후속 호출은 처음의 a/ρ, T/ρ 비율을 유지하는 균일 변경만 허용합니다. |
Set Metric Parameters |
Callable, Deprecated | Initialize Physical Metric의 하위 호환 이름입니다. 새 코드에서 사용하지 마세요. |
Set Uniform Physical Metric Scale / Get Uniform Physical Metric Scale |
Callable / Pure | 초기화한 Metric을 균일하게 물리 확대하고 현재 배수를 읽습니다. |
Set Portal Visual Scale / Get Portal Visual Scale |
Callable / Pure | 렌더링 크기만 바꾸고 읽습니다. 프레임 단위 성장 효과에 권장합니다. |
| Metric Getter | Pure | Get Portal Radius, Get Mouth Radius, Get Throat Half Length, Get Transition Length, Get Transition Radius |
Get Portal Cube Render Target |
Pure | 런타임이 소유한 참조를 반환합니다. 크기 변경, 초기화, 업데이트 또는 해제를 호출하지 마세요. |
Get LUT Texture / Get LUT Z |
Pure | 활성 Volume LUT와 현재 포털의 논리적 Slice를 반환합니다. |
Transform Ray Through Portal |
Callable | 진입 표면점과 안쪽 방향을 연결된 포털 공간으로 변환합니다. Trace는 수행하지 않습니다. 기본 Exit Offset은 2 cm입니다. |
Set Draw Portal Debug / Is Portal Debug Enabled |
Callable / Pure | Editor 경계 표시를 제어합니다. |
런타임 크기 변경 계약
Initialize Physical Metric으로 최종 형태를 먼저 확정하세요. 물리적으로
커져야 할 때만 Set Uniform Physical Metric Scale을 사용하고, 생성
애니메이션처럼 시각적인 변화는 Set Portal Visual Scale을 사용합니다.
Actor Transform Scale은 이 계산에 반영되지 않으므로 (1, 1, 1)로
유지해야 표시와 Collision의 불일치를 피할 수 있습니다.
Transit Component¶
Actor가 포털을 통과하게 하려면 UWPTransitComponent를 추가합니다.
속성¶
| 속성 | 기본값 | 역할 |
|---|---|---|
| Transit Enabled | 켜짐 | Portal Overlap이 Transit을 시작할 수 있게 합니다. |
| Transit Type | Auto |
처리 타입을 직접 선택하거나 자동 판별합니다. |
| Ignore Time | 0.15 s |
성공적인 Commit 후 즉시 재진입하는 것을 막습니다. |
| Draw Debug | 꺼짐 | 활성 Transit 진단 형상을 표시합니다. |
| Use Voxel Collision | 꺼짐 | Master와 Twin이 공존하는 동안 베이크된 복셀 충돌을 사용합니다. |
| Use Material Clip | 꺼짐 | Custom Primitive Data를 통해 호환 머티리얼을 제어합니다. |
| Voxel Size | 20 cm |
Editor Bake에서 요청할 복셀 한 변의 길이입니다. |
| Max Voxel Count | 256 |
각 Bake 대상 Primitive당 최대 Box 수입니다. 범위는 1–512입니다. |
| Center Mode | Root Component Location |
진입 접평면의 기준입니다. 선택값: Root Component Location, Actor OBB Center. |
Auto의 판별 순서는 Character, Projectile, Pawn, Physics입니다.
구체적인 타입을 선택하면 그 타입만 검증하며 다른 Handler로 대체되지
않습니다.
모든 타입은 Actor가 직접 소유하는 Movable Collision Primitive가 필요합니다. Transit 후보 중 하나 이상은 Query Collision과 Generate Overlap Events가 켜져 있고 포털 Trigger와 Overlap할 수 있어야 합니다. Instanced Static Mesh Component는 지원하지 않습니다.
| 타입 | 필수 구성 |
|---|---|
| Character | ACharacter, Root Capsule, 해당 Capsule을 Updated Component로 사용하는 Character Movement. 선택적 시각 Skeletal Mesh가 있으면 Physics Simulation이 꺼져 있어야 함 |
| Projectile | 유효한 UProjectileMovementComponent와 Actor 소유의 Updated Primitive. 해당 Primitive는 Physics Simulation을 사용하지 않음 |
| Pawn | Character가 아닌 APawn, Pawn Movement, Root이자 Updated Component인 Actor 소유 Primitive. 해당 Primitive는 Physics Simulation을 사용하지 않음 |
| Physics | Physics Collision 및 Simulation이 켜진 지원 단일 Body Primitive 하나 이상. 유효한 Mesh의 Static Mesh 또는 Shape Component를 지원하며 Instanced Static Mesh는 제외 |
Use Voxel Collision은 Instanced가 아닌 Static Mesh와 Box/Sphere/Capsule
Shape Component에 사용할 수 있습니다. Static Mesh의 Bake Source는 Sphere,
Box, Capsule 또는 Convex Simple Collision입니다. 생성 기본 경로는
/Game/WormholePortal/Generated/Voxels이며 Max Voxel Count는 각 참여
Primitive별 제한입니다.
Use Material Clip을 사용할 때는
/WormholePortal/Materials/MaterialFunctions/MF_WPTransitClip을 Material에
연결합니다. 기본 Clip Base Index 28부터 연속된 네 Custom Primitive
Data 슬롯이 비어 있고 Material 쪽 Index와 Project Settings가 같은지
확인하세요.
Delegate¶
| Delegate | 호출 시점 |
|---|---|
On Phase Changed |
소유 Actor의 Transit Phase가 변경될 때 |
On Twin Preparing |
Template 복제가 끝난 직후이자 Twin Construction Script 직전. 동기 작업만 안전하며 Delay 같은 Latent Action을 사용하면 안 됩니다. |
On Twin Created |
Twin 생성과 Run 준비가 완료될 때 |
On Twin Removing |
Twin이 제거되기 직전 |
Blueprint API¶
| 노드 | 설명 |
|---|---|
Get Phase |
Idle, Check, Crossing, Cooldown을 반환합니다. |
Get Transit Role |
None, Master, Twin을 반환합니다. |
Get Counter Part Actor |
현재 관계의 반대편 Actor를 반환합니다. |
Get Master Actor / Get Twin Actor |
관계의 특정 Actor를 반환합니다. |
Get Source Portal / Get Dest Portal |
진입 및 목적지 포털을 반환합니다. |
Get Transit Type |
Auto 판별 이후의 실제 타입을 반환합니다. |
Get Transit Sequence |
현재 World 안에서 Transit을 식별하는 번호입니다. |
Cancel Transit |
Authority를 가진 World에서 활성 Transit을 취소합니다. |
Get Entry Data / Get Exit Data |
표면 위치와 바깥쪽 Normal을 반환합니다. |
Map Point, Map Direction, Map Rotation, Map Transform |
현재 Transit Mapping으로 값을 변환합니다. 유효한 Mapping이 없으면 false입니다. |
Is Point Inside Portal |
활성 진입 접평면의 안쪽인지 검사합니다. |
Refresh From Owner |
타입과 컴포넌트 캐시를 다시 판별합니다. Idle에서만 가능합니다. |
Transit Enum¶
| Enum | 값 |
|---|---|
EWPTransitType |
Auto, Physics, Character, Projectile, Pawn |
EWPTransitPhase |
Idle, Check, Crossing, Cooldown |
EWPTransitRole |
None, Master, Twin |
EWPTransitResult |
None, Rejected, Committed, Cancelled |
EWPTransitFailReason |
None, NotReady, PortalUnavailable, AlreadyInTransit, CooldownActive, DoesNotFitGate, TwinCreationFailed, PortalDestroyed, InternalError, UnsupportedActor, InvalidSetup, TransitDisabled, MissingPrimitives, MissingPhysicsMesh, MissingVoxelData, InvalidVelocity, InvalidCenter, InvalidPlane, BeginFailed, VoxelBeginFailed, UpdateFailed, RuntimeStateLost, MappingInvalid, InvalidRunState, ReturnedToSource, CommitFailed, CancelRequested, SubsystemClosed |
설정 검사기와 Transit Manager가 사용하는 EWPTransitResolveFailReason 값은
다음과 같습니다.
None, UnsupportedActor, TransitDisabled, MissingPrimitives, NoPhysicsBody,
MissingVoxelData, TypeMismatch, MissingMovement, InvalidMoveOwner,
InvalidUpdatedPart, InvalidRootPart, InvalidPartOwner, PartNotMovable,
PartNoCollision, UnsupportedPart, ExcludedPart, SimPhysics, InvalidMoveType,
NoOverlapPart
DoesNotFitGate는 이동 방향에 수직인 Actor의 투영 통과 단면이 Source
Portal Gate/Core Radius 안에 들어가지 않는다는 뜻입니다.
포털 인식 Line Trace¶
일반 Scene Trace Channel로 WPPortalTrace를 전달하지 마세요. 이 채널은
라이브러리가 포털을 찾을 때 내부적으로 사용합니다.
| Blueprint 노드 | 결과 |
|---|---|
Portal Line Trace By Channel |
마지막 Blocking Hit Result와 종료 상태 |
Portal Line Trace Detailed By Channel |
논리적 거리와 Portal Event를 포함한 FWPPortalTraceResult |
Portal Line Trace Multi By Channel |
논리적 경로 순서의 Overlap Hit와 첫 Blocking Hit |
Portal Line Trace Multi Detailed By Channel |
모든 구간의 상세 Scene Hit와 Portal Event |
공통 기본값은 Ignore Self = true, Max Portal Depth = 4, Portal Exit
Offset = 2 cm, Draw Time = 5 s, 빨간 Trace, 초록 Hit입니다.
FHitResult.Distance는 포털을 지난 새 구간마다 다시 시작합니다. 최초
시작점 기준 거리는 FWPPortalTraceHit.LogicalDistance를 사용하세요.
논리적 거리에는 포털 내부 거리와 Portal Exit Offset이 포함되지
않습니다.
Blueprint 예제¶
카메라 위치를 Start, 카메라 Forward Vector에 원하는 거리를 곱해 더한
값을 End로 만들고 Portal Line Trace Detailed By Channel에 연결합니다.
일반 월드 충돌 채널(예: Visibility)을 사용하고, 반환된
FWPPortalTraceResult.Status가 Completed인지 확인한 뒤 Scene Hits와
Portal Events를 처리하세요. WPPortalTrace는 내부 포털 감지 채널이므로
노드의 Trace Channel로 선택하지 마세요.
Portal Exit Offset 동작
Offset은 출구 포털을 즉시 다시 Hit하는 것을 막습니다. 현재 남은 Trace 거리에서는 차감되지 않으며, 출구 표면과 Offset이 적용된 Trace 시작점 사이의 구간은 Collision을 검사하지 않습니다.
Trace 결과 타입¶
| 타입 | 주요 필드 |
|---|---|
FWPPortalTraceResult |
Status, bBlockingHit, RequestedDistance, ProcessedDistance, PortalTraversalCount, SceneHits, PortalEvents |
FWPPortalTraceHit |
Hit, LogicalDistance, SegmentIndex |
FWPPortalTracePortalEvent |
DetectionHit, EntryPortal, ExitPortal, EntryDirection, ExitTraceStart, ExitDirection, LogicalDistance, PortalDepth, Outcome |
EWPPortalTraceStatus |
Completed, InvalidInput, MaxPortalDepthReached, PortalTransformFailed |
EWPPortalTracePortalOutcome |
Traversed, MaxDepthReached, TransformFailed |
C++에는 PortalLineTraceTestByChannel, PortalLineTraceSingleByChannel,
PortalLineTraceMultiByChannel도 공개되어 있습니다.
Project Settings¶
Edit > Project Settings > Plugins > Wormhole Portal에서 설정합니다. 값은
DefaultEngine.ini에 저장됩니다.
Trace 및 Transit¶
| 설정 | 플러그인 기본값 |
|---|---|
| Portal Trace Channel | ECC_GameTraceChannel1 |
| Portal Trace Channel Name | WPPortalTrace |
| Plane Tie Angle | 1° |
| Plane Priority | YZ > XZ > XY |
| Clip Base Index | 28 |
| Generated Voxel Asset Path | /Game/WormholePortal/Generated/Voxels |
Clip Base Index부터 연속된 네 개의 Custom Primitive Data 값을
사용하며, MF_WPTransitClip을 사용하는 머티리얼과 같은 값이어야 합니다.
Generated Voxel Asset Path는 대소문자를 구분하는 /Game/ Prefix를 가진
유효하고 쓰기 가능한 Unreal Long Package Directory여야 합니다. 역슬래시와
끝의 Slash는 검증 전에 정규화됩니다. 설치된 Plugin Content 경로인
/WormholePortal/...은 생성 Asset을 쓸 수 없으므로 거부됩니다.
동적 Cubemap 해상도¶
| 설정 | 플러그인 기본값 |
|---|---|
| Lowest Visible Resolution | 64 |
| 초기 Tier 1 Start / Resolution | 30% / 128 |
| 초기 Tier 2 Start / Resolution | 60% / 256 |
| 초기 Tier 3 Start / Resolution | 100% / 512 |
| Inside SafeProxy Resolution | 768 |
Resolution Tiers는 Project Settings에서 요소를 추가·삭제·재정렬할 수
있는 배열입니다. 런타임은 Start 값을 0–100%로 제한하고 임시 정책을
오름차순으로 정렬합니다. 양수 해상도는 다음 8 배수로 올림한 뒤
8–2048 범위로 제한합니다. 각 Tier는 Lowest Visible Resolution부터
내림차순이 되지 않도록 보정되며, Inside SafeProxy Resolution도 Lowest
값 이상으로 보정됩니다. 배열이 비어 있으면 Safe Proxy 바깥의 모든
거리에서 Lowest 값을 사용합니다. 위 Tier 값은 새 설정을 초기화할 때의
코드 기본값이며 프로젝트 Config가 이를 덮어쓸 수 있습니다.
Cubemap Memory 통계는 진단용이며 실제 해상도 정책은 위 Project Settings에서 결정됩니다.
Scene Capture Show Flag¶
플러그인 코드에서는 다음 항목이 기본으로 켜져 있습니다.
- Lumen Reflections
- Screen Space Ambient Occlusion
- Volumetric Cloud Bundle
- Dynamic Shadows Bundle
- Sky Lighting Bundle
- Sky Atmosphere Bundle
- Deferred Lighting Bundle
- Lighting Master Bundle
- Fog Master Bundle
- Volumetric Fog
이 옵션은 관리되는 Cube Capture에만 적용되며 플레이어 Main View에는 적용되지 않습니다. Lighting Master Bundle과 Fog Master Bundle은 각 하위 옵션의 상위 스위치입니다.
Portal Audio¶
| 설정 | 플러그인 기본값 |
|---|---|
| Enable Portal Audio | 켜짐 |
| Transmission Gain | 1.0 |
| Enable Occlusion | 켜짐 |
| Occlusion Channel | Visibility |
| Occlusion Check Interval | 0.1 s |
| Occluded Volume Multiplier | 0.35 |
| Occlusion Low-pass Frequency | 1200 Hz |
| Occlusion Surface Bias | 2 cm |
| Source Reconcile Interval | 0.25 s |
Portal Source Shadow¶
| 설정 | 플러그인 기본값 |
|---|---|
| Enable Portal Source Shadows | 켜짐 |
| Base Resolution | 256 |
| Update Rate | 30 Hz |
| Captures Per Frame | 2 |
| Active Routes | 8 |
| Depth Bias | 1 cm |
| PCF Radius | 1 texel |
LUT¶
| 설정 | 플러그인 기본값 |
|---|---|
| Generated LUT Asset Path | /Game/WormholePortal/Generated/LUT |
| Impact / Transition / Ratio Samples | 512 / 48 / 24 |
| Integration Steps | 192 |
| Transition Ratio Domain | 0.5–8.0 |
| Tail Flatten Start | 0.5 |
| Allow Runtime LUT Fallback | 켜짐 |
Generated LUT Asset Path에도 같은 /Game/ Long Package Directory 규칙이
적용됩니다. 기본 LUT 및 Voxel 경로는 프로젝트 Content에 생성되며, 설치된
Plugin Content 경로로 변경할 수 없습니다.
Tag¶
| Actor 또는 Component Tag | 효과 |
|---|---|
Wormhole.Ignore |
Actor 또는 Primitive Component를 Transit 판별에서 제외합니다. |
WP.PortalAudio.Disabled |
Audio Component 또는 소유 Actor를 Portal Audio에서 제외합니다. |
WP.PortalLight.Disabled |
Light Component 또는 소유 Actor를 Portal Light 수집에서 제외합니다. |
WP.PortalAudio.Generated, WP.PortalLight.Generated,
WormholeGeneratedTransit은 플러그인이 만든 오브젝트를 위한 내부 값이므로
직접 지정하지 마세요.
Editor 도구¶
| 위치 | 기능 |
|---|---|
| Tools > Wormhole Portal > Transit Manager | Actor 호환성을 검사하고 Ready, Needs Setup, Not Supported를 표시하며 준비된 Actor에 Transit을 적용합니다. |
| Tools > Wormhole Portal > Bake All LUTs | LUT Bake Settings를 열고 공용 Volume LUT와 Catalog를 생성합니다. |
| Transit Component Details | Use Voxel Collision이 켜져 있을 때 Bake Voxel Body로 지원 Static Mesh Simple Collision 또는 Box/Sphere/Capsule Shape Component를 복셀 에셋으로 만듭니다. |
| Portal Actor Details | 활성 LUT Domain을 표시하고 Metric 입력 범위를 해당 Domain에 맞게 제한합니다. |
| 시작 알림 | WPPortalTrace가 없거나 불일치할 때 Add Automatically 및 Open Collision Settings를 제공합니다. |
LUT의 Quality 및 Domain Preset은 다음과 같습니다.
| Preset 그룹 | 옵션 |
|---|---|
| Quality | Fast (256/24/12/64), Balanced (512/48/24/192), High (768/64/32/384), Cinematic (1024/96/48/768) |
| Domain | Current Level Auto, Standard (0.5–8), Wide (0.25–16), Narrow (1–4) |
Quality 숫자는 차례로 Impact Samples, Transition Samples, Ratio Samples, Integration Steps입니다.
연동 예제¶
Blueprint 패턴¶
런타임에 포털 쌍을 만들 때는 다음 순서를 사용합니다.
- Set Linked Portal을 호출합니다.
- 전체
ρ,a,T를 Initialize Physical Metric으로 한 번에 초기화합니다. - Timeline에서 Set Portal Visual Scale을 구동해 값싼 열림 효과를 만듭니다.
- Collision과 실제 통과 Gate도 함께 커져야 할 때만 Set Uniform Physical Metric Scale을 사용합니다.
Transit은 Components 패널에서 WPTransitComponent를 추가하고 Transit
Type: Auto, Transit Enabled로 Compile한 뒤 Transit Manager에서
검사합니다. Trace는 Portal Line Trace Detailed By Channel을 Break
WPPortalTraceResult에 연결하고 Status, Scene Hits, Portal Events와
논리적 거리를 처리합니다.
C++ 모듈 의존성¶
사용자 모듈의 .Build.cs에 Runtime 모듈을 추가합니다.
PublicDependencyModuleNames.AddRange(
new string[]
{
"WormholePortalRuntime"
});
포털 쌍 설정과 애니메이션¶
#include "WormholePortalActor.h"
void ConfigurePortalPair(
AWormholePortalActor* PortalA,
AWormholePortalActor* PortalB)
{
if (!IsValid(PortalA) || !IsValid(PortalB))
{
return;
}
PortalA->SetLinkedPortal(PortalB);
PortalA->InitializePhysicalMetric(75.0f, 150.0f, 300.0f);
// 프레임 단위 열림 효과에는 렌더링 크기만 바꿉니다.
PortalA->SetPortalVisualScale(0.5f);
// 실제 Gate와 Collision도 커져야 할 때 대신 사용합니다.
// PortalA->SetUniformPhysicalMetricScale(1.25f);
}
복제되는 게임플레이 변경은 Authority에서 실행하세요. 세 개의 독립 Metric Setter를 Tick마다 호출하지 마세요.
기존 Transit Component 새로고침¶
#include "Transit/WPTransitComponent.h"
if (UWPTransitComponent* Transit =
Actor->FindComponentByClass<UWPTransitComponent>())
{
Transit->SetTransitType(EWPTransitType::Auto);
Transit->SetTransitEnabled(true);
Transit->RefreshFromOwner(); // Idle 상태에서만 성공합니다.
}
포털 인식 Trace 실행¶
#include "Trace/WPTraceLibrary.h"
FWPPortalTraceResult Result;
const bool bBlockingHit = UWPTraceLibrary::PortalLineTraceSingleByChannel(
WorldContextObject,
Result,
Start,
End,
ECC_Visibility);
ECC_Visibility는 이 예제의 일반 Scene Collision Channel입니다.
WPPortalTrace로 바꾸지 마세요. bBlockingHit은 최종 Scene Blocking Hit의
존재 여부이며 종료 이유와 전체 경로는 Result에서 확인합니다.
Native 서브시스템¶
| 타입 | 범위와 용도 |
|---|---|
UWPRegistrySubsystem |
World 단위 포털 및 Pair Registry와 Native 등록·변경·Pair Delegate |
UWPTransitSubsystem |
서버 권한 Transit Coordinator와 Native Lifecycle Delegate |
UWPPortalStreamingSubsystem |
World Partition 목적지 요청. 일반 게임플레이는 Portal Actor에서 준비 상태를 읽습니다. |
UWPPortalAudioSubsystem |
반대편 Audio Route를 생성하며 Blueprint에서 추적 Source와 Proxy 수를 읽을 수 있습니다. |
UWPPortalLightCollectionSubsystem |
C++ Snapshot을 위해 Point, Spot, Directional Light를 수집합니다. |
UWPPortalLightTransmissionSubsystem |
Point/Spot Proxy Light와 Source Shadow Route를 생성합니다. |
UWPLUTCacheSubsystem |
Engine 단위 비동기 Baked/Fallback LUT Cache. 완료 처리는 Game Thread로 돌아옵니다. |
IWPRenderer |
Pair 등록과 변경 불가능한 Render Packet을 위한 고급 Modular Feature 경계 |
FWPTransform은 생성, Point/Direction/Rotation Mapping, 역방향 Mapping,
Exit Mapping, 전체 Transform Mapping을 제공합니다.
진단¶
다음 명령을 실행합니다.
stat WormholePortal
CPU 준비와 제출 시간, 활성 Pair, Cubemap 메모리와 Megapixel, Capture 제출,
LUT 요청·Cache Hit·Fallback, Render Packet 수, Composite 작업량을
표시합니다. 실제 GPU 실행 시간은 stat gpu 또는 ProfileGPU에서
확인하세요.
Output Log를 LogWormhole로 필터링합니다. 현재 세션의 로그 상세도를
높이려면 다음을 실행합니다.
Log LogWormhole Verbose
주요 렌더링 CVar¶
| CVar | 코드 기본값 | 역할 |
|---|---|---|
wp.RuntimeEnabled |
1 |
Production Render Packet Pipeline의 상위 스위치 |
wp.SceneViewExtensionEnabled |
1 |
Warmup 및 Production Composite의 상위 스위치 |
wp.SimulateViewEnabled |
1 |
SIE Viewport Production Pass 활성화 |
wp.CaptureSchedulerMode |
2 |
1: Atomic Pair, 2: Staggered Endpoint. 0은 1의 Deprecated Alias |
wp.CaptureTargetEndpointHz |
30 |
보이는 Endpoint 갱신 주기. 실제 런타임 Clamp 범위 5–120 Hz |
wp.CaptureVisibilityInvisibleHoldSeconds |
0.5 |
양쪽이 보이지 않은 뒤 Capture를 멈추기까지의 시간 |
wp.CaptureVisibilityFeedbackMaxAgeSeconds |
0.25 |
GPU Visibility 피드백을 최신으로 인정하는 최대 시간 |
wp.CaptureOcclusionTraceIntervalSeconds |
0.1 |
CPU SafeProxy Occlusion 검사 주기 |
wp.CaptureResolutionUpgradeHoldSeconds |
0.75 |
해상도를 높이기 전 대기 시간 |
wp.CaptureResolutionDowngradeHoldSeconds |
0.15 |
해상도를 낮추기 전 대기 시간 |
wp.CaptureResolutionMinimumDwellSeconds |
0.5 |
완료된 해상도 전환 사이의 최소 간격 |
wp.CaptureMaxViewDistanceCm |
-1 |
양수이면 Capture 거리 제한, <=0이면 제한 없음 |
wp.CaptureLODDistanceFactor |
1 |
Capture LOD 배수. 범위 1–10 |
wp.CaptureFiniteFarPlane |
0 |
1이면 CaptureMaxViewDistanceCm을 Projection Far Plane에도 적용하는 진단 옵션 |
wp.CubeAADirectPublish |
1 |
지원되는 Direct Publish Cubemap 경로 활성화 |
wp.CubeLumenParityMode |
0 |
0: Lumen 없음, 1: GI, 2: GI 및 Reflection |
wp.ViewSummaryInterval |
5 |
렌더링 집계 로그 주기(초) |
CVar는 프로파일링과 통제된 오버라이드에 사용하세요. 일반적인 제작 설정은 Project Settings를 기준으로 하는 것이 좋습니다.