ENetConnection in Godot – Complete Guide

Welcome to our tutorial on the ENetConnection class in Godot 4, where we’re going to dive into the fascinating world of network programming within one of the most popular game engines. If you’re interested in making your game multiplayer or simply want to understand how networking operates in a real-time environment, you’re in the right place. Networking is a crucial aspect of game development, allowing players from around the world to connect and interact in a shared space. So, whether you’re a hobbyist looking to level up your game with multiplayer features or a seasoned developer aiming to optimize your network code, this tutorial will provide you with the insights needed to get started.

What is ENetConnection?

ENetConnection is a wrapper class provided within Godot 4, specifically designed to manage network communication for your projects. It is built on top of UDP (User Datagram Protocol), which is a communication protocol known for its speed and efficiency, particularly in real-time applications like multiplayer games.

What is ENetConnection used for?

This class allows developers to create robust, high-performance network connections between a server and multiple clients, making it the backbone for multiplayer game functionalities. With ENetConnection, you can establish a connection, send and receive data, handle bandwidth limitations, broadcast messages to multiple clients, and work with different compression methods for data packets.

Why should I learn it?

Understanding and implementing ENetConnection provides several advantages:

– **Real-Time Networking**: It enables the development of real-time multiplayer games or applications.
– **Platform Independence**: ENetConnection is compatible with multiple platforms, broadening your audience reach.
– **Performance Optimization**: You can optimize network performance by controlling bandwidth and utilizing different compression modes.
– **Security**: The class supports DTLS encryption, protecting the data shared between connections.

Mastering ENetConnection is a step forward in becoming a versatile Godot developer, opening the door to a whole new facet of game development and programming skills that are highly sought after in the industry. Let’s get started by exploring some of the basics of the ENetConnection class with practical examples.

CTA Small Image

Establishing a Server with ENetConnection

Before clients can connect, we must establish a server. Godot makes server creation straightforward using the ENetConnection class. Here’s a basic example of establishing a server that listens for incoming connections:

var server = ENetConnection.new()

func _ready():
    server.create_server(1234, 10)  # Port number, Maximum clients
    print("Server started on port 1234, awaiting connections...")

This code creates a server that listens on port 1234 and allows up to 10 clients to connect. The `create_server` method is the key function in setting up your server.

Connecting a Client to the Server

On the client side, connecting to a server is equally simple:

var client = ENetConnection.new()

func _ready():
    if client.create_client("", 1234) == OK:
        print("Successfully connected to the server!")
        print("Failed to connect to the server.")

In this snippet, the client attempts to connect to the server using its IP address and the port number on which the server is listening. The `create_client` method tries to establish this connection.

Handling Incoming Data

Once the connection between a client and server is established, both need to handle incoming data. With Godot, this process is event-driven and can be coded as follows:

Server side:

func _process(delta):
    while server.get_event() == OK:
        match server.get_packet_channel():
                # Handle chat messages
                # Handle game actions

Client side:

func _process(delta):
    while client.get_event() == OK:
        match client.get_packet_channel():
                # Display chat messages
                # Update game state

These examples demonstrate a basic event loop that processes incoming data packets.

Sending Data Across the Network

For both clients and servers, sending data over the network is imperative. Below are examples of sending a chat message from a client and broadcasting a message from the server.

Client sending message:

var message = "Hello, World!"
client.send_packet(message.to_utf8(), 1)  # Channel ID for chat

Server broadcasting message:

var broadcast_message = "Welcome to the server!"
server.broadcast_packet(broadcast_message.to_utf8(), 1)  # Channel ID for chat

In these code snippets, `send_packet` sends a message to the server while `broadcast_packet` sends a message from the server to all connected clients.

Please note that the real power of ENetConnection comes with its ability to handle more complex data structures and performant communication practices. In subsequent parts of this tutorial, we will delve deeper into these topics. But for now, this basic foundation in ENetConnection sets the stage for creating functional multiplayer experiences in Godot 4.Continuing with our dive into Godot 4’s ENetConnection class, let’s explore some more advanced features and use cases. We’ll look into handling disconnections, custom packet channels, syncing player movements, and managing in-game sessions.

Handling Disconnections

In any networked game, you need to handle disconnections gracefully. You can check for disconnection events as follows:

func _process(delta):
    while server.get_event() == OK:
        if server.get_packet_command() == ENetConnection.DISCONNECT:
            var client_id = server.get_packet_peer_id()
            print("Client " + str(client_id) + " has disconnected.")

Setting Up Custom Packet Channels

Using custom packet channels can help in organizing different types of data, making it easier to manage network traffic:

const CHAT_CHANNEL = 1

# Send a chat message over the chat channel
func send_chat_message(text):
    var message = "Chat: " + text
    client.send_packet(message.to_utf8(), CHAT_CHANNEL)

# Send a gameplay action over the gameplay channel
func perform_action(action_name):
    var action = "Action: " + action_name
    client.send_packet(action.to_utf8(), GAMEPLAY_CHANNEL)

Syncing Player Movement

Syncing player movement across the network is a common requirement. Imagine a simple scenario where the players control a character that can move in four directions:

# Assuming movement has been captured in a Vector2 'movement_vector' 
func send_player_movement():
    var movement_data = to_json({ "type": "move", "data": movement_vector })
    client.send_packet(movement_data.to_utf8(), GAMEPLAY_CHANNEL)

