Building Your First Game with Python

What Python offers for game creation

Python is a programming language that lets you write game code in plain English-like sentences instead of complex symbols. You do not need to learn a separate language for games — the same Python you use to write other programs works for games too. The main reason to choose Python is that it has libraries (pre-written code packages) designed specifically for games, so you spend your time on your game's logic and story instead of rebuilding basic functions.

The most common library for Python games is Pygame, which handles graphics, sound, keyboard input, and collision detection. Pygame runs on Windows, Mac, and Linux, and it is free. If you want 3D games with more advanced graphics, Panda3D is another option, though it has a steeper learning curve. For this guide, we will focus on Pygame because it is the most straightforward path for someone starting out.

Python games run slower than games written in languages like C++, so Pygame works best for 2D games — side-scrollers, puzzle games, top-down adventures, and turn-based strategy. If your goal is a fast-paced 3D shooter, Python is not the right choice. But for learning game development and building games you can actually finish, Python is practical.

Key Takeaways

You need Python installed on your computer, plus the Pygame library, both of which are free and take 10 minutes to set up.
A basic Pygame game requires a game loop (code that runs over and over), a way to draw objects on screen, and a way to respond to player input.
Start with a straightforward game like Pong or a tile-based maze before attempting anything with complex physics or many moving objects.
Python games are slower than games in other languages, so Pygame works best for 2D games, not fast 3D games.
You can test your game on your own computer as you build it, without uploading it anywhere or paying for hosting.

Installing Python and Pygame on your computer

Go to python.org and read the latest version of Python (version 3.10 or newer). Run the installer. On Windows, make sure you check the box that says "Add Python to PATH" — this lets you run Python from anywhere on your computer. On Mac or Linux, Python usually installs with that setting already on.

Once Python is installed, open a terminal or command prompt. On Windows, press the Windows key and type "cmd". On Mac, press Command and Space, type "terminal", and press Enter. Type this command and press Enter: pip install pygame. The computer will read and install Pygame automatically. If you see "Successfully installed pygame", you are ready to start.

To test that everything works, type python in the terminal and press Enter. You should see a prompt that starts with ">>>". Type import pygame and press Enter. If nothing happens (no error message), Pygame is installed correctly. Type exit() to close Python.

The structure of a basic game loop

Every Pygame game has the same basic structure: initialize the game window, then run a loop that repeats 60 times per second (or however many times you set it to). Inside that loop, you check for player input, update the positions of objects, draw everything on screen, and then start over. If you do not have this loop, your game will freeze or crash.

Here is the skeleton of a Pygame game:

import pygame — tells Python to load the Pygame library. pygame.init() — starts Pygame. screen = pygame.display.set_mode((800, 600)) — creates a window 800 pixels wide and 600 pixels tall. clock = pygame.time.Clock() — creates a clock to control how fast the loop runs. running = True — a variable that stays True as long as the game is open. while running: — starts the loop that repeats every frame.

Inside the loop, you check for event in pygame.event.get(): to see if the player pressed a key or closed the window. You update the position of any moving objects. You draw everything with pygame.draw.rect() or pygame.draw.circle() or by loading an image. You call pygame.display.flip() to show the updated screen. Finally, you call clock.tick(60) to make the loop run 60 times per second.

Drawing shapes and handling player input

The simplest way to start is to draw basic shapes — rectangles, circles, lines — and move them when the player presses a key. You do not need images or complex graphics yet.

To draw a rectangle, use pygame.draw.rect(screen, color, (x, y, width, height)). The color is a tuple of three numbers for red, green, and blue — for example, (255, 0, 0) is red, (0, 255, 0) is green, (0, 0, 255) is blue, and (255, 255, 255) is white. The x and y are the position on screen, starting from the top-left corner.

To respond to keyboard input, check pygame.key.get_pressed() inside your game loop. This returns a list of which keys are currently held down. For example, if pygame.key.get_pressed()[pygame.K_LEFT]: checks if the left arrow key is pressed. If it is, you can subtract from the x position to move an object left. This approach is simpler than checking for individual key-press events when you want smooth movement.

A common mistake is updating the screen before you have drawn everything. Always draw all your objects first, then call pygame.display.flip() once at the end of the loop. If you call flip() multiple times, you will see flickering.

Building a complete example: a moving rectangle

Here is a complete, working game that draws a white rectangle and lets you move it with the arrow keys:

You import pygame and initialize it. You create a window 800 by 600 pixels. You set a clock to 60 frames per second. You create variables for the rectangle's position (x and y) and its size (width and height). You set a variable called running to True.

