Update Lua definitions

Author: github-actions[bot]

library/paper/imports.lua

@@ -674,7 +674,6 @@
 ---| '"io.papermc.paper.command.brigadier.CommandSourceStack"' 
 ---| '"io.papermc.paper.command.brigadier.Commands"' 
 ---| '"io.papermc.paper.command.brigadier.MessageComponentSerializer"' 
----| '"io.papermc.paper.command.brigadier.MessageComponentSerializerHolder"' 
 ---| '"io.papermc.paper.command.brigadier.argument.ArgumentTypes"' 
 ---| '"io.papermc.paper.command.brigadier.argument.CustomArgumentType.Converted"' 
 ---| '"io.papermc.paper.command.brigadier.argument.CustomArgumentType"' 
@@ -694,6 +693,13 @@
 ---| '"io.papermc.paper.command.brigadier.argument.resolvers.selector.PlayerSelectorArgumentResolver"' 
 ---| '"io.papermc.paper.command.brigadier.argument.resolvers.selector.SelectorArgumentResolver"' 
 ---| '"io.papermc.paper.configuration.ServerConfiguration"' 
+---| '"io.papermc.paper.connection.PlayerCommonConnection"' 
+---| '"io.papermc.paper.connection.PlayerConfigurationConnection"' 
+---| '"io.papermc.paper.connection.PlayerConnection"' 
+---| '"io.papermc.paper.connection.PlayerGameConnection"' 
+---| '"io.papermc.paper.connection.PlayerLoginConnection"' 
+---| '"io.papermc.paper.connection.ReadablePlayerCookieConnection"' 
+---| '"io.papermc.paper.connection.WritablePlayerCookieConnection"' 
 ---| '"io.papermc.paper.datacomponent.BuildableDataComponent"' 
 ---| '"io.papermc.paper.datacomponent.DataComponentBuilder"' 
 ---| '"io.papermc.paper.datacomponent.DataComponentHolder"' 
@@ -831,6 +837,10 @@
 ---| '"io.papermc.paper.event.block.PlayerShearBlockEvent"' 
 ---| '"io.papermc.paper.event.block.TargetHitEvent"' 
 ---| '"io.papermc.paper.event.block.VaultChangeStateEvent"' 
+---| '"io.papermc.paper.event.connection.PlayerConnectionValidateLoginEvent"' 
+---| '"io.papermc.paper.event.connection.configuration.AsyncPlayerConnectionConfigureEvent"' 
+---| '"io.papermc.paper.event.connection.configuration.PlayerConnectionInitialConfigureEvent"' 
+---| '"io.papermc.paper.event.connection.configuration.PlayerConnectionReconfigureEvent"' 
 ---| '"io.papermc.paper.event.entity.ElderGuardianAppearanceEvent"' 
 ---| '"io.papermc.paper.event.entity.EntityAttemptSmashAttackEvent"' 
 ---| '"io.papermc.paper.event.entity.EntityCompostItemEvent"' 
@@ -893,6 +903,7 @@
 ---| '"io.papermc.paper.event.player.PlayerPickEntityEvent"' 
 ---| '"io.papermc.paper.event.player.PlayerPickItemEvent"' 
 ---| '"io.papermc.paper.event.player.PlayerPurchaseEvent"' 
+---| '"io.papermc.paper.event.player.PlayerServerFullCheckEvent"' 
 ---| '"io.papermc.paper.event.player.PlayerShieldDisableEvent"' 
 ---| '"io.papermc.paper.event.player.PlayerSignCommandPreprocessEvent"' 
 ---| '"io.papermc.paper.event.player.PlayerStonecutterRecipeSelectEvent"' 
@@ -989,6 +1000,8 @@
 ---| '"io.papermc.paper.registry.data.GameEventRegistryEntry.Builder"' 
 ---| '"io.papermc.paper.registry.data.GameEventRegistryEntry"' 
 ---| '"io.papermc.paper.registry.data.InlinedRegistryBuilderProvider"' 
+---| '"io.papermc.paper.registry.data.InstrumentRegistryEntry.Builder"' 
+---| '"io.papermc.paper.registry.data.InstrumentRegistryEntry"' 
 ---| '"io.papermc.paper.registry.data.JukeboxSongRegistryEntry.Builder"' 
 ---| '"io.papermc.paper.registry.data.JukeboxSongRegistryEntry"' 
 ---| '"io.papermc.paper.registry.data.PaintingVariantRegistryEntry.Builder"' 

library/paper/io.papermc.paper.command.brigadier.MessageComponentSerializerHolder.lua

