Improve sendSignChange and related documentation

By: md_5 <git@md-5.net>
This commit is contained in:
Bukkit/Spigot
2023-06-14 18:36:11 +10:00
parent 738ff02e72
commit 54d5defe73

View File

@@ -638,10 +638,13 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
* a certain location. This will not actually change the world in any way. * a certain location. This will not actually change the world in any way.
* This method will use a sign at the location's block or a faked sign * This method will use a sign at the location's block or a faked sign
* sent via * sent via
* {@link #sendBlockChange(org.bukkit.Location, org.bukkit.Material, byte)}. * {@link #sendBlockChange(org.bukkit.Location, org.bukkit.block.data.BlockData)}.
* <p> * <p>
* If the client does not have a sign at the given location it will * If the client does not have a sign at the given location it will
* display an error message to the user. * display an error message to the user.
* <p>
* To change all attributes of a sign, including the back Side, use
* {@link #sendBlockUpdate(org.bukkit.Location, org.bukkit.block.TileState)}.
* *
* @param loc the location of the sign * @param loc the location of the sign
* @param lines the new text on the sign or null to clear it * @param lines the new text on the sign or null to clear it
@@ -655,10 +658,13 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
* a certain location. This will not actually change the world in any way. * a certain location. This will not actually change the world in any way.
* This method will use a sign at the location's block or a faked sign * This method will use a sign at the location's block or a faked sign
* sent via * sent via
* {@link #sendBlockChange(org.bukkit.Location, org.bukkit.Material, byte)}. * {@link #sendBlockChange(org.bukkit.Location, org.bukkit.block.data.BlockData)}.
* <p> * <p>
* If the client does not have a sign at the given location it will * If the client does not have a sign at the given location it will
* display an error message to the user. * display an error message to the user.
* <p>
* To change all attributes of a sign, including the back Side, use
* {@link #sendBlockUpdate(org.bukkit.Location, org.bukkit.block.TileState)}.
* *
* @param loc the location of the sign * @param loc the location of the sign
* @param lines the new text on the sign or null to clear it * @param lines the new text on the sign or null to clear it
@@ -674,10 +680,13 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
* a certain location. This will not actually change the world in any way. * a certain location. This will not actually change the world in any way.
* This method will use a sign at the location's block or a faked sign * This method will use a sign at the location's block or a faked sign
* sent via * sent via
* {@link #sendBlockChange(org.bukkit.Location, org.bukkit.Material, byte)}. * {@link #sendBlockChange(org.bukkit.Location, org.bukkit.block.data.BlockData)}.
* <p> * <p>
* If the client does not have a sign at the given location it will * If the client does not have a sign at the given location it will
* display an error message to the user. * display an error message to the user.
* <p>
* To change all attributes of a sign, including the back Side, use
* {@link #sendBlockUpdate(org.bukkit.Location, org.bukkit.block.TileState)}.
* *
* @param loc the location of the sign * @param loc the location of the sign
* @param lines the new text on the sign or null to clear it * @param lines the new text on the sign or null to clear it
@@ -694,7 +703,7 @@ public interface Player extends HumanEntity, Conversable, OfflinePlayer, PluginM
* the given location. This will not actually change the world in any way. * the given location. This will not actually change the world in any way.
* This method will use a TileState at the location's block or a faked TileState * This method will use a TileState at the location's block or a faked TileState
* sent via * sent via
* {@link #sendBlockChange(org.bukkit.Location, org.bukkit.Material, byte)}. * {@link #sendBlockChange(org.bukkit.Location, org.bukkit.block.data.BlockData)}.
* <p> * <p>
* If the client does not have an appropriate tile at the given location it * If the client does not have an appropriate tile at the given location it
* may display an error message to the user. * may display an error message to the user.