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

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

Скилл roblox-physics помогает собирать и отлаживать физику в Roblox: механизмы, транспорт, констрейнты и сетевое владение.

MIT 521 установок ★ 36 обновлён 2026-10-22

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

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

Скилл объясняет ИИ-агенту правила физического движка Roblox. Он подсказывает, как собирать жесткие сборки (assemblies), правильно выбирать корневую деталь через AssemblyRootPart и не ломать структуру лишним закреплением. Если закрепить несколько деталей внутри одной сборки, движок разделит её на части, поэтому скилл напоминает якорить только корневой узел.

Внутри заложены правила миграции с устаревших BodyMover на современные констрейнты перемещения (AlignPosition, LinearVelocity, VectorForce), таблицы механических сочленений вроде HingeConstraint или SpringConstraint, а также примеры скриптов (VehicleController.lua, DoorHinge.lua, PlatformMover.lua, Suspension.lua). Отдельное внимание уделено сетевому владению: клиент может манипулировать физикой переданных ему деталей, поэтому критические проверки урона нельзя вешать на клиентские события Touched.

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

  • перевести старые объекты с BodyMover на современные mover constraints
  • настроить подвеску и рулевое управление машины через HingeConstraint
  • устранить лаги ввода транспорта через передачу Network Ownership
  • предотвратить засыпание физических механизмов во время медленного движения

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

  • Помоги переписать управление платформой с BodyVelocity на современные LinearVelocity и AlignOrientation
  • Собери скрипт подвески для колеса с использованием SpringConstraint в Roblox
  • Как настроить передачу Network Ownership для водительского места в Roblox?

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

1Через Skills CLI (Vercel)

npx skills add nonlooped/roblox-suite --skill roblox-physics -a claude-code

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

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

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

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

Вопросы о roblox-physics

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

Выполните команду npx skills add nonlooped/roblox-suite --skill roblox-physics -a claude-code в терминале.

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

Даёт агенту контекст по физике Roblox: типам констрейнтов, расчету массы, спящему режиму движка и сетевому владению объектами.

Почему нельзя якорить все детали транспорта?

Закрепление нескольких деталей в одной связке разделяет единую сборку (assembly) на изолированные части и ухудшает производительность симуляции.

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

SKILL.md · MIT
---
name: roblox-physics
description: "Build or debug Roblox vehicles, mechanisms, and moving objects. Use for assemblies, mechanical or mover constraints, network ownership, collision filtering, and simulation performance."
last_reviewed: 2026-06-17
---

# roblox-physics

**Official sources:**
- https://create.roblox.com/docs/physics
- https://create.roblox.com/docs/physics/assemblies
- https://create.roblox.com/docs/physics/mechanical-constraints
- https://create.roblox.com/docs/physics/mover-constraints
- https://create.roblox.com/docs/physics/network-ownership
- https://create.roblox.com/docs/physics/sleep-system
- https://create.roblox.com/docs/physics/adaptive-timestepping
- https://create.roblox.com/docs/physics/units
- https://create.roblox.com/docs/workspace/collisions

Use mechanical constraints to connect parts and mover constraints to apply forces or velocity targets. For older code, use the BodyMover migration table below.

## Core concepts

### Assemblies

An **assembly** is one or more parts connected by rigid welds or movable joints, simulated as a single rigid body.

Key `BasePart` properties (same for any part in the assembly):
- `AssemblyLinearVelocity` / `AssemblyAngularVelocity`: prefer constraints or `ApplyImpulse` over direct assignment for realistic motion.
- `AssemblyCenterOfMass`: force here produces pure linear acceleration.
- `AssemblyMass`: sum of all part masses; infinite if any part is anchored.
- `AssemblyRootPart`: automatically chosen root for replication and network ownership.

Root-part priority: anchored > non-massless > higher `RootPriority` > size/name heuristics.

### Anchoring

- Anchoring one part in an assembly makes it the root; the rest are implicitly anchored.
- Anchoring multiple parts in the same assembly **splits** it.
- To anchor an entire assembly, only anchor the root part.

### Collision filtering

Use collision groups (`Workspace:RegisterCollisionGroup` (inherited from `WorldRoot`), `BasePart.CollisionGroup`) or `NoCollisionConstraint` for part-to-part filtering. `CanCollide`, `CanTouch`, and `CanQuery` control different behaviors; see [references/collisions-and-filtering.md](references/collisions-and-filtering.md).

## Mechanical constraints

All mechanical constraints connect one or two `Attachment`s (or `Bone`s), except `WeldConstraint` and `NoCollisionConstraint` which use `Part0`/`Part1`.