@@ -0,0 +1,30 @@
+--- Optional.empty
+---@meta
+-- io.papermc.paper.connection.PlayerCommonConnection
+---@class io.papermc.paper.connection.PlayerCommonConnection: io.papermc.paper.connection.WritablePlayerCookieConnection, io.papermc.paper.connection.ReadablePlayerCookieConnection, java.lang.Object
+local PlayerCommonConnection = {}
+
+---@param details java.util.Map report details
+---@public
+---@return nil 
+--- Sends data to appear in this connection's report logs. This is useful for debugging server state that may be causing player disconnects. <p> These are formatted as key - value, where keys are limited to a length of 128 characters, values are limited to 4096, and 32 maximum entries can be sent.
+function PlayerCommonConnection:sendReportDetails(details) end
+
+---@param links org.bukkit.ServerLinks links to send
+---@public
+---@return nil 
+--- Sends the given server links to this connection.
+function PlayerCommonConnection:sendLinks(links) end
+
+---@param host string host
+---@param port number port
+---@public
+---@return nil 
+--- Transfers this connection to another server.
+function PlayerCommonConnection:transfer(host, port) end
+
+---@param type com.destroystokyo.paper.ClientOption client option
+---@public
+---@return T the client option value of the player
+function PlayerCommonConnection:getClientOption(type) end
+

library/paper/io.papermc.paper.connection.PlayerCommonConnection.lua

@@ -0,0 +1,25 @@
+---@meta
+-- io.papermc.paper.connection.PlayerConfigurationConnection
+---@class io.papermc.paper.connection.PlayerConfigurationConnection: io.papermc.paper.connection.PlayerCommonConnection, java.lang.Object
+local PlayerConfigurationConnection = {}
+
+---@public
+---@return net.kyori.adventure.audience.Audience the configuring player audience
+--- Returns the audience representing the player in configuration mode. This can be used to interact with the Adventure API during the configuration stage. This is guaranteed to be an instance of {@link PlayerConfigurationConnection}
+function PlayerConfigurationConnection:getAudience() end
+
+---@public
+---@return com.destroystokyo.paper.profile.PlayerProfile profile
+--- Gets the profile for this connection.
+function PlayerConfigurationConnection:getProfile() end
+
+---@public
+---@return nil 
+--- Clears the players chat history and their local chat.
+function PlayerConfigurationConnection:clearChat() end
+
+---@public
+---@return nil 
+--- Completes the configuration for this player, which will cause this player to reenter the game. <p> Note, this should be only be called if you are reconfiguring the player.
+function PlayerConfigurationConnection:completeReconfiguration() end
+

library/paper/io.papermc.paper.connection.PlayerConfigurationConnection.lua

@@ -0,0 +1,36 @@
+---@meta
+-- io.papermc.paper.connection.PlayerConnection
+---@class io.papermc.paper.connection.PlayerConnection: java.lang.Object
+local PlayerConnection = {}
+
+---@param component net.kyori.adventure.text.Component disconnect reason
+---@public
+---@return nil 
+--- Disconnects the player connection. <p> Note that calling this during connection related events may caused undefined behavior.
+function PlayerConnection:disconnect(component) end
+
+---@public
+---@return boolean is transferred
+--- Gets if this connection originated from a transferred connection. <p> Do note that this is sent and stored on the client.
+function PlayerConnection:isTransferred() end
+
+---@public
+---@return java.net.SocketAddress the remote {@link SocketAddress} of the channel
+--- Gets the raw remote address of the connection. This may be a proxy address or a Unix domain socket address, depending on how the channel was established.
+function PlayerConnection:getAddress() end
+
+---@public
+---@return java.net.InetSocketAddress the client {@link InetSocketAddress}
+--- Gets the real client address of the player. If the connection is behind a proxy, this will be the actual player’s IP address extracted from the proxy handshake.
+function PlayerConnection:getClientAddress() end
+
+---@public
+---@return java.net.InetSocketAddress The client's virtual host, or {@code null} if unknown
+--- Returns the virtual host the client is connected to.  <p>The virtual host refers to the hostname/port the client used to connect to the server.</p>
+function PlayerConnection:getVirtualHost() end
+
+---@public
+---@return java.net.InetSocketAddress the player's proxy address, null if the server doesn't have Proxy Protocol enabled, or the player didn't connect to an HAProxy instance
+--- Gets the socket address of this player's proxy
+function PlayerConnection:getHAProxyAddress() end
+

library/paper/io.papermc.paper.connection.PlayerConnection.lua

