Commits
Patrick Seidel authored and Travis Watkins committed 609f137230a
298 298 | * certain location. This will not actually change the world in any way. |
299 299 | * |
300 300 | * @param loc The location of the changed block |
301 301 | * @param material The new block ID |
302 302 | * @param data The block data |
303 303 | * @deprecated Magic value |
304 304 | */ |
305 305 | |
306 306 | public void sendBlockChange(Location loc, int material, byte data); |
307 307 | |
308 + | /** |
309 + | * Send a sign change. This fakes a sign change packet for a user at |
310 + | * a certain location. This will not actually change the world in any way. |
311 + | * This method will use a sign at the location's block or a faked sign |
312 + | * sent via {@link #sendBlockChange(org.bukkit.Location, int, byte)} or |
313 + | * {@link #sendBlockChange(org.bukkit.Location, org.bukkit.Material, byte)}. |
314 + | * <p> |
315 + | * If the client does not have a sign at the given location it will |
316 + | * display an error message to the user. |
317 + | * |
318 + | * @param loc the location of the sign |
319 + | * @param lines the new text on the sign or null to clear it |
320 + | * @throws IllegalArgumentException if location is null |
321 + | * @throws IllegalArgumentException if lines is non-null and has a length less than 4 |
322 + | */ |
323 + | public void sendSignChange(Location loc, String[] lines) throws IllegalArgumentException; |
324 + | |
308 325 | /** |
309 326 | * Render a map and send it to the player in its entirety. This may be |
310 327 | * used when streaming the map in the normal manner is not desirable. |
311 328 | * |
312 329 | * @param map The map to be sent |
313 330 | */ |
314 331 | public void sendMap(MapView map); |
315 332 | |
316 333 | /** |
317 334 | * Forces an update of the player's entire inventory. |