Skip to content
Roblox API Reference

TextChatService

A service handling in-experience text chat.
  • Not creatable
  • Service
Memory category
Instances
Own members
66
Inherited members
75
Subclasses
0
Siblings
608

Properties32

Inherited fromObject2

Property categoryData

Inherited fromInstance21

Property categoryBehavior

Property categoryData

Property categoryPermissions

Defined byTextChatService9

Property categoryData

  • TextChatService.ChatTranslationEnabled: boolean = true
    Determines whether a user has chat translation enabled.
    • Not replicated
    • Write: Roblox script security
    • Read capabilities: Chat
  • TextChatService.ChatTranslationFTUXShown: boolean = false
    • Hidden
    • Not replicated
    • Roblox script security
    • Read capabilities: Chat
  • TextChatService.ChatTranslationToggleEnabled: boolean = false
    • Hidden
    • Not replicated
    • Roblox script security
    • Read capabilities: Chat
  • Determines whether to fully enable TextChatService or revert to the legacy chat system.
    • Write: Roblox script security
    • Read capabilities: Chat
  • TextChatService.CreateDefaultCommands: boolean = true
    Determines whether TextChatService should create default TextChatCommands.
    • Write: Plugin security
    • Read capabilities: Chat
  • TextChatService.CreateDefaultTextChannels: boolean = true
    Determines whether TextChatService should create default TextChannels.
    • Write: Plugin security
    • Read capabilities: Chat
  • TextChatService.HasSeenDeprecationDialog: boolean = false
    • Hidden
    • Not replicated
    • Roblox script security
    • Read capabilities: Chat
  • TextChatService.IsLegacyChatDisabled: boolean = false
    • Hidden
    • Roblox script security
    • Read capabilities: Chat
  • TextChatService.PlatformIntegratedChat: Enum.RolloutState = Enum.RolloutState.Default
    Determines whether platform-integrated chat is enabled for the experience. Requires RobloxScript security.
    • Roblox script security
    • Read capabilities: Chat

Methods66

Inherited fromObject3
  • Get an event that fires when a given property of the object changes.
    Parameters
    ParameterDescription
    property: string
    The property to connect to.
    Returns
    TypeDescription
    RBXScriptSignal
    A signal that fires whenever the property changes.
  • Object:IsA(className: string): boolean
    Returns true if an object's class matches or inherits from a given class.
    • Custom Lua state
    • Thread safe
    Parameters
    ParameterDescription
    className: string
    The class against which the Object's class will be checked. Case-sensitive.
    Returns
    TypeDescription
    boolean
    Describes whether the Object's class matched or is a subclass of the given class.
  • Object:isA(className: string): boolean
    Deprecated: This deprecated function is a variant of Object:IsA() which should be used instead.
    • Deprecated
    • Custom Lua state
    Parameters
    Parameter
    className: string
    Returns
    Type
    boolean

    Use IsA instead.

