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

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

Скилл roblox-security для Claude Code помогает проектировать серверную защиту игр на Roblox против эксплойтов. Включается при написании серверных обработчиков, проверке репликации, рейтов и механик боя.

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

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

Что делает roblox-security

Инструкции ориентируют агента на серверную архитектуру: клиентскому коду в Luau нельзя доверять никакие вычисления. Клиент передаёт намерение, а сервер рассчитывает урон, начисление валюты и валидирует каждый входящий аргумент в событиях OnServerEvent и OnServerInvoke.

Внутрь заложены паттерны валидации типов через math.isfinite для отсечения NaN и бесконечности, проверка строк на UTF-8, контроль принадлежности Instance доверенным контейнерам и лимитирование вызовов алгоритмом token bucket. Рассматривается обход ProximityPrompt, манипуляции с ClickDetector и сетевым владением (network ownership).

Защита требует строго серверного хранения цен и конфигов в ServerScriptService или ServerStorage, а секретные ключи читаются через HttpService:GetSecret(). Для физики передвижения предложены серверные рейкасты, мягкая коррекция координат вместо мгновенного кика или режим AuthorityMode = Server.

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

  • отфильтровать некорректные аргументы удалённых событий вроде NaN и поддельных таблиц под видом объектов
  • ограничить частоту вызовов сетевых событий через алгоритм token bucket
  • проверить попадания в бою по расстоянию, пингу и серверному лучу без доверия клиенту
  • предотвратить обход таймеров и дистанции в ProximityPrompt и ClickDetector
  • настроить серверное владение сетевыми деталями через SetNetworkOwner

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

  • Проверь серверный обработчик атаки на защиту от передачи NaN в уроне и дистанции
  • Напиши лимитер вызовов для удалённого события покупки предмета на базе token bucket
  • Покажи безопасный серверный валидатор для ProximityPrompt с проверкой расстояния

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

1Через Skills CLI (Vercel)

npx skills add EL4CTEO/roblox-skills --skill roblox-security -a claude-code

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

~/.claude/skills/roblox-security/SKILL.md

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

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

Вопросы о roblox-security

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

Установка выполняется командой npx skills add EL4CTEO/roblox-skills --skill roblox-security -a claude-code. Конфигурация сохранится в путь ~/.claude/skills/roblox-security/SKILL.md.

Что делает roblox-security?

Скилл обучает ассистента правилам антиэксплойт-дизайна в Luau: строгой валидации всех аргументов удалённых событий, серверной авторизации действий и защите интерактивных объектов.

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

Серверный код должен размещаться в ServerScriptService или ServerStorage, для защиты секретов требуется вызов HttpService:GetSecret(), а в критичных частях механики сетевое владение снимается через SetNetworkOwner(nil).

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

SKILL.md · MIT
---
name: roblox-security
description: Anti-exploit design - never trust the client, validate every remote argument (NaN, spoofed instances, strings), rate limiting, ProximityPrompt/ClickDetector abuse, network ownership, movement and hit validation, economy/trade duplication, code confidentiality, secure teleports, Device Trust API, heuristics, Ban API. Use when writing server handlers for client input, combat/economy/trading, or reviewing for exploits.
---

# Roblox security

**Exploiters fully control their client**: they can run any Luau, read every replicated script
(decompiled), fire any remote with any arguments at any rate, edit any local property (WalkSpeed,
prompt `Enabled`, `MaxActivationDistance`), and move anything they have network ownership of.
Client-side anti-cheat is at best a speed bump. Security comes from server design.

## Core rules

1. **The server decides.** Clients send *intent* ("I pressed attack aiming here"), never *results*
   ("I dealt 50 damage", "give me 100 coins").
2. **Validate every argument** of every `OnServerEvent`/`OnServerInvoke`: type, structure, range, finiteness.
3. **Validate context**: is the player alive, in range, not on cooldown, owns the item, allowed to act?
4. **Rate limit** everything a client can trigger (remotes, prompts, touches, clicks).
5. **Keep secrets server-side**: server code in `ServerScriptService`/`ServerStorage`; API keys via
   `HttpService:GetSecret()`; never ship unreleased content to production places.
