Skip to content

Settings Reference

This page documents all configurable settings in ProStream, organized by their location in the Settings Panel.

Opening the Settings Panel

Click the settings icon in the ProStream Editor toolbar, or access via individual panel headers.

Settings Panel Tabs

The Settings Panel contains multiple tabs for organizing settings:

TabPanelDescription
Search/MatchObjectMatchingPanelValidation and search query settings
Scene/SetupSceneSetupPanelScene configuration and SubScene settings

Search/Match Tab (ObjectMatchingPanel)

Settings related to the matching process and search queries.

Matching Settings

SettingDefaultDescription
Check for basic issuesOffCheck GameObjects for common DOTS compatibility issues during the matching process (e.g., empty MeshRenderers, missing Materials). Runs during Calculate Positions.
Check for advanced issuesOffCheck GameObjects for advanced DOTS compatibility issues (e.g., incompatible Shaders, LOD issues). More intensive but helps prevent conversion/runtime errors.

TIP

See Validation & Diagnostics for detailed information on what each validation level checks.

Search Keyword Settings

These settings affect how MatchBySearchQuery rules match object names.

SettingDefaultDescription
Use keyword separationOffWhen enabled, adds separator characters around search terms to reduce false matches from fuzzy matching.
Keyword separator_The character used to separate keywords when keyword separation is enabled.

Example:

Without keyword separation:

  • Search for Tree matches: Environment_Tree_01 and City_Street_01 (false positive)

With keyword separation (separator = _):

  • Search for Tree becomes _Tree_
  • Matches: Environment_Tree_01 but NOT City_Street_01

Scene/Setup Tab (SceneSetupPanel)

Settings related to scene configuration, SubScene creation, and streaming behavior.

SubScene Settings

SettingDefaultDescription
Auto-save scenesOnAutomatically save scenes after major operations (Calculate Positions, Create SubScenes)
SubScene directorySubScene_AssetsRoot directory for SubScene files
Entity subdirectoryEntitySubdirectory within SubScene folder for entity scenes

Streaming Settings

SettingDefaultDescription
Hysteresis buffer10.0Distance buffer (in meters) added to unload threshold to prevent rapid load/unload cycles
Update frequencyEvery FrameHow often streaming system checks distances
Enable debug visualizationOffShow gizmos for streaming boundaries in Scene view

Performance Settings

SettingDefaultDescription
Max concurrent loads4Maximum number of SubScenes that can load simultaneously
Load priorityDistanceHow to prioritize loading (Distance, Manual, etc.)
Async loadingOnLoad SubScenes asynchronously to avoid frame drops

QuadTree Settings

SettingDefaultDescription
Grid sizeAutoSize of QuadTree grid (Auto, 4x4, 8x8, 16x16, 32x32)
Cell sizeAutoSize of individual cells in meters (Auto or manual)
Bounds padding10.0Extra padding around scene bounds for QuadTree calculation

Layer Configuration

Layer-specific settings are configured in the Layer Editor, not the Settings Panel.

Access: SceneConnector Inspector → Layer Editor button

Per-Layer Settings:

  • Load distance (meters)
  • Persistent (always loaded)
  • Enabled/disabled
  • Section index

See Streaming Layers for details.

Rule Configuration

Rule-specific settings are configured in the Rule Editor.

Access: ProStream Editor → Scene Match RulesRule Editor

Per-Rule Settings:

  • Enabled/disabled
  • Priority (execution order)
  • Target layer
  • Rule-specific parameters

See Rule Engine for details.

Modification Configuration

Modification-specific settings are configured on individual modification assets.

Access: Select modification asset in Project window

Per-Modification Settings:

  • Enabled/disabled
  • Execution placement
  • Execution order
  • Modification-specific parameters

See Modification Engine for details.

Advanced Settings

Debug Settings

SettingDefaultDescription
Verbose loggingOffEnable detailed console logging for debugging
Log timingOffLog execution time for major operations
Log rule matchesOffLog each object matched by rules

Experimental Settings

WARNING

Experimental settings may change or be removed in future versions. Use with caution.

SettingDefaultDescription
Parallel processingOffUse parallel processing for rule matching (experimental)
GPU cullingOffUse GPU-based frustum culling (experimental)

Resetting Settings

To reset all settings to defaults:

  1. Open Settings Panel
  2. Click Reset to Defaults button at bottom
  3. Confirm the action

DANGER

This will reset ALL ProStream settings. This action cannot be undone.

Settings Storage

ProStream settings are stored in:

  • Project Settings: ProjectSettings/ProStreamSettings.asset
  • Scene Settings: SceneName/SceneData/SceneName_Settings.asset

See Also

ProStream - High-performance scene streaming for Unity