skills.rest
Humusoft
HumusoftOFFICIAL
Explore all skills by this author →
WebsiteGitHub

phx-engine-gotchas

Diagnose PHX engine gateway calls and rigid-body simulation errors.

7|Updated Jun 25, 2026
Search Tags:#debugging#constraints#matlab#phx engine#bullet physics#rigid-body simulation#matlab.unittest
One-click install
npx skills add https://github.com/Humusoft/phx --skill phx-engine-gotchas
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: phx-engine-gotchas
Source: https://github.com/Humusoft/phx/tree/main/.claude/skills/phx-engine-gotchas
Command: npx skills add https://github.com/Humusoft/phx --skill phx-engine-gotchas

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps diagnose low-level PHX physics behavior, avoid runtime gateway errors, and implement new simulable objects without relying on fragile assumptions about the Bullet engine.

Core Features & Use Cases

  • Engine Gateway Guidance: Explains the phx.engine.io verbs, payloads, frame flags, constraints, body fields, and engine variants.
  • Physics Debugging: Covers timestep stability, static and dynamic body behavior, sleeping and wake-map quirks, force application, and automatic pipeline rebuilding.
  • Development and Testing: Guides new object implementation, unified error IDs, matlab.unittest filtering, and safe use of PHX internals.
  • Use Case: When a thruster applies force in the wrong direction or a constrained scene becomes unstable, use this skill to verify frame flags, reduce the timestep, inspect engine fields, and select the appropriate test suite.

Quick Start

Use the phx-engine-gotchas skill to diagnose the PHX engine issue, identify the relevant gateway call or known quirk, and recommend a corrected implementation or test command.

Frequently Asked Questions about phx-engine-gotchas

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does my rigid-body simulation become unstable when applying forces in Bullet physics?▼

Rigid-body simulation instability often stems from incorrect frame flags or an oversized timestep. Diagnose the PHX engine behavior by verifying force application arguments, reducing the timestep, and inspecting engine fields to correct thruster direction issues.

How do I debug phx.engine.io gateway payload and verb errors in MATLAB?▼

Debug phx.engine.io gateway errors by validating correct gateway verbs, payloads, and frame flags against engine specifications. Ensure constraint collision arguments and body fields match expected formats to prevent runtime errors during rigid-body simulation.

What causes constrained bodies to behave incorrectly in PHX engine?▼

Constrained bodies behave incorrectly when constraint collision arguments or frame flags are misconfigured. Diagnose the PHX engine behavior by inspecting body sleeping quirks, verifying wake-map logic, and ensuring proper automatic pipeline rebuilding.

How do I select the right matlab.unittest test layer for PHX engine debugging?▼

Select the appropriate matlab.unittest test layer by matching test filters to the specific PHX engine issue. Use unified error IDs to isolate failures in new simulable objects, constraint behavior, or timestep stability during test execution.

Does PHX engine support custom simulable objects without breaking the physics pipeline?▼

PHX engine supports custom simulable objects when implemented with correct gateway verbs, unified error IDs, and safe use of internal engine fields. Avoid fragile assumptions about Bullet engine behavior to maintain automatic pipeline rebuilding stability.

What are the limitations of relying on default engine settings for rigid-body sleeping behavior?▼

Default engine settings for rigid-body sleeping can cause unexpected wake-map quirks and static body behavior. Diagnose these PHX engine limitations by inspecting body fields, verifying frame flags, and adjusting engine variants to prevent simulation errors.

Related Skills

Explore More Software Engineering Skills→
HumusoftHumusoft
7

phx-scene-basics

Construct and run 3D rigid-body physics scenes in MATLAB.

Official
Advanced
HumusoftHumusoft
7

phx-constraints-forces

Connect and actuate PHX rigid bodies with joints, springs, and forces.

Official
Advanced
Seth-arcSeth-arc
1

physics-baseline

Configure Cannon-ES physics engine settings for reproducible Myelin LOTO simulations.

Community
Advanced
HumusoftHumusoft
7

phx-simulink

Connect PHX rigid-body scenes to Simulink for property-driven co-simulation.

Official
Advanced