Component:CommonAvatarBuilder: Difference between revisions

From Resonite Wiki
Automated: update Fields, Categories
add some info
 
Line 6: Line 6:
}}
}}


<!--T:2-->
Common Avatar Builder is a component that is part of every world that defines the spawning behavior and routines to do for all users when they spawn into a world. This can be used to add world settings menus, change what parts of a user get automatically set up, and so on.
== Intoduction ==
{{stub}}


<!--T:3-->
<!--T:3-->
== Usage ==
== Usage ==
{{Table ComponentFields
{{Table ComponentFields
|LoadCloudAvatars|Bool| {{stub}}
|LoadCloudAvatars|Bool| Whether to load the User's set avatar, or load the default avatar instead.
|CustomAvatarTemplates|{{RootFieldType|SyncList`1|[[#AvatarTemplate|AvatarTemplate]]}}|TypeAdv1=true| {{stub}}
|CustomAvatarTemplates|{{RootFieldType|SyncList`1|[[#AvatarTemplate|AvatarTemplate]]}}|TypeAdv1=true|  
|AutoInject|Slot| A slot that will automatically be duplicated and added as a child of an avatar when they join the world.
|AutoInject|Slot| A slot that will automatically be duplicated and added as a child of an avatar when they join the world. Certain components will use this to override user behavior when part of this slot's hierarchy, like [[Component:AvatarAudioConfig|Avatar Audio Config]] to name one.
|SetupNameBadges|Bool| {{stub}}
|SetupNameBadges|Bool| Whether to set up the user's default name badge when they spawn
|SetupIconBadges|Bool| {{stub}}
|SetupIconBadges|Bool| Whether to set up the user's default badges when they spawn.
|SetupServerVoice|Bool| {{stub}}
|SetupServerVoice|Bool|  
|SetupClientVoice|Bool| {{stub}}
|SetupClientVoice|Bool|  
|SetupServerTools|Bool| {{stub}}
|SetupServerTools|Bool|  
|SetupClientTools|Bool| {{stub}}
|SetupClientTools|Bool|  
|SetupLocomotion|Bool| {{stub}}
|SetupLocomotion|Bool| Whether to give the user the default locomotion modules when they spawn.
|AllowLocomotion|Bool| {{stub}}
|AllowLocomotion|Bool| Whether to allow the user to move using locomotion when they spawn.
|DefaultHostSilenced|Bool| {{stub}}
|DefaultHostSilenced|Bool| Whether the user should be default muted to the host when they spawn.
|DefaultClientSilenced|Bool| {{stub}}
|DefaultClientSilenced|Bool| Whether the user should be default muted on their end when they spawn.
|LocomotionModules|Slot| {{stub}}
|LocomotionModules|Slot| The slot full of locomotion modules that the user will have by default after they spawn.
|ForceDefaultLocomotionModule|ILocomotionModule| {{stub}}
|ForceDefaultLocomotionModule|ILocomotionModule| The locomotion to enable for the user by default when spawning rather than the one in that user's locomotion settings set in their dash.
|SyncActiveLocomotionModule|Bool| {{stub}}
|SyncActiveLocomotionModule|Bool|  
|SetupItemShelves|Bool| {{stub}}
|SetupItemShelves|Bool| Whether to add item shelves to the user when they spawn.
|ParentClientsToServer|Bool| {{stub}}
|ParentClientsToServer|Bool|  
|AlignTracking|Bool| {{stub}}
|AlignTracking|Bool|  
|EmptyAvatarSlotHandler|IEmptyAvatarSlotHandler| {{stub}}
|EmptyAvatarSlotHandler|IEmptyAvatarSlotHandler|
|FillEmptySlots|Bool| {{stub}}
|FillEmptySlots|Bool| Whether to fill empty AvatarObjectSlots with default head and hand objects if they are missing on their loaded avatar.
}}
}}


<!--T:4-->
<!--T:4-->
== Behavior ==
== Behavior ==
{{stub}}
This component gets read and executed every time a user respawns or joins into a world.


<!--T:5-->
<!--T:5-->
== Examples ==
== Examples ==
{{stub}}
Found under [[Root]] in every world, and is used to control user spawning.


[[Category:ComponentStubs]]
[[Category:ComponentStubs]]

Latest revision as of 18:54, 29 October 2024


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


Component image 
CommonAvatarBuilder component as seen in the Scene Inspector


Common Avatar Builder is a component that is part of every world that defines the spawning behavior and routines to do for all users when they spawn into a world. This can be used to add world settings menus, change what parts of a user get automatically set up, and so on.

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.
LoadCloudAvatars Bool Whether to load the User's set avatar, or load the default avatar instead.
CustomAvatarTemplates list of AvatarTemplate
AutoInject Slot A slot that will automatically be duplicated and added as a child of an avatar when they join the world. Certain components will use this to override user behavior when part of this slot's hierarchy, like Avatar Audio Config to name one.
SetupNameBadges Bool Whether to set up the user's default name badge when they spawn
SetupIconBadges Bool Whether to set up the user's default badges when they spawn.
SetupServerVoice Bool
SetupClientVoice Bool
SetupServerTools Bool
SetupClientTools Bool
SetupLocomotion Bool Whether to give the user the default locomotion modules when they spawn.
AllowLocomotion Bool Whether to allow the user to move using locomotion when they spawn.
DefaultHostSilenced Bool Whether the user should be default muted to the host when they spawn.
DefaultClientSilenced Bool Whether the user should be default muted on their end when they spawn.
LocomotionModules Slot The slot full of locomotion modules that the user will have by default after they spawn.
ForceDefaultLocomotionModule ILocomotionModule The locomotion to enable for the user by default when spawning rather than the one in that user's locomotion settings set in their dash.
SyncActiveLocomotionModule Bool
SetupItemShelves Bool Whether to add item shelves to the user when they spawn.
ParentClientsToServer Bool
AlignTracking Bool
EmptyAvatarSlotHandler IEmptyAvatarSlotHandler
FillEmptySlots Bool Whether to fill empty AvatarObjectSlots with default head and hand objects if they are missing on their loaded avatar.

Behavior

This component gets read and executed every time a user respawns or joins into a world.

Examples

Found under Root in every world, and is used to control user spawning.