player-physics

Apply and manage physics forces on the local player in Decentraland scenes.

3|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/decentraland/sdk-skills --skill player-physics
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: player-physics
Source: https://github.com/decentraland/sdk-skills/tree/main/player-physics
Command: npx skills add https://github.com/decentraland/sdk-skills --skill player-physics

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Apply physics forces to the local player's avatar, enabling interactive, scene-driven motion such as launches, pushes, and area effects without requiring manual frame-by-frame scripting.

Core Features & Use Cases

  • Impulse (One-Shot Push): launches the player upward or in a specified direction for a moment.
  • Knockback & Repulsion: pushes the player away from a point or area, with optional falloff and radius.
  • Continuous & Timed Forces: applies persistent or time-limited forces for wind tunnels, conveyors, gravity fields, and zone effects.
  • Coordinate Utilities: converts local directions to world space to push the player relative to an entity's orientation.

Quick Start

Integrate the Physics API and apply basic forces to the local player in your scene.

Frequently Asked Questions about player-physics

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

FAQPage Schema
How do I apply physics forces to the local player in Decentraland?

You can apply physics forces to the local player in Decentraland by integrating the Physics API from @dcl/sdk/ecs, enabling scene-driven motion like launches and pushes without manual frame-by-frame scripting.

What is the best way to create a knockback effect that pushes the player away from a specific point?

Knockback and repulsion effects push the player away from a designated point or area with optional falloff and radius. This approach manages the force application automatically, requiring no manual frame updates.

Can I apply continuous or timed physics forces for zone effects like wind tunnels in Decentraland?

Yes, you can apply continuous and timed physics forces to the local player. This supports persistent or time-limited forces ideal for simulating wind tunnels, conveyors, gravity fields, and zone effects in your scene.

Does this physics approach support converting local directions to world space for entity-relative pushes?

Yes, coordinate utilities are included to convert local directions to world space. This allows you to push the local player relative to a specific entity's orientation rather than just global world axes.

Do I need @dcl/sdk/ecs to use player physics forces in my scene?

Yes, you need the Physics API from the @dcl/sdk/ecs package to operate on the local player. The Skill relies on this dependency to apply forces and manage per-entity force ownership with automatic cleanup.

Why should I use managed physics forces instead of manual frame-by-frame scripting?

Managed physics forces eliminate the need for manual frame-by-frame scripting by supporting per-entity force ownership and automatic cleanup. This ensures interactive scene-driven motion like launches and repulsion are handled efficiently.