# roblox-physics

Скилл для работы с физикой Roblox: сборки, ограничения, группы столкновений, рейкасты и владение по сети. Пригодится, когда .Touched врёт или механизм дрожит.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3500 установок · ★ 4506
- Автор: gamedev-skills
- Лицензия: Apache-2.0 · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/other-engines/roblox-physics/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/gamedev-skills-roblox-physics

## Что делает

Скилл помогает агенту разобраться с физической симуляцией в Roblox: сборки `BasePart`, ограничения, группы столкновений, рейкасты и объёмные запросы, импульсы, силы, масса, движущиеся объекты и владение по сети. Внутри есть таблица выбора механизма под задачу и пошаговый разбор: осмотреть механизм в Studio, задать политику взаимодействия, выбрать симуляцию или запрос, приложить движение на уровне сборки, выставить владельца, ограничить стоимость и время жизни, проверить под нагрузкой и в мультиплеере.

Отдельно разобраны два шаблона. Первый — серверный рейкаст с `RaycastParams`, фильтром по персонажу стрелка и группой `WeaponQuery`; результат проверяется игровой логикой, а не принимается на веру. Второй — объёмный запрос через `OverlapParams` и `GetPartBoundsInBox` с дедупликацией моделей. Есть таблица частых поломок: например, сварной механизм не двигается, если хоть одна деталь заякорена.

Важная деталь про `OverlapParams.RespectCanCollide`: этот флаг решает, уважает ли запрос `CanCollide` или `CanQuery`, и если его не выставить осознанно, он молча перекроет вашу политику флагов. Клиентское владение ускоряет отклик, но не даёт права на игровой результат: сервер обязан сам проверять попадания, позиции и права. Для стабильности и ощущения от физики скилл советует работать в паре с `physics-tuning`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill roblox-physics -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/roblox-physics/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/roblox-physics/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill roblox-physics -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/roblox-physics/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill roblox-physics -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/roblox-physics/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install gamedev-skills/awesome-gamedev-agent-skills roblox-physics
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/roblox-physics/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill roblox-physics -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/gamedev-skills/awesome-gamedev-agent-skills --path skills/other-engines/roblox-physics
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/roblox-physics/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add gamedev-skills/awesome-gamedev-agent-skills --skill roblox-physics -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/gamedev-skills/awesome-gamedev-agent-skills/tree/HEAD/skills/other-engines/roblox-physics/SKILL.md

## Когда брать
- поймать попадание серверным рейкастом с фильтрами вместо `.Touched`
- настроить группы столкновений и развести `CanCollide`, `CanTouch`, `CanQuery`
- починить механизм, который не двигается из-за заякоренной детали
- выставить владение по сети для критичных объектов
- убрать временные ограничения и слушатели после использования

## Примеры запросов агенту
- Разбери мой механизм на ограничениях: почему он дрожит и как выставить владение по сети
- Сделай серверный рейкаст для оружия с `RaycastParams` и группой `WeaponQuery`
- Проверь объёмный запрос через `OverlapParams`: нужно ли выставлять `RespectCanCollide`

## Похожие
- [roblox-building](https://affpapa.org/nevibecode/skills/roblox-building.md) — скилл · 2400 установок
- [roblox-lighting](https://affpapa.org/nevibecode/skills/roblox-lighting.md) — скилл · 2200 установок
- [roblox-animation](https://affpapa.org/nevibecode/skills/roblox-animation.md) — скилл · 392 установки
- [roblox-mcp](https://affpapa.org/nevibecode/skills/roblox-mcp.md) — скилл · 317 установок
- [roblox-game-development](https://affpapa.org/nevibecode/skills/roblox-game-development.md) — скилл · 2200 установок
- [godot-physics-3d](https://affpapa.org/nevibecode/skills/godot-physics-3d.md) — скилл · 418 установок

## Другие версии с тем же именем

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md