Component:AvatarNameTagAssigner: Difference between revisions

From Resonite Wiki
→‎Usage: add field infos
get rid of stub tags
 
Line 2: Line 2:
<translate>
<translate>
<!--T:1-->
<!--T:1-->
{{stub}}
{{Infobox Component
{{Infobox Component
|Image=AvatarNameTagAssignerComponent.png
|Image=AvatarNameTagAssignerComponent.png
Line 35: Line 34:
</translate>
</translate>
[[Category:Components{{#translation:}}|Avatar Name Tag Assigner]]
[[Category:Components{{#translation:}}|Avatar Name Tag Assigner]]
[[Category:ComponentStubs]]
[[Category:Components:Users:Common Avatar System:Nameplate{{#translation:}}|Avatar Name Tag Assigner]]
[[Category:Components:Users:Common Avatar System:Nameplate{{#translation:}}|Avatar Name Tag Assigner]]

Latest revision as of 16:49, 15 October 2024

Component image 
AvatarNameTagAssigner component as seen in the Scene Inspector


The AvatarNameTagAssigner component is responsible for setting the nametag's text, color, and the ContactLink UserId. It basically defines what a nametag is.

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.
LabelTargets list of IField`1<String> A list of string fields that should be set to the user's display name when this component is under an avatar and the avatar is equipped.
UserIdTargets list of IField`1<String> A list of string fields that should be set to the user's UUID (aka UserID) when this component is under an avatar and the avatar is equipped.
ColorTargets list of IField`1<ColorX> A list of colorX fields that should be set to the user's special color when this component is under an avatar and the avatar is equipped. Supporters, Staff, Mentors, and Moderators are some of the many users that get custom name plate colors through this component.
OutlineTargets list of IField`1<ColorX> Similar to ColorTargets but for the outline.
BackgroundTargets list of IField`1<ColorX> Similar to ColorTargets but for the background color.
DequippedLabel String What text should display when the avatar this component belongs to is dequipped. You can be creative with this!

Behavior

When an avatar is dequipped the DequippedLabel contents will be written to the LabelTargets, by default the DequippedLabel is "---".

Examples

By default a user's Name Badge will contain a AvatarNameTagAssigner connected to TextRenderer, TextUnlitMaterial, and a ContactLink. The user's username will be written to the TextRenderer, their default Name Badge colors will be written to the TextUnlitMaterial, and their UserId will be written to the ContactLink.

Not unassigning these fields located in this component will result in your hard work being overwritten when equipping the avatar. Please make sure that the parts that you want overridden is referenced here, else leave those parts blank to have them customized.

Related Components