Inherited fromInstance39
Defined byTextChatService24
  • TextChatService:CanUserChatAsync(userId: User): boolean
    Determines whether a user has permission to chat in experiences.
    • Yields
    • Capabilities: Chat
    Parameters
    ParameterDescription
    userId: User
    The Player.UserId of the user whose chat permission is being checked.
    Returns
    TypeDescription
    boolean
    A boolean indicating whether the user has permission to chat.
  • TextChatService:CanUsersChatAsync(userIdFrom: User, userIdTo: User): boolean
    Determines whether or not two users can receive messages from each other.
    • Yields
    • Capabilities: Chat
    Parameters
    ParameterDescription
    userIdFrom: User
    The Player.UserId of the potential message sender.
    userIdTo: User
    The Player.UserId of the potential message receiver.
    Returns
    TypeDescription
    boolean
    A boolean indicating whether the two users can exchange messages.
  • TextChatService:CanUsersDirectChatAsync(requesterUserId: User,userIds: { any },): { any }
    Determines whether a user has permission to chat directly with other users in experiences based on factors such as their parental control settings.
    • Yields
    • Capabilities: Chat
    Parameters
    ParameterDescription
    requesterUserId: User
    The user who would have initiated the direct chat request. If the user is not in the current server, this method will error.
    userIds: { any }
    A list of users who the requesterUserId would like to chat with directly. Users not in the current server are ignored.
    Returns
    TypeDescription
    { any }
    A list of users who could participate in the direct chat request. If none of the users can direct chat with the requesterUserId, the result is an empty array.
  • TextChatService:CanUsersWhisperAsync(fromUserId: User, toUserId: User): boolean
    • Yields
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    fromUserId: User
    toUserId: User
    Returns
    Type
    boolean
  • TextChatService:ChatIsLoaded()
    • Roblox script security
    • Capabilities: Chat
  • TextChatService:DisplayBubble(partOrCharacter: Instance, message: string)
    Displays a chat bubble above the provided part or player character.
    • Capabilities: Chat
    Parameters
    ParameterDescription
    partOrCharacter: Instance
    The part or character that the bubble to be displayed above.
    message: string
    The text to be displayed in the chat bubble.
  • TextChatService:GetChatableUserCountAsync(userId: User, context: string): number
    • Yields
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    userId: User
    context: string
    Returns
    Type
    number
  • TextChatService:GetChatGroupsAsync(players: { Instance }): { any }
    Returns chat group IDs that indicate which players can synchronously text chat together.
    • Yields
    • Capabilities: Chat
    Parameters
    ParameterDescription
    players: { Instance }
    A list of Players currently in the experience to evaluate for text chat compatibility.
    Returns
    TypeDescription
    { any }
    A sorted array of arrays of chat group ID strings. Players who share a matching chat group ID are eligible to synchronously text chat with each other.
  • TextChatService:GetPresetsAsync(): { [string]: any }
    • Yields
    • Roblox script security
    • Capabilities: Chat
  • TextChatService:GetTextChannelWindows(): { any }
    • Roblox script security
    • Capabilities: Chat
    Returns
    Type
    { any }
  • TextChatService:HasAllocatedUniverseChatContext(context: string): boolean
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    context: string
    Returns
    Type
    boolean
  • TextChatService:IsProtectedChatEnabled(): boolean
    • Roblox script security
    • Capabilities: Chat
    Returns
    Type
    boolean
  • TextChatService:OnUserChatSettingUpdateAsync(featureName: string,featureValue: string,): boolean
    • Yields
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    featureName: string
    featureValue: string
    Returns
    Type
    boolean
  • TextChatService:SendDictatedSpeechUniverseChatAsync(text: string): TextChatMessage
    • Yields
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    text: string
    Returns
    Type
    TextChatMessage
  • TextChatService:SendEnableChatButtonClicked()
    • Roblox script security
    • Capabilities: Chat
  • TextChatService:SendEnableChatButtonShown()
    • Roblox script security
    • Capabilities: Chat
  • TextChatService:SendExpChatLoadSuccess(loadingLatency: number,extras: { [string]: any }?,chatWindowType: string? = "",textChannelWindowName: string? = "",)
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    loadingLatency: number
    extras: { [string]: any }?
    chatWindowType: string? = ""
    textChannelWindowName: string? = ""
  • TextChatService:SendExpChatMessageClientRendered(textChatMessage: TextChatMessage,messageRenderedSurface: string? = "unknown",selectedChannelTab: number? = -1,textChannelWindowName: string? = "",specialEffects: { any }? = {},)
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    textChatMessage: TextChatMessage
    messageRenderedSurface: string? = "unknown"
    selectedChannelTab: number? = -1
    textChannelWindowName: string? = ""
    specialEffects: { any }? = {}
  • TextChatService:SendExpChatWindowScroll(chatWindowType: string? = "",textChannelWindowName: string? = "",)
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    chatWindowType: string? = ""
    textChannelWindowName: string? = ""
  • TextChatService:SendExpChatWindowStatusChange(timeClosed: number,timeOpen: number,timeBackgroundIdle: number,timeTextIdle: number,chatWindowType: string? = "",textChannelWindowName: string? = "",)
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    timeClosed: number
    timeOpen: number
    timeBackgroundIdle: number
    timeTextIdle: number
    chatWindowType: string? = ""
    textChannelWindowName: string? = ""
  • TextChatService:SendTextChatCommandClientSent(textChatCommandName: string,chatWindowType: string? = "",textChannelWindowName: string? = "",)
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    textChatCommandName: string
    chatWindowType: string? = ""
    textChannelWindowName: string? = ""
  • TextChatService:SendUniverseChatMessageAsync(text: string,metadata: string,): TextChatMessage
    • Yields
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    text: string
    metadata: string
    Returns
    Type
    TextChatMessage
  • TextChatService:SendUniverseChatPresetAsync(presetId: string): TextChatMessage
    • Yields
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    presetId: string
    Returns
    Type
    TextChatMessage
  • TextChatService:setModerationModeEnabled(userId: number,enabled: boolean,): boolean
    • Roblox script security
    • Capabilities: Chat
    Parameters
    Parameter
    userId: number
    enabled: boolean
    Returns
    Type
    boolean

Events40

Inherited fromObject1
Inherited fromInstance9
Defined byTextChatService30

Callbacks3

Defined byTextChatService3