Skip to main content
skill CX Codex

godot-raycasting-queries — Claude Code skill: setup guide

godot-raycasting-queries is a Claude Code skill with Godot physics query blueprints for RayCast, ShapeCast, and DirectSpaceState. It helps implement hit detection, mouse picking, and AI vision cones.

LGPL-3.0 328 installs ★ 983 updated 2026-10-16

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a claude-code
Open on GitHub

What godot-raycasting-queries does

This skill provides structured GDScript blueprints for 2D and 3D physics queries. It guides the agent on bypassing node overhead with direct intersect_ray calls, handling screen-to-world clicks, and calculating laser reflections.

Included scripts handle footing checks via ShapeCast, AI field-of-view scanners, and piercing projectile chains. Physics queries run strictly within _physics_process because querying direct_space_state during normal frames triggers thread safety issues while Godot locks the simulation. The recipes enforce caster RID exclusion to stop rays from hitting the originating body.

What it helps with

  • implement 3D mouse picking from viewport coordinates
  • prevent self-collision by filtering out caster RIDs
  • detect uneven ground contact using ShapeCast volumes
  • build piercing projectiles that record multiple hits along a line

Example prompts for the agent

  • Set up screen-to-world raycasting for clicking 3D objects with PhysicsRayQueryParameters3D.
  • Implement character ground detection using ShapeCast3D instead of thin rays.
  • Create an AI visibility cone using raycasts while excluding the agent RID.

How to install godot-raycasting-queries

1Skills CLI (Vercel)

npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a claude-code

2Manually: put the files in place

~/.claude/skills/godot-raycasting-queries/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/godot-raycasting-queries/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about godot-raycasting-queries

How to install godot-raycasting-queries in Claude Code?

Run npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-raycasting-queries -a claude-code.

What does godot-raycasting-queries do?

It equips the agent with GDScript blueprints for raycasting, volume queries, and server-side physics lookups in Godot projects.

Why must direct_space_state stay inside _physics_process?

Godot can lock the physics world or run it on another thread, making direct queries inside _process unsafe.

Similar skills

All skills for Game dev and 3D: Unity, Unreal, Godot, Blender →

From the same set100

The whole set →
godot-adapt-2d-to-3d godot-adapt-2d-to-3d migrates Godot games from 2D to 3D. It handles node mapping, SpringArm3D camera rigs, physics layers, and camera-relative movement. CX Codex +1 342installs godot-genre-shooter godot-genre-shooter — a skill for building TPS shooters and hybrids in Godot: SpringArm3D camera, aim assist, cover validation rays, and routing to FPS skill for first-person feel. CX Codex +1 340installs godot-genre-fighting godot-genre-fighting is a Claude Code skill providing a Godot fighting-game framework with frame data, hitboxes, input buffering, and rollback netplay. CX Codex +1 339installs godot-genre-racing godot-genre-racing is a Claude Code skill with components for racing games: vehicle physics, checkpoints, rubber-banding AI, drifting, and camera feel. It works in Godot for arcade racers, kart games, and driving simulators. CX Codex +1 336installs godot-adapt-mobile-to-desktop godot-adapt-mobile-to-desktop guides a mobile-to-desktop Godot port with mouse and keyboard input, resized UI, display settings, window modes, and platform hooks. CX Codex +1 328installs godot-adapt-3d-to-2d godot-adapt-3d-to-2d is a Claude Code skill with patterns for adapting Godot 3D games to 2D, including fake depth, isometric math, physics swaps, and model-to-sprite baking. CX Codex +1 327installs godot-mechanic-secrets godot-mechanic-secrets implements cheat combos, Easter egg interactions, hidden wall triggers, and meta persistence in Godot. CX Codex +1 327installs godot-genre-educational godot-genre-educational is a Claude Code skill for structuring educational Godot games with adaptive difficulty, student profiles, and spaced repetition. CX Codex +1 326installs

Project sponsors

Companies that keep this analytics open