Ctrlk
HomeDiscordGitHub
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Geometry-cache meshes for streaming-sector collision nodes

This page explains how to use PhysX geometry-cache meches for streaming sectors collision nodes

Concepts

The purpose of this tutorial is to allow for simpler world editing by reusing an existing collider that's already cached in the current vanilla streaming sector, rather than attempting to create and import a new collider.

Requirements

Knowledge

  • Basic understanding of:

    • How to work with WolvenKit, RedHotTools and World Builder

    • Data structures which are used in game world implementation, like .streamingsector

Step 1: Resolve PhysX mesh identifiers in the geometry cache

1

Enable Game Physics targeting mode in RedHotTools World Inspector.

2

Target the desired object in-game.

In World Inspector, note the streaming-sector file name and the node definition index within that sector.

3

Find and open the streaming-sector file in WolvenKit.

4

Find the node whose index matches step 1.2.

5

Locate the sectorHash field on that node.

You will enter this value into the World Builder collider Sector Hash parameter.

6

Open the sector preview tab in WolvenKit

find the node with the index from step 1.2 in the nodes tree.

7

Search for exact collider which represents object

Use the visibility toggle to find the tree entry (and its index in the name) for the actor that represents the collision of the targeted object.

8

Return to the sector data tab.

Under compiledData → Actors, open the actor whose index matches step 1.7. Expand Shapes, then the first item. The fields you need are Hash and ShapeType; use them for the World Builder collider parameters.

Step 2: Create the collider in World Builder

1

Spawn the desired mesh object and add a simple collider for it.

Important: the mesh object and the collider must be in the same group at the same hierarchy level.

2

Enabling PhysX mesh for collider

Select the collider, enable PhysX Mesh (the PhysX Mesh Settings section appears), and expand it.

With PhysX Mesh enabled, the simple collider shown in-game is only for editing; it is not exported. The PhysX mesh is what gets exported.

3

Set the PhysX mesh parameters

  • Target name: name of the object you are attaching the collider to

  • Sector hash: value of the sectorHash field from step 1.5

  • Actor Shape Hash: value of the Hash field from step 1.8

  • Actor Shape Type: value of the ShapeType field from step 1.8

PreviousCreating Prefabs with BlenderNextRemoving Objects

Last updated