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

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

Скилл roblox-networking для Claude Code управляет сетевым взаимодействием клиента и сервера на Roblox, помогая настраивать RemoteEvent, RemoteFunction и оптимизировать трафик.

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

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

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

Скилл описывает правила выбора сетевых каналов между RemoteEvent, UnreliableRemoteEvent и RemoteFunction, а также правила сериализации данных в Roblox. Агент использует его, когда в проекте добавляются новые удалённые вызовы, синхронизируется состояние с клиентами, отлаживаются потерянные аргументы или снижается задержка сети.

В тексте приведены шаблоны для централизованного создания удалённых объектов и серверные обработчики с проверкой типов и ограничением частоты запросов. Также разбираются упаковка данных в буферы, синхронизация времени через workspace:GetServerTimeNow и профилирование трафика.

Применение RemoteFunction:InvokeClient запрещено, если клиент зависнет или выдаст ошибку, так как сервер будет ожидать ответ бесконечно. Для оптимизации горячих путей рекомендуется использовать генераторы Zap или Blink.

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

  • выбрать правильный сетевой канал в Roblox
  • настроить серверный обработчик с ограничением частоты запросов
  • упаковать данные в буфер для экономии трафика
  • синхронизировать время между сервером и клиентом

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

  • Сгенерируй модуль для централизованного создания RemoteEvent и RemoteFunction
  • Напиши серверный обработчик для RequestPurchase с проверкой типов и лимитом
  • Как упаковать данные о попадании в буфер вместо таблицы?

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о roblox-networking

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

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

Что делает скилл roblox-networking?

Он помогает проектировать сетевой код для Roblox, настраивать RemoteEvent и RemoteFunction, оптимизировать трафик и обрабатывать данные на сервере.

Какие каналы связи поддерживает Roblox согласно скиллу?

Скилл описывает RemoteEvent, UnreliableRemoteEvent, RemoteFunction, а также автоматическую репликацию атрибутов, свойств и физики.

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

SKILL.md · MIT
---
name: roblox-networking
description: Client-server communication - RemoteEvent, UnreliableRemoteEvent, RemoteFunction, what survives serialization, typed remote modules, server validation and rate limiting, bandwidth (deltas, buffers, batching), synced time, Zap/Blink. Use when adding remotes, syncing state to clients, debugging nil/lost remote arguments, or reducing lag and bandwidth.
---

# Roblox networking

## Pick the right channel

| Channel | Delivery | Use for |
| --- | --- | --- |
| `RemoteEvent` | Reliable, ordered | Requests (client→server), game events, UI updates. The default. |
| `UnreliableRemoteEvent` | May drop or reorder; payload ≤ **1000 bytes** (larger payloads are dropped) | Continuous, superseded-by-next data: aim direction, cosmetic VFX, positions of non-physics objects. |
| `RemoteFunction` | Request/response, yields caller | Client→server queries that need an answer (e.g. "can I buy X?"). |
| Attributes / properties | Automatic replication server→client | Persistent state clients read (health, team, round state). |
| Physics replication | Automatic for owned assemblies | Moving parts; see `roblox-physics`. |

Never use `RemoteFunction:InvokeClient`: if the client errors, disconnects, or never returns, the server
throws or **yields forever**. Use a `RemoteEvent` to the client and another back if you need a reply.

## Defining remotes once (typed)

Create remotes on the server; clients wait for them. Centralize names so typos can't happen.

```luau
--!strict
-- ReplicatedStorage/Shared/Net.luau
local ReplicatedStorage = game:GetService("ReplicatedStorage")
local RunService = game:GetService("RunService")

local FOLDER_NAME = "Remotes"
local IS_SERVER = RunService:IsServer()

local folder: Instance
if IS_SERVER then
	folder = ReplicatedStorage:FindFirstChild(FOLDER_NAME) or Instance.new("Folder")
	folder.Name = FOLDER_NAME
	folder.Parent = ReplicatedStorage
else
	folder = ReplicatedStorage:WaitForChild(FOLDER_NAME)
end

local function get<T>(className: string, name: string): T
	if IS_SERVER then
		local existing = folder:FindFirstChild(name)
		if existing then
			return existing :: any
		end
		local remote = Instance.new(className)
		remote.Name = name
		remote.Parent = folder
		return remote :: any
	end
	return folder:WaitForChild(name) :: any
end

return {
	RequestPurchase = get("RemoteEvent", "RequestPurchase") :: RemoteEvent,
	InventoryChanged = get("RemoteEvent", "InventoryChanged") :: RemoteEvent,
	AimDirection = get("UnreliableRemoteEvent", "AimDirection") :: UnreliableRemoteEvent,
	GetShopStock = get("RemoteFunction", "GetShopStock") :: RemoteFunction,
}
```

