Switching between sector states

How to use streamingSectorPrefabVariant

This page contains the theory of sector variants, for creating sectors with variants, head over to the Creating Sector Variants guide

Summary

Published: Jan 07 2025 by Sergey Last documented edit: Jan 08 2025 by manavortex

This page will show you how to switch sector states.

Wait, this is not what I want!

• To learn more about .streamingsector files, check The whole world: .streamingsector

• To learn about .streamingblocks, check .streamingBlock: Sector definitions and -variants

• For a list of node types, check Reference: .streamingsector node types

• check World Editing -> Archived: Merging World Additions via ArchiveXL if that's what you'd rather do

World state variants

Here is an overview of file relations between .streamingsector and -block:

Streamingblock

The game contains only 3 streamingblocks that gather more than 26300 sectors. We will focus on the main one and take a look at the first sector inside (exterior_-18_3_-12_0).

When creating a mod with sectors, you will need to create your own block that will list your new sectors.

This sector has 10 variants, in this case, each one is related to a quest state.

numNodeRanges indicate the number of node ranges the sector contains; it always corresponds to the number of variant + sector's default range (so here 10 variants + 1 default).

When opening a variant definition, we can find the range index (to find the right range inside the sector file). rangeIndex cannot be 0, 0 is used as sector's default range.

Variant's name is only used to identify the variant within the streamingblock.

The link between quests and sectors' variants is not well-researched as of Jan 2024 - if you know anything more about this, please get in touch via Discord or update the wiki!

Defining a new variant

In the .streamingsector file, add a new entry in each of these lists:

• variantIndices

• variantNodes

How to trigger a switch

To trigger a switch between sector states, you can use

• .questphase files

• Codeware via redscript/CET