6. **Prefer silent mitigation** (drop, clamp, correct state) over instant kicks; escalate on repeated signals.

## Argument validation toolkit

```luau
--!strict
-- ServerScriptService/Server/Validate.luau
local Validate = {}

function Validate.number(value: unknown, min: number, max: number): number?
	if typeof(value) ~= "number" or not math.isfinite(value) then
		return nil -- rejects NaN and ±inf (NaN fails every comparison, so range checks alone don't catch it)
	end
	if value < min or value > max then
		return nil
	end
	return value
end

function Validate.integer(value: unknown, min: number, max: number): number?
	local n = Validate.number(value, min, max)
	return if n and n == math.floor(n) then n else nil
end

function Validate.string(value: unknown, maxLength: number): string?
	if typeof(value) ~= "string" or #value > maxLength or utf8.len(value) == nil then
		return nil -- also rejects invalid UTF-8 (which DataStores refuse)
	end
	return value
end

function Validate.vector3(value: unknown, maxMagnitude: number): Vector3?
	if typeof(value) ~= "Vector3" then
		return nil
	end
	if not (math.isfinite(value.X) and math.isfinite(value.Y) and math.isfinite(value.Z)) then
		return nil
	end
	return if value.Magnitude <= maxMagnitude then value else nil
end

-- Accept only a real instance of the expected class that lives under a trusted container.
-- Exploiters can send tables shaped like instances ({ ClassName = "Part", ... }).
function Validate.instanceIn(value: unknown, className: string, container: Instance): Instance?
	if typeof(value) ~= "Instance" or not value:IsA(className) or not value:IsDescendantOf(container) then
		return nil
	end
	return value
end

function Validate.enum<T>(value: unknown, allowed: { [T]: boolean }): T?
	if allowed[value :: any] then
		return value :: any
	end
	return nil
end

return Validate
```

- Treat every handler parameter after `player` as `unknown` and narrow it with these helpers.
- Look items up by ID in **server** tables (`ITEMS[itemId]`); never read prices/stats from client data
  or from replicated `NumberValue`s the client could reference.
- Cap table sizes and iterate client tables defensively (keys may be NaN-like, nested, huge).

## Rate limiting (token bucket)

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

type Bucket = { tokens: number, last: number }

local function newLimiter(capacity: number, windowSeconds: number)
	local refillRate = capacity / windowSeconds
	local buckets: { [Player]: Bucket } = {}

	Players.PlayerRemoving:Connect(function(player)
		buckets[player] = nil
	end)

	return function(player: Player): boolean
		local now = os.clock()
		local bucket = buckets[player]
		if not bucket then
			bucket = { tokens = capacity, last = now }
			buckets[player] = bucket
		else
			bucket.tokens = math.min(capacity, bucket.tokens + (now - bucket.last) * refillRate)
			bucket.last = now
		end
		if bucket.tokens >= 1 then
			bucket.tokens -= 1
			return true
		end
		return false
	end
end