## Server handler template

Every `OnServerEvent`/`OnServerInvoke` handler: **rate limit → type-check every argument → check
game rules → act**. The first parameter is always the real `Player` (Roblox fills it in; it can't be forged).

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

local Net = require(ReplicatedStorage.Shared.Net)

local ITEM_PRICES: { [string]: number } = { Sword = 100, Shield = 150 }
local MIN_INTERVAL = 0.25
local lastRequest: { [Player]: number } = {}

Net.RequestPurchase.OnServerEvent:Connect(function(player: Player, itemId: unknown)
	local now = os.clock()
	if now - (lastRequest[player] or 0) < MIN_INTERVAL then
		return -- rate limited
	end
	lastRequest[player] = now

	if typeof(itemId) ~= "string" or #itemId > 64 then
		return -- malformed: never trust argument types
	end
	local price = ITEM_PRICES[itemId]
	if not price then
		return -- unknown item
	end
	-- check the player's server-side balance, deduct, grant, then notify:
	Net.InventoryChanged:FireClient(player, { added = itemId })
end)

game:GetService("Players").PlayerRemoving:Connect(function(player)
	lastRequest[player] = nil -- avoid leaking Player keys
end)
```

Full validation toolkit (NaN/inf checks, instance ownership, distance and cooldown checks): `roblox-security`.

## What survives the wire

- Tables are **copied**: identity and metatables are lost; functions become `nil`.
- Don't mix array and dictionary keys in one table; don't put `nil` holes in arrays.
- Non-string dictionary keys (Instances, numbers in sparse tables) are converted to strings — send arrays of pairs instead.
- Instances arrive as `nil` if the receiver can't see them (e.g. `ServerStorage` items, or parts not
  yet streamed in on the client).
- Supported: `nil`, booleans, numbers, strings, tables, `buffer`, Roblox datatypes (`Vector3`, `CFrame`,
  `Color3`, `EnumItem`, ...), and replicated `Instance` references.
- Server→client ordering vs. property replication is not guaranteed: a remote may arrive before or
  after a property change it relates to.

## Bandwidth and CPU

- Send **changes**, not full state (item added, not the whole inventory). Send on change, not per frame.
- Throttle input-driven sends on the client (e.g. aim at most 20 Hz) and still rate-limit on the server.
- Send IDs/enums as small numbers; quantize floats; pack hot, high-frequency data into a `buffer`.
- Batch many small messages into one per frame (queue in a table, flush on `Heartbeat`).
- Server-side `TweenService` replicates every frame and looks jittery: tween on clients instead.
- VFX: the server decides the outcome and fires a minimal event; each client spawns effects locally.
- Profile with the MicroProfiler (`ProcessPackets`, `Allocate Bandwidth and Run Senders`) and the
  Developer Console **Network** tab.

```luau
--!strict
-- Pack a hit notification into 11 bytes instead of a table with string keys.
local function encodeHit(targetId: number, damage: number, position: Vector3): buffer
	local b = buffer.create(11)
	buffer.writeu32(b, 0, targetId)
	buffer.writeu16(b, 4, math.clamp(math.round(damage), 0, 65535))
	buffer.writei16(b, 6, math.clamp(math.round(position.X), -32768, 32767))
	buffer.writei16(b, 8, math.clamp(math.round(position.Z), -32768, 32767))
	buffer.writeu8(b, 10, math.clamp(math.round(position.Y / 4), 0, 255))
	return b
end

local function decodeHit(b: buffer): (number, number, Vector3)
	return buffer.readu32(b, 0),
		buffer.readu16(b, 4),
		Vector3.new(buffer.readi16(b, 6), buffer.readu8(b, 10) * 4, buffer.readi16(b, 8))
end

print(decodeHit(encodeHit(42, 25, Vector3.new(10, 20, 30))))
```

For many remotes with hot paths, schema-driven generators (**Zap**, **Blink**) produce typed,
validated, buffer-packed remotes automatically. Adopt them when profiling shows network cost.

## Time and latency

- `workspace:GetServerTimeNow()` is a synchronized clock on server and clients: send a start timestamp
  and let clients compute progress locally (round timers, cooldown bars, projectiles).
- `player:GetNetworkPing()` returns round-trip network latency in seconds (clients may only query
  `LocalPlayer`); use it to size lag-compensation windows.
- Don't send countdown ticks every second; send the end time once.

More patterns (request/response with timeouts, state snapshots + deltas, per-frame batching, client
prediction): [references/patterns.md](references/patterns.md).

## Related skills

`roblox-security` (validation, anti-exploit), `roblox-architecture` (where remotes live),
`roblox-physics` (network ownership, server authority), `roblox-performance`.

© EL4CTEO · MIT · EL4CTEO/roblox-skills

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

Все скиллы по теме «Геймдев и 3D: Unity, Unreal, Godot, Blender» →

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

roblox-networking gamedev-skills Скилл roblox-networking для Claude Code, Codex, Cursor и других платформ управляет сетевым взаимодействием клиент-сервер в Roblox и защитой от эксплойтов. CX Codex +1 9 300установок roblox-networking TabooHarmony Скилл roblox-networking проверяет клиент-серверный код в Roblox: валидацию RemoteEvent, лимиты вызовов, NaN-значения и защиту от читов. Пригодится при настройке сетевого обмена. CX Codex +1 3 300установок roblox-networking nonlooped Скилл roblox-networking для Claude Code: проектирует и проверяет клиент-серверную связь в Roblox. Разбирает RemoteEvent, сетевое владение и защиту от эксплойтов. CX Codex +1 548установок scenario-roblox-networking scenario-labs Скилл scenario-roblox-networking для Claude Code помогает проектировать сетевую архитектуру Roblox и защищать игру от эксплойтов. Он разбирает проверку аргументов RemoteEvent, лимиты запросов, проверку попаданий и защиту от читов движения. CX Codex +1 350установок roblox-datastores gamedev-skills Автоматизирует работу с Roblox DataStoreService, загрузку профилей и защиту от перезаписи прогресса. Применяется при потере данных игроков или дублировании предметов после телепортации. CX Codex +1 11 400установок roblox-physics gamedev-skills Скилл roblox-physics для Claude Code настраивает физику и пространственные запросы в Roblox, включая сборки, ограничения и владение сетью. CX Codex +1 9 100установок roblox-building TabooHarmony Скилл roblox-building для сборки геометрии, карт и пропов в Roblox Studio через MCP или Luau. Помогает не угадывать координаты и доводить модель до проверяемого результата. CX Codex +1 4 200установок roblox-lighting TabooHarmony Скилл roblox-lighting для Claude Code и Codex. Настраивает освещение, атмосферу, цикл дня и ночи и пост-обработку в Roblox, решает проблемы с плоскими или пересвеченными сценами. CX Codex +1 3 900установок roblox-animation nonlooped Скилл roblox-animation для Claude Code и других агентов: треки, IK-позы, маркерные события и твины интерфейса для анимаций персонажей Roblox. Собирает локомоцию и эмоции без потери приоритетов. CX Codex +1 992установок

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

Весь набор →
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установок roblox-input Скилл roblox-input для Claude Code настраивает ввод игрока и камеры в Roblox. Он подключается к задачам с клавишами, способностями, транспортом, сенсорными кнопками или собственной камерой. CX Codex +1 1 200установок roblox-analytics-liveops Скилл roblox-analytics-liveops для Claude Code настраивает игровую аналитику, воронки, экономику и live-ops на Lua. Включается при добавлении событий, A/B-тестов или начислении наград. CX Codex +1 1 200установок roblox-audio Скилл roblox-audio для Claude Code помогает настраивать звук в Roblox: музыку, эффекты и пространственное аудио. Включается при добавлении звука или поиске причины, по которой он не воспроизводится. CX Codex +1 1 200установок roblox-data-stores Скилл roblox-data-stores для Claude Code помогает проектировать сохранение данных игроков и облачные сервисы Roblox. Включается при настройке таблиц лидеров, очередей или устранении потери и дублирования данных. CX Codex +1 1 200установок roblox-studio-mcp Скилл Claude Code подключает ИИ-агент к встроенному серверу Roblox Studio через протокол MCP для проверки и правки игровых миров. CX Codex +1 1 200установок roblox-architecture Скилл roblox-architecture для Claude Code объясняет устройство проекта Roblox и разделение кода между клиентом и сервером. Включается при настройке структуры проекта и разборе проблем с репликацией или стримингом. CX Codex +1 1 200установок

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

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