Then you start the while loop. You check for events — if the player closes the window, you set running to False. You check which keys are pressed. If the left arrow is pressed, you subtract 5 from x (moving left). If the right arrow is pressed, you add 5 to x (moving right). If the up arrow is pressed, you subtract 5 from y (moving up). If the down arrow is pressed, you add 5 to y (moving down).

You fill the screen with black (0, 0, 0) to erase the old frame. You draw a white rectangle at the current x and y position. You call pygame.display.flip() to show the updated screen. You call clock.tick(60) to keep the loop at 60 frames per second. When the player closes the window, running becomes False, the loop ends, and pygame.quit() closes Pygame.

Moving from shapes to images and collision detection

Once you can move a rectangle, the next step is to load an image file instead of drawing a shape. Use pygame.image.load("filename.png") to load an image, then use screen.blit(image, (x, y)) to draw it at a specific position. The image file must be in the same folder as your Python file, or you need to provide the full path.

Collision detection means checking whether two objects are touching. The simplest way is to use rectangles. Every image and every drawn shape has a rectangle around it. You can check if two rectangles overlap with rect1.colliderect(rect2). If they do, something has collided — maybe the player touched an enemy, or a bullet hit a wall.

For example, if you have a player rectangle and an enemy rectangle, you can check if player_rect.colliderect(enemy_rect): and then end the game or subtract health. This works for any game where you need to know if two things are touching.

Common mistakes and how to avoid them

The most common mistake is forgetting to call pygame.display.flip() or pygame.display.update() at the end of your loop. Without it, the screen does not update and you see nothing. The second mistake is updating the screen multiple times per loop, which causes flickering. Draw everything, then update once.

The third mistake is moving objects outside the game loop. If you write code that moves an object but it is not inside the while loop, it only runs once. The fourth mistake is checking for input with pygame.event.get() but not storing the result. You must loop through the events and check each one.

The fifth mistake is using the wrong coordinate system. In Pygame, (0, 0) is the top-left corner, x increases to the right, and y increases downward. If your object is moving in the wrong direction, you probably have the signs backwards.

What to build next after your first game

After you can move a rectangle and detect collisions, build a straightforward game with a clear goal. Pong is the classic choice — a ball bounces around the screen, two paddles try to hit it, and the first player to miss loses. It teaches you movement, collision, and score tracking without being overwhelming.

A tile-based maze is another good next step. You draw a grid of tiles (some are walls, some are empty), the player moves through the empty tiles with arrow keys, and the goal is to reach the exit. This teaches you how to organize data in a grid and check collisions against multiple objects at once.

Avoid jumping straight to a large game with many features. The temptation is to build your dream game, but you will get stuck on physics, animation, or sound and give up. Build something small that works, then add one feature at a time.

Frequently Asked Questions

Can I make a multiplayer game with Pygame?

Pygame itself does not handle networking, so two players on different computers cannot play together without extra work. You can make a two-player game on one computer where both players use the same keyboard (one uses arrow keys, the other uses WASD). For online multiplayer, you need to add a networking library, which is beyond what Pygame handles alone.

How do I add sound and music to my game?

Pygame has a mixer module for sound. Use pygame.mixer.Sound("filename.wav") to load a sound effect, then call sound.play() when something happens (like a collision). For background music, use pygame.mixer.music.load("filename.mp3") and pygame.mixer.music.play(). The audio file must be in the same folder as your Python file.

What if my game runs too slowly?

Pygame games slow down when you draw too many objects or run too much code in each frame. Start by checking how many objects you are drawing — if it is more than a few hundred, you need to optimize. You can also reduce the window size or lower the frame rate from 60 to 30. If the game is still slow, Pygame may not be the right tool for what you are trying to build.

Can I turn my Pygame game into an app for phones?

Pygame games run on Windows, Mac, and Linux, but not natively on phones. You can use a tool like Kivy to convert Python code to run on Android or iOS, but it requires rewriting parts of your game. For now, focus on building a game that works on a computer.

Where do I find free images and sounds for my game?

Websites like OpenGameArt.org, Itch.io, and Freesound.org have free images, sprites, and sound effects made by other game developers. Always check the license to make sure you can use them in your game. Most are free for personal and commercial use as long as you credit the creator.

This guide is for general information only and is not medical, financial, legal, or other professional advice. For decisions specific to your situation, consult a qualified professional. See our Editorial Policy.