Page 1 of 1

Computer Networking, Two-Player Interactive Game

#1 DK3250  Icon User is offline

  • Pythonian
  • member icon

Reputation: 287
  • View blog
  • Posts: 908
  • Joined: 27-December 13

Posted 28 March 2017 - 07:40 AM

Computer Networking, Two-Player Interactive Game

It is only fair to admit that Python Network Programming is not my core competence. Some code lines are still a bit unclear to me.
What I present here is very simple and probably not an optimal code. But it works. I'll be happy to get feedback and suggestions improving the performance.

With this tutorial, I move into an area where I am still a novice. I have, however, spend quite long time figuring out how to connect two computers for interactive gaming. My code works and there is no other tutorial that covers the subject.

So, bear with me if something is not best practice – and do come forward with suggestions for improvements.

The code is the simplest I can think of; two icons move around on the screen. They do nothing and do not interact. But they are controlled from two different computers – and the game play is up to you.

Nevertheless, this tutorial will be fairly large. We need to cover DHCP addresses and IP addresses, Router settings, the socket module and finally the interactive game.

DHCP address
DHCP is acronym for Dynamic Host Configuration Protocol. Your DHCP address is the unique number used in communication to your Router, something like ”” or “”. To find the DHCP address, open a command prompt and type 'ipconfig', you'll get an output like:

Posted Image

The address is here called Ipv4 Address. I normally use the term 'DHCP address' for addresses inside the Router, and 'IP address' for the Router access from the Internet. Often, both are just called 'IP'.

If you plan to connect to another computer on the same Router e.g. A family member in the same house, you should also look for the DHCP address of this other computer. More to read:

You will also need a port number for the communication. Ports are address inside the computer used when communicating. This is a whole major subject in its own right; what you need to know is that ports used here should always be in the range 1025-65535. I tend to use 9990-9999.

IP addresses
If you plan to connect to a computer on another network, you need to know the two Router IP addresses involved. This is the IP address of your Router when seen from outside the local network. The easiest way to get the IP address is by using one of the many free services on the Internet, such as

If your Router has dynamic IP-address, the value may change.
You will need to check the IP address periodically, especially if the Router has been stopped.

Port forwarding
If you plan to connect two networks, you’ll need to set-up the port forwarding in both Routers.
This can be a bit of a challenge, and depends of your Router. Please look-up your Router manual for details.
A signal arriving to the Router will be blocked by your firewall unless port forwarding is established. With port forwarding, the Router knows which DHCP address that listen to each port; thus, directing the signal to the correct device.
You will need to assign port forwarding for the port number chosen in the program (see below); in the Router you assign the port to your computer; remember to enable the connection after setting it in the Router.

If you run the two computers on the same LAN, you don't need to consider port forwarding.

To communicate between two computers, we use the Python socket module.

We instantiate a small Server and let it 'listen' for data traffic on the specified port. Any data on the port will be translated to meaningful instructions using a small home build 'protocol' – as you will see, the protocol used here is extremely simple.

All the Server does is listen on the port and provide data to our program.

Whenever we want to send data; we first construct the message using the protocol and we then enter a 'client cycle':

1. initialize a Client
2. send the message
3. close the Client

So, in this program clients are only for sending, and clients only 'live' to send one single message.

Code structure
The code I'll show consist of two programs. The first one is a module used by the second one. In this module I have placed all the code necessary for communication. The main program is (almost) standard Python/Pygame code.
You need to download the two programs in the same folder; the first code MUST be named ''. I'll refer to the second program as 'game'.
The two programs must be placed on two computers. The DHCP/IP addresses of the two computes must be hard coded to line 15 and 17 in both versions of 'game'. Also, make sure that the ports are mirrored in line 16 and 18 (or use same port on both computers).

import socket, sys

data_payload = 2048
backlog = 2

class Client():
    def __init__(self, ip, port):
        self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
            self.sock.connect((ip, port))
        except socket.timeout:
            print('Timeout at connect')

    def send(self, message):
        except socket.timeout:
            print('Timeout at send')

    def shutdown(self):

class Server():
    def __init__(self, ip, port):
        self.sock = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
        self.sock.setsockopt(socket.SOL_SOCKET, socket.SO_REUSEADDR, 1)
        self.sock.bind((ip, port))

    def receive(self):
        data = None
        self.client, address = self.sock.accept()
        data = self.client.recv(data_payload).decode()
        return data

    def shutdown(self):

def send(msg, OTHER_HOST, OTHER_PORT):
    client = Client(OTHER_HOST, OTHER_PORT)

The code here I've collected and assembled by a lot of reading and testing; I'm not sure of all details, so bear with me for not explaining it in detail.
On a high-level the code describes two class objects, Client and Server with their 'send' and 'receive' methods respectively. Furthermore a small function 'def send():' executing the client cycle described above.
The two print statements in line 13 and 19 are remnants from the code development. In a real game the timeouts in communication should be handled more gracefully; this is still work in progress.

The code utilizes the socket module.
Link to the socket documentation: https://docs.python....ary/socket.html
Link to socket tutorial:


import pygame, sys, socket
import connection

