unreal-world-partition

Configure and debug World Partition streaming, Data Layers, and HLODs in Unreal Engine 5.8.

Updated May 28, 2023
One-click install
npx skills add https://github.com/steveulrich/ProjectB --skill unreal-world-partition-steveulrich
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: unreal-world-partition
Source: https://github.com/steveulrich/ProjectB/tree/main/.cursor/skills/unreal-world-partition
Command: npx skills add https://github.com/steveulrich/ProjectB --skill unreal-world-partition-steveulrich

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Building large streamed worlds in Unreal Engine 5.8 involves many interacting systems—streaming sources, runtime grids, Data Layers, HLODs, OFPA, and Level Instances—and misconfiguring any of them causes pop-in, hitches, memory bloat, or broken multiplayer state. This Skill provides operational guidance to design, implement, profile, and debug a partitioned world correctly. ## Core Features & Use Cases - System selection and conversion: Choose between World Partition, Level Instances, Packed Level Blueprints, or legacy sublevel streaming, and convert existing maps safely with the World Partition Convert Commandlet. - Streaming configuration: Set up streaming sources, runtime grids, cell sizes, loading ranges, and safe teleport gating using IsStreamingCompleted. - Data Layers and HLOD authoring: Manage runtime world-state variants with server-authoritative Data Layers and build distant proxy geometry with HLOD layers. - Diagnosis and automation: Debug cells with wp.Runtime console commands, World Partition Insights tracing, and unattended builder commandlets. - Use Case: You are shipping an open-world game and players see missing collision after fast travel. Use this Skill to implement the source-gated teleport pattern, derive a measured loading range, and verify the fix on a cooked target build. ## Quick Start Use the unreal-world-partition skill to design a streaming setup for my open-world map, including runtime grid settings, streaming sources, and a safe teleport flow.

Frequently Asked Questions about unreal-world-partition

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up World Partition streaming in Unreal Engine 5?▼

Enable World Partition with streaming on, start with the default 2D Runtime Spatial Hash and one runtime grid, then place streaming sources on the player or via a WorldPartitionStreamingSourceComponent. Derive loading range from maximum travel speed times worst observed load latency plus a safety margin.

How to teleport without pop-in in Unreal World Partition?▼

Place a temporary streaming source at the destination, enable it, and poll UWorldPartitionSubsystem::IsStreamingCompleted before moving the player. Keep the source active until the normal player source owns the destination cells, and provide a timeout fallback instead of teleporting into unloaded collision.

What is the difference between Data Layers and HLOD in Unreal Engine?▼

Runtime Data Layers control whether world content is Unloaded, Loaded, or Activated for stateful world variants, with the server owning state in networked play. HLOD replaces distant unloaded content with proxy visuals only; it is never authoritative collision, interaction, or gameplay state.

Does One File Per Actor prevent merge conflicts in Unreal?▼

No. OFPA stores actor edits in external files so teammates can edit different actors without checking out the whole level, but it does not prevent two people changing the same actor or logical conflicts between related actors. It is an editor workflow; cooked builds embed actors into level packages.

Why is my World Partition content not loading at runtime?▼

Diagnose in layers: check the streaming source's location, state, and priority; verify the runtime cell is generated and requested; confirm Is Spatially Loaded, Data Layer state, and grid assignment agree; then check hard references that bundle distant actors. Use wp.Runtime.ToggleDrawRuntimeHash2D and stat streaming to visualize.

When should I not use World Partition in Unreal Engine 5?▼

Avoid it for small maps that fit the memory budget, where streaming complexity adds no value, or when a legacy discrete-sublevel architecture already works and conversion risk exceeds its benefit. Do not introduce World Composition in new UE5 projects.