آموزش ساخت بازی با پایتون Pygame: از صفر تا پروژه واقعی

فهرست مطالب

• کتابخانه Pygame چیست و چرا برای ساخت بازی مناسب است؟
• پیش‌نیازها و نصب محیط توسعه
• معماری اصلی یک بازی در Pygame (Game Loop)
• آموزش ساخت یک بازی کامل (پروژه عملی تیراندازی)
• ۳ نکته تخصصی که بازی شما را حرفه‌ای می‌کند
• خروجی گرفتن و تبدیل بازی به فایل exe
• پرسش‌های متداول
• راهنمای عیب‌یابی سریع

خلاصه سریع و کلیدهای اصلی مقاله

• Pygame یک فریم‌ورک مبتنی بر کتابخانه SDL است که مدیریت گرافیک، صدا و ورودی‌ها را در پایتون آسان می‌کند.
• قلب تپنده هر بازی در Pygame یک حلقه بی‌نهایت (Game Loop) است که پردازش ورودی‌ها، به‌روزرسانی منطق و رندر مجدد را انجام می‌دهد.
• برای کنترل سرعت بازی در سخت‌افزارهای مختلف، استفاده از Delta Time و کنترل FPS الزامی است.

import pygame
import sys

# ۱. مقداردهی اولیه
pygame.init()
WIDTH, HEIGHT = 800, 600
screen = pygame.display.set_mode((WIDTH, HEIGHT))
pygame.display.set_caption("My First Pygame")
clock = pygame.time.Clock()

# ۲. حلقه اصلی بازی
running = True
while running:
    # الف) پردازش رویدادها (Events)
    for event in pygame.event.get():
        if event.type == pygame.QUIT:
            running = False

    # ب) به‌روزرسانی منطق بازی (Update)
    
    # ج) رسم عناصر گرافیکی (Draw)
    screen.fill((30, 41, 59)) # رنگ پس‌زمینه
    
    pygame.display.flip() # نمایش تغییرات
    clock.tick(60) # تنظیم فریم ریت روی 60

pygame.quit()
sys.exit()

class Player(pygame.sprite.Sprite):
    def __init__(self):
        super().__init__()
        # ساخت یک مستطیل سبز به عنوان سفینه
        self.image = pygame.Surface((50, 40))
        self.image.fill((34, 197, 94))
        self.rect = self.image.get_rect()
        self.rect.centerx = WIDTH // 2
        self.rect.bottom = HEIGHT - 20
        self.speed = 8

    def update(self):
        keys = pygame.key.get_pressed()
        if keys[pygame.K_LEFT] and self.rect.left > 0:
            self.rect.x -= self.speed
        if keys[pygame.K_RIGHT] and self.rect.right < WIDTH:
            self.rect.x += self.speed

import random

class Bullet(pygame.sprite.Sprite):
    def __init__(self, x, y):
        super().__init__()
        self.image = pygame.Surface((8, 16))
        self.image.fill((239, 68, 68)) # رنگ قرمز
        self.rect = self.image.get_rect()
        self.rect.centerx = x
        self.rect.bottom = y
        self.speed = -10

    def update(self):
        self.rect.y += self.speed
        if self.rect.bottom  HEIGHT:
            self.rect.x = random.randint(0, WIDTH - self.rect.width)
            self.rect.y = random.randint(-100, -40)
            self.speedy = random.randint(2, 6)

# بررسی برخورد گلوله به دشمن (هر دو حذف می‌شوند)
hits = pygame.sprite.groupcollide(enemies, bullets, True, True)
for hit in hits:
    score += 10
    # ایجاد یک دشمن جدید برای ادامه بازی
    new_enemy = Enemy()
    all_sprites.add(new_enemy)
    enemies.add(new_enemy)

آیا Pygame برای ساخت بازی‌های ۳ بعدی مناسب است؟

خیر، Pygame تخصصی برای بازی‌های ۲ بعدی طراحی شده است. برای بازیسازی ۳ بعدی با پایتون بهتر است سراغ کتابخانه‌هایی مثل Ursina یا Panda3D بروید.

چرا بازی اجرا شده در Pygame لگ دارد یا کند کار می‌کند؟

دلایل اصلی معمولاً بارگذاری تصاویر داخل حلقه بازی (به جای خارج از حلقه)، عدم استفاده از `.convert()` روی Surfaceها یا رندر مداوم متون فریم به فریم است.

بهترین فرمت برای تصاویر و صداها در Pygame چیست؟

برای تصاویر فرمت PNG (به دلیل پشتیبانی از پس‌زمینه شفاف) و برای افکت‌های صوتی فرمت WAV و موسیقی پس‌زمینه فرمت MP3 یا OGG بهترین گزینه هستند.

چگونه می‌توان بازی ساخت‌شده را روی گوشی‌های اندروید اجرا کرد؟

با استفاده از ابزار Python-for-Android یا بسته Kivy می‌توان خروجی APK گرفت، اما فرایند پیچیده‌ای دارد و Pygame رسماً برای دسکتاپ بهینه‌تر است.

۱. خطای FileNotFoundError هنگام آدرس‌دهی عکس یا صدا

علت: مسیر فایل‌ها به‌صورت نسبی نوشته شده و لودر پایتون دایرکتوری جاری را پیدا نمی‌کند.
راه‌حل: مسیر دقیق را با ماژول `os` ایجاد کنید: os.path.join(os.path.dirname(__file__), 'image.png')

۲. پنجره بازی قفل می‌کند و ارور Not Responding می‌دهد

علت: حلقه `pygame.event.get()` در بازی اجرا نمی‌شود یا رویدادها خالی نمی‌شوند.
راه‌حل: مطمئن شوید پیمایش روی رویدادها حتماً داخل حلقه `while` اصلی قرار دارد.

۳. حرکات اشیاء روان نیست و لرزش دارد

علت: عدم هماهنگی فریم‌ریت با نمایشگر یا ذخیره مختصات به صورت عدد صحیح.
راه‌حل: مختصات اشیاء را اعشاری ذخیره کنید و هنگام رسم، آن‌ها را به `int` تبدیل کنید. همچنین حتماً از `clock.tick(60)` استفاده کنید.