local allowAttack = newLimiter(5, 1) -- bursts of 5, refills 5/second
print(allowAttack)
```

Rate-limit expensive or exploitable operations especially: DataStore/Badge/HTTP calls (they have
their own budgets), cloning large models, teleports, currency grants, anything broadcast to all clients.

## Client-triggered instances are not safe

| Object | What exploiters can do | Server must |
| --- | --- | --- |
| `ProximityPrompt` | Fire events while disabled; change distance/line-of-sight/`HoldDuration` locally. Only `Triggered` gets a distance check. | Re-check enabled state, distance from character, alive, cooldown. |
| `ClickDetector` | Fire from any distance even when disabled. No server checks at all. | Same as above. |
| `DragDetector` | Inherited click events unchecked; drag respects only `Enabled` and `PermissionPolicy`. | Validate drag results on the server. |
| `Touched` on client-owned parts | Fake or suppress touches. | Validate with server-side distance/overlap queries. |

If these objects sit in **unanchored** parts the client can own, an exploiter can pull the part to
themselves: anchor them, or `part:SetNetworkOwner(nil)` for server ownership.

## Network ownership and movement

Clients own their character's physics, so they can teleport, fly, noclip, speed hack, fling other
players (NaN/huge velocities), and suppress `Touched`. Options, strongest first:

1. **Server authority** (Workspace `AuthorityMode = Server`; fully released, opt-in): the
   server simulates movement with client prediction and rollback, eliminating movement exploits.
   See `roblox-physics`.
2. Server-side movement checks: compare horizontal (XZ) displacement per interval against max speed
   plus latency tolerance; exempt legitimate teleports (set a flag server-side when *you* move them);
   rubber-band to the last valid position instead of kicking.
3. Keep gameplay-critical unanchored parts server-owned: `part:SetNetworkOwner(nil)`.

## Combat validation (hit reports)

Client sends origin, direction/target part, and timestamp. Server checks:
- Origin is near the character's **server** position (tolerance scaled by `player:GetNetworkPing()`).
- Target is alive, an enemy, and within weapon range; claimed hit point is near the target's server position.
- A server raycast against **static** geometry finds no wall between origin and target.
- Fire rate, ammo, reload/sprint state tracked on the server.

## Economy, trading, purchases

- Currency, inventory, and prices exist only on the server. Clients request; the server checks balance
  and applies changes atomically.
- Trades: validate both sides fully, then commit both, then save both; on any failure revert everything.
  Beware "trade then leave before save" duplication: lock items during trades and save immediately after.
- Robux purchases: grant only in `MarketplaceService.ProcessReceipt` (developer products) or after a server
  ownership check (passes). Never trust `PromptProductPurchaseFinished` from the client. See `roblox-monetization`.

## Confidentiality

- Any `LocalScript`, client `Script`, or `ModuleScript` that replicates can be decompiled — even if
  disabled or never required. Don't mix server-only branches into shared modules.
- Anything replicated (models, UI, attributes) can be data-mined. Keep unreleased content in separate
  private universes, not hidden in production.
- Clients can teleport to **any place in the universe**: set **Access Control for Places → Secure within
  universe only** in Creator Dashboard, and verify eligibility on join in restricted places (default deny).
- Never put API keys in scripts or attributes; use the in-experience Secrets store (`HttpService:GetSecret`).

## Device trust (hardware attestation)

`Player.DeviceTrustLevel` (server-read) reports `Pending` → `Unknown` / `None` / `Standard` / `Full`. Supported
today on Android, Chromebook, and Meta Quest; web reports `None`; iOS, desktop, and consoles report `Unknown`
until supported (**`Unknown` ≠ untrusted**). Studio is always `Pending`. It describes the device, not the
player — it complements server validation, never replaces it.

- Prefer routing (ranked place for `Standard`/`Full`) or gating features (trading) over rejecting players;
  check the impact first in Creator Hub → Safety → Anti-cheat.
- Treat `Pending` as untrusted for sensitive features. Decide on the server; tell the client via a remote.
- To reject on join, assign the one-per-place callback in a server script:

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

type Decision = { Action: Enum.PlayerDeviceTrustDecision, Message: string? }

IntegrityService.EvaluatePlayerDeviceTrust = function(player: Player, _measures): Decision
	if player.DeviceTrustLevel == Enum.PlayerDeviceTrustLevel.None then
		return { Action = Enum.PlayerDeviceTrustDecision.Reject, Message = "This game can't verify your device." }
	end
	return { Action = Enum.PlayerDeviceTrustDecision.Accept }
end
```

## Detection and consequences

Layer server-side heuristics on top of validation: fastest-possible completion time, rate of resource
gain, inhumanly regular action cadence, honeypot remotes no legit client fires. Accumulate a
suspicion score; act on multiple signals. Ladder: silent logging → quiet mitigation → restrict
features → kick/ban. Delay visible consequences so exploiters can't bisect your checks.

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

local function banForExploiting(player: Player, evidence: string)
	local ok, err = pcall(function()
		Players:BanAsync({
			UserIds = { player.UserId },
			Duration = 7 * 24 * 60 * 60, -- seconds; -1 = permanent
			DisplayReason = "Exploiting detected.", -- shown to the user (max 400 chars, filtered)
			PrivateReason = evidence, -- visible to you only
			ExcludeAltAccounts = false, -- also ban detected alt accounts
			ApplyToUniverse = true,
		})
	end)
	if not ok then
		warn("BanAsync failed:", err)
		player:Kick("Exploiting detected.")
	end
