unity-physics

Perform Unity physics queries and configure gravity, layers, and materials.

5|1|Updated Apr 21, 2026
One-click install
npx skills add https://github.com/batihandev/unity-mcp-skills --skill unity-physics-batihandev
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-physics
Source: https://github.com/batihandev/unity-mcp-skills/tree/main/skills/physics
Command: npx skills add https://github.com/batihandev/unity-mcp-skills --skill unity-physics-batihandev

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps AI agents perform Unity physics operations accurately by providing guidance for collision queries, raycasts, gravity settings, and physics material management while avoiding common API mistakes.

Core Features & Use Cases

  • Physics Queries: Perform raycasts, sphere casts, box casts, and overlap checks to detect objects and collisions in Unity scenes.
  • Physics Configuration: Manage global gravity, layer collision rules, and PhysicMaterial creation or assignment.
  • Use Case: Use this Skill when building or debugging Unity gameplay systems that require accurate collision detection, physics settings, or runtime scene analysis.

Quick Start

Ask the AI to use the unity-physics skill to perform a raycast from a specified position and report the hit object.

Frequently Asked Questions about unity-physics

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

FAQPage Schema
How do I perform a raycast in Unity to detect collision with specific objects?

To perform a Unity raycast for collision detection, you cast a ray from a specified position and direction to identify hit objects in the scene. This skill guides AI agents to execute validated physics queries accurately.

What is the best way to configure global gravity and layer collision rules in Unity?

Configuring Unity global gravity and layer collision rules involves modifying physics settings to control object interactions. This skill applies validated commands to manage gravity and layer collision matrix rules reliably.

Can I use this to perform sphere casts and box casts for overlap checks?

Yes, you can perform sphere casts, box casts, and overlap checks for scene analysis. The skill handles these Unity physics queries to detect objects and collisions accurately during gameplay development or debugging.

Do I need Unity MCP physics commands to manage PhysicMaterial creation?

Yes, managing PhysicMaterial creation and assignment requires Unity MCP physics commands. The skill depends on these commands to execute validated queries and modify physics-related settings without common API mistakes.

Why does my Unity physics configuration return incorrect collision detection results?

Incorrect Unity collision detection often stems from API mistakes in physics queries or misconfigured layer collision rules. This skill provides guidance to avoid these errors and apply validated physics settings reliably.