unity-physics

Run Unity editor physics queries and configure gravity, materials, and layer collisions.

Updated Aug 18, 2026
One-click install
npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-physics-ethanjpope
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: unity-physics
Source: https://github.com/ethanJPope/Our-Main-Hackathon-Game/tree/main/.agents/skills/unity-skills/skills/physics
Command: npx skills add https://github.com/ethanJPope/Our-Main-Hackathon-Game --skill unity-physics-ethanjpope

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? It lets you perform Unity physics queries (raycasts, sphere casts, overlap checks) and modify physics settings (gravity, PhysicMaterial assets, layer collision matrix) directly in the editor without entering Play mode or writing test scripts. ## Core Features & Use Cases - Physics Queries: Cast rays, spheres, and boxes, or check overlap volumes to inspect colliders and hits in the scene at editor time. - Physics Configuration: Get and set global gravity, create PhysicMaterial assets, assign them to colliders, and read or write the layer collision matrix. - Use Case: While building a level, ask the AI to raycast downward from a spawn point to verify ground placement, then create a bouncy PhysicMaterial and assign it to a collider, all without pressing Play. ## Quick Start Ask the AI to cast a ray from position (0, 5, 0) straight down for 10 units and report what collider it hits.

Frequently Asked Questions about unity-physics

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

FAQPage Schema
How do I raycast in the Unity editor without entering Play mode?

Use the physics_raycast skill with an origin point, direction vector, and optional max distance and layer mask. It runs synchronously on the editor thread and returns hit information including collider name, distance, and world-space coordinates.

How do I change gravity in Unity programmatically?

Call physics_set_gravity with x, y, z values such as 0, -9.81, 0 to set the global gravity vector. Use physics_get_gravity to read the current setting before making changes.

Can this skill add Rigidbody or Collider components to GameObjects?

No, physics_add_rigidbody and physics_add_collider do not exist in this module. Use the component module's component_add skill with componentType set to Rigidbody, BoxCollider, or similar instead.

Does this skill run physics simulation or step the physics engine?

No, physics simulation only advances during Play mode. This module performs single-frame queries and writes assets or global settings in the editor; it does not step or start the simulation.

Why does physics_set_material fail with TARGET_NOT_FOUND?

The target GameObject has no Collider attached, or the PhysicMaterial asset path could not be loaded. Add a collider via component_add or verify the material path with asset_find, then retry.