使用方法
- 复制安装命令，在自己的智能体环境安装前先检查源码包。
- 从原始文档核对所需工具、凭据和支持的宿主。
- 说明输入材料与期望交付物，并对照来源检查输出。
npx skills add https://github.com/hungrykelvin123/dstack --skill roblox-physics开始前需了解
- 安装不包含模型订阅、API 额度或访问文件的权限。
- 仓库星数和安装量反映活跃情况，不等于独立质量或安全测试。
仓库原始内容
按源仓库内容呈现，保留标题、案例、代码、表格、链接以及原文引用的演示图片。
Roblox physics
Read `../../references/roblox-engineering.md`. Inspect the authored hierarchy, assemblies, roots, anchoring, attachments, constraints, collision groups, and current ownership code before changing behavior.
Treat simulation as distributed and untrusted
- Decide network ownership at the assembly level as both a responsiveness and authority choice. Client ownership reduces input latency and server work, but the client can manipulate its simulation.
- Keep gameplay-critical assemblies server-owned when practical. For responsive player-controlled physics, assign ownership deliberately and validate server-observed position, speed, state transitions, and outcomes within game-specific tolerances.
- Reapply or release explicit ownership when seats, characters, tools, assemblies, or round state change. Anchoring and reconnecting parts can change the ownership model.
- Do not treat
Touchedalone as proof of authoritative damage, collection, or completion. Confirm server-side identity, spatial plausibility, state, cooldown, and duplicate behavior; use an appropriate ray or swept spatial query for fast motion. - Prefer attachments and constraints for simulated mechanisms. Apply forces or impulses to the intended assembly instead of fighting physics with repeated per-frame transforms or velocity assignments.
- Make collision groups and query filters explicit. Exclude the source assembly, validate returned instances and ancestry, and separate physical collision from detection when gameplay requires different rules.
- Bound active simulated assemblies, query frequency, and per-frame work. Measure server physics cost, replication, and mobile client behavior before optimizing.
Deliverable
State the assembly root, owner through each lifecycle state, authority checks, collision and query rules, constraint model, cleanup, and failure behavior. Verify pure hit-validation and state-transition logic locally. Give the user exact Studio checks for ownership visualization, multiple clients, latency, reset, and high-speed contact; never invoke the playtest through MCP.
