关于 roblox-physics
roblox-physics 面向开发物理驱动型 Roblox 玩法的开发者,涵盖车辆、布娃娃和移动平台。内容涉及约束、所有权、权威设置及常见配置问题。
主要功能
- 01选择约束与执行器
- 02配置车辆物理
- 03管理布娃娃状态恢复
- 04选择网络所有权与权威模型
- 05检查常见约束问题
适用场景
- 01构建带悬架和转向的车辆
- 02创建可恢复角色状态的布娃娃
- 03设计投射物和移动平台
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ tabooharmony/ roblox-brain --skill roblox-physics安装后在 Claude Code 中输入/roblox-physics确认已加载。
附带文件references/full.md
详细介绍
Roblox Physics
加载时机
在构建物理驱动的玩法时使用此技能:载具、布娃娃、投射物、机械装置、电梯、摆动平台,或任何使用约束和力的内容。
快速参考
约束类型
机械: HingeConstraint、PrismaticConstraint、CylindricalConstraint、BallSocketConstraint、UniversalConstraint、WeldConstraint/RigidConstraint
运动: AlignPosition、AlignOrientation、LinearVelocity、AngularVelocity、VectorForce、Torque
弹簧/绳索: SpringConstraint、RopeConstraint、RodConstraint
附件模式
约束通过 Attachment 对象连接。在每个部件上创建一个附件,设置 Attachment0/Attachment1,并将约束设为 part0 的子级。执行器类型包括 None、Motor 和 Servo。
载具
载具:使用电机驱动的 HingeConstraint 车轮、SpringConstraint 悬架、伺服转向,以及 CustomPhysicalProperties 来调整摩擦力。
布娃娃
跟踪每个布娃娃更改的关节和实例;仅恢复其拥有的状态,并在恢复移动前协调相互重叠的效果。BallSocketConstraint 配方:full.md。
权限与网络所有权
经典项目:自动所有权可能会将未锚定的装配体分配给附近的玩家。SetNetworkOwner(nil) 会使其保持服务器所有权;SetNetworkOwner(player) 会将模拟所有权交给玩家。应将玩家所有权下的物理视为不可信,并验证游戏结果。
服务器权威:设置 Workspace.AuthorityMode = Server,并配置所需设置。核心对象可以继续由服务器拥有,同时通过预测保持控制响应灵敏,因此不会出现经典的安全性与延迟之间的权衡。SetNetworkOwner() 不能替代此设置。
规则: 先选择模型。让 NPC 和对玩法至关重要的对象保持权威;仅在行为可接受且经过测试时,才将非关键物理对象的所有权交给客户端。
常见问题
- 约束对锚定部件不起作用
- 必须同时设置 Attachment0 和 Attachment1(缺少任一项都会静默失败)
- 约束过多会导致抖动。使用
CustomPhysicalProperties调整质量 - 命中扫描使用 Raycast;仅对速度较慢的物理投射物使用
Touched - 始终为物理投射物设置生命周期
配方、API 详情和检查项请参阅
references/full.md。