el4cteo/roblox-skills

roblox-text-chat

Chat and text safety - TextChatService (channels, SendAsync, ShouldDeliverCallback, OnIncomingMessage, commands, bubbles, custom UI, platform-integrated chat and TextChannelWindow migration due May 2027), mandatory TextService filtering of any player-author…

소스 보기

사용 방법

  1. 설치 명령을 복사하고 자신의 에이전트 환경에 설치하기 전에 소스 패키지를 확인하세요.
  2. 필요한 도구, 인증 정보, 지원 환경은 원본 문서에서 확인하세요.
  3. 입력과 원하는 산출물을 설명하고 출처와 결과를 대조하세요.
npx skills add https://github.com/el4cteo/roblox-skills --skill roblox-text-chat

시작 전 확인

  • 설치에는 모델 구독, API 한도, 파일 접근 권한이 포함되지 않습니다.
  • 별점 수와 설치 수는 활동 지표이며 독립적인 품질·보안 검증이 아닙니다.
원본 Skill 문서

원본 저장소의 제목, 예시, 코드, 표, 링크, 이미지를 유지해 표시합니다.

Chat and text safety

Non-negotiable rules (Roblox Community Standards)

  1. Player-to-player conversation must go through TextChatService TextChannels (handles filtering,

privacy/parental settings, and abuse reporting). The legacy Chat service/ChatService Lua modules are gone — TextChatService is the only chat system.

  1. Any text authored by one player and shown to another (pet names, signs, guild names, trade notes,

custom UI) must be filtered with TextService:FilterStringAsync on the server before display — and re-filtered when loaded from a DataStore later.

  1. Editable text others can see (signs, bulletin boards) needs a rate limit of at least 1 minute.
  2. Respect privacy settings with CanUserChatAsync/CanUsersChatAsync/CanUsersDirectChatAsync and mark

direct-message channels with TextChannel:SetDirectChatRequester().

Not chat (no filtering needed): your own UI text, game status messages, admin announcements you write.

Filtering player-authored text

luau
--!strict
local TextService = game:GetService("TextService")

-- Broadcast (e.g. a sign everyone sees). Returns nil if filtering failed: then show nothing.
local function filterForEveryone(text: string, fromUserId: number): string?
	local ok, result = pcall(function()
		local filterResult = TextService:FilterStringAsync(text, fromUserId, Enum.TextFilterContext.PublicChat)
		return filterResult:GetNonChatStringForBroadcastAsync()
	end)
	return if ok then result else nil
end