end

return banForExploiting
```

Enable `Players.BanningEnabled` for the Ban API. Prefer reversible, time-limited bans (check
`Players:GetBanHistoryAsync` to escalate); version detection rules and monitor false-positive rates.

Security review checklist and common vulnerable-code patterns: [references/checklist.md](references/checklist.md).

## Related skills

`roblox-networking`, `roblox-physics` (ownership, server authority), `roblox-data-stores`,
`roblox-monetization`, `roblox-code-review`.

© EL4CTEO · MIT · EL4CTEO/roblox-skills

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

Все скиллы по теме «Безопасность» →

Сначала — roblox-security от других авторов.

roblox-security TabooHarmony Скилл roblox-security проверяет серверный код Roblox на уязвимости, дюпы валюты и доверие клиенту. Пригодится перед релизом плейса или при аудите RemoteEvent и сохранений. CX Codex +1 3 500установок roblox-security sentinelcore Скилл roblox-security для Claude Code и пяти других ИИ-агентов, который подсказывает безопасные паттерны Roblox-скриптов. Включается при написании RemoteEvent-обработчиков, валюты, урона и проверок на сервере. CX Codex +1 783установок roblox-anti-exploit-review LihFolk roblox-anti-exploit-review — скилл для Claude Code, который разбирает угрозы читов и уязвимости игровых механик Roblox. Запускается при проверке ремоутов, обменов и покупок перед релизом. CX Codex +1 ★ 98звёзд репо roblox-remote-events sentinelcore Скилл roblox-remote-events для ИИ-агента, который помогает писать клиент-серверную связь в Roblox и закрывать дыры, через которые эксплойтеры ломают игру. CX Codex +1 656установок roblox-networking gamedev-skills Скилл roblox-networking для Claude Code, Codex, Cursor и других платформ управляет сетевым взаимодействием клиент-сервер в Roblox и защитой от эксплойтов. CX Codex +1 9 300установок roblox-game brockmartin Скилл roblox-game для Claude Code помогает проектировать и программировать плейсы Roblox на языке Luau. Ассистент проверяет сетевую безопасность, настраивает DataStore и генерирует скрипты. CX Codex +1 553установок roblox-system-builder LihFolk Скилл roblox-system-builder для Claude Code проектирует геймплейные системы Roblox с серверной валидацией, сохранением данных в DataStore и сетевой защитой. CX Codex +1 ★ 98звёзд репо roblox-luau gamedev-skills Скилл roblox-luau для Claude Code помогает писать Luau-код для Roblox и проверять его статическими инструментами. Подключается, когда не запускается LocalScript, клиент получает nil после входа или пора заменить wait(). CX Codex +1 12 300установок

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

Весь набор →
roblox-world-building Скилл roblox-world-building для Claude Code и других платформ, автоматизирующий создание 3D-миров и игровых механик в Roblox. Запускается при генерации окружения, уровней и визуальных эффектов. CX Codex +1 1 400установок roblox-performance Скилл roblox-performance для Claude Code, который диагностирует производительность игр в Roblox, ищет утечки памяти и устраняет просадки кадров. Включается при лагах, падении FPS, зависаниях и высоком пинге. CX Codex +1 1 300установок roblox-code-review Скилл roblox-code-review для Claude Code проверяет Roblox-код на уязвимости, потерю данных и ошибки жизненного цикла. Запускается при ревью PR или скрипта, аудите игры и обновлении устаревшего кода. CX Codex +1 1 300установок roblox-characters-animation Скилл roblox-characters-animation для Claude Code описывает работу с персонажами и анимацией в Roblox. Подключается к задачам про движение, урон, респаун, аватары, оружие и твины. CX Codex +1 1 300установок roblox-game-systems Скилл roblox-game-systems для Claude Code и Codex помогает собирать игровые механики Roblox с серверной валидацией. Включается при создании экономики, раундов, инвентаря, боевой системы или чекпоинтов. CX Codex +1 1 300установок 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установок

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

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