Class ServerLoginNetworking

java.lang.Object

net.fabricmc.fabric.api.networking.v1.ServerLoginNetworking

public final class ServerLoginNetworking
extends Object

Offers access to login stage server-side networking functionalities.

Server-side networking functionalities include receiving serverbound query responses and sending clientbound query requests.

See Also:

• ServerPlayNetworking
• ServerConfigurationNetworking

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	ServerLoginNetworking.LoginQueryResponseHandler
static interface	ServerLoginNetworking.LoginSynchronizer	Allows blocking client log-in until all futures passed into ServerLoginNetworking.LoginSynchronizer.waitFor(Future) are completed.

Method Summary

Modifier and Type	Method	Description
static Set<net.minecraft.resources.Identifier>	getGlobalReceivers()	Gets all channel names which global receivers are registered for.
static LoginPacketSender	getSender(net.minecraft.server.network.ServerLoginPacketListenerImpl listener)	Gets the packet sender which sends packets to the connected client.
static net.minecraft.server.MinecraftServer	getServer(net.minecraft.server.network.ServerLoginPacketListenerImpl listener)	Returns the Minecraft Server of a server login packet listener.
static boolean	registerGlobalReceiver(net.minecraft.resources.Identifier channelName, ServerLoginNetworking.LoginQueryResponseHandler channelHandler)	Registers a handler to a query response channel.
static boolean	registerReceiver(net.minecraft.server.network.ServerLoginPacketListenerImpl packetListener, net.minecraft.resources.Identifier channelName, ServerLoginNetworking.LoginQueryResponseHandler responseHandler)	Registers a handler to a query response channel.
static @Nullable ServerLoginNetworking.LoginQueryResponseHandler	unregisterGlobalReceiver(net.minecraft.resources.Identifier channelName)	Removes the handler of a query response channel.
static @Nullable ServerLoginNetworking.LoginQueryResponseHandler	unregisterReceiver(net.minecraft.server.network.ServerLoginPacketListenerImpl packetListener, net.minecraft.resources.Identifier channelName)	Removes the handler of a query response channel.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

registerGlobalReceiver

public static boolean registerGlobalReceiver(net.minecraft.resources.Identifier channelName,
 ServerLoginNetworking.LoginQueryResponseHandler channelHandler)

Registers a handler to a query response channel. A global receiver is registered to all connections, in the present and future.

If a handler is already registered to the channel, this method will return false, and no change will be made. Use unregisterGlobalReceiver(Identifier) to unregister the existing handler.

Parameters:

channelName - the id of the channel

channelHandler - the handler

Returns:

false if a handler is already registered to the channel

See Also:

• unregisterGlobalReceiver(Identifier)
• registerReceiver(ServerLoginPacketListenerImpl, Identifier, LoginQueryResponseHandler)

unregisterGlobalReceiver

public static @Nullable ServerLoginNetworking.LoginQueryResponseHandler unregisterGlobalReceiver(net.minecraft.resources.Identifier channelName)

Removes the handler of a query response channel. A global receiver is registered to all connections, in the present and future.

The channel is guaranteed not to have a handler after this call.

Parameters:

channelName - the id of the channel

Returns:

the previous handler, or null if no handler was bound to the channel

See Also:

• registerGlobalReceiver(Identifier, LoginQueryResponseHandler)
• unregisterReceiver(ServerLoginPacketListenerImpl, Identifier)

getGlobalReceivers

public static Set<net.minecraft.resources.Identifier> getGlobalReceivers()

Gets all channel names which global receivers are registered for. A global receiver is registered to all connections, in the present and future.

Returns:

all channel names which global receivers are registered for.

registerReceiver

public static boolean registerReceiver(net.minecraft.server.network.ServerLoginPacketListenerImpl packetListener,
 net.minecraft.resources.Identifier channelName,
 ServerLoginNetworking.LoginQueryResponseHandler responseHandler)

Registers a handler to a query response channel.

If a handler is already registered to the channelName, this method will return false, and no change will be made. Use unregisterReceiver(ServerLoginPacketListenerImpl, Identifier) to unregister the existing handler.

Parameters:

packetListener - the listener

channelName - the id of the channel

responseHandler - the handler

Returns:

false if a handler is already registered to the channel name

unregisterReceiver

public static @Nullable ServerLoginNetworking.LoginQueryResponseHandler unregisterReceiver(net.minecraft.server.network.ServerLoginPacketListenerImpl packetListener,
 net.minecraft.resources.Identifier channelName)

Removes the handler of a query response channel.

The channelName is guaranteed not to have a handler after this call.

Parameters:

channelName - the id of the channel

Returns:

the previous handler, or null if no handler was bound to the channel name

getServer

public static net.minecraft.server.MinecraftServer getServer(net.minecraft.server.network.ServerLoginPacketListenerImpl listener)

Returns the Minecraft Server of a server login packet listener.

Parameters:

listener - the server login packet listener

getSender

public static LoginPacketSender getSender(net.minecraft.server.network.ServerLoginPacketListenerImpl listener)

Gets the packet sender which sends packets to the connected client.

Parameters:

listener - the packet listener, representing the connection to the client

Returns:

the packet sender