Hey there! Let’s work through getting your collision detection up and running with Pymunk and Pygame. It sounds like the core issue is making sure your car and obstacles are properly registered in the Pymunk space so collisions can be detected and trigger your custom functions. Let’s break this down step by step.

1. First: Double-Check Your Pymunk Space Setup #

Before anything else, make sure you’ve initialized your Pymunk space correctly—this is the "physics world" where all collisions and interactions happen:

import pymunk
import pygame

# Initialize Pygame and Pymunk space
pygame.init()
screen = pygame.display.set_mode((800, 600))
space = pymunk.Space()
space.gravity = (0, 0)  # Use (0, 900) if you need gravity, but top-down games usually skip it

2. Add Physical Bodies & Shapes for Car + Obstacles #

The most common mistake here is forgetting to tie your visual sprites to Pymunk’s physical bodies and shapes. Every object that needs collision detection needs both a Body (handles physics properties like mass and movement) and a Shape (defines the collision boundary).

For Your Car (Dynamic Body) #

Since your car moves, it should be a dynamic body (mass > 0):

# Define car dimensions (match your sprite size!)
car_width, car_height = 40, 20
car_start_pos = (100, 300)

# Create dynamic body for the car
car_body = pymunk.Body(mass=1, moment=pymunk.moment_for_box(1, (car_width, car_height)))
car_body.position = car_start_pos

# Create collision shape (a box matching the car's size)
car_shape = pymunk.Poly.create_box(car_body, (car_width, car_height))
car_shape.collision_type = 1  # Assign a unique ID for collision handling
car_shape.friction = 0.5  # Optional: Add friction for realistic movement

# Add both body and shape to the Pymunk space
space.add(car_body, car_shape)

For Obstacles (Static Body) #

Obstacles don’t move, so use a static body (mass = 0, fixed in place):

# Example obstacle
obstacle_width, obstacle_height = 50, 50
obstacle_pos = (400, 300)

# Create static body
obstacle_body = pymunk.Body(body_type=pymunk.Body.STATIC)
obstacle_body.position = obstacle_pos

# Create collision shape
obstacle_shape = pymunk.Poly.create_box(obstacle_body, (obstacle_width, obstacle_height))
obstacle_shape.collision_type = 2  # Unique ID different from the car
space.add(obstacle_body, obstacle_shape)

3. Set Up Collision Callback Functions #

To trigger your custom logic when the car hits an obstacle, use Pymunk’s collision handlers. You can define exactly what happens when two collision types interact:

def on_collision(arbiter, space, data):
    # This runs when the car (type 1) hits an obstacle (type 2)
    print("Crash! Car hit an obstacle.")
    # Call your custom function here
    # your_custom_function()
    return True  # Return True to let Pymunk process the collision normally

# Link the collision types to your callback
collision_handler = space.add_collision_handler(1, 2)
collision_handler.begin = on_collision  # Trigger when collision first starts

4. Update the Pymunk Space in Your Game Loop #

Don’t forget to step the physics simulation every frame—this is how Pymunk calculates collisions and updates object positions:

clock = pygame.time.Clock()
running = True

while running:
    dt = clock.tick(60) / 1000.0  # Convert milliseconds to seconds
    space.step(dt)  # Update physics
    
    # Handle Pygame events
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False
    
    # Move the car (replace with your existing movement logic)
    keys = pygame.key.get_pressed()
    if keys[pygame.K_LEFT]:
        car_body.angle += 0.1
    if keys[pygame.K_RIGHT]:
        car_body.angle -= 0.1
    if keys[pygame.K_UP]:
        force = car_body.rotation_vector * 100
        car_body.apply_force_at_local_point(force)
    
    # Draw everything (match your existing drawing code)
    screen.fill((255,255,255))
    # Draw car (convert Pymunk position to Pygame coordinates)
    pygame.draw.rect(screen, (255,0,0), (car_body.position.x - car_width/2, car_body.position.y - car_height/2, car_width, car_height))
    # Draw obstacle
    pygame.draw.rect(screen, (0,0,255), (obstacle_pos[0] - obstacle_width/2, obstacle_pos[1] - obstacle_height/2, obstacle_width, obstacle_height))
    
    pygame.display.flip()

pygame.quit()

Quick Checks for Your Existing Code #

If you’re still having issues, ask yourself these questions:

• Did I add both the body and shape to the Pymunk space?
• Are my collision types set correctly (so the handler knows which objects to watch)?
• Am I calling space.step(dt) every frame in my game loop?
• Is my obstacle set to a static body (so it doesn’t move when hit)?

内容的提问来源于stack exchange，提问作者Joe Granlie