godot-autopilot-content
Skill1 starsChanged 17 days agoMITView on GitHub
Godot content pipeline guide: TileMap and TileSet, AnimationPlayer and AnimationTree, audio buses and playback, and Control theming and layout - with the silent-failure gotchas of each domain. Use when building tile levels, animating, configuring sound or styling UI.
In this repository16 other files it gives its agents.
- AGENTS.mdAGENTS.md
- cpp-registrationSkill
- domain-tool-authoringSkill
- gda-demo-e2eSkill
- gda-e2e-analysisSkill
- skill-proposerSkill
- thread-security-gateSkill
- wiki-maintainerSkill
- godot-autopilot-csharpSkill
- godot-autopilot-resourcesSkill
- godot-autopilot-runtimeSkill
- godot-autopilot-scene-systemSkill
- godot-autopilot-scriptingSkill
- godot-autopilot-serversSkill
- godot-autopilotSkill
- godot-autopilot-toolsSkill
The file
Files
Godot Content Pipeline
Invocation: use the native MCP tools first; when that channel is down, follow the calling ladder in the godot-autopilot-tools skill (the gda CLI, via bunx, a global install, or the standalone gda binary); with no CLI available, work through its references/manual-fallback.md.
Four content domains via godot-autopilot: TileMap and TileSet levels,
AnimationPlayer and AnimationTree animation, audio buses and playback, and
Control theming and layout. Each section below is the condensed workflow plus
that domain's top gotchas; the references/ files carry the full tool
payloads and the source-verified silent-failure details. Scene tools act on
the scene open in the Godot editor; audio bus tools act on the editor
process (a running game keeps its own device and layout).
TileMap and TileSet
Build order matters: node, then TileSet, atlas source, physics layer, then cells.
create_tilemap- the TileMap node with an attached default TileSet (name,tile_sizepixels,parent_path; the scene must already have a root, otherwise the call errors).create_tilemap_tileset- a TileSet resource in memory (memory:// reference; nothing on disk yet).add_tilemap_atlas_source- slice ares://texture into a tile grid (source_id0-255 must be unused; optionalmargin/spacing). Returns the source id, created tile count and grid size.add_tilemap_physics_layer- required before per-tile collision (optionalcollision_layer/collision_maskbitmasks, default 1).save_resourcethe TileSet to disk, thenproperty_setthe node'stile_setto the saved path - a memory:// resource must never be assigned to a node property directly. Finish withsave_editor_scene.set_tilemap_cell/set_tilemap_cells- place tiles.source_idmust already exist in the node's TileSet; cell tools accept TileMap or TileMapLayer nodes.set_tilemap_tile_collision- polygon points are relative to the tile center (a full 16 px square is (-8,-8)..(8,8)); an array of arrays sets multiple polygons, an empty array clears.
Bulk example:
{"name": "set_tilemap_cells", "arguments": {"node_path": "Ground", "cells": [{"x": 0, "y": 9, "source_id": 0, "atlas_coords": {"x": 0, "y": 0}}, {"x": 1, "y": 9, "source_id": 0, "atlas_coords": {"x": 1, "y": 0}}]}}Top gotchas (details in the reference):
set_cellwith exactly one of source id / atlas coords / alternative INVALID silently clears the cell instead of erroring.set_tilemap_cellshas no fixed server-side entry cap; oversized JSON arguments can hit client or transport request limits and fail as a parse error before the tool runs. For map-scale fills, loop overset_cellwithexecute_scriptorcode_execute. An entry withsource_id-1 clears the cell at those coordinates.- Invalid entries in a bulk call are skipped with a warnings list and a set count - read both back.
- A texture that is missing on disk or not yet imported errors at atlas creation.
- 4.8: TileMap/TileMapLayer/TileSet moved into modules/; TileMap is now a thin wrapper over TileMapLayer - prefer TileMapLayer for new work.
Animation
Three sub-workflows: AnimationPlayer clips, AnimationTree state machines, and SpriteFrames for AnimatedSprite2D.
AnimationPlayer
create_scene_animation_player- add the node (parent_pathrequired, e.g. Root/Actors;namedefaults to AnimationPlayer).create_animation- a clip in the player's default library.namemust not exist yet (checkget_animation_listfirst);loop_mode0 none, 1 linear, 2 pingpong;length_secdefault 1.0.create_animation_track-track_typevalue or method. Value tracks needproperty(e.g. position:x or modulate:a) and become node:property paths; duplicate node+property tracks are rejected.insert_animation_keyframe-timein seconds. Value tracks take the property value as JSON (number or object); method tracks take {"method": ..., "args": [...]}.get_animation_list- verify clip lengths and loop modes after building.
{"name": "create_animation", "arguments": {"player_path": "AnimationPlayer", "name": "walk", "length_sec": 1.0, "loop_mode": 1}}remove_animation_track deletes a track by index; remove_animation deletes
a clip by name across all libraries. There is no single-key delete tool - use
code_execute for surgical key edits. Clips persist with the scene after
save_editor_scene.
AnimationTree state machines
create_scene_animation_tree creates the tree with an empty
AnimationNodeStateMachine root and optionally wires anim_player. Add states
with add_animation_machine_state (unique state_name; animation assigns
the clip) and connect with connect_animation_states - condition names a
bool parameter and switches the transition to automatic advance; omit it for
a manual transition. Both states must exist first; duplicate transitions are
rejected.
SpriteFrames
create_spriteframes creates an in-memory SpriteFrames and, as a flagged
side effect, removes the built-in default animation. Add named animations
with add_spriteframes_animation (fps, loop), then add_spriteframes_frame -
optional hframes/vframes split a sheet into one AtlasTexture frame per
cell, duration scales per-frame timing. Save with save_resource, then
property_set the node's sprite_frames (the Godot 3 frames name is gone).
Top gotchas (details in the reference):
- Inserting a key at an existing time replaces it but keeps the old key's transition, and the engine returns the PREVIOUS index - do not treat it as a fresh append.
travelwith no constructable transition path silently teleports (states reset per reset_on_teleport); a missing destination name errors; deleting the currently playing state silently stops playback.- AUTO transitions fail silently when the mode is not AUTO, the condition parameter is unregistered or false, or the expression errors.
- Value track update modes are only CONTINUOUS/DISCRETE/CAPTURE; bool, int and String properties need DISCRETE.
Audio
Audio bus tools act on the editor process. Master is always bus 0; bus
setters take a zero-based bus_index and apply immediately.
get_audio_bus_layout- snapshot the complete layout first; it doubles as your read-back for bus count, names, volumes and effect chains.set_audio_bus_volume_db/set_audio_bus_mute/set_audio_bus_solo/set_audio_bus_bypass_effects- the four per-bus switches.add_audio_bus_effect-effect_typeis an instantiable AudioEffect subclass class name (e.g. AudioEffectReverb);at_positioninserts, -1 appends.remove_audio_bus_effecttakes the chain index - read the chain first.set_audio_bus_layout- replaces the ENTIRE layout (count, names, volumes, effects). Never write back a hand-made partial object: get -> edit the returned object -> write back.- Player tools for AudioStreamPlayer/2D/3D:
play_audio_player(optionalstream_path,from_position),stop_audio_player,set_audio_player_volume_db,set_audio_player_pitch_scale,get_audio_player_playback_position,seek_audio_player. - Devices:
get_audio_device_outputs/get_audio_device_inputslist hardware names;set_audio_device_output/set_audio_device_inputswitch the editor device (devicemust match a listed name).
Minimal example - a reverb on Master, then a shot:
{"name": "get_audio_bus_layout", "arguments": {}}
{"name": "add_audio_bus_effect", "arguments": {"bus_index": 0, "effect_type": "AudioEffectReverb"}}
{"name": "play_audio_player", "arguments": {"node_path": "Level1/Player", "stream_path": "res://audio/shot.wav"}}Top gotchas (details in the reference):
- A player whose
busnames a nonexistent bus silently plays on Master. - Adding or renaming a bus onto an existing name silently appends " 2" / " 3".
- bypass skips the effect chain; mute multiplies by zero AFTER effects - a muted bus still spends effect CPU. Solo overrides mute.
- A bus
sendto a missing bus or a cycle silently reroutes to Master; the layout caps at 256 buses.
UI Theming and Layout
Theme files
create_theme_resource- create the .tres under res:// (missing directories are created; an existing file is never overwritten;base_typeis reference metadata only).set_theme_color/set_theme_constant/set_theme_font_size/set_theme_stylebox_flat- each takespath,theme_type(e.g. Button) andvarname, then load-modify-saves the file. Colors take #rrggbb, #rrggbbaa or rgba float objects; the stylebox builder takes optional bg_color, border_color, border_width, corner_radius and content_margin (a single number applies to all sides). Runget_theme_infofirst to list valid type/item pairs.apply_theme_to_control- assign the theme to a Control in the edited scene; only the in-memory scene changes, so finish withsave_editor_scene.
Anchor presets and runtime recon
set_control_anchor_preset applies one of the 16 Control layout presets
(center is 8, full_rect is 15) to a node in the edited scene. The tool's
keep_offsets defaults to false - offsets are recomputed for the new
anchors. Persist with save_editor_scene.
While the game runs, get_game_ui_elements walks the running Control tree:
node path, type, visibility, optional text and global rectangle per Control
(max_elements default 100 / hard cap 1000, truncated responses are flagged;
timeout_ms default 5000 / max 25000). Use the rectangles to aim
queue_game_input - the game channel details are in the runtime skill.
The full-window root recipe (preset, zero-offset readback, grow-both
centering) is in references/ui-theme-details.md.
HUD-theme feedback is often short-lived (a toast that lives 2 s, a death
overlay that blinks for 0.7 s), so screenshotting it needs a condition rather
than a poll-and-race. capture_game_viewport (and capture_editor_viewport
with target game) takes after_frames (rendered frames to wait) and
when (a GDScript expression re-checked every rendered frame, run against the
current scene, e.g. a HUD label's text becoming non-empty). Act first, then
call capture with a condition - do not slow the game down. A malformed
expression fails immediately; an expression that never turns true returns a
structured timeout error instead of hanging. For small themed text, add
scale (integer 1-8, nearest neighbour) after the region crop; the
max_dimension cap still wins when both are given.
Top gotchas (details in the reference):
- The engine preset APIs disagree:
set_anchors_presetalone keeps offsets by default,set_anchors_and_offsets_presetforces a recompute - know which one your GDScript calls. - Anchored Controls do not persist
position/sizein .tscn; anchor_, offset_ and grow_* are the persisted truth. - Theme lookup exhausts each ancestor's whole type chain before moving outward - a near ancestor's generic item beats a far ancestor's exact variation, and variation chains do not cross Theme boundaries.
See also
- TileMap and TileSet details - full payloads, serialization bounds, alternative-tile bits, silent failures.
- Animation details - track/keyframe semantics, travel and AUTO transition rules, SpriteFrames payloads.
- Audio details - bus naming and send routing, bypass vs mute CPU costs, polyphony stealing.
- UI theme details - preset enums, the persistence model, the theme lookup chain.
- godot-autopilot-scene-system - node lifecycle,
property_setJSON value shapes, the property rename table. - godot-autopilot-resources -
save_resource, the texture import pipeline and .tres path rules. - godot-autopilot-scripting -
code_executefor bulk cell fills and surgical animation edits. - godot-autopilot-runtime - run the scene, inspect the live UI tree and inject input at styled controls.
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