@@ -0,0 +1,15 @@
+---@meta
+-- io.papermc.paper.connection.PlayerGameConnection
+---@class io.papermc.paper.connection.PlayerGameConnection: io.papermc.paper.connection.PlayerCommonConnection, java.lang.Object
+local PlayerGameConnection = {}
+
+---@public
+---@return nil 
+--- Bumps the player to the configuration stage. <p> This will, by default, cause the player to stay until their connection is released by {@link PlayerConfigurationConnection#completeReconfiguration()}
+function PlayerGameConnection:reenterConfiguration() end
+
+---@public
+---@return org.bukkit.entity.Player player
+--- Gets the player that is associated with this game connection.
+function PlayerGameConnection:getPlayer() end
+

library/paper/io.papermc.paper.connection.PlayerGameConnection.lua

@@ -0,0 +1,15 @@
+---@meta
+-- io.papermc.paper.connection.PlayerLoginConnection
+---@class io.papermc.paper.connection.PlayerLoginConnection: io.papermc.paper.connection.ReadablePlayerCookieConnection, java.lang.Object
+local PlayerLoginConnection = {}
+
+---@public
+---@return com.destroystokyo.paper.profile.PlayerProfile authenticated profile, or null if not present
+--- Gets the authenticated profile for this connection. This may return null depending on what stage this connection is at.
+function PlayerLoginConnection:getAuthenticatedProfile() end
+
+---@public
+---@return com.destroystokyo.paper.profile.PlayerProfile the unsafe unauthenticated profile, or null if not sent
+--- Gets the player profile that this connection is requesting to authenticate as.
+function PlayerLoginConnection:getUnsafeProfile() end
+

library/paper/io.papermc.paper.connection.PlayerLoginConnection.lua

@@ -0,0 +1,11 @@
+---@meta
+-- io.papermc.paper.connection.ReadablePlayerCookieConnection
+---@class io.papermc.paper.connection.ReadablePlayerCookieConnection: io.papermc.paper.connection.PlayerConnection, java.lang.Object
+local ReadablePlayerCookieConnection = {}
+
+---@param key org.bukkit.NamespacedKey the key identifying the cookie
+---@public
+---@return java.util.concurrent.CompletableFuture a {@link CompletableFuture} that will be completed when the Cookie response is received or otherwise available. If the cookie is not set in the client, the {@link CompletableFuture} will complete with a null value.
+--- Retrieves a cookie from this connection.
+function ReadablePlayerCookieConnection:retrieveCookie(key) end
+

library/paper/io.papermc.paper.connection.ReadablePlayerCookieConnection.lua

@@ -0,0 +1,12 @@
+---@meta
+-- io.papermc.paper.connection.WritablePlayerCookieConnection
+---@class io.papermc.paper.connection.WritablePlayerCookieConnection: io.papermc.paper.connection.PlayerConnection, java.lang.Object
+local WritablePlayerCookieConnection = {}
+
+---@param key org.bukkit.NamespacedKey the key identifying the cookie
+---@param value table<number> the data to store in the cookie
+---@public
+---@return nil 
+--- Stores a cookie in this player's client.
+function WritablePlayerCookieConnection:storeCookie(key, value) end
+

library/paper/io.papermc.paper.connection.WritablePlayerCookieConnection.lua

@@ -0,0 +1,41 @@
+--- Optional.empty
+---@meta
+-- io.papermc.paper.event.connection.PlayerConnectionValidateLoginEvent
+---@class io.papermc.paper.event.connection.PlayerConnectionValidateLoginEvent: org.bukkit.event.Event, java.lang.Object
+---@overload fun(connection: io.papermc.paper.connection.PlayerConnection, kickMessage: net.kyori.adventure.text.Component): io.papermc.paper.event.connection.PlayerConnectionValidateLoginEvent
+local PlayerConnectionValidateLoginEvent = {}
+
+---@public
+---@return io.papermc.paper.connection.PlayerConnection connection
+--- Gets the connection of the player in this event. Note, the type of this connection is not guaranteed to be stable across versions. Additionally, disconnecting the player through this connection / using any methods that may send packets is not supported.
+function PlayerConnectionValidateLoginEvent:getConnection() end
+
+---@public
+---@return nil 
+--- Allows the player to log in. This skips any login validation checks.
+function PlayerConnectionValidateLoginEvent:allow() end
+
+---@param message net.kyori.adventure.text.Component Kick message to display to the user
+---@public
+---@return nil 
+--- Disallows the player from logging in, with the given reason
+function PlayerConnectionValidateLoginEvent:kickMessage(message) end
+
+---@public
+---@return net.kyori.adventure.text.Component disallow reason
+--- Gets the reason for why a player is not allowed to join the server. This will be null in the case that the player is allowed to log in.
+function PlayerConnectionValidateLoginEvent:getKickMessage() end
+
+---@public
+---@return boolean if allowed
+--- Gets if the player is allowed to enter the next stage.
+function PlayerConnectionValidateLoginEvent:isAllowed() end
+
+---@public
+---@return org.bukkit.event.HandlerList 
+function PlayerConnectionValidateLoginEvent:getHandlers() end
+
+---@public
+---@return org.bukkit.event.HandlerList 
+function PlayerConnectionValidateLoginEvent:getHandlerList() end
+