К основному содержанию
скилл CX Codex

roblox-text-chat — скилл для Claude Code: что делает и как установить

Скилл roblox-text-chat для Claude Code и Cursor, который настраивает TextChatService, фильтрацию текста и чат в Roblox. Включается при добавлении чата, команд или табличек с текстом игроков.

MIT 1 200 установок ★ 131 обновлён 2026-11-03

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add EL4CTEO/roblox-skills --skill roblox-text-chat -a claude-code
Открыть на GitHub

Что делает roblox-text-chat

Скилл автоматизирует работу с TextChatService в Roblox, настраивает каналы связи, обработку сообщений через OnIncomingMessage и создание кастомных команд. Модуль требует обязательной фильтрации любого текста игроков на сервере через TextService:FilterStringAsync и проверки настроек приватности через PolicyService. В коде учитывается миграция на платформенный чат, запланированная на май 2027 года.

Инструмент помогает соблюдать стандарты сообщества Roblox, настраивает ограничения частоты отправки сообщений для редактируемых табличек и выстраивает архитектуру команд через TextChatCommand. Применяется при разработке кастомных интерфейсов чата, команд администратора и систем отображения текста между игроками.

Какие задачи решает

  • настроить фильтрацию текста игроков на сервере
  • создать кастомную команду в TextChatService
  • подключить обработчик входящих сообщений
  • проверить настройки конфиденциальности PolicyService

Примеры запросов агенту

  • Добавь фильтрацию текста для таблички через TextService
  • Создай админ-команду через TextChatCommand
  • Настрой кастомный вид чата через TextChatService

Как установить roblox-text-chat

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/roblox-skills --skill roblox-text-chat -a claude-code

2Вручную: положить файлы

~/.claude/skills/roblox-text-chat/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/roblox-text-chat/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о roblox-text-chat

Как установить roblox-text-chat в Claude Code?

Выполните команду npx skills add EL4CTEO/roblox-skills --skill roblox-text-chat -a claude-code, затем обратитесь к файлу ~/.claude/skills/roblox-text-chat/SKILL.md.

Что делает roblox-text-chat?

Скилл помогает настраивать TextChatService, фильтровать сообщения игроков и проектировать систему чата под требования безопасности Roblox.

Что нужно для работы roblox-text-chat?

Для работы требуется игровая среда Roblox Studio с поддержкой TextChatService и серверные скрипты на Luau.

Исходный текст

SKILL.md · MIT
---
name: roblox-text-chat
description: 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-authored text, rate limits, privacy checks, PolicyService restrictions, legacy Chat migration. Use when adding chat features or commands, or any feature that shows one player's text to others (names, signs, notes).
---

# Chat and text safety

## Non-negotiable rules (Roblox Community Standards)

1. Player-to-player conversation must go through **TextChatService** `TextChannel`s (handles filtering,
   privacy/parental settings, and abuse reporting). The legacy `Chat` service/`ChatService` Lua modules
   are gone — `TextChatService` is the only chat system.
2. **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.
3. Editable text others can see (signs, bulletin boards) needs a rate limit of at least 1 minute.
4. 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 `TextChannel`s 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 `TextChannelWindow`s you place in UI (one per
  `TextChannel` via `Target`; works in `SurfaceGui`s). 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 `TextChatCommand`s; 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](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).

© EL4CTEO · MIT · EL4CTEO/roblox-skills

Похожие скиллы

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →
roblox-networking gamedev-skills Скилл roblox-networking для Claude Code, Codex, Cursor и других платформ управляет сетевым взаимодействием клиент-сервер в Roblox и защитой от эксплойтов. CX Codex +1 9 300установок roblox-datastores gamedev-skills Автоматизирует работу с Roblox DataStoreService, загрузку профилей и защиту от перезаписи прогресса. Применяется при потере данных игроков или дублировании предметов после телепортации. CX Codex +1 11 400установок roblox-game brockmartin Скилл roblox-game для Claude Code помогает проектировать и программировать плейсы Roblox на языке Luau. Ассистент проверяет сетевую безопасность, настраивает DataStore и генерирует скрипты. CX Codex +1 553установок roblox-server-data TabooHarmony Скилл roblox-server-data для работы с общими данными между серверами Roblox: лидерборды, рассылки, MemoryStore, сезоны и гильдии. CX Codex +1 3 000установок roblox-building TabooHarmony Скилл roblox-building для сборки геометрии, карт и пропов в Roblox Studio через MCP или Luau. Помогает не угадывать координаты и доводить модель до проверяемого результата. CX Codex +1 4 200установок roblox-game-development greedychipmunk Скилл roblox-game-development для разработки игр на Roblox: помогает писать скрипты на Luau, собирать игровые системы и готовить проект к релизу. CX Codex +1 2 400установок

Из того же набора22

Весь набор →
roblox-luau Скилл roblox-luau для Claude Code помогает писать и разбирать скрипты Roblox на Luau. Включается при создании, рефакторинге и объяснении скриптов, исправлении ошибок типов и обновлении старого Lua-кода. CX Codex +1 1 300установок roblox-ui Скилл roblox-ui для Claude Code и Codex формирует адаптивный интерфейс в Roblox. Включается при сборке HUD, инвентарей, магазинов или починке вёрстки под мобильные экраны и консоли. CX Codex +1 1 300установок roblox-testing Скилл roblox-testing для Claude Code помогает тестировать код Roblox и проверять игровые изменения. Подключается при добавлении тестов, настройке тестового запуска или CI. CX Codex +1 1 300установок roblox-open-cloud Скилл roblox-open-cloud для Claude Code помогает работать с Open Cloud API Roblox и HttpService. Включается при создании внешних инструментов, ботов и CI/CD для игр. CX Codex +1 1 200установок roblox-monetization Скилл roblox-monetization для Claude Code помогает настраивать монетизацию в Roblox и разбирать сбои покупок. Подключается при работе с магазинами, пропусками, подписками, рекламой и платными случайными предметами. CX Codex +1 1 200установок roblox-physics Скилл roblox-physics для Claude Code управляет физикой и пространственными запросами. Подключается при настройке столкновений, лучей и транспорта. CX Codex +1 1 200установок roblox-npc-ai Скилл roblox-npc-ai для Claude Code помогает создавать ИИ врагов, питомцев и других NPC в Roblox. Используется для настройки поиска пути, преследования, атак и поведения персонажей, а также для исправления застревающих NPC. CX Codex +1 1 200установок roblox-teleport-matchmaking Скилл roblox-teleport-matchmaking для Claude Code управляет телепортацией игроков и созданием матчей в Roblox через TeleportService. CX Codex +1 1 200установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой