# godot-genre-shooter-fps

godot-genre-shooter-fps — a Godot FPS skill covering mouse look, movement physics, hitscan fire, recoil, weapon motion, and server-checked hit handling.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 296 installs · ★ 983 repo stars
- Author: thedivergentai
- License: LGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-genre-shooter-fps/SKILL.md
- Updated: 2026-10-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/godot-genre-shooter-fps

## What it does

This skill lays out a first-person shooter setup for Godot. Its scripts cover mouse look through `_input`, acceleration and friction, air control, hitscan queries with `intersect_ray`, weapon bob and sway, plus procedural recoil. Other included pieces handle weapon states, spread, impact decals, animation links, and aim assistance.

The gameplay flow moves from movement and aiming to firing, recoil recovery, and target acquisition. The rules place hit checks in `_physics_process`, require the player RID to be excluded from the query, and put damage under server authority with lag compensation. Mouse input belongs in `_input`; muzzle direction comes from `-transform.basis.z`.

The skill also covers step-up movement, tactical camera lean, layered gunfire audio, pooled decals, and `WeaponData` resources for weapon values. That networking requirement is concrete: client-trusted damage does not fit this FPS setup.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-shooter-fps -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/godot-genre-shooter-fps/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/godot-genre-shooter-fps/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-shooter-fps -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/godot-genre-shooter-fps/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-shooter-fps -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-genre-shooter-fps/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install thedivergentai/Game-Dev-Agentic-Skills skills/godot-genre-shooter-fps
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-genre-shooter-fps/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-shooter-fps -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-genre-shooter-fps
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-genre-shooter-fps/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-genre-shooter-fps -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/thedivergentai/Game-Dev-Agentic-Skills/tree/HEAD/skills/godot-genre-shooter-fps/SKILL.md

## When to use it
- build mouse-look controls with `_input`
- tune FPS movement with air control
- trace hitscan shots through `intersect_ray`
- apply camera recoil and weapon spread
- add bobbing and sway to a viewmodel

## Example prompts
- Build a Godot FPS controller with mouse look, acceleration, friction, and air control.
- Add hitscan firing with `intersect_ray`, exclude the player RID, and run hit checks in `_physics_process`.
- Wire procedural recoil, weapon bobbing, and tactical camera lean into the FPS controller.

## Similar
- [fps-shooter](https://affpapa.org/en/nevibecode/skills/fps-shooter.md) — skill · 12000 installs
- [godot-signals-groups](https://affpapa.org/en/nevibecode/skills/godot-signals-groups.md) — skill · 12300 installs
- [spritecook-use-assets-in-godot](https://affpapa.org/en/nevibecode/skills/spritecook-use-assets-in-godot.md) — skill · 773 installs
- [scenario-godot-vfx](https://affpapa.org/en/nevibecode/skills/scenario-godot-vfx.md) — skill · 469 installs
- [scenario-godot-rendering-lighting](https://affpapa.org/en/nevibecode/skills/scenario-godot-rendering-lighting.md) — skill · 449 installs
- [godot-ui](https://affpapa.org/en/nevibecode/skills/godot-ui.md) — skill · 2700 installs

From the same set: [thedivergentai/game-dev-agentic-skills](https://affpapa.org/en/nevibecode/by/thedivergentai/game-dev-agentic-skills.md) — 100 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
