Godot collision not working? A tested checklist, and an AI that finds the cause

A tested checklist published by Ziva, an AI agent that runs inside the Godot editor, documents seven settings that break Godot 4.7.2 collision detection, including an Area2D mask that omits the body's layer, a missing or disabled CollisionShape2D shape, and Monitoring turned off. Ziva's agent found and fixed all four bugs in a deliberately broken scene in 1 minute 34 seconds using its validate_physics_setup tool and by reading the scene, and the broken project is available for download. The checklist's first five items were verified with a headless Godot 4.7.2 script that dropped a CharacterBody2D on collision layer 2 through an Area2D with a 60 x 60 rectangle shape, moving it 4 pixels per physics frame with move_and_slide().

Godot collision not working? A tested checklist, and an AI that finds the cause If your Area2D's body entered never fires, or your player falls straight through the floor, check the seven settings below. We tested the Area2D ones in Godot 4.7.2 and reproduced the floor one in an example project. If you would rather have an AI find it: Ziva https://ziva.sh/ , an AI agent inside the Godot editor, found and fixed all four bugs in a deliberately broken scene in 1 minute 34 seconds, using its validate physics setup tool and by reading the scene. That test is further down, along with the broken project to download. The checklist the-checklist Work down the list. Each item has its fix in one line. | | Cause | Fix | |---|---|---| | 1 | The Area2D's Mask does not include the body's layer | Tick the body's layer under Collision Mask on the Area2D | | 2 | The CollisionShape2D has no Shape , or it is Disabled | Set Shape to a new RectangleShape2D or similar and untick Disabled | | 3 | Monitoring is off on the Area2D | Tick Monitoring in the Area2D's inspector | | 4 | The signal is not connected, or connected to the wrong node | Connect body entered to the node whose script has the method | | 5 | You listen to area entered for a body | Use body entered for bodies, area entered for other Area2Ds | | 6 | A CharacterBody2D falls through the floor | Tick the floor's layer under Collision Mask on the character | | 7 | The floor is a TileMapLayer with no physics layer | Add a physics layer to its TileSet and draw collision polygons on the solid tiles | How we tested items 1 to 5: a headless Godot 4.7.2 script dropped a CharacterBody2D on collision layer 2 through an Area2D with a 60 x 60 rectangle shape, moving it 4 pixels per physics frame with move and slide , and recorded whether the signal fired. A working setup fired; every broken variant in items 1 to 5 did not. 1. Collision layers and masks: the Area2D's mask is what matters 1-collision-layers-and-masks-the-area2ds-mask-is-what-matters Godot's physics introduction https://docs.godotengine.org/en/stable/tutorials/physics/physics introduction.html collision-layers-and-masks defines the two properties. The layer "describes the layers that the object appears in". The mask "describes what layers the body will scan for collisions. If an object isn't in one of the mask layers, the body will ignore it." Both default to layer 1. For an Area2D to report a body, the body's layer must be in the Area2D's mask . In our test, an Area2D with mask 1 never saw a body on layer 2. The reverse direction did not matter: with the Area2D's layer set to 0 and the body's mask set to 0, body entered still fired. So when a coin or trigger ignores the player, look at the trigger's Mask first. In the inspector you tick layer numbers. In .tscn files and code the same values are bitmasks: layer 1 is 1 , layer 2 is 2 , layer 3 is 4 , layer 4 is 8 . A scene that says collision mask = 4 scans layer 3, not layer 4. In code you can skip the arithmetic with set collision mask value https://docs.godotengine.org/en/stable/classes/class collisionobject2d.html class-collisionobject2d-method-set-collision-mask-value : 2. Missing or disabled shape 2-missing-or-disabled-shape An Area2D with a CollisionShape2D child whose Shape is empty detected nothing in our test, and neither did one with the shape set but Disabled ticked. Select the CollisionShape2D, click the empty Shape field, pick a shape and size it over your sprite. 3. Monitoring is off 3-monitoring-is-off With Monitoring off, our Area2D detected nothing. The Area2D reference https://docs.godotengine.org/en/stable/classes/class area2d.html class-area2d-signal-body-entered says body entered "Requires monitoring to be set to true." It defaults to on; check the inspector and any script that sets it to false . 4. The signal is not connected, or goes to the wrong node 4-the-signal-is-not-connected-or-goes-to-the-wrong-node A on body entered function does nothing unless the signal is connected to it. With no connection, nothing fired in our test. Connect it in the Signals dock the Signals tab next to the Inspector , or in code as in the snippet above. The connection also has to target the node whose script holds the method. In our example scene, a connection from the coin to the level root which has no script never ran on body entered , and Godot printed no error. If the dock shows a connection but nothing happens, check its target. 5. body entered vs area entered 5-body entered-vs-area entered body entered fires for physics bodies CharacterBody2D, RigidBody2D, StaticBody2D and for tile maps whose TileSet has collision shapes. area entered fires only for other Area2Ds. In our test, listening to area entered for a CharacterBody2D never fired. 6. CharacterBody2D falls through the floor 6-characterbody2d-falls-through-the-floor This is item 1 in the other direction: a character collides with a floor only if the floor's layer is in the character's mask. In our example project the player was on layer 2 with collision mask = 4 layer 3 and the floor was on layer 1. After 3 seconds the player was at y 4327, far below the floor at y 560. Setting the player's mask to 1 left it resting on the floor at y 520. 7. TileMapLayer floor with no physics layer 7-tilemaplayer-floor-with-no-physics-layer A TileMapLayer has no collision until its TileSet has a physics layer and the solid tiles have collision polygons. The steps are in our TileMapLayer guide https://ziva.sh/blogs/godot-tilemap add-collision-to-a-tilemaplayer . The character's mask still has to include that physics layer's collision layer. Not the cause not-the-cause Two suspects did not stop detection in our tests: - Moving the body by setting position instead of move and slide : body entered still fired. Our body moved 4 pixels per frame; we did not test large jumps that could skip over a thin area. - The body starting inside the area : body entered still fired. Tested: an AI that finds why the collision is not working tested-an-ai-that-finds-why-the-collision-is-not-working A chat window sees only the code you paste into it, but layers, masks, shapes and signal connections live in the scene file. One Godot forum user, stuck on a jump that left their character floating, wrote that "chat gpt just scrambled my code to trash" Godot Forum https://forum.godotengine.org/t/character-stuck-in-air-during-jump/113942 . We wanted to see whether an agent that can read the scene and run it does better on collision bugs. Ziva.sh makes Ziva and wrote this test. We ran it on 10 November 2026 with Godot 4.7.2 on Linux, a development build of Ziva and Ziva Smart, the default model, with auto-approve on. It is one project and one run, so treat it as an example, not a benchmark. We built a small scene with four planted bugs: the player's mask missed the floor's layer, the coin's mask missed the player's layer, the coin's CollisionShape2D had no shape, and the coin's on body entered was never connected. Download the broken project https://ziva.sh/assets/blogs/godot-collision-not-working-broken-example.zip ZIP, 2 KB to try it yourself. It imports and loads in Godot 4.7.2; press F5 and the player falls through the floor. The prompt, word for word: What Ziva did: 1. Read the scene tree, level.tscn , and both scripts. 2. Called validate physics setup on the Player and the Floor. It returned one issue: "collision mask does not overlap with any platform collision layer" on /root/Player , and the suggestion "Update collision mask on /root/Player to include bits from platform layers" . 3. Listed all four bugs. The tool had flagged only the first; Ziva found the coin's mask, the missing shape and the missing connection in the scene file it had read. 4. Fixed them by editing level.tscn : player mask 4 to 1 , coin mask 1 to 2 , a 24 x 24 RectangleShape2D for the coin, and a body entered connection. 5. Caught its own mistake: it first connected the signal to the level root, then noticed that on body entered lives in the coin's script and changed the target to the Coin node before running anything. 6. Ran validate physics setup again no issues , then ran the scene. Godot printed Coin collected , and Ziva's screenshot showed the player on the floor with the coin gone. It took 1 minute 34 seconds, 16 tool calls and $0.0175 of Ziva usage on Ziva Smart, the default model. Our own check, a separate script run on the fixed project, agreed: the player rested on the floor at y 520, Coin collected was printed and the coin was removed. What validate physics setup checks, and what it does not what-validate physics setup-checks-and-what-it-does-not validate physics setup takes a scene, the character nodes and the platform nodes. For each character it checks that the collision mask is not 0, that the mask overlaps at least one platform's collision layer, and that it has a CollisionShape2D child with a shape. For TileMapLayer platforms it checks that a TileSet is assigned and has a physics layer. It returns a list of issues and suggestions. It does not look at Area2Ds, monitoring or signal connections. In this run it caught the floor bug only. The three coin bugs were found by the model reading the scene, so on a bigger scene that part depends on Ziva reading the right files. Where Ziva slipped where-ziva-slipped - A wrong signal target, caught in time. Its first connection pointed at the level root, which would have failed without an error, as item 4 above shows. Ziva fixed it before running the scene. - One small scene. The scene had three nodes that mattered and the bugs were all visible in one file. We have not tested Ziva on a collision bug spread across many scenes or caused by code that changes layers at runtime. To try it on your own project, install Ziva https://ziva.sh/docs/installation and describe the symptom the way you would to a person, for example "my player falls through the floor, find out why and fix it, then run the scene."