Reference API Roblox

Engine API

Website

Related

Reference API Roblox

TextChatCommand

Represents a text chat command.

Memory categoryInstances

Member index 5

HistoryMember
726AutocompleteVisible: bool
726Enabled: bool
514PrimaryAlias: string
514SecondaryAlias: string
514Triggered(originTextSource: TextSource, unfilteredText: string)
inherited from Instance
726Archivable: bool
726Capabilities: SecurityCapabilities
726IsInSandbox: bool
726Name: string
726Parent: Instance
726PredictionMode: PredictionMode
726Sandboxed: bool
726UniqueId: 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
707GetDescendants(): Instances
486GetFullName(): string
706GetStyled(name: string, selector: string?): Variant
657GetStyledPropertyChangedSignal(property: string): RBXScriptSignal
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
664IsPropertyModified(property: string): bool
698QueryDescendants(selector: string): Instances
573Remove(): null
576RemoveTag(tag: string): null
664ResetPropertyToDefault(property: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
726children(): Instances
726clone(): Instance
726destroy(): null
726findFirstChild(name: string, recursive: bool = false): Instance
726getChildren(): Instances
726isDescendantOf(ancestor: Instance): bool
726remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
657StyledPropertiesChanged()
726childAdded(child: Instance)
inherited from Object
726ClassName: string
726className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
726isA(className: string): bool
647Changed(property: string)

Description

Represents a text chat command. Can be used to create custom text chat commands when parented to TextChatService.

Custom commands can have up to two aliases, and the Triggered event fires when a user's message matches the value of either the PrimaryAlias or SecondaryAlias. For an example of custom commands, see Custom text chat commands.

To learn more about using TextChatService, see In-experience text chat.

History 10

Members 5

AutocompleteVisible

TypeDefault
bool
Thread safetyReadSafe
CategoryBehavior
Loaded/Savedtrue

History 2

Enabled

TypeDefault
bool

Determines whether the TextChatCommand is enabled.

When disabled, messages that match the value of PrimaryAlias or SecondaryAlias are not sunk and is sent to other users.

Use this to disable default commands on a case-by-case basis.

Thread safetyReadSafe
CategoryBehavior
Loaded/Savedtrue

History 3

PrimaryAlias

TypeDefault
string

A primary alias used to trigger the TextChatCommand.

If a user sends a message with TextChannel:SendAsync() that matches the PrimaryAlias, the message is not sent and instead TextChatCommand.Triggered is fired.

Thread safetyReadSafe
CategoryBehavior
Loaded/Savedtrue

History 1

SecondaryAlias

TypeDefault
string

A secondary alias used to trigger the TextChatCommand.

Thread safetyReadSafe
CategoryBehavior
Loaded/Savedtrue

History 1

Triggered

Parameters (2)
originTextSourceTextSource
unfilteredTextstring

An event that developers can bind to execute commands.

When a user sends a message to the server via TextChannel:SendAsync(), the message is intercepted by the TextChatCommand and not replicated to other users if the content of the message matches the PrimaryAlias or SecondaryAlias.

For example, for a TextChatCommand with TextChatCommand.PrimaryAlias as "mute", if a user sends "/mute SomeUserName", then the relevant TextChatCommand for mute will fire its TextChatCommand.Triggered. The message "/mute SomeUserName" is not replicated to other users.

Thread safetyUnsafe

History 1

Settings