# On the server, interpret and broadcast the movement data
func _process(delta):
    while server.get_event() == OK:
        if server.get_packet_channel() == GAMEPLAY_CHANNEL:
            var data = parse_json(server.get_packet().get_string_from_utf8())
            if data["type"] == "move":
                server.broadcast_packet(server.get_packet(), GAMEPLAY_CHANNEL)

Managing In-Game Sessions

When hosting multiple game sessions, it’s important to manage each separately:

var sessions = {}

func create_new_session(session_id):
    sessions[session_id] = {
        "players": [],
        "state": {}

func add_player_to_session(session_id, player_id):
    if session_id in sessions:

And when sending updates, only send them to players in the same game session:

func broadcast_to_session(session_id, packet, channel):
    if session_id in sessions:
        for player_id in sessions[session_id]["players"]:
            server.send_packet(player_id, packet, channel)

These snippets highlight the versatility of Godot’s ENetConnection class when it comes to managing various network-related scenarios. Beyond these examples, developers can utilize ENetConnection for features like lobby systems, match making, and turn-based game logic. Using these advanced networking techniques will set your multiplayer project for success in Godot 4.Let’s delve even further into ENetConnection’s capabilities, focusing on optimizing data to minimize bandwidth usage—a critical aspect of network programming in games.

Optimizing Network Data

When sending updates across the network, it’s essential to only send what’s necessary. For example, you might send position updates at a fixed interval instead of every frame:

var update_timer = 0.0
const UPDATE_INTERVAL = 0.1  # seconds

func _process(delta):
    update_timer += delta
    if update_timer >= UPDATE_INTERVAL:
        update_timer = 0.0

func send_player_position():
    var position_data = to_json({ "type": "position", "x": player.x, "y": player.y })
    client.send_packet(position_data.to_utf8(), GAMEPLAY_CHANNEL)

Another strategy is to compress your data. For smaller data types like integers or floats, simple packing might suffice:

func pack_vector2(v):
    return PoolByteArray([v.x, v.y])

func send_player_position():
    var packed_position = pack_vector2(player.position)
    client.send_packet(packed_position, GAMEPLAY_CHANNEL)

For more complex data structures, you might consider zipping the data before sending:

import zlib

func compress_data(data):
    return zlib.compress(data)

func send_complex_data(data):
    var json_data = to_json(data)
    var compressed_data = compress_data(json_data.to_utf8())
    client.send_packet(compressed_data, GAMEPLAY_CHANNEL)

Leveraging Godot’s built-in functionality, you can also enable compression for all packets sent through ENetConnection:

client.set_compression_mode(1)  # Enables range coder compression for all packets

Previously, we’ve looked at broadcast packets for sending data to all connected clients. However, sometimes you will want to send a message to a specific client:

func send_private_message(client_id, message):
    var message_data = to_json({ "type": "private_message", "content": message })
    server.send_packet(client_id, message_data.to_utf8(), CHAT_CHANNEL)

For games that require precision and speed, such as fast-paced multiplayer shooters, you might opt to use unreliable packets for non-critical updates:

func send_position_unreliable(position):
    var position_data = to_json({ "x": position.x, "y": position.y })
    client.send_packet_unreliable(position_data.to_utf8(), GAMEPLAY_CHANNEL)

Using ENetConnection’s `send_packet_unreliable` method, packets are sent more quickly, but without any guarantee they’ll arrive or stay in order—which is acceptable for certain types of real-time data.

Through these examples, we see how ENetConnection accommodates a variety of scenarios, from basic chatting functions to complex session management and data optimization. Remember, the key to efficient network programming lies not only in the structures and algorithms you choose but also in understanding and leveraging the tools provided by the game engine. With ENetConnection in Godot 4, you have a powerful set of features to make your multiplayer game both functional and performant.

Continue Your Game Development Journey with Zenva

Now that you’ve had a taste of networking in Godot 4 with the ENetConnection class, it’s time to expand your skills and continue your game development journey. If these tutorials sparked your interest and you’re eager to master Godot 4, our Godot Game Development Mini-Degree is the perfect next step. This comprehensive learning path is designed to take you from the basics to creating your own cross-platform games using the powerful, yet lightweight Godot 4 game engine.

The Mini-Degree covers a wide range of essential topics, from working with 2D and 3D assets, understanding GDScript, crafting engaging gameplay, to developing rich game mechanics for various game genres. You’ll gain hands-on experience by building projects that challenge and refine your skills, equipping you with the practical knowledge needed for real-world game development.

Whether you’re just starting out or looking to polish up your existing skills, our library of Godot courses offers something for everyone. At Zenva, we’re proud to support learners at every stage of their coding and game creation journey. With access to our video lessons, interactive coding exercises, and certificates of completion, you can progress from beginner to professional at your own pace. So why wait? Join us at Zenva Academy and turn your game development dreams into reality!


In the limitless expanse of game development, mastering the network layer with tools like Godot 4’s ENetConnection class takes you one step closer to bringing your multiplayer game visions to life. The journey through handling connections, optimizing data, and providing seamless player interactions is both challenging and rewarding. It’s a skill that can distinguish your games and potentially attract a global audience of players.

Remember, learning is a continuous adventure, especially in the ever-evolving field of game development. Dive deeper, perfect your craft, and turn your passion into stunning, interactive experiences with our Godot Game Development Mini-Degree. Your next milestone in game development awaits, and we at Zenva are excited to be a part of your journey, empowering you to create, innovate, and thrive. The game industry waits for no one, so grab the opportunity and keep leveling up your skills with us!

Python Blog Image

FINAL DAYS: Unlock coding courses in Unity, Godot, Unreal, Python and more.