Component:AvatarNameTagAssigner: Difference between revisions

From Resonite Wiki
Style. Added warning note. Added link.
→‎Usage: add field infos
Line 14: Line 14:
== Usage ==
== Usage ==
{{Table ComponentFields
{{Table ComponentFields
|LabelTargets|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]<[[Type:String|String]]>}}|TypeAdv0=true|
|LabelTargets|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]<[[Type:String|String]]>}}|TypeAdv0=true| 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|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]<[[Type:String|String]]>}}|TypeAdv1=true|
|UserIdTargets|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]<[[Type:String|String]]>}}|TypeAdv1=true| 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|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]<[[Type:ColorX|ColorX]]>}}|TypeAdv2=true|
|ColorTargets|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]<[[Type:ColorX|ColorX]]>}}|TypeAdv2=true| 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|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]<[[Type:ColorX|ColorX]]>}}|TypeAdv3=true|
|OutlineTargets|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]&lt;[[Type:ColorX|ColorX]]&gt;}}|TypeAdv3=true| Similar to <code>ColorTargets</code> but for the outline.
|BackgroundTargets|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]&lt;[[Type:ColorX|ColorX]]&gt;}}|TypeAdv4=true|
|BackgroundTargets|{{RootFieldType|SyncRefList`1|[[Type:IField`1|IField`1]]&lt;[[Type:ColorX|ColorX]]&gt;}}|TypeAdv4=true| Similar to <code>ColorTargets</code> but for the background color.
|DequippedLabel|String|
|DequippedLabel|String|What text should display when the avatar this component belongs to is dequipped. You can be creative with this!
}}
}}


<!--T:4-->
== Behavior ==
== Behavior ==
When an avatar is dequipped the DequippedLabel contents will be written to the LabelTargets, by default the DequippedLabel is "---".
When an avatar is dequipped the DequippedLabel contents will be written to the LabelTargets, by default the DequippedLabel is "---".

Revision as of 16:49, 15 October 2024


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


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