Component:ValueUserOverride

This article or section is a Stub. You can help the Resonite Wiki by expanding it.

Component image 

ValueUserOverride component as seen in the Scene Inspector

Intoduction

The ValueUserOverride Component allows for the driving of a value for each user listed in _overrides

Usage

Fields

Name	Type	Description
persistent	Bool	Determines whether or not this item will be saved to the server.
UpdateOrder	Int	Controls the order in which this component is updated.
Enabled	Bool	Controls whether or not this component is enabled.
Target	field drive of T	Target field of the specified type, that gets driven to the override value.
Default	T	The default value given to Target if no suitable override exists in _overrides
CreateOverrideOnWrite	Bool	Creates an entry in _overrides when Target is written back.
PersistentOverrides	Bool	Values in _overrides are stored with the object when it is saved
_overrides	direct SyncBag`1<Override<T>>	A list of Overrides and the corresponding users they apply to.

Behavior

The _overrides bag contains a list of users and their associated values - whenever the local user matches a user entry in the bag, the associated value is driven to Target. Otherwise, Target is driven to the value in Default

CreateOverrideOnWrite allows for new users and values to be added to the bag when the driven value in Target is directly or indirectly changed by that user. If it is not enabled, the value in Target is not changeable.

Attempting to write to or otherwise cause a discrete entry to a driven field is known as Hooking it. Any Hook to the Target value is intercepted by the ValueUserOverride Component and will change the modifying user's entry in the _overrides bag. If there is no entry for the user and if CreateOverrideOnWrite is enabled, it will create an entry using the set value.

Examples

• ValueUserOverride for Local World State by ProbablePrime