Up to date

This page is up to date for Godot 4.3. If you still find outdated information, please open an issue.

TCPServerΒΆ

Inherits: RefCounted < Object

A TCP server.

DescriptionΒΆ

A TCP server. Listens to connections on a port and returns a StreamPeerTCP when it gets an incoming connection.

Note: When exporting to Android, make sure to enable the INTERNET permission in the Android export preset before exporting the project or using one-click deploy. Otherwise, network communication of any kind will be blocked by Android.

MethodsΒΆ

int

get_local_port() const

bool

is_connection_available() const

bool

is_listening() const

Error

listen(port: int, bind_address: String = "*")

void

stop()

StreamPeerTCP

take_connection()


Method DescriptionsΒΆ

int get_local_port() const πŸ”—

Returns the local port this server is listening to.


bool is_connection_available() const πŸ”—

Returns true if a connection is available for taking.


bool is_listening() const πŸ”—

Returns true if the server is currently listening for connections.


Error listen(port: int, bind_address: String = "*") πŸ”—

Listen on the port binding to bind_address.

If bind_address is set as "*" (default), the server will listen on all available addresses (both IPv4 and IPv6).

If bind_address is set as "0.0.0.0" (for IPv4) or "::" (for IPv6), the server will listen on all available addresses matching that IP type.

If bind_address is set to any valid address (e.g. "192.168.1.101", "::1", etc.), the server will only listen on the interface with that address (or fail if no interface with the given address exists).


void stop() πŸ”—

Stops listening.


StreamPeerTCP take_connection() πŸ”—

If a connection is available, returns a StreamPeerTCP with the connection.