Agent skill

Godot Server Architecture

by thedivergentai in thedivergentai/GD-Agentic-Skills

Expert blueprint for dedicated / headless multiplayer hosts: ENet/DTLS, authority validation, safe packet decode, matchmaker handoff, and health telemetry.

LGPL-3.0Auto-check passedGame Development

Install Godot Server Architecture

skills CLI
$ npx skills add thedivergentai/GD-Agentic-Skills --skill godot-server-architecture -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install thedivergentai/GD-Agentic-Skills godot-server-architecture --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/thedivergentai/GD-Agentic-Skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/godot-server-architecture .claude/skills/godot-server-architecture && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
godot-server-architecture
GitHub stars
821
Token cost
~2.9k tokens
SKILL.md length
794 words
Files
17 (incl. scripts, references)
Skills in repo
98
Repo updated
First seen
Licence
LGPL-3.0

At a glance

Expert blueprint for dedicated / headless multiplayer hosts: ENet/DTLS, authority validation, safe packet decode, matchmaker handoff, and health telemetry.

  • Works in 5 steps: Headless detect/init — MANDATORY… → Safe decode — MANDATORY… → Host peer — enet_optimized_host.gd; add… → …
  • Building authoritative servers
  • SKILL.md covers Skill boundary (Do NOT Load), Host Golden Path (MANDATORY), Available Scripts and NEVER Do in Server…, plus 3 more sections
  • --headless hosts

What it does

Godot Server Architecture is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for dedicated / headless multiplayer hosts: ENet/DTLS, authority validation, safe packet decode, matchmaker handoff, and health telemetry. Use when building authoritative servers, --headless hosts, or hardening host networking. Keywords: dedicated server, headless, ENet, DTLS, authority, safepacketdecoder, multiplayer host, WebSocketMultiplayerPeer.

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 18 other files, including scripts and reference files (for example `references/migration-notes.md` and `references/rendering-physics-server-cookbook.md`).

It sits in Game Development, covering Game development and Multiplayer and networking. It works with Godot. The repository describes itself as: The official "Long-Term Memory" for Godot 4.7+ AI Agents. A high-density library of 99 expert skills and 27 genre blueprints, providing audited, strictly typed GDScript patterns… The licence is LGPL-3.0.

When your agent uses it

  • Building authoritative servers
  • --headless hosts
  • Hardening host networking

Example prompts

  • “/godot-server-architecture”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Headless detect/init — MANDATORY headless_init_manager.gd (--headless / dedicated_server feature).
  2. Safe decode — MANDATORY safe_packet_decoder.gd before any untrusted get_var.
  3. Host peer — enet_optimized_host.gd; add dtls_secure_server.gd when encrypting UDP.
  4. Authority — server_authority_validator.gd on every privileged RPC.
  5. Ops — peer_kick_manager.gd, server_health_exporter.gd; matchmaker handoff via server_matchmaker_client.gd.

What it can do on your machine

Read from SKILL.md and the folder at commit 4c4d0ff. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 14 files in scripts/, which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • docs.godotengine.org

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Godot Server Architecture loads about 2.9k tokens when it runs, and up to ~3.8k if it reads all its reference files. Until then it costs about 99 tokens; SKILL.md has 794 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~99
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~3.8k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from thedivergentai/GD-Agentic-Skills at commit 4c4d0ff, republished under its LGPL-3.0 licence (© thedivergentai). 794 words, ~2,936 tokens.

