Component:ColliderUserTracker: Difference between revisions

From Resonite Wiki
Slight grammar change and a usage addition for its most common usage pattern
fix up page, remove from component stubs
 
Line 1: Line 1:
<!--T:1-->
<!--T:1-->
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=ColliderUserTrackerComponent.png
|Image=ColliderUserTrackerComponent.png
Line 6: Line 5:
}}
}}


The '''ColliderUserTracker''' keeps track of users who enter and leave a collider. It must be used on a Slot that also has an attached Collider whose type is set to "Trigger".
The '''ColliderUserTracker''' keeps track of users who enter and leave a collider. It must be used on a Slot that also has an attached Collider whose type is set to "Trigger", unless <code>TriggersOnly</code> is set to false.


As this component works on colliders, it cannot detect users in No-Clip.
As this component works using colliders, it cannot detect users in No-Clip.


<!--T:2-->
<!--T:2-->
== Fields ==
== Fields ==
{{Table ComponentFields
{{Table ComponentFields
|TriggersOnly|Bool|
|TriggersOnly|Bool| Whether to only allow use of Triggers or not.
|IsLocalUserInside|{{RootFieldType|RawOutput`1|[[Type:Bool|Bool]]}}|TypeAdv1=true| Becomes set for the local user if the local user is within the collider of the object that this component is attached to.
|IsLocalUserInside|{{RootFieldType|RawOutput`1|[[Type:Bool|Bool]]}}|TypeAdv1=true| Becomes set for the local user if the local user is within the collider of the object that this component is attached to.
|IsAnyUserInside|{{RootFieldType|RawOutput`1|[[Type:Bool|Bool]]}}|TypeAdv2=true| Becomes set for all users if any user is within the collider of the object that this component is attached to.
|IsAnyUserInside|{{RootFieldType|RawOutput`1|[[Type:Bool|Bool]]}}|TypeAdv2=true| Becomes set for all users if any user is within the collider of the object that this component is attached to.
Line 22: Line 21:
<!--T:3-->
<!--T:3-->
== Usage ==
== Usage ==
{{stub}}
Attach this component to a slot, and add a [[Colliders|Collider]] to the slot. The component will then start functioning as long as the Collider is a trigger or as long as <code>TriggersOnly</code> is set to false.
 
<!--T:4-->This component can be very useful in defining zones in a world for various features, the most common of which is using the IsLocalUserInside bool to drive the Enabled state on various slots to work as a culling system.


<!--T:4-->
== Examples ==
== Examples ==
{{stub}}
This component can be very useful in defining zones in a world for various features, the most common of which is using the <code>IsLocalUserInside</code> to drive the Enabled state on various slots to work as a culling system.


[[Category:ComponentStubs]]
[[Category:Components:Physics:Utility{{#translation:}}|Collider User Tracker]]
[[Category:Components:Physics:Utility{{#translation:}}|Collider User Tracker]]
[[Category:Components{{#translation:}}|Collider User Tracker]]
[[Category:Components{{#translation:}}|Collider User Tracker]]

Latest revision as of 17:16, 16 October 2024

Component image 
Collider User Tracker component as seen in the Scene Inspector


The ColliderUserTracker keeps track of users who enter and leave a collider. It must be used on a Slot that also has an attached Collider whose type is set to "Trigger", unless TriggersOnly is set to false.

As this component works using colliders, it cannot detect users in No-Clip.

Fields

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.
TriggersOnly Bool Whether to only allow use of Triggers or not.
IsLocalUserInside raw output of Bool Becomes set for the local user if the local user is within the collider of the object that this component is attached to.
IsAnyUserInside raw output of Bool Becomes set for all users if any user is within the collider of the object that this component is attached to.
NumberOfUsersInside raw output of Int Tracks the number of users inside the collider of the object that this component is attached to.
_usersInside direct SyncBag`1<UserRef> Data on the users that are inside the collider of the object that this component is attached to.

Usage

Attach this component to a slot, and add a Collider to the slot. The component will then start functioning as long as the Collider is a trigger or as long as TriggersOnly is set to false.

Examples

This component can be very useful in defining zones in a world for various features, the most common of which is using the IsLocalUserInside to drive the Enabled state on various slots to work as a culling system.