""" This demonstrates a two-player game to be played from two different PCs
    connected to a local network (LAN) or even via the Internet. The code
    requeres access to the module 'connection' for handling of generel server
    and client code.

    Data send between the two players must be 'string'-format.


X = 600
Y = 400

screen = pygame.display.set_mode((X, Y))

WHITE = (255, 255, 255)
RED = (255, 0, 0)
BLUE = (0, 0, 255)

class Player():
    def __init__(self, pos):
        self.img = pygame.surface.Surface((20, 20))
        self.rect = self.img.get_rect(center = pos)

    def move(self, dir):
        if dir == 'up' and > 0:
            self.rect.centery -= 2
        if dir == 'down' and self.rect.bottom < Y:
            self.rect.centery += 2
        if dir == 'left' and self.rect.left > 0:
            self.rect.centerx -= 2
        if dir == 'right' and self.rect.right < X:
            self.rect.centerx += 2

    def draw(self):
        screen.blit(self.img, self.rect)

    def make_data_package(self):
        datax = str(self.rect.centerx).rjust(4, '0')
        datay = str(self.rect.centery).rjust(4, '0')
        return datax + datay

class Player_1(Player):
    def __init__(self, pos=(200, 200)):

class Player_2(Player):
    def __init__(self, pos=(400, 200)):

def ip_value(ip):
    """ ip_value returns ip-string as integer """
    return int(''.join([x.rjust(3, '0') for x in ip.split('.')]))

def define_players():
    if ip_value(MY_SERVER_HOST) > ip_value(OTHER_HOST):
        me = Player_1()
        enemy = Player_2()
        me = Player_2()
        enemy = Player_1()
    return me, enemy

def event_handling():
    for event in pygame.event.get():
        if event.type == pygame.QUIT:

def get_input():
    keys = pygame.key.get_pressed()
    for button, direction in [(pygame.K_UP, 'up'), (pygame.K_DOWN, 'down'),
                              (pygame.K_LEFT, 'left'), (pygame.K_RIGHT, 'right')]:
        if keys[button]:

def data_transfer():
    me_data = me.make_data_package()
    connection.send(me_data, OTHER_HOST, OTHER_PORT) # the send code

    enemy_data = server.receive() # the receive code
    enemy.rect.centerx = int(enemy_data[:4])
    enemy.rect.centery = int(enemy_data[4:])

def update_screen():

me, enemy = define_players()
server = connection.Server(MY_SERVER_HOST, MY_SERVER_PORT)        
while True:

The idea in this code is that both players use exactly same code (apart from the IP and port addresses). The two player objects needed are called 'me' and 'enemy'. The code ensures that the 'me' player on one computer is perceived as the 'enemy' player on the other, and vise versa.

In line 1-2 imports are made; the module 'socket' is from the standard library, it provides all the server and client code. The module 'connection' is the code provided in this tutorial, above.

Line 15-18 is where you need to insert the IP and port addresses relevant for you. I could have wrapped this in a nice input page, but I want to keep this tutorial as simple as possible.

When you are connected to a LAN, it is possible to get the local IP address using:

MY_SERVER_HOST = socket.gethostbyname(socket.gethostname())

But as you still need to enter OTHER_HOST and the port numbers, I have kept things as transparent as possible.

The class Player() is a general player object. It has three small methods; move(), draw() and make_data_package().

The make_data_package() executes the 'protocol' for data transfer.
We want to send the x- and y- position of the player; the two values are converted to string of length 4, padded with zeros as necessary. Examples: 2 → '0002'; 123 → '0123'.
Finally, the two strings are concatenated to a structure like 'xxxxyyyy', which it the data package to send.
If we jump to line 102-105, this is where data are received and unpacked; you see how we convert the string back to two integers, updating data for the other player.

The two player objects, Player_1 and Player_2, inherits from Player. The two instances only differ in starting position and color.

The small ip_value() function converts an IP address to an integer; it does so by padding each octet (three digit group) with zeros and removing the dots. Example: '' → 192168000018.

As the two DHCP/IP addresses will always be different, the comparison in line 73 will always turn out 'True' on one computer and 'False' on the other. We don't care which is which, but we use this to ensure that 'me' on one computer is Player_1 and 'me' on the other is Player_2.
In this small code, it is of less importance, it only ensures two different start positions, but in more complicated games you may need to define different roles like 'master' and 'slave'.

The event_handling() function is standard, just notice the server.shutdown() included in the termination of the program.

The get_input() is also simple. Could also be made with a dictionary, but I chose a small list of tuples.

In the data_transfer() function the data package is created and send to the other computer.
Then we listen for received data which is then converted as explained above.

The update_screen() needs no comments.

Finally, in line 116-117, the two Player instances and the Server instance are created.
The small game loop in line 119-123 is simple.

I have tried to keep everything as simple as possible, only focusing on code related to the data transfer and data handling.

Posted Image

The 'game' is not a game, but rather a framework on which a game can be build. I plan to issue a tutorial demonstrating a full interactive game building on the code shown here; but you don't need to wait for it – you can probably make something yourself now.

Play around and feel free to use this in any way you can think of.
If you find improvements, I’ll be happy to learn about it as a respond to this tutorial.

I have placed the code shown in this tutorial on github:
This is an invitation to all interested to participate in further development of this code.

Is This A Good Question/Topic? 0
  • +

Page 1 of 1