Manni at 09:18, 24 January 2026

2026-01-24T09:18:27Z

Manni: Created page with "{{Quicklinks|InterestManagement}} '''InterestManagement''' is a subsystem in OpenSimulator (OpenSim) that manages the prioritization and control of updates for [[Avatar]..."

2026-01-24T09:15:26Z

Created page with "{{Quicklinks|InterestManagement}} '''InterestManagement''' is a subsystem in OpenSimulator (OpenSim) that manages the prioritization and control of updates for [[Avatar]..."

New page

{{Quicklinks|InterestManagement}}

'''InterestManagement''' is a subsystem in [[OpenSimulator]] (OpenSim) that manages the prioritization and control of updates for [[Avatar]]s and objects between the server and client. It is primarily configured via the <code>[InterestManagement]</code> section and serves to efficiently distribute [[bandwidth]] and [[CPU]] load.

== Configuration ==
InterestManagement settings are located in the <code>OpenSim.ini</code> or <code>OpenSimDefaults.ini</code> file. The following parameters are available in the <code>[InterestManagement]</code> section:

{| class="wikitable"
|-
! Parameter
! Description
! Values / Notes
|-
| <code>UpdatePrioritizationScheme</code>
| Sets the scheme for prioritizing updates.
| Possible values:
* <code>BestAvatarResponsiveness</code>
* <code>SimpleAngularDistance</code> (more CPU intensive)
|-
| <code>ReprioritizationEnabled</code>
| Enables regular re-prioritization of update priorities.
| <code>true</code> or <code>false</code>
|-
| <code>ReprioritizationInterval</code>
| Time interval (in milliseconds) between re-prioritization runs.
| Number (in ms)
|-
| <code>RootReprioritizationDistance</code>
| Distance threshold for re-prioritizing root (main) avatars.
| Number (distance)
|-
| <code>ObjectsCullingByDistance</code>
| If enabled, object updates outside the view distance are not sent to the client.
| <code>true</code> or <code>false</code> – Saves bandwidth but increases CPU load.
|-
| <code>RootTerseUpdatePeriod</code>
| Only every nth compact ("terse") update is sent for avatars within the same region.
| Number (0 = always send)
|-
| <code>ChildTerseUpdatePeriod</code>
| Only every nth compact ("terse") update is sent for avatars in other regions (e.g., neighboring regions).
| Number (0 = always send)
|}

These options allow fine-tuning of how often and under what conditions clients are informed about state changes of objects and avatars.

== Implementation in Scene.cs ==
The core code for InterestManagement is located in the <code>Scene.cs</code> file. However, it does not evaluate the complete list of parameters documented in the INI file.

The following settings are actually read and used in <code>Scene.cs</code>:
* <code>UpdatePrioritizationScheme</code>
* <code>ReprioritizationEnabled</code>
* <code>ReprioritizationInterval</code>
* <code>RootReprioritizationDistance</code>
* <code>ObjectsCullingByDistance</code>

The following parameters, documented in the configuration file, are '''not''' evaluated in <code>Scene.cs</code> and have no direct effect there:
* <code>ChildReprioritizationDistance</code>
* <code>RootTerseUpdatePeriod</code>
* <code>ChildTerseUpdatePeriod</code>

Their influence on the system only exists if they are processed elsewhere in the OpenSimulator source code.

== Purpose and Function ==
The InterestManagement system filters and prioritizes data sent to clients. Its goal is to minimize network load and optimize server performance without significantly degrading the subjective user experience (e.g., avatar responsiveness). For example, <code>ObjectsCullingByDistance</code> ensures that invisible objects do not generate updates, while prioritization schemes determine which objects or avatars are updated first.

== See also ==
* [[OpenSimulator]]
* [[Configuration file]]
* [[Scene Graph]]

[[Category:OpenSimulator]]
[[Category:Networking]]
[[Category:Server technology]]

← Older revision		Revision as of 09:18, 24 January 2026
Line 1:		Line 1:
	{{Quicklinks\|InterestManagement}}		{{Quicklinks\|InterestManagement}}
−

	'''InterestManagement''' is a subsystem in [[OpenSimulator]] (OpenSim) that manages the prioritization and control of updates for [[Avatar]]s and objects between the server and client. It is primarily configured via the <code>[InterestManagement]</code> section and serves to efficiently distribute [[bandwidth]] and [[CPU]] load.		'''InterestManagement''' is a subsystem in [[OpenSimulator]] (OpenSim) that manages the prioritization and control of updates for [[Avatar]]s and objects between the server and client. It is primarily configured via the <code>[InterestManagement]</code> section and serves to efficiently distribute [[bandwidth]] and [[CPU]] load.

InterestManagement - Revision history

Manni at 09:18, 24 January 2026

Manni: Created page with "{{Quicklinks|InterestManagement}} '''InterestManagement''' is a subsystem in OpenSimulator (OpenSim) that manages the prioritization and control of updates for [[Avatar]..."