# godot-adapt-single-to-multiplayer

godot-adapt-single-to-multiplayer is a Claude Code skill with patterns for adding multiplayer to single-player Godot games. It covers retrofitting online play and designing co-op.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 348 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-adapt-single-to-multiplayer/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-adapt-single-to-multiplayer

## What it does

The skill covers three architectural models: authoritative server (for PvP and competitive titles), lockstep P2P (for 2–4 player co-op), and hybrid host-authority (for party games). The core principle separates input (client) from simulation (authority): clients send intents only, the server validates and broadcasts state.

Includes scripts for key challenges: `multiplayer_sync.gd` handles remote peer interpolation, `rpc_bridge.gd` bridges gameplay events across the network, `net_prediction_reconciliation.gd` buffers input and replays it after server correction, `net_lag_compensation.gd` rewinds hit registration server-side (raycast into the past), `net_rpc_rate_limiter.gd` defends against RPC floods. A latency simulator (`net_latency_simulator.gd`) lets you test under ~150 ms delay.

Critical rules: never trust client positions (only input), avoid full-state sync every frame (use 20–30 Hz tick-rate), never snap peer positions (interpolate between snapshots with ~100 ms jitter buffer). Client-side prediction is mandatory or movement feels sluggish.

## Requirements
- Works with: Godot

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-single-to-multiplayer -a claude-code
```

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

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-single-to-multiplayer -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/godot-adapt-single-to-multiplayer/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-single-to-multiplayer -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/godot-adapt-single-to-multiplayer/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-adapt-single-to-multiplayer
```

2. **Manually: put the files in place**
- File: `.github/skills/godot-adapt-single-to-multiplayer/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-single-to-multiplayer -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/thedivergentai/Game-Dev-Agentic-Skills --path skills/godot-adapt-single-to-multiplayer
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/godot-adapt-single-to-multiplayer/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add thedivergentai/Game-Dev-Agentic-Skills --skill godot-adapt-single-to-multiplayer -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-adapt-single-to-multiplayer/SKILL.md

## When to use it
- add multiplayer to an existing single-player Godot game
- design an authoritative server for PvP with action validation
- eliminate jitter and latency in remote player movement sync
- protect against cheats and RPC-based DDoS attacks
- synchronise late-joining players with the current world state

## Example prompts
- Set up authoritative server for competitive play with `net_auth_server_validator.gd` to validate player positions
- Interpolate remote movement with a 100 ms jitter buffer using `net_snapshot_interpolation.gd`
- Rate-limit RPCs against floods with `net_rpc_rate_limiter.gd` and test under 150 ms latency via `net_latency_simulator.gd`

## Similar
- [godot-multiplayer](https://affpapa.org/en/nevibecode/skills/godot-multiplayer.md) — skill · 11600 installs
- [scenario-godot-multiplayer](https://affpapa.org/en/nevibecode/skills/scenario-godot-multiplayer.md) — skill · 431 installs
- [godot-resources](https://affpapa.org/en/nevibecode/skills/godot-resources.md) — skill · 12400 installs
- [scenario-godot-performance-export](https://affpapa.org/en/nevibecode/skills/scenario-godot-performance-export.md) — skill · 452 installs
- [layer-tilesets](https://affpapa.org/en/nevibecode/skills/layer-tilesets.md) — skill · 1100 installs
- [game-engines](https://affpapa.org/en/nevibecode/skills/game-engines.md) — skill · 206 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
