← 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. Non-player movers (enemies, projectiles, vehicles) — why position += v * delta on a plain Node2D/Node3D phases through walls, which body type sweeps, the mandatory CollisionShape child, and ray line-of-sight. Use when a mover ignores geometry or when picking its body class.",
  "included_files": [],
  "name": "moving-things-that-collide",
  "skill_md_contents": "---\nname: moving-things-that-collide\ndescription: \"For Exekite-hosted Godot games only. Non-player movers (enemies, projectiles, vehicles) — why position += v * delta on a plain Node2D/Node3D phases through walls, which body type sweeps, the mandatory CollisionShape child, and ray line-of-sight. Use when a mover ignores geometry or when picking its body class.\"\n---\n\n# Things that move and must not pass through walls\n\nExposed by every temple arm and Race-B: enemies and rivals were translated by\nsetting `position` directly on a plain `Node3D`. They phased through geometry,\nhad no line-of-sight, and floated through the level. Detection today: **none** —\nthe game boots, the scene loads, nothing errors. It just looks wrong.\n\n## Setting `position` is teleporting\n\n```gdscript\n# WRONG on anything that should collide\nposition += direction * speed * delta\n```\n\nThat moves the transform. It does not sweep, so nothing is between the old\nposition and the new one — walls included. It is correct only for things that\nSHOULD pass through everything: floating damage numbers, background parallax,\ncamera rigs.\n\n## Pick the body type by what the thing must do\n\n| The thing | Node | How it moves |\n|---|---|---|\n| Player, enemy, NPC — scripted movement that collides | `CharacterBody2D`/`3D` | set `velocity`, call `move_and_slide()` |\n| Crate, debris — physics owns it | `RigidBody2D`/`3D` | `apply_impulse()`, never set position |\n| Platform, door — moves on rails, pushes bodies | `AnimatableBody2D`/`3D` | set `position`; it sweeps correctly |\n| Trigger volume, pickup, hitbox | `Area2D`/`3D` | `body_entered` signal |\n| Decoration | `Node2D`/`Node3D`, `MeshInstance3D` | anything |\n\n**Every one of them needs a `CollisionShape2D`/`3D` child with an actual\n`shape` assigned.** A body with no shape collides with nothing and reports no\nerror — which is the second half of this failure class.\n\n```gdscript\nfunc _make_enemy() -> CharacterBody3D:\n    var body := CharacterBody3D.new()\n    var col := CollisionShape3D.new()\n    var shape := CapsuleShape3D.new()\n    shape.radius = 0.4\n    shape.height = 1.8\n    col.shape = shape                      # WITHOUT this the body is a ghost\n    body.add_child(col)\n    body.add_child(MeshInstance3D.new())   # the visible part is separate\n    return body\n```\n\n## Moving one\n\n```gdscript\nfunc _physics_process(delta: float) -> void:\n    var to_player := (_player.global_position - global_position)\n    var dir := to_player.normalized()\n\n    if not is_on_floor():\n        velocity.y -= GRAVITY * delta      # 3D: -Y is down\n    velocity.x = dir.x * SPEED\n    velocity.z = dir.z * SPEED\n    move_and_slide()                       # sweeps; stops at walls\n```\n\n`move_and_slide()` reads and writes `velocity` and needs no arguments in Godot\n4. In `_physics_process`, never `_process` — physics runs on its own clock and\nmixing them gives frame-rate-dependent movement.\n\n## Line of sight is a ray, not a distance check\n\nDistance alone makes an enemy see through walls.\n\n```gdscript\nfunc _can_see(target: Node3D) -> bool:\n    var space := get_world_3d().direct_space_state\n    var q := PhysicsRayQueryParameters3D.create(global_position, target.global_position)\n    q.exclude = [get_rid()]                # or it hits itself immediately\n    var hit := space.intersect_ray(q)\n    return hit.is_empty() or hit.collider == target\n```\n\nThe 2D form is the same with `get_world_2d()` and\n`PhysicsRayQueryParameters2D`. `exclude` is not optional — a ray starting inside\nyour own collider hits it on the first step.\n\n## Two traps that look like this one\n\n- **Layer/mask set to 0.** The body has a shape and still passes through\n  everything, because it scans for nothing. Set both explicitly.\n- **Scaling a collision shape by scaling the node.** Godot warns for non-uniform\n  scale on physics bodies and the collision does not match what you see. Size\n  the `shape` resource instead.\n"
}

SHA-256 of public snapshot: 62a303823fcf19a0637a0cc3af7ff401970701ff1a151f08f5ae441a7ebf92ba