| name | ovphysx-drop-contact-acceptance |
| description | Author and accept a reproducible OVPhysX rigid-body drop or contact test from Blender, including collision proxies, authoritative pose readback, settling, and visible contact evidence. Use when a user needs to prove that a SimReady prop falls, collides, and comes to rest through the installed OVRTX/OVPhysX runtime rather than a Blender-only animation. |
| license | Apache-2.0 |
| metadata | {"author":"Max Bickley","version":"0.1","team":"omniverse","domain":"physical-ai","tags":["blender","omniverse","ovrtx","ovphysx"]} |
OVPhysX drop and contact acceptance
Use this skill to answer a narrow question: did the authored bodies undergo a
real OVPhysX simulation and make the expected contact without tunneling,
floating, or losing identity? Blender and the add-on author the scene; OVPhysX
owns simulation state. OVRTX may render an authoritative pose replay.
When to Use
Use when a user needs to prove that a SimReady prop falls, collides, and comes to rest through the installed OVRTX/OVPhysX runtime rather than a Blender-only animation.
Runtime boundary
The add-on source and included scripts are available to the user. The
OVPhysX service, OVRTX worker, protocol definitions, and native client are
installed dependencies. Never ask the user to clone, build, inspect, or
patch those components. A missing service/client/GPU is blocked, not a reason
to substitute Blender rigid bodies or hand-authored keyframes.
Instructions
- Work from a copy of the
.blend or USD and write artifacts to a unique
unique caller-selected working directory.
Hash the source before and after the run.
- Choose one support (floor, stair, shelf, or collider) and one or more
dynamic roots. Record stable Blender object names, exported USD prim paths,
intended mass, initial transforms, units, up-axis, gravity, fixed
dt,
duration, solver/substeps, and the camera used for review.
- Validate finite transforms and initial non-overlap. Keep each independently
moving visual root as a separate body. Exclude cameras, lights, rigs, and
decorative helpers unless they are explicitly simulated.
- Build collision geometry from evaluated meshes. Use supported convex or
compound primitives for concave or thin props and hide proxies only in the
beauty render. Record proxy bounds and the approximation made; do not use a
broad invisible box to conceal bad contact.
Run and Read Back Native Poses
Use the add-on's documented OVPhysX controls or included probe after checking
its local --help and README. A fresh checkout may expose
python3 scripts/run_ovphysx_drop_probe.py --require-real; treat that command
as versioned and stop if it is not present.
Create the simulation through the supported API, apply only the authored
initial state/impulse, and step for a bounded interval. At every sample retain
the complete body pose set (body identity, timestamp, position, orientation,
and velocities when available). Reject missing, duplicate, reordered, NaN, or
infinite values. Compute a normalized state hash over the ordered pose set so
reruns can be compared without treating timestamps as identity.
Replay poses onto matching visual roots only through the documented shared-stage
or pose-replay path. Do not infer physics from a render image or Blender's own
rigid-body cache. Label each product as native OVRTX, Blender replay, or
diagnostic/viewport output.
Acceptance gates
Pass only when all applicable gates hold:
- preflight and native simulation creation succeeded;
- expected body count and stable identity match the authored manifest;
- every sampled pose is finite and has a traceable timestamp/state hash;
- the dynamic body moves from its authored start and records a support contact;
- visible mesh-to-support distance is within the chosen scene tolerance after
contact (a gap larger than about 1 cm at metre scale is normally a failure);
- no unexpected tunneling, persistent floating, or support penetration appears;
- a quiet/settled window satisfies the declared velocity and hysteresis limits;
- replay mapping is complete and source hashes are unchanged.
For a non-contact scenario, explicitly mark contact/settling gates as
not_applicable; never silently omit them. A short-lived contact followed by
continued unbounded motion is a failure, not a settled result.
Result
Return the body identities, timestep/gravity, finite pose/contact/settling
metrics, and whether replay mapping passed. Keep raw pose samples when they are
the requested deliverable or needed to reproduce a failure; create previews or
a machine-readable result only when useful to the caller. If native readback or
the runtime is unavailable, return the first exact status message and do not
generate a passing movie from fake poses.
