scenario-godot-gameplay
Use when building gameplay systems in Godot 4.7: enemy AI that patrols, chases and attacks, state machines, behavior trees (LimboAI), NavigationAgent3D pathfinding and avoidance for 100 to 1000 enemies, 'agents stack up' or 'path is empty', hitbox and hurtbox combat, fast bullets going through walls…
Install / Use
npx skills add scenario-labs/skills --skill scenario-godot-gameplayInstalls into whichever agent you are using.
SKILL.md
Installable skill definition
Quality Score
Category
OtherSupported Platforms
Tags
Our assessment of scenario-godot-gameplay
scenario-godot-gameplay scores 86/100 on our quality scale, 198th of 354 Other skills we index.
Its SKILL.md is 19 KB long, well organised into 11 sections and no code examples: a thorough specification that gives an agent plenty to work with.
With 1,048 GitHub stars, it is one of the more widely adopted skills in the catalogue.
Maintenance, license and trust
- The repository was last updated 35 days ago, so scenario-godot-gameplay is actively maintained.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-11-20. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
scenario-godot-gameplay compared with similar skills
All 4 of these similar skills score higher than scenario-godot-gameplay; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| scenario-godot-gameplay (this skill)by scenario-labs | 86 | 1.0k | 35d ago | SKILL.md |
| algorithmic-artby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| pptxby anthropics | 100 | 177.9k | 2mo ago | SKILL.md |
| prospectingby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
| ad-creativeby coreyhaines31 | 100 | 60.1k | 11d ago | SKILL.md |
Frequently asked questions
- How do I install scenario-godot-gameplay?
- Run
npx skills add scenario-labs/skills --skill scenario-godot-gameplay. The install tabs above show the steps for each supported agent. - Which AI agents does scenario-godot-gameplay work with?
- It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
- Is scenario-godot-gameplay safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is scenario-godot-gameplay still maintained?
- The repository was last updated 35 days ago, so scenario-godot-gameplay is actively maintained.
Skill content
View source on GitHubname: scenario-godot-gameplay description: "Use when building gameplay systems in Godot 4.7: enemy AI that patrols, chases and attacks, state machines, behavior trees (LimboAI), NavigationAgent3D pathfinding and avoidance for 100 to 1000 enemies, 'agents stack up' or 'path is empty', hitbox and hurtbox combat, fast bullets going through walls, save and load, inventory, quests, dialogue (Dialogue Manager), input remapping, procedural dungeons, or measuring agent counts and frame time headless." license: MIT
Godot gameplay systems (gameplay systems programmer)
Target: Godot 4.7.2.stable, Jolt, macOS Apple Silicon.
At expert level, gameplay systems are small contracts that can be tested without a scene: pure
decision functions, Resources for data, groups for discovery. Their cost is measured at the agent
count the game needs before anyone argues about it. The core stance: build the rule as data, run it
headless at --fixed-fps 60, then look at one capture. If a sibling skill named here is missing
from your available skills, load it with skill_get (Scenario MCP) or ask the user to install it
(https://github.com/scenario-labs/skills#install); unattended, proceed from tool schemas and flag
the gap.
REQUIRED BACKGROUND: scenario-godot-expert (channels, gd_run, the review loop, 4.7 traps).
Status (2026-10-02): 16 live tests, the round-2 checks (P15) and the offline suite pass in Godot
4.7.2 (references/procedures.md, tests/code/godot-gameplay/).
Dialogue Manager 4.1.0, LimboAI 1.8.1 and GUT 9.7.1 were run in their own project copies.
Stance (the expert delta)
- Benchmark with
--fixed-fps 60, never plain headless. A headless frame sleeps 6.9 ms (low_processor_usage_mode_sleep_usec) and runs fewer physics ticks than frames.Performance.TIME_*monitors refresh about once per second and read 0 under fixed fps. Measure wall milliseconds per frame, median of 3, and compare A/B pairs from the same run (observed, P0). - The crowd is not the bottleneck the baseline thinks. 200 CharacterBody3D enemies with
NavigationAgent3D avoidance cost about 2 ms per frame on an M5 Max. Cost is linear to 800 agents
(7.3 ms), and avoidance itself is within noise at 200. Tuning
max_neighborsor the repath interval gave no measurable gain. What avoidance buys is correctness: 0 overlapping pairs against 3108 without it (P2). Go to server agents plus one MultiMesh (0.26 ms for 200) only when the agents need no nodes. - Wait for the mesh you assigned, not for "the map". The docs say wait one physics frame. Live,
the first sync took 3. After a rebake the map id moved while the region still served the old
polygons. Read
region_get_iteration_idbefore assigning, wait for it to move, then one more map sync (nav_tools.wait_applied, P1). - Bake from a group of static colliders. A new NavigationMesh parses Both (meshes and colliders) from the region's children, so an NPC under the region carves a 3 m hole (Bramwell 2W4JP48oZ8U 00:12:37; measured P1).
- Pick the AI tier by the deciding condition. Use an enum brain for crowds (Shaggy Dev oqFbZoA2lnU 00:00:32) and a node FSM for a hero or player character. Use a behavior tree when designers author behavior (Chap.C E_FIy2dTkNc), and GOAP only when many generic actions recombine (Wahaha Yes cm5Jxo31plw). Budget thinking: 5 Hz with 40 enemies per tick cost 0.07 ms over no AI; every enemy every tick cost 0.45 ms (P3).
- Hitboxes mask, hurtboxes layer, one HitLog per swing (Queble cX-vzfmzjnE 00:06:36, 00:12:55). New areas start on layer 1 and mask 1 and hit their own owner (P4).
- Fast bullets are data, or bodies with CCD. Without
continuous_cd, 6 of 8 balls went through a 0.1 m wall even at 30 m/s. Jolt clamps at 500 m/s. Ray-swept data bullets drawn by one MultiMesh cost 0.35 ms per 1000, against 1.05 ms for pooled RigidBody3D with CCD (P5). - A
.tressave is code. A GDScript sub_resource runs on load (Godotneers 43BZsLZheA4 01:03:14; reproduced P6). Scan before loading, load withCACHE_MODE_IGNORE, version and migrate, validate values instead of encrypting (01:01:37).
The NavigationAgent3D contract (P15, measured)
Docs warnings (NavigationAgents page) and Bramwell (2W4JP48oZ8U 00:14:14), measured in 4.7.2 unless marked:
- Avoidance needs a
target_position. With avoidance on and no target,safe_velocitystayed 0 for 30 ticks; with a target it returned the full 3 m/s. - Avoidance never feeds pathfinding. Agents are circles with no navmesh or physics knowledge, so walls still come from the path (docs).
- One
get_next_path_position()per physics frame, and none after the end. Onceis_navigation_finished()is true it still returns the last point (0.93 m away here): stop steering there, or the agent creeps. path_desired_distancemust exceed one tick of travel and the navmesh's float above the floor (about 0.3 m). At 25 m/s (0.42 m per tick) with 0.1, the agent reversed on 1782 of 1800 ticks and never arrived; at 1.0 it arrived in 182. With 0.1 and the feet measured at floor height, it never left the first path point.- Defaults:
time_horizon_agents1.0,time_horizon_obstacles0.0. Lower the horizon if agents slow down too early. Too fewmax_neighborsand avoidance is ignored (docs; not measured here).
Establish first
| Input | Why it changes the plan | Default | | ------------------------- | ---------------------------------------- | ------------------------------------------------ | | Agent count on screen | nodes vs server agents, think budget | 200 | | Frame budget for gameplay | the gate for every benchmark | a quarter of 16.67 ms (4.2 ms) at 60 fps [added] | | 2D or 3D | NavigationAgent2D vs 3D, Area2D vs 3D | 3D | | Who authors behavior | code (FSM, enum) vs designers (LimboAI) | code | | Save trust | own files only vs shared or modded saves | shared: scan or JSON | | Platform | input devices, CPU budget | desktop, keyboard and mouse plus pad |
Workflow
- Set up the project.
- Clone Base3D with
gd_env.base_project("3d", P)and give it its ownapplication/config/name, because clones otherwise shareuser://. Rungg.install(P). - GATE: project.godot has
3d/physics_engine="Jolt Physics"and a stated renderer;gd_run.check_all(P)reports 0 parse errors.
- Clone Base3D with
- Level navigation.
- Static geometry goes in group
nav_source. Build the mesh withmake_navmesh(parsed colliders, source group), thenbake, thenwait_applied. - GATE:
map_get_pathbetween sample points is non-empty with 0 obstacle crossings; the polygon count is above 0; no hole at NPC spawns (P1).
- Static geometry goes in group
- Movement and the crowd.
- Enable avoidance;
velocity_computeddrivesmove_and_slide; repath is throttled; steering is XZ only. - Run
gg.crowd_bench(P, n)at 50, 200 and 800, thengg.scaling_verdict. In your own benchmark scene, logPerformance.add_custom_monitor(&"ai/thinks", callable)andOBJECT_ORPHAN_NODE_COUNTbeside wall time (it read 5 after 5 strayNode.new(), P15). - GATE: 0 overlapping pairs; exponent under 1.3; the median at the target count fits the gameplay
budget (
gg.budget_share); the orphan count is flat. Then a windowed capture of the crowd, opened.
- Enable avoidance;
- AI.
- Write the brain as
decide(state, percept)with hysteresis. Perception is cheap first (distance, cone, one ray, stale-hit check). The manager thinks at about 5 Hz with a per-tick cap. Far enemies think less: key the tiers on squared distance, becauseVisibleOnScreenNotifier3D.is_on_screen()stays false headless and a benchmark would put everyone in the far tier (P15). The node FSM is for the hero; LimboAI if designers author. - GATE: the GUT transition table is green; the hero scenario history matches the expected sequence (patrol, chase, attack, chase, search, patrol); the think-cost A/B is measured (P3, P9, P13).
- Write the brain as
- Combat.
- Name the layers (World 1, Player 2, Enemy 3, PlayerHurtbox 5, EnemyHurtbox 6, Projectile 7).
Hitbox and hurtbox come from the kit. Bullets go through
bullet_pool; bouncing objects are RigidBody3D with CCD. - GATE: a shared-log swing scores 1 hit; same faction 0; the tunnelling test reads 0 of 8 at the top speed; bullets on their own layer (P4, P5).
- Name the layers (World 1, Player 2, Enemy 3, PlayerHurtbox 5, EnemyHurtbox 6, Projectile 7).
Hitbox and hurtbox come from the kit. Bullets go through
- Persistence.
- Typed save Resource with VERSION and
migrate(),save_io.save_resource_atomic,load_resource_checked; inventories duplicated per holder. - GATE: round trip equal; every old fixture loads; the evil fixture is refused; the cache test passes (P6, P7).
- Typed save Resource with VERSION and
- Dialogue and quests.
- Dialogue Manager 4.x
.dialoguefiles; quest order is turn in, then continue, then offer. - GATE: the import compiles every file with 0 errors;
gg.check_dialogue_textfinds no missing cue; a headless walk reaches each branch and mutates state (P8).
- Dialogue Manager 4.x
- Input.
- Physical-key actions; gameplay in
_unhandled_input; remaps go to a ConfigFile. - GATE: synthetic press and just-pressed tests pass; the STOP panel consumes a pushed click; the remap survives a reload (P10).
- Physical-key actions; gameplay in
- Procedural content.
- Seeded data first (
dungeon_gen), validators, then geometry, bake and path. - GATE: 1000 seeds with 0 validator failures; the same seed gives the same hash; a path from start to boss exists; the top capture is opened (P11).
- Seeded data first (
- Wrap up.
- Run
test_gameplay_live.pyand copy the evidence. Score yourself againstreferences/critique.md.
- Run
Numbers
| Value | Measured | Relative to |
| -------------------------------- | ------------------------------------------------------------------------------- | ---------------------------------------------------- |
| 200 bodies with avoidance | 1.98 ms per frame, 0 overlaps | M5 Max, fixed fps 60, 60 m arena with 14 obstacles |
| Scaling with avoidance | 50 agents: 1.07 ms, 200: 2.00, 800: 7.31 (about 9 µs per agent) | same |
| 200 server agents plus MultiMesh | 0.26 ms | same |
| Think cost, 200 enemies | budget 0.40 ms, every tick 0.78, none 0.33 | 5 Hz, 40 per tick |
| First navmesh sync | 3 physics frames; rebake applied after 2 to 16 | async iterations on (default) |
| Bake | 5 ms, 180 polygons | 60 m arena, cell 0.25 |
| 1000 bullets | data 0.35 ms; RigidBody3D with CCD 1.05; without CCD 1.00 (45% miss walls) | 60 m/s, 2 s life |
| Jolt speed clamp | 500 m/s | physics/jolt_physics_3d/limits/max_linear_velocity |
| Dungeon generate plus validate | 88 µs median, 1000 of 1000 valid | 14-room main path, 4 branches |
Truncated for display — read the full file on GitHub.
Related Skills
algorithmic-art
177.9kCreating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems.
pptx
177.9kUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an em…
prospecting
60.1kWhen the user wants to find and qualify prospects for outbound, or asks who to target first, which signal to prioritize, or where to spot buyers with the problem: buying signals, enrichment, verification, account research.
ad-creative
60.1kWhen the user wants to write or judge ad creative, or asks which ad, hook, or angle to run or kill: headlines, primary text, and variations for Google, Meta, LinkedIn, and TikTok, fresh angles when creative fatigues. Test hypotheses name the metric, comparison, and expected direction.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
