mcpField
R
roblox-physics

roblox-physics

github.com/tabooharmony开发1402.1k 次安装2 周前更新
代码仓库

关于 roblox-physics

roblox-physics 面向开发物理驱动型 Roblox 玩法的开发者,涵盖车辆、布娃娃和移动平台。内容涉及约束、所有权、权威设置及常见配置问题。

主要功能

  1. 01选择约束与执行器
  2. 02配置车辆物理
  3. 03管理布娃娃状态恢复
  4. 04选择网络所有权与权威模型
  5. 05检查常见约束问题

适用场景

  1. 01构建带悬架和转向的车辆
  2. 02创建可恢复角色状态的布娃娃
  3. 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。

评论

支持 Markdown