콘텐츠로 이동

레퍼런스

이 페이지는 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 패턴

런타임에 포털 쌍을 만들 때는 다음 순서를 사용합니다.

  1. Set Linked Portal을 호출합니다.
  2. 전체 ρ, a, T를 Initialize Physical Metric으로 한 번에 초기화합니다.
  3. Timeline에서 Set Portal Visual Scale을 구동해 값싼 열림 효과를 만듭니다.
  4. 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를 기준으로 하는 것이 좋습니다.