| Constraint | Use case |
| --- | --- |
| `WeldConstraint` | Rigidly lock two parts together, same relative transform |
| `RigidConstraint` | Same as WeldConstraint but attachment-based, supports bones |
| `HingeConstraint` | Doors, levers, rotating parts; motor/servo optional |
| `PrismaticConstraint` | Sliding doors, elevators, pistons |
| `CylindricalConstraint` | Slides + rotates, like hydraulic rams or landing gear |
| `SpringConstraint` | Springs, shocks, suspension |
| `TorsionSpringConstraint` | Rotational springs |
| `BallSocketConstraint` | Shoulders, ball joints |
| `UniversalConstraint` | Drive shafts, constant-velocity joints |
| `RopeConstraint` | Cables, winches, maximum length |
| `RodConstraint` | Fixed separation distance |
| `PlaneConstraint` | Constrain motion to a plane |
| `NoCollisionConstraint` | Disable collisions between two specific parts |

See [references/mechanical-constraints.md](references/mechanical-constraints.md) for creation, orientation, motor/servo tuning, and limits.

## Mover constraints

Modern replacements for deprecated `BodyMover`s:

| Legacy | Modern | Use case |
| --- | --- | --- |
| `BodyPosition` | `AlignPosition` | Move attachment to a position or another attachment |
| `BodyGyro` | `AlignOrientation` | Align orientation; `LookAtPosition` for tracking |
| `BodyVelocity` | `LinearVelocity` | Maintain constant velocity along vector/line/plane |
| `BodyAngularVelocity` | `AngularVelocity` | Maintain constant angular velocity |
| `BodyForce`/`BodyThrust` | `VectorForce` | Apply constant force |
| `RocketPropulsion` | `LineForce` + `AlignOrientation` | Follow + face target |
| - | `Torque` | Apply constant torque |
| - | `LineForce` | Force along line between two attachments |
| - | `AnimationConstraint` | Constraint driven by animation/transform |

See [references/mover-constraints.md](references/mover-constraints.md) for force modes (`Magnitude` vs `PerAxis`), relativity frames, rigidity, and reaction forces.

## Network ownership

- The server owns anchored parts.
- Unanchored parts near a player character are automatically owned by that client.
- Set ownership explicitly with `BasePart:SetNetworkOwner(player)` (server only). Reset with `SetNetworkOwnershipAuto()`.
- Assign vehicle/driver ownership carefully: the first seated player may own the whole assembly otherwise.

**Security:** clients can exploit owned parts (teleport, fake collisions). Validate gameplay-critical events server-side. See [references/network-ownership.md](references/network-ownership.md).

## Sleep system

Assemblies stop simulating when still to save performance. They wake on collisions, property changes, impulses, or gravity/wind changes.

- If a slow mechanism falls asleep, increase motion or use actuated joints (motor/servo constraints) which get stricter sleep thresholds.
- Visualize sleep states with **Awake parts** in Studio's Visualization Options.

## Physics stepping method

Workspace.PhysicsSteppingMethod:
- **Fixed** (default, 240 Hz): best general choice; use for racing, destruction, tanks, or when most parts already solve at 240 Hz.
- **Adaptive**: assigns assemblies to 60/120/240 Hz islands for up to ~2.5× performance in suitable experiences.

Use the MicroProfiler to check island distribution.

## Units quick reference

| Roblox | Metric |
| --- | --- |
| 1 stud | 28 cm |
| 1 RMU | 21.952 kg |
| 196.2 studs/s² | default "Classic" gravity |
| 35 studs/s² | "Realistic" gravity (≈ 9.8 m/s²) |

See [references/units-and-physical-properties.md](references/units-and-physical-properties.md).

## Common mistakes

- Using deprecated `BodyMover`s instead of modern constraints.
- Setting `CFrame` every frame instead of using forces/constraints.
- Anchoring every part in an assembly (splits it and hurts performance).
- Ignoring network ownership on vehicles and then wondering why input lags.
- Trusting `Touched` events from client-owned parts for damage/authority.
- Letting actuated joints fall asleep prematurely.

## Scripts

- `scripts/VehicleController.lua`: chassis setup with `HingeConstraint` steering and motor drive, with client ownership and server validation.
- `scripts/DoorHinge.lua`: motorized/servo door with limits and state machine.
- `scripts/PlatformMover.lua`: `AlignPosition` + `AlignOrientation` platform with configurable waypoints.
- `scripts/Suspension.lua`: spring-damper suspension using `SpringConstraint`.

## How to proceed

1. Decide if the object is a rigid mechanism (mechanical constraint) or force-driven (mover constraint).
2. Plan assemblies, root parts, and anchoring strategy.
3. Set network ownership for multiplayer responsiveness.
4. Tune forces/velocities using units and physical properties.
5. Profile with MicroProfiler and watch sleep/ownership visualizations.