Download SKILL.mdSave it as .claude/skills/godot-server-architecture/SKILL.md (or your agent's skills folder). This skill also uses 16 other files; get the full folder from GitHub.
name
godot-server-architecture
description
Expert blueprint for dedicated / headless multiplayer hosts: ENet/DTLS, authority validation, safe packet decode, matchmaker handoff, and health telemetry. Use when building authoritative servers, --headless hosts, or hardening host networking. Keywords: dedicated server, headless, ENet, DTLS, authority, safe_packet_decoder, multiplayer host, WebSocketMultiplayerPeer.

Skill boundary (Do NOT Load)

Use this skill forUse godot-multiplayer-networking for
--headless / dedicated export bootLobby UI, matchmaking UX, friend invites
ENet/DTLS host peer + safe decodeRPC signatures, @rpc gameplay handlers
Authority validation on privileged opsMultiplayerSynchronizer / scene replication
Kick, health telemetry, matchmaker handoffClient prediction, lag compensation

Do NOT Load lobby/RPC tutorial scripts from multiplayer-networking when only booting a host — follow Host Golden Path here first.

Host Golden Path (MANDATORY)

  1. Headless detect/init — MANDATORY headless_init_manager.gd (--headless / dedicated_server feature).
  2. Safe decode — MANDATORY safe_packet_decoder.gd before any untrusted get_var.
  3. Host peer — enet_optimized_host.gd; add dtls_secure_server.gd when encrypting UDP.
  4. Authority — server_authority_validator.gd on every privileged RPC.
  5. Ops — peer_kick_manager.gd, server_health_exporter.gd; matchmaker handoff via server_matchmaker_client.gd.

Available Scripts

headless_init_manager.gd

Detect/initialize dedicated server logic for --headless / dedicated_server.

headless_manager.gd

Headless runtime manager companion patterns.

enet_optimized_host.gd

High-performance ENet UDP hosts with bandwidth/client limits.

dtls_secure_server.gd

DTLS + X509 hardening for ENet UDP.

safe_packet_decoder.gd

Forbid object decoding on untrusted packets (RCE guard).

manual_network_poll.gd

Manual multiplayer.poll() when auto-poll is disabled.

isolated_multiplayer_api.gd

Isolated MultiplayerAPI instances (client+server in one process).

server_authority_validator.gd

get_remote_sender_id() gates for authoritative requests.

websocket_server_compat.gd

HTML5-compatible WebSocketMultiplayerPeer hosts.

peer_kick_manager.gd

Graceful peer termination with reason propagation.

server_matchmaker_client.gd

Load-balancer / matchmaker handoff to game hosts.

server_health_exporter.gd

Headless telemetry for monitoring stacks.

physics_server_direct.gd / rid_performance_server.gd

Optional host-side RID sim — only when node physics cannot hold tick budget: > ~200 active bodies per tick, or headless host CPU > 70% on physics step with nodes. Criteria: profile first; if SceneTree bodies dominate, prefer godot-performance-optimization. Do NOT Load RID scripts for ≤64 entity lobbies.

NEVER Do in Server Architecture (Host)

  • NEVER trust the client — Validate state, purchases, and damage on the authoritative host.
  • NEVER use TRANSFER_MODE_RELIABLE for continuous streams — Prefer unreliable for high-rate transforms.
  • NEVER use get_var(true) on untrusted packets — Object decode = RCE. MANDATORY safe_packet_decoder.
  • NEVER use TCP for fast-paced action — Prefer ENet UDP (or WebSocket for HTML5 constraints).
  • NEVER run a dedicated server without stripping visuals — Dedicated Server export / dummy drivers.
  • NEVER expect RPCs before connected_to_server / peer ready.
  • NEVER assume UNRELIABLE packets arrive in order.
  • NEVER leave SceneTree.multiplayer_poll false without manual poll().
  • NEVER mix incompatible engine/multiplayer protocol versions across peers.
  • NEVER forget free_rid on server-created RIDs if the host uses Physics/RenderingServer pools.

Host Patterns

Interest management

Large worlds: MultiplayerSynchronizer.public_visibility = false + visibility filters (AABB / grid) so the host does not sync the entire world to every peer.

gdscript
# Hook on synchronizer — filter peers by grid cell / AABB (no full tutorial)
func _visibility_filter(for_peer: int, node: Node) -> bool:
	return _interest_grid.is_visible_to_peer(for_peer, node.global_position)
# Assign: synchronizer.set_visibility_filter(_visibility_filter)
Health metrics

Watch host FPS, static memory (RID leaks), and orphan counts via server_health_exporter.gd.

Deep recipes (on demand)

LLM-ignorance rule: if a general agent would not know it before reading, it lives here or in scripts/ — never delete, only move.

TopicReference
RID canvas/physics cookbookrendering-physics-server-cookbook.md

Reference

Progressive disclosure: open Official Documentation links only when researching a specific API; load Related Skills when routing to a peer domain — do not preload the whole lattice.

Show full SKILL.md (342 more words)Show less
Official Documentation
  • Using Servers — RID-based RenderingServer/PhysicsServer/NavigationServer workflow when SceneTree nodes are too slow.
  • RenderingServer — canvas_item_* / instance_* / free_rid for procedural draw and mesh swarms without MeshInstance nodes.
  • PhysicsServer3D — body_create, space binding, and direct-state queries for headless authoritative simulation.
  • PhysicsServer2D — 2D body/shape RIDs mirroring the same SceneTree-bypass pattern.
  • RID — opaque server handles; every *_create() needs a matching free_rid to avoid leaks.
  • High-level multiplayer — authority, RPCs, and peer lifecycle for dedicated hosts and isolated MultiplayerAPI branches.
  • ENetMultiplayerPeer — UDP host creation, channels/bandwidth limits, and DTLS host setup on peer.host.
  • WebSocket multiplayer — browser-compatible peer path when ENet UDP is unavailable (HTML5 clients).
  • Exporting for dedicated servers — dedicated-server export presets and stripping visuals/audio for production hosts.
  • Command line tutorial — --headless and CLI flags used by headless init/managers.
  • Binary serialization API — get_var(false) / object-decoding rules that block RCE on untrusted packets.
  • DTLSServer — DTLS accept path complementary to ENet dtls_server_setup with X509/TLSOptions.
Prerequisites
  • godot-project-foundations — project layout, Autoloads, and feature tags that dedicated-server and headless launches depend on.
  • godot-gdscript-mastery — typed RID arrays, @rpc annotations, and safe Variant decoding patterns used across server scripts.
  • godot-physics-3d — node-level PhysicsBody3D/space concepts before bypassing them with PhysicsServer3D RIDs.
Complements
Downstream / consumers
Master
  • godot-master — library router and mirrored module entry; open when discovering which Domain Skill owns a cross-cutting server concern.

© thedivergentai, LGPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 16 other files (scripts, references) in skills/godot-server-architecture of thedivergentai/GD-Agentic-Skills.

  • SKILL.md
  • references/migration-notes.md
  • references/rendering-physics-server-cookbook.md
  • scripts/dtls_secure_server.gd
  • scripts/enet_optimized_host.gd
  • scripts/headless_init_manager.gd
  • scripts/headless_manager.gd
  • scripts/isolated_multiplayer_api.gd
  • scripts/manual_network_poll.gd
  • scripts/peer_kick_manager.gd
  • scripts/physics_server_direct.gd
  • scripts/rid_performance_server.gd
  • scripts/safe_packet_decoder.gd
  • scripts/server_authority_validator.gd
  • scripts/server_health_exporter.gd
  • scripts/server_matchmaker_client.gd
  • scripts/websocket_server_compat.gd

Open the folder on GitHubat commit 4c4d0ff

Compare with similar skills

Godot Server Architecture next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Godot Server Architecture compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Godot Server Architecture this skillthedivergentai/GD-Agentic-Skills821—~2.9kAutomated safety check: PassLGPL-3.0
Godot Multiplayergamedev-skills/awesome-gamedev-agent-skills1.4k—~1.6kAutomated safety check: PassApache-2.0
Gamedev Multiplayerericrisco/rsc-harness180—~3.9kAutomated safety check: PassMIT
Unityericrisco/rsc-harness180—~4kAutomated safety check: PassMIT
Godot Gdscript Patterns925236118/AlphaAgent10310 repos~5kAutomated safety check: PassMIT
2D Map and Scene Generator0x0funky/agent-sprite-forge4.4k—~2.9kAutomated safety check: PassMIT

Similar skills

  • Godot Multiplayer

    gamedev-skills/awesome-gamedev-agent-skills

    Build networked games with Godot 4.7 high-level multiplayer: set up an ENetMultiplayerPeer server/client, define RPCs with the @rpc annotation (call via rpc()/rpcid()), set per-node multiplayer…

    1.4k GitHub stars~1.6k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed
  • Gamedev Multiplayer

    ericrisco/rsc-harness

    A skill your agent uses when adding multiplayer or netcode to a game — client-server vs P2P, server authority and anti-cheat, state replication vs RPCs, prediction and reconciliation, lag…

    180 GitHub stars~3.9k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Unity

    ericrisco/rsc-harness

    A skill your agent uses when writing, reviewing or structuring Unity game code in C for Unity 6 LTS — GameObjects and the Transform hierarchy, the MonoBehaviour lifecycle, prefabs and variants…

    180 GitHub stars~4k tokensUpdated yesterday
    Game DevelopmentAuto-check passed
  • Godot Gdscript Patterns

    925236118/AlphaAgent

    Master Godot 4 GDScript patterns including signals, scenes, state machines, and optimization.

    103 GitHub starsUsed in 10 repos~5k tokens
    Game DevelopmentAuto-check passed
  • 2D Map and Scene Generator

    0x0funky/agent-sprite-forge

    Plans and builds 2D game maps and scenes, from tilemaps and parallax backgrounds to HD-2D plates, with collision checks, a playable HTML preview and Tiled, Godot or LDtk export.

    4.4k GitHub stars~2.9k tokensUpdated 4 days ago
    Game DevelopmentAuto-check passed
  • Development and review guide for the Fantasy C# distributed game server framework: ECS, FTask, routing, service discovery, config and databases.

    1.4k GitHub stars~5.8k tokensUpdated 2 days ago
    Game DevelopmentAuto-check passed

More from thedivergentai/GD-Agentic-Skills

All 98 skills in this repo
  • Godot 2D Animation

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 2D animation in Godot using AnimatedSprite2D and skeletal cutout rigs.

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot 3D World Building

    thedivergentai/GD-Agentic-Skills

    Expert patterns for 3D level design using GridMap with MeshLibrary, CSG constructive solid geometry, occlusion, and runtime GridMap builders.

    821 GitHub stars~3.3k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 2D To 3D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for migrating 2D games to 3D including node type conversions, camera systems (third-person, first-person, orbit), physics layer migration, sprite-to-model art pipeline, and control…

    821 GitHub stars~4.7k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Adapt 3D To 2D

    thedivergentai/GD-Agentic-Skills

    Expert patterns for simplifying 3D games to 2D including dimension reduction strategies, 2.5D fake-depth, isometric ports, camera flattening, physics conversion, 3D-to-sprite art pipeline, and…

    821 GitHub stars~4.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Agent Vision

    thedivergentai/GD-Agentic-Skills

    Agentic eyes for Godot work: cross-platform screenshot CLI (asset/region/window/screen) to budgeted WebP, TEMP editor viewport bridge under .gdskills/, and Taste Receptor Atlas v2 (~237…

    821 GitHub stars~3.5k tokensUpdated 1 mo ago
    Auto-check passed
  • Godot Animation Tree Mastery

    thedivergentai/GD-Agentic-Skills

    Expert patterns for AnimationTree including StateMachine transitions, BlendSpace2D for directional movement, BlendTree for layered animations, root motion, transition conditions, advance…

    821 GitHub stars~3.6k tokensUpdated 1 mo ago
    Auto-check passed

Works with

Questions about Godot Server Architecture

What does Godot Server Architecture do?

Expert blueprint for dedicated / headless multiplayer hosts: ENet/DTLS, authority validation, safe packet decode, matchmaker handoff, and health telemetry. Godot Server Architecture is an agent skill from thedivergentai/GD-Agentic-Skills. Expert blueprint for dedicated / headless multiplayer hosts: ENet/DTLS, authority validation, safe packet decode, matchmaker handoff, and health telemetry.

When should I use Godot Server Architecture?

Godot Server Architecture fits situations like: building authoritative servers; --headless hosts; hardening host networking.

How do I install Godot Server Architecture in Claude Code?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-server-architecture -a claude-code`. Or copy the skill folder (skills/godot-server-architecture in thedivergentai/GD-Agentic-Skills) into .claude/skills/godot-server-architecture in your project. Claude Code loads it when a task matches its description.

How do I install Godot Server Architecture in Codex?

Run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-server-architecture -a codex`. Or copy the skill folder (skills/godot-server-architecture in thedivergentai/GD-Agentic-Skills) into .agents/skills/godot-server-architecture in your project. Codex loads it when a task matches its description.

Can I use Godot Server Architecture in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add thedivergentai/GD-Agentic-Skills --skill godot-server-architecture -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/godot-server-architecture, .gemini/skills/godot-server-architecture, .github/skills/godot-server-architecture and .opencode/skills/godot-server-architecture in your project.

What does Godot Server Architecture need to run?

SKILL.md names no scripts, command-line tools or credentials: Godot Server Architecture is instructions for the agent only.

Does Godot Server Architecture access the network?

SKILL.md names 1 domain. As links in the text: docs.godotengine.org. This is read from the text; nothing was executed.

Is Godot Server Architecture safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Godot Server Architecture use?

Godot Server Architecture is published under the LGPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Godot Server Architecture use?

About 2.9k tokens (SKILL.md is roughly 12k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 897 tokens, read only when the agent opens those files.

What are the alternatives to Godot Server Architecture?

Skills that share tags, products or a category with Godot Server Architecture: Godot Multiplayer (gamedev-skills/awesome-gamedev-agent-skills, 1.4k stars), Gamedev Multiplayer (ericrisco/rsc-harness, 180 stars), Unity (ericrisco/rsc-harness, 180 stars) and Godot Gdscript Patterns (925236118/AlphaAgent, 103 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Godot Server Architecture?

thedivergentai (a GitHub user) maintains it in thedivergentai/GD-Agentic-Skills, which has 821 GitHub stars. The repository holds 98 skills in this directory. The repository was last updated on September 9, 2026.

Source: thedivergentai/GD-Agentic-Skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.