physics-system

Guide Godot 4.3+ physics implementation for 2D/3D bodies, collisions, areas, and raycasting.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Godot's physics system is powerful but complex; this skill provides structured guidance for implementing reliable 2D/3D physics workflows, including bodies, collisions, areas, and raycasts, so AI agents can reason about motion and interactions.

Core Features & Use Cases

  • Unified guidance for Area2D/3D, StaticBody, RigidBody, and CharacterBody types with practical GDScript and C# examples.
  • Collision shapes, queries, and per-frame rules to prevent tunneling and ensure deterministic behavior using _integrate_forces.
  • Techniques for managing collision layers/masks, contact signals, and basic Jolt vs GodotPhysics considerations (3D).
  • Use cases include player movement, NPC physics, environmental interactions, and networked physics scenarios.

Quick Start

Run a minimal Godot 4.3 project with a moving RigidBody, an Area2D/Area3D, and basic collision layers to observe correct interactions.

Frequently Asked Questions about physics-system

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

FAQPage Schema
How do I prevent RigidBody tunneling and ensure deterministic physics in Godot 4?

To ensure deterministic physics in Godot 4, enforce correct use of collision shapes and implement _integrate_forces for RigidBody. This structured approach prevents tunneling and guarantees reliable per-frame motion behavior.

What is the best way to manage collision layers and masks for Area3D interactions?

Managing collision layers and masks for Area3D requires configuring specific layer and mask values to filter interactions. This ensures accurate contact signals and prevents unintended overlaps between different object types.

Does this physics guidance support both GDScript and C# in Godot 4.3?

Yes, this physics guidance supports both GDScript and C# in Godot 4.3. It provides unified, practical examples for Area2D/3D, StaticBody, RigidBody, and CharacterBody types across both programming languages.

When should I use Jolt vs GodotPhysics for 3D game development?

Choosing between Jolt vs GodotPhysics for 3D game development depends on your project's scale. This guidance outlines basic considerations for both engines to help you select the appropriate physics backend.

How do I compose hitboxes and environmental hazards using Area2D?

Composing hitboxes and environmental hazards using Area2D involves utilizing contact signals and precise collision shapes. This allows accurate detection of overlapping bodies for player and NPC interactions.