Product media placeholder
Replace this area with a screenshot or short walkthrough video during the media sweep.
Pure sink. On the rising edge of `trigger`, calls bodySetPose on the wired body — instantaneous position write, not solver-mediated. Optional companion bodySetVelocity. Use for "bounce once + fall through" without a global solidness gate (each contact teleports the colliding body past the obstacle, leaving the obstacle solid for everyone else), portal-style entry/exit, or reset-to-spawn on state change.
Type physicsBodyTeleportCategory solversContext sharedDynamic ports noCompound no
Inputs
| Port | Type | Description |
|---|---|---|
world | any | Wire to the sibling `physicsWorld.world` output. |
bodyId | float | Body to teleport. Wire from `physicsCollisionPulse.otherBodyId`, `physicsMouseDrag.pickedBodyId`, etc. |
x | float | Target X |
y | float | Target Y |
rotation | float | Target Rotation (rad) |
vx | float | Only applied when `setVelocity > 0.5`. |
vy | float | Target Velocity Y (px/s) |
setVelocity | float | > 0.5 = also apply `vx/vy` on teleport. ≤ 0.5 = preserve existing velocity (carry momentum through). |
trigger | float | Rising edge fires the teleport. Wire from collision pulse, click pulse, state-machine event, etc. |
Outputs
| Port | Type | Description |
|---|---|---|
| - | - | No ports declared. |
Parameters
| Parameter | Type | Default | Description |
|---|---|---|---|
| - | - | - | No configurable parameters. |
Use cases
- Bounce-once-then-fall-through — `physicsCollisionPulse.otherBodyId → bodyId`, `pulse → trigger`. Teleport target Y = obstacle bottom + body radius. Static body stays solid for all other bodies; concurrent collisions each get their own bounce + drop without any shared time window.
- Reset-on-state — wire a state-machine pulse trigger; teleport body back to spawn pose.
- Portal — sensor entry pulse → teleport to portal exit, optionally carrying velocity (set `setVelocity = 1` and wire `vx/vy`).
Related nodes
Envelope
Use physicsBodyTeleport as the node type inside a graph node envelope. Add id, optional params, optional connections, and optional activeWhen based on the guide context.
Generated source
Registry faster-motion-docs/node-registry.jsonCategory page /help/faster-motion/faster-motion-node-category-solvers/