Reference API Roblox

Engine API

Website

Related

Reference API Roblox

TextChatMessage

Immutable data object representing a text chat message.

This class is not creatable. Instances of this class cannot be created with Instance.new.
Memory categoryInstances
Tags: [NotCreatable]

Member index 10

HistoryMember
587BubbleChatMessageProperties: BubbleChatMessageProperties
514MessageId: string
513Metadata: string
513PrefixText: string
513Status: TextChatMessageStatus
513Text: string
553TextChannel: TextChannel
553TextSource: TextSource
553Timestamp: DateTime
595Translation: string
inherited from Instance
553Archivable: bool
635Capabilities: SecurityCapabilities
553ClassName: string
553Name: string
553Parent: Instance
635Sandboxed: bool
616UniqueId: UniqueId
553className: string
576AddTag(tag: string): null
573ClearAllChildren(): null
462Clone(): Instance
573Destroy(): null
486FindFirstAncestor(name: string): Instance
486FindFirstAncestorOfClass(className: string): Instance
486FindFirstAncestorWhichIsA(className: string): Instance
486FindFirstChild(name: string, recursive: bool = false): Instance
486FindFirstChildOfClass(className: string): Instance
486FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486FindFirstDescendant(name: string): Instance
563GetActor(): Actor
486GetAttribute(attribute: string): Variant
462GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631GetAttributes(): Dictionary
486GetChildren(): Objects
462GetDebugId(scopeLength: int = 4): string
486GetDescendants(): Array
486GetFullName(): string
462GetPropertyChangedSignal(property: string): RBXScriptSignal
641GetStyled(name: string): Variant
576GetTags(): Array
576HasTag(tag: string): bool
486IsA(className: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
580IsPropertyModified(name: string): bool
573Remove(): null
576RemoveTag(tag: string): null
580ResetPropertyToDefault(name: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
553children(): Objects
553clone(): Instance
573destroy(): null
553findFirstChild(name: string, recursive: bool = false): Instance
553getChildren(): Objects
462isA(className: string): bool
553isDescendantOf(ancestor: Instance): bool
573remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462Changed(property: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
553childAdded(child: Instance)

Description

Immutable data object representing a text chat message.

To learn more about using TextChatMessages, see In-Experience Text Chat.

History 14

Members 10

BubbleChatMessageProperties

TypeDefault
BubbleChatMessageProperties
Thread safetyReadSafe
CategoryData
Loaded/Savedtrue

History 1

MessageId

TypeDefault
string

A unique identifier for the TextChatMessage.

Thread safetyReadSafe
CategoryData
Loaded/Savedfalse

History 1

Metadata

TypeDefault
string

A general purpose field for storing miscellaneous data about the TextChatMessage. The second argument of TextChannel:SendAsync() and TextChannel:DisplaySystemMessage() is used to populate this field.

If TextChatService.CreateDefaultTextChannels is true, default system messages sent to the system channel have unique TextChatMessage.Metadata values.

Use this field to apply additional formatting for special messages within TextChatService.OnIncomingMessage and TextChannel.OnIncomingMessage callbacks.

Thread safetyReadSafe
CategoryData
Loaded/Savedfalse

History 1

PrefixText

TypeDefault
string

A prefix to add to a user's message. This supports Rich Text, so developers can set custom properties for this text to support chat tags.

By default, TextChatMessage.PrefixText is the name of the TextSource, which is the Player.DisplayName of the user associated with the TextSource via TextSource.UserId.

Thread safetyReadSafe
CategoryData
Loaded/Savedfalse

History 1

Status

TypeDefault
TextChatMessageStatus

Indicates the status of the TextChatMessage.

Thread safetyReadSafe
CategoryData
Loaded/Savedfalse

History 1

Text

TypeDefault
string

The filtered text message for the user. Different users may receive different strings from this property based on filtering rules. It can be an empty string.

Thread safetyReadSafe
CategoryData
Loaded/Savedfalse

History 1

TextChannel

TypeDefault
TextChannel

A reference to the origin TextChannel.

Thread safetyReadSafe
CategoryData
Loaded/Savedtrue

History 2

TextSource

TypeDefault
TextSource

A reference to the origin TextSource.

Thread safetyReadSafe
CategoryData
Loaded/Savedtrue

History 2

Timestamp

TypeDefault
DateTime

A timestamp of when the message was originally sent.

Thread safetyReadSafe
CategoryData
Loaded/Savedfalse

History 2

Translation

TypeDefault
string

Represents translated and filtered text messages based on users' localization settings. The system doesn't translate messages between users with the same localization settings or using languages without the text filter support, so this property can be an empty string if no translation happens. For customization, see Customizing Translated Messages.

Thread safetyReadSafe
CategoryData
Loaded/Savedfalse

History 1

Settings