<!-- catalog:references:start -->
## Reference index

- [collisions-and-filtering.md](references/collisions-and-filtering.md): Configure collision groups, touch events, or spatial query filters.
- [mechanical-constraints.md](references/mechanical-constraints.md): Connect parts with hinges, springs, ropes, or other mechanical constraints.
- [mover-constraints.md](references/mover-constraints.md): Apply forces or velocity targets, or migrate BodyMover code.
- [network-ownership.md](references/network-ownership.md): Assign physics simulation to the server or a player and debug ownership.
- [units-and-physical-properties.md](references/units-and-physical-properties.md): Tune mass, density, friction, force, or simulation stepping.
<!-- catalog:references:end -->

© nonlooped · MIT · nonlooped/roblox-suite

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

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

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

roblox-physics gamedev-skills Скилл roblox-physics для Claude Code настраивает физику и пространственные запросы в Roblox, включая сборки, ограничения и владение сетью. CX Codex +1 9 100установок roblox-physics TabooHarmony Скилл roblox-physics помогает настраивать физику в Roblox: связки констрейнтов, рэгдоллы, транспорт, сетевое владение и поведение снарядов при багах симуляции. CX Codex +1 3 200установок roblox-physics EL4CTEO Скилл roblox-physics для Claude Code управляет физикой и пространственными запросами. Подключается при настройке столкновений, лучей и транспорта. CX Codex +1 1 200установок roblox-characters gamedev-skills Скилл roblox-characters для Claude Code помогает чинить скрипты персонажей Roblox, их анимации и управление движением. Активируется при сбоях после возрождения, проблемах с репликацией или конфликте спринта с Humanoid. CX Codex +1 9 300установок roblox-animation-vfx TabooHarmony Скилл roblox-animation-vfx для ИИ-агента, который помогает писать и чинить анимации, партиклы, лучи, трейлы и твины в Roblox. CX Codex +1 4 200установок roblox-monetization TabooHarmony Скилл roblox-monetization для Claude Code: работа с покупками в Roblox (Game Passes, Developer Products, подписки, приватные серверы). Помогает отследить, почему покупка не выдала предмет. CX Codex +1 3 400установок roblox-animations sentinelcore Скилл roblox-animations для Claude Code и других агентов: справочник по анимациям Roblox — загрузка треков, приоритеты, замена стандартных анимаций персонажа. Покрывает код для Humanoid и рига на AnimationController. CX Codex +1 1 000установок roblox-security sentinelcore Скилл roblox-security для Claude Code и пяти других ИИ-агентов, который подсказывает безопасные паттерны Roblox-скриптов. Включается при написании RemoteEvent-обработчиков, валюты, урона и проверок на сервере. CX Codex +1 783установок scenario-roblox-environment scenario-labs Скилл scenario-roblox-environment для Claude Code настраивает окружение и освещение карт в Roblox Studio. Помогает собирать уровень от камеры спавна и проверять коллизии проходов. CX Codex +1 393установок

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

Весь набор →
roblox-gamepasses Скилл roblox-gamepasses помогает агенту собрать монетизацию в Roblox: пассы, developer products, подписки и переводы Robux — с выдачей бонусов только на сервере. CX Codex +1 547установок roblox-core Скилл roblox-core для Claude Code помогает выбирать сервисы Roblox, места для скриптов и контексты выполнения. Он подключается к вопросам о типах Luau, сериализации, загрузке модулей и обмене данными между клиентом и сервером. CX Codex +1 546установок roblox-datastores Скилл roblox-datastores помогает реализовать и отладить сохранение данных игроков в Roblox: профили, OrderedDataStore для лидербордов, миграции и выбор между DataStore и MemoryStore. CX Codex +1 544установок roblox-audio Скилл roblox-audio помогает собирать и отлаживать аудиосистемы Roblox: от позиционного звука до преобразования речи. Пригодится при настройке аудиографа или миграции со старого Sound. CX Codex +1 522установок roblox-rojo Скилл roblox-rojo настраивает проекты Rojo 7 для синхронизации файлов с диска в Roblox Studio, генерации сборок и карт исходников. CX Codex +1 519установок roblox-teleport Скилл roblox-teleport переносит игроков Roblox между местами, серверами и зарезервированными серверами через TeleportAsync. Подскажет, как передать данные, обработать ошибки и настроить лобби. CX Codex +1 519установок roblox-npcs Скилл roblox-npcs для Claude Code создаёт и отлаживает навигацию NPC в Roblox через PathfindingService. Настраивает патрулирование, преследование и обход препятствий. CX Codex +1 518установок roblox-open-cloud Справочник по REST API Roblox Open Cloud для внешней автоматизации, CI/CD и работы с Data Stores без запуска игры. CX Codex +1 497установок

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

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