-- Per-recipient (respects each viewer's age/settings; e.g. a private note).
local function filterForUser(text: string, fromUserId: number, toUserId: number): string?
	local ok, result = pcall(function()
		local filterResult = TextService:FilterStringAsync(text, fromUserId, Enum.TextFilterContext.PrivateChat)
		return filterResult:GetNonChatStringForUserAsync(toUserId)
	end)
	return if ok then result else nil
end

return { forEveryone = filterForEveryone, forUser = filterForUser }
  • Filter on the server, after the player submits (not per keystroke); rate-limit and length-cap first.
  • On failure, fail closed (show nothing / a placeholder), never the raw text.
  • Store the raw text if you must, but always filter at display time (filters and viewer settings change).
  • Numbers-only or short strings can still be filtered (hashtags ###); design UI for that.

TextChatService essentials

  • Defaults: CreateDefaultTextChannels creates RBXGeneral and RBXSystem; CreateDefaultCommands

adds built-ins (/whisper, /team, /mute, ...). Configure look via ChatWindowConfiguration, ChatInputBarConfiguration, BubbleChatConfiguration (or disable and build your own UI with TextChannel:SendAsync and TextChatService.MessageReceived).

  • Flow: client TextChannel:SendAsync(text) → server TextChannel.ShouldDeliverCallback(message, textSource)

per recipient → filtering → clients' OnIncomingMessage callbacks → display.

  • Callbacks must not yield. ShouldDeliverCallback is server-only; TextChatService.OnIncomingMessage

and TextChannel.OnIncomingMessage are client-only (formatting).

  • System messages: channel:DisplaySystemMessage(text) on the client (local only).
  • Custom channels (team, party, proximity): create TextChannels under TextChatService on the server,

channel:AddUserAsync(userId) to add members; check the returned TextSource's CanSend.

luau
--!strict
-- Client: chat tags and colors via OnIncomingMessage (formatting only; never yields).
local Players = game:GetService("Players")
local TextChatService = game:GetService("TextChatService")

TextChatService.OnIncomingMessage = function(message: TextChatMessage)
	local properties = Instance.new("TextChatMessageProperties")
	local source = message.TextSource
	if source then
		local player = Players:GetPlayerByUserId(source.UserId)
		if player and player:GetAttribute("VIP") then
			properties.PrefixText = `<font color="#F5CD30">[VIP]</font> {message.PrefixText}`
		end
	end
	return properties
end
luau
--!strict
-- Server: a /spawn command, restricted to admins.
local Players = game:GetService("Players")
local TextChatService = game:GetService("TextChatService")

local ADMINS: { [number]: boolean } = { [123456] = true }

local command = Instance.new("TextChatCommand")
command.Name = "SpawnCommand"
command.PrimaryAlias = "/spawn"
command.Parent = TextChatService

command.Triggered:Connect(function(source: TextSource, unfilteredText: string)
	if not ADMINS[source.UserId] then
		return
	end
	local player = Players:GetPlayerByUserId(source.UserId)
	print(`{player and player.Name} ran: {unfilteredText}`)
end)

Platform-integrated chat (required May 2027)

Roblox is making chat native. Opt in to test now: select TextChatService in Studio and set PlatformIntegratedChat = Enabled (Studio only, not scriptable). When enabled:

  • Roblox renders all chat, in the default window or TextChannelWindows you place in UI (one per

TextChannel via Target; works in SurfaceGuis). Custom chat UIs can no longer render messages.

  • Message text is hidden from code: TextChatMessage.Text/Translation/PrefixText, OnIncomingMessage,

Player.Chatted, and TextChannel:SendAsync stop working (return "" + warning). No chat logging.

  • Commands must be TextChatCommands; preset phrases → Quick Words; chat tags/prefixes → role badges

(planned Feb 2027 — don't opt in yet if you rely on prefixes). DisplaySystemMessage and BubbleChatConfiguration/OnBubbleAdded styling still work.

  • New code: build on TextChatCommand, TextChannelWindow, and system messages; avoid reading message

text. The OnIncomingMessage tag example above only works until migration.

More: proximity chat, team channels, custom UI, and migrating from legacy chat: references/chat-recipes.md.

Quick Words (preset safe phrases for all ages, for coordinating where free chat is limited): add game-specific ones in Creator Hub → game → Configure → Chat → Quick Words — up to 3 categories of 3–10 phrases, in English (auto-translated), reviewed before going live. They replace the default categories; General stays.

PolicyService (per-user restrictions)

PolicyService:GetPolicyInfoForPlayerAsync(player) (server, pcall) returns flags such as ArePaidRandomItemsRestricted, IsPaidItemTradingAllowed, AreAdsAllowed, AllowedExternalLinkReferences, IsSubjectToChinaPolicies, IsContentSharingAllowed. Gate loot boxes, trading, ads, and links to social media (only show platforms listed in AllowedExternalLinkReferences) per player.

Related skills

roblox-security (rate limits, validation), roblox-ui (text input UI), roblox-monetization (paid random items), roblox-data-stores (storing user text).

같은 저장소의 Skills

더 많은 Skills

모든 Skills
el4cteo
커뮤니티

roblox-architecture

Roblox project structure and client/server model - replication, where code and assets belong (ServerScriptService, ReplicatedStorage, StarterPlayer), RunContext, service/controller bootstrapping, player/character lifecycle, CollectionService components, attributes, streaming-safe client code, library choices. Use when starting a project, deciding where code goes, or fixing replication/streaming bugs.

1시간 설치 수
5
GitHub Stars
131
업데이트
11월 17일
el4cteo
커뮤니티

roblox-audio

Sound and music - the Audio API (AudioPlayer, AudioEmitter, AudioListener, AudioDeviceOutput, Wire, effects, faders), classic Sound/SoundGroup, 2D vs 3D audio, music and SFX volume, client vs server playback, asset permissions, streaming caveats, voice routing, text-to-speech. Use when adding music, sound effects, spatial audio, mixing, or fixing sounds that don't play.

1시간 설치 수
5
GitHub Stars
131
업데이트
11월 17일
el4cteo
커뮤니티

roblox-characters-animation

Characters and animation - Humanoid properties/states, spawning (LoadCharacterAsync), health and damage, HumanoidDescription appearance, Animator/AnimationTrack playback, priorities and markers, default animation replacement, Tools, TweenService, IKControl, Character Controller Library (beta). Use when changing movement, abilities, damage, respawn, avatars, animations, tweens, or tools/weapons.

1시간 설치 수
5
GitHub Stars
131
업데이트
11월 17일
el4cteo
커뮤니티

roblox-code-review

Review Roblox/Luau code for exploits, data loss, memory leaks, performance problems, lifecycle bugs, policy issues, and deprecated or superseded APIs, using a severity-ranked checklist and the full 2026 deprecation map. Use when reviewing a PR or script, auditing a game before launch, modernizing legacy code, or asked what is wrong with some Roblox code.

1시간 설치 수
5
GitHub Stars
131
업데이트
11월 17일