如何在Pymunk/Pygame中实现主动布偶角色站立及程序动画？

问题现状 #

用Pymunk/Pygame编写游戏角色脚本，通过PinJoint搭建了布偶骨骼，但角色仅会像重物般倒地，无法自主站立，也实现不了走路、攀爬、抓取物体等动作。尝试使用RotaryLimitJoint但未生效，布偶定义代码如下：

import pymunk
import pygame
from math import pi

# 假设space和screen已在外部初始化
space = pymunk.Space()
space.gravity = (0, 900)
screen = pygame.display.set_mode((800, 600))

class BonePoint():
    def __init__(self, x, y, group):
        self.body = pymunk.Body()
        self.body.position = x, y
        self.shape = pymunk.Circle(self.body, radius=10)
        self.shape.elasticity = 0.5
        self.shape.density = 1
        self.shape.filter = pymunk.ShapeFilter(group = group)
        space.add(self.shape, self.body)
    
    def draw(self):
        x, y = self.body.position
        pygame.draw.circle(screen, (255,0,0), (int(x), int(y)), 10)


class Bone():
    def __init__(self, body1, attachement, min_angle, max_angle, identifier = "body"):
        self.body1 = body1
        if identifier == "body":
            self.body2 = attachement
        elif identifier == "position":
            self.body2 = pymunk.Body(body_type=pymunk.Body.STATIC)
            self.body2.position = attachement
        # 保留PinJoint维持关节距离
        self.pin_joint = pymunk.PinJoint(self.body1, self.body2)
        # 添加RotaryLimitJoint限制旋转角度（修复原代码未生效问题）
        self.rotary_joint = pymunk.RotaryLimitJoint(self.body1, self.body2, min_angle, max_angle)
        space.add(self.pin_joint, self.rotary_joint)
        
    def draw(self):
        pos1 = self.body1.position
        pos2 = self.body2.position
        pygame.draw.line(screen, (0,0,0), (int(pos1.x), int(pos1.y)), (int(pos2.x), int(pos2.y)), 10)

class Player():
    def __init__(self, x, y):
        self.shoulders = BonePoint(x, y, 1)
        self.head = BonePoint(x, y-40, 1)
        self.left_elbow = BonePoint(x-50, y, 1)
        self.left_hand = BonePoint(x-100, y, 1)
        self.right_elbow = BonePoint(x+50, y, 1)
        self.right_hand = BonePoint(x+100, y, 1)
        self.hip = BonePoint(x, y+100, 1)
        # 调整腿部初始位置，避免骨骼重叠
        self.left_knee = BonePoint(x-30, y+150, 1)
        self.right_knee = BonePoint(x+30, y+150, 1)
        self.left_foot = BonePoint(x-30, y+200, 1)
        self.right_foot = BonePoint(x+30, y+200, 1)
        
        # 创建带角度限制的关节
        self.neck_bone = Bone(self.shoulders.body, self.head.body, -pi/4, pi/4)
        self.left_arm_bone = Bone(self.shoulders.body, self.left_elbow.body, -pi/2, pi/2)
        self.left_forearm_bone = Bone(self.left_elbow.body, self.left_hand.body, 0, pi)
        self.right_arm_bone = Bone(self.shoulders.body, self.right_elbow.body, -pi/2, pi/2)
        self.right_forearm_bone = Bone(self.right_elbow.body, self.right_hand.body, 0, pi)
        self.left_thigh_bone = Bone(self.hip.body, self.left_knee.body, -pi/4, pi/1.5)
        self.left_leg_bone = Bone(self.left_knee.body, self.left_foot.body, -pi/1.5, 0)
        self.right_thigh_bone = Bone(self.hip.body, self.right_knee.body, -pi/4, pi/1.5)
        self.right_leg_bone = Bone(self.right_knee.body, self.right_foot.body, -pi/1.5, 0)
        self.torso_bone = Bone(self.shoulders.body, self.hip.body, -pi/2, pi/2)
        
        # 优化物理参数提升稳定性
        self.left_foot.shape.friction = 2.0
        self.right_foot.shape.friction = 2.0
        self.left_knee.body.mass = 2
        self.right_knee.body.mass = 2
        self.left_foot.body.mass = 3
        self.right_foot.body.mass = 3
        
    def draw_player(self):
        self.shoulders.draw()
        self.head.draw()
        self.left_elbow.draw()
        self.left_hand.draw()
        self.right_elbow.draw()
        self.right_hand.draw()
        self.hip.draw()
        self.left_knee.draw()
        self.right_knee.draw()
        self.left_foot.draw()
        self.right_foot.draw()
        
        self.neck_bone.draw()
        self.left_arm_bone.draw()
        self.left_forearm_bone.draw()
        self.right_arm_bone.draw()
        self.right_forearm_bone.draw()
        self.torso_bone.draw()
        self.left_thigh_bone.draw()
        self.left_leg_bone.draw()
        self.right_thigh_bone.draw()
        self.right_leg_bone.draw()

# 走路控制示例
def control_player(player, keys):
    if keys[pygame.K_LEFT]:
        # 给左腿关节施加冲量模拟迈步
        player.left_thigh_bone.body1.apply_impulse_at_local_point((0, -50), (0,0))
        player.left_leg_bone.body1.apply_impulse_at_local_point((0, 50), (0,0))
    if keys[pygame.K_RIGHT]:
        # 给右腿关节施加冲量
        player.right_thigh_bone.body1.apply_impulse_at_local_point((0, -50), (0,0))
        player.right_leg_bone.body1.apply_impulse_at_local_point((0, 50), (0,0))
    if keys[pygame.K_UP]:
        # 给躯干施加向上冲量尝试站立
        player.hip.body.apply_impulse_at_local_point((0, -200), (0,0))

核心解决要点 #

• 修复RotaryLimitJoint失效问题：原代码的Bone类仅创建了PinJoint，未实际添加RotaryLimitJoint。修改Bone类，同时初始化并添加两种关节，传入角度限制参数即可生效。
• 添加主动控制逻辑：通过apply_impulse或apply_force给关节/身体部位施加力，模拟走路、站立动作；也可使用MotorJoint实现更稳定的关节旋转驱动。
• 优化物理参数：调整各部位的质量、摩擦力，脚部增加摩擦力防止滑倒，腿部增加质量提升站立稳定性；调整初始骨骼位置避免重叠。
• 平衡姿态矫正：检测躯干角度等姿态数据，实时给对应关节施加矫正力，维持站立平衡。
• 抓取功能实现：检测手部与物体碰撞后，创建PivotJoint连接手部和物体；松开按键时移除该关节即可实现抓取/释放。

内容的提问来源于stack exchange，提问作者Andrea Valsesia