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 11

HistoryMember
587BubbleChatMessageProperties: BubbleChatMessageProperties
644ChatWindowMessageProperties: ChatWindowMessageProperties
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
553Name: string
553Parent: Instance
635Sandboxed: bool
616UniqueId: UniqueId
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
648GetChildren(): Instances
462GetDebugId(scopeLength: int = 4): string
486GetDescendants(): Array
486GetFullName(): string
641GetStyled(name: string): Variant
576GetTags(): Array
576HasTag(tag: 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
648children(): Instances
553clone(): Instance
573destroy(): null
553findFirstChild(name: string, recursive: bool = false): Instance
648getChildren(): Instances
553isDescendantOf(ancestor: Instance): bool
573remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
553childAdded(child: Instance)
inherited from Object
647ClassName: string
647className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
650isA(className: string): bool
647Changed(property: string)

Description

Immutable data object representing a text chat message.

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

History 15

Members 11

BubbleChatMessageProperties

TypeDefault
BubbleChatMessageProperties
Thread safetyReadSafe
CategoryData
Loaded/Savedtrue

History 1

ChatWindowMessageProperties

TypeDefault
ChatWindowMessageProperties
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