← ExekiteCONTENT HISTORY

Update to Exekite

Snapshot Nov 17, 2026 · 12:11 UTC · version 1.0.0

Collection source: downloaded plugin package.

WHAT CHANGED

First saved snapshot

No earlier snapshot is available to establish a change.

Save Exekite and check future changes in Following.

Up to 3 plugins free · no card required.

Compare saved observations

Download comparison JSON
Full technical diff · 0 changed fields
Full snapshot data
{
  "description": "For Exekite-hosted Godot games only. Typed ArtBank accessors and legacy AssetRegistry guard shapes. Use when wiring existing generated textures, SpriteFrames, model scenes or audio, or repairing code inside their guards. Preserve the procedural fallback and match the accessor to the resource kind. Also for moving a static 3D model or a code-built 3D character (holder bob, lean and turn; jointed limbs).",
  "included_files": [],
  "name": "generated-media-wiring",
  "skill_md_contents": "---\nname: generated-media-wiring\ndescription: \"For Exekite-hosted Godot games only. Typed ArtBank accessors and legacy AssetRegistry guard shapes. Use when wiring existing generated textures, SpriteFrames, model scenes or audio, or repairing code inside their guards. Preserve the procedural fallback and match the accessor to the resource kind. Also for moving a static 3D model or a code-built 3D character (holder bob, lean and turn; jointed limbs).\"\n---\n\n# Wiring guarded art\n\nUse this craft when integrating existing media or a model created through the\nExekite connection. The typed `create_3d_model`, `open_3d_model`, and\n`save_3d_model` tools can author and register a retained model, source and\npreview. Paid image, sound, and animation generation, when the user asks for\nit, uses `estimate_cost` and then the matching paid asset tool; a code edit\ndoes not request those providers. Procedural geometry and synthesized audio\nremain valid assets.\n\nKeep distinct procedural variants in named visual builder functions and sounds\nin literal named slots such as `_sfx[\"gem\"] = _wav(...)`. Simple enum `match`\nbranches calling distinct parameterless visual builders are discovered as\nseparate assets. For other supported factories, put\n`# @asset-site entity gem Gem pickup` or\n`# @asset-site audio gem_chime Gem chime` immediately above a top-level function\nwith no required parameters; an audio label may also precede a named sound\nassignment. Entity factories need visible 3D geometry, audio factories an\nAudioStream return type. These comments describe source sites, not registry\nentries. Do not mint or edit platform `# @asset` identities, the manifest, or\n`scripts/art_bank.gd`. A focused Assets edit changes only its selected function\nor assignment; preserve sibling variants, dispatchers and shared helpers.\n\n## Current projects: ArtBank\n\nRead `scripts/art_bank.gd` to see the project's asset IDs. It is a generated\n`class_name` with static methods, not an autoload. Do not edit it or add an\nautoload. Match the method to the resource:\n\n| Resource | Accessor | Consumer |\n|---|---|---|\n| Texture2D | `ArtBank.tex(\"id\")` | Sprite2D/Sprite3D, texture drawing or material |\n| SpriteFrames | `ArtBank.frames(\"id\")` | AnimatedSprite2D/AnimatedSprite3D |\n| AudioStream | `ArtBank.audio(\"id\")` | Existing audio player or sound factory |\n| PackedScene (GLB model) | `ArtBank.scene(\"id\")` | Instantiate as Node3D under the existing visual holder |\n\nEach returns null for a missing resource or a different resource kind. Keep\nthe existing procedural visual or synthesized audio as the null fallback.\nIf the project has no bank, keep its procedural implementation.\n\nFor characters, use the actual frame dimensions to fit the existing body and\nfeet. Check `has_animation()` before playing a clip; drive available clips\nfrom movement and action states. Do not replace collision shapes or gameplay\nwith the new visual. A SpriteFrames is not a Texture2D, and asking `tex()` for\nit silently falls back instead of showing the paid art.\n\nFor audio, preserve event timing, volume, bus and looping behavior. The\nreplacement is an AudioStream; widen a procedural factory's AudioStreamWAV\nreturn annotation if necessary, retaining the synthesis as the fallback.\n\nFor a 3D model, check the PackedScene for null and the instantiated root for\nNode3D. Keep the procedural model if either check fails. Fit the imported\nmesh bounds to the existing visual footprint and ground height at runtime,\nso a regenerated model with different dimensions still fits. Preserve the\nphysics body, collider, movement, camera and references used by visual effects.\nA CharacterBody3D may be a car: do not assume a humanoid rig or animation\nclips. Play animations only if the delivered model actually contains them.\nDo not install a legacy addon or autoload to use `ArtBank.scene()`.\n\n## Static models and jointed characters\n\nGenerated and Blender 3D models are static: no skeleton and no animation\nclips. Move the visual holder from the existing movement state instead: a\nsmall bob while moving, a slight forward lean, and a turn toward the travel\ndirection when the body itself does not turn. Never move the body or the\ncollider for this.\n\nA character built in code that should walk needs joints. Give each limb its\nown pivot Node3D placed AT the joint (hip, shoulder, neck) with the limb mesh\nhanging below it, and swing the pivots from speed. A mesh centred on its\npivot spins around its middle instead. A model built from separate parts\nworks too: once the instance is in the scene tree, find each limb by name,\nadd a pivot Node3D at its joint, and `reparent()` the limb under it. It keeps\nits place; done before the instance is in the tree, it jumps to the pivot.\nThis script is the visual holder under the body; call\n`animate(velocity, delta)` from the body's physics step. For a static model,\nkeep only the bob, lean and turn.\n\n```gdscript\nextends Node3D\n# Visual holder for a code-built character. The body keeps movement and collision.\n# Torso and head are plain MeshInstance3D children; only limbs need pivots.\n\nconst SWING := 0.7  # limb swing at full speed, radians\nconst BOB := 0.06  # metres\nconst SIDES := [1.0, -1.0, -1.0, 1.0]  # left leg, right leg, left arm, right arm\n@export var max_speed := 6.0\nvar _phase := 0.0\nvar _rest_y := 0.0\nvar _limbs: Array[Node3D] = []\n\n\nfunc _ready() -> void:\n\t_rest_y = position.y\n\t_limbs.append(_limb(Vector3(-0.15, 0.9, 0.0), Vector3(0.14, 0.9, 0.14)))  # hips\n\t_limbs.append(_limb(Vector3(0.15, 0.9, 0.0), Vector3(0.14, 0.9, 0.14)))\n\t_limbs.append(_limb(Vector3(-0.4, 1.6, 0.0), Vector3(0.12, 0.7, 0.12)))  # shoulders\n\t_limbs.append(_limb(Vector3(0.4, 1.6, 0.0), Vector3(0.12, 0.7, 0.12)))\n\n\n# The pivot sits at the joint and the mesh hangs below it.\nfunc _limb(joint: Vector3, size: Vector3) -> Node3D:\n\tvar pivot := Node3D.new()\n\tpivot.position = joint\n\tvar box := BoxMesh.new()\n\tbox.size = size\n\tvar mesh := MeshInstance3D.new()\n\tmesh.mesh = box\n\tmesh.position.y = -size.y * 0.5\n\tpivot.add_child(mesh)\n\tadd_child(pivot)\n\treturn pivot\n\n\n# Call from the body's _physics_process. The visual faces -Z.\nfunc animate(velocity: Vector3, delta: float) -> void:\n\tvar speed := Vector2(velocity.x, velocity.z).length()\n\tvar amount := clampf(speed / max_speed, 0.0, 1.0)\n\t_phase = fmod(_phase + delta * speed * 2.5, TAU)\n\tvar blend := minf(1.0, 12.0 * delta)\n\tfor i in _limbs.size():\n\t\tvar target: float = sin(_phase) * SWING * amount * SIDES[i]\n\t\t_limbs[i].rotation.x = lerpf(_limbs[i].rotation.x, target, blend)\n\tposition.y = _rest_y + absf(sin(_phase)) * BOB * amount\n\trotation.x = lerpf(rotation.x, -0.12 * amount, blend)\n\t# Skip the turn when the body already rotates to face its movement.\n\tif speed > 0.1:\n\t\trotation.y = lerp_angle(rotation.y, atan2(-velocity.x, -velocity.z), blend)\n```\n\n## Legacy projects: AssetRegistry guard shapes\n\nPlay only clips the resource actually contains\n(`sprite_frames.has_animation()` / `AnimationPlayer.has_animation()`): a clip\nthat does not exist leaves the character frozen on whatever was playing\nbefore, so if a movement state of yours has no matching clip (a glide, a\ndash, a swim), play the closest clip that DOES exist instead of naming the\nstate. Keep each guarded id as a GUARDED swap site with the procedural visual\nas the fallback. Use EXACTLY this shape for a still TEXTURE (the\nAssetRegistry autoload is not guaranteed to exist, so never reference it\nbare; and `get_texture` never returns null — it returns a magenta\nplaceholder, so for a texture `is_placeholder` is the correct \"do I have real\nart?\" test; shapes 3 and 4 below need a DIFFERENT test, and using this one\nthere is what ships a magenta box):\n\n    var _reg = get_node_or_null(\"/root/AssetRegistry\")\n    var _has_art: bool = _reg != null and not _reg.is_placeholder(\"hero_sprite\")\n    if _has_art:\n        sprite.texture = _reg.get_texture(\"hero_sprite\")\n    else:\n        pass  # keep drawing your procedural visual\n\nThe guard must read correctly in all three states: the autoload absent, the\nid resolving to a placeholder (your procedural visual keeps rendering), and\nreal art present.\n\nTHE GUARD DEPENDS ON THE KIND. There are four shapes and they are NOT\ninterchangeable — using the wrong one ships a broken game with a green gate.\n\n1. A TEXTURE on a Sprite2D/Sprite3D/material — the shape above\n   (`is_placeholder` + `get_texture`).\n\n2. IMMEDIATE-MODE 2D. If you draw with `draw_rect`/`draw_circle`/\n   `draw_polygon` inside `_draw()`, there is no node to assign a texture to.\n   Draw the texture instead of the shape, keeping the shape as the else:\n\n       func _draw() -> void:\n           var _reg = get_node_or_null(\"/root/AssetRegistry\")\n           if _reg != null and not _reg.is_placeholder(\"hero_sprite\"):\n               draw_texture_rect(_reg.get_texture(\"hero_sprite\"), _body_rect, false)\n           else:\n               draw_rect(_body_rect, cloak_colour)   # the procedural fallback\n\n3. AN ANIMATED 2D SPRITE (`sprite_frames`). The art arrives as a\n   `SpriteFrames` resource — one animation per clip it carries — so it\n   needs an `AnimatedSprite2D`, never a `Sprite2D`. `is_placeholder` is the\n   WRONG test here, for the same reason as the rigged mesh below: it is\n   kind-agnostic, so it answers \"real art\" for a SpriteFrames — but\n   `get_texture` cannot return one and hands back the magenta checker, which\n   is how a paid sheet renders as a magenta box. Ask for the frames and test\n   for null:\n\n       var _reg = get_node_or_null(\"/root/AssetRegistry\")\n       var _sf: SpriteFrames = null if _reg == null else _reg.get_sprite_frames(\"enemy_bonelord\")\n       if _sf != null:\n           anim.sprite_frames = _sf          # anim is an AnimatedSprite2D\n           anim.play(\"idle\")\n           procedural_body.visible = false   # your drawn version steps aside\n           var _f0 := _sf.get_frame_texture(\"idle\", 0)\n           if _f0 != null and _f0.get_height() > 0:\n               anim.scale = Vector2.ONE * (48.0 / float(_f0.get_height()))\n       else:\n           pass  # keep drawing your procedural character\n\n   Frames arrive PRE-SIZED for the kind (24-128 px tall, not full-resolution\n   renders). Scale only if your procedural body renders at a different size —\n   set the target height to YOUR character's on-screen size (the example\n   normalizes to 48 px; change or drop it to match). Drive the clips from the body's own state\n   (`anim.play(\"walk\")` when it moves, `\"attack\"` when it swings) — a sheet\n   that only ever plays \"idle\" leaves its other clips unseen.\n\n4. A RIGGED 3D CHARACTER (`glb_mesh` for a character). `is_placeholder` is\n   the WRONG test here — it is deliberately kind-agnostic and returns false\n   for ANY resource that loads, including a STATIC mesh that came back with\n   no skeleton. Use `get_rigged_character`, which returns an EMPTY dictionary\n   unless a real rig arrived:\n\n       var _reg = get_node_or_null(\"/root/AssetRegistry\")\n       var _rig: Dictionary = {} if _reg == null else _reg.get_rigged_character(\"hero_model\")\n       if not _rig.is_empty():\n           var _inst = _rig[\"scene\"].instantiate()\n           model.add_child(_inst)\n           procedural_model.visible = false\n           var _ap = _inst.find_child(\"AnimationPlayer\", true, false)\n           if _ap != null and \"idle\" in _rig[\"animations\"]:\n               # Provider clips are baked WITHOUT loop flags: an un-looped\n               # idle plays once and freezes on its last frame — reads\n               # exactly like the T-pose this guard exists to avoid. Force\n               # looping on the locomotion clips (one-shots like attack or\n               # death stay one-shot).\n               for _cn in [\"idle\", \"walk\", \"run\"]:\n                   if _ap.has_animation(_cn):\n                       _ap.get_animation(_cn).loop_mode = Animation.LOOP_LINEAR\n               _ap.play(\"idle\")\n       else:\n           pass  # keep your procedural model — it is the fallback\n\n   Replace only the VISUAL. Never move, resize or remove the entity's own\n   CollisionShape3D: the collider is gameplay and the swap is cosmetic.\n\nNever block gameplay on art: the game must play identically when a guard\nfalls back to the procedural visual.\n\n## Why the legacy AssetRegistry guard shape matters\n\n`get_texture()` NEVER returns null — a missing id resolves to the 16x16 magenta\nchecker at `res://assets/placeholders/_missing.png`. So a null check cannot tell\nyou whether real art arrived, and `is_placeholder()` is the only correct test.\nThat distinction is not academic: using the wrong guard for a kind ships a\nbroken game with a GREEN gate, because every tier sees a texture that loaded.\n\n`is_placeholder` is also kind-agnostic — it answers \"real art\" for a\n`SpriteFrames` that `get_texture` then cannot return. Match the guard to the\nkind, every time.\n"
}

SHA-256 of public snapshot: 171f6b2f3337ee0018692551ec00da7098254e38b1c180d86d56697cc71a281d