Package org.bukkit.block

Interface Sign

All Superinterfaces:

BlockState, Colorable, Metadatable, PersistentDataHolder, TileState

All Known Subinterfaces:

HangingSign

public interface Sign
extends TileState, Colorable

Represents a captured state of either a SignPost or a WallSign.

Method Summary

Modifier and Type	Method	Description
@NotNull DyeColor	getColor()	Deprecated. A sign may have multiple writable sides now.
@NotNull String	getLine(int index)	Deprecated. A sign may have multiple writable sides now.
@NotNull String[]	getLines()	Deprecated. A sign may have multiple writable sides now.
@NotNull SignSide	getSide(@NotNull Side side)	Return the side of the sign.
boolean	isEditable()	Deprecated. use isWaxed()
boolean	isGlowingText()	Deprecated. A sign may have multiple writable sides now.
boolean	isWaxed()	Gets whether the sign has been waxed and therefore prevents editing.
Component	line(int index)	Deprecated. A sign may have multiple writable sides now.
void	line(int index, @NotNull Component line)	Deprecated. A sign may have multiple writable sides now.
List<Component>	lines()	Deprecated. A sign may have multiple writable sides now.
void	setColor(@NotNull DyeColor color)	Deprecated. A sign may have multiple writable sides now.
void	setEditable(boolean editable)	Deprecated. use setWaxed(boolean)
void	setGlowingText(boolean glowing)	Deprecated. A sign may have multiple writable sides now.
void	setLine(int index, @NotNull String line)	Deprecated. A sign may have multiple writable sides now.
void	setWaxed(boolean waxed)	Sets whether the sign is waxed.

Methods inherited from interface org.bukkit.block.BlockState

getBlock, getBlockData, getChunk, getData, getDrops, getDrops, getDrops, getLightLevel, getLocation, getLocation, getRawData, getType, getWorld, getX, getY, getZ, isCollidable, isPlaced, setBlockData, setData, setRawData, setType, update, update, update

Methods inherited from interface org.bukkit.metadata.Metadatable

getMetadata, hasMetadata, removeMetadata, setMetadata

Methods inherited from interface org.bukkit.block.TileState

getPersistentDataContainer, isSnapshot

Method Details

lines

@NotNull
List<Component> lines()

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.lines().

Gets all the lines of text currently on the Side.FRONT of this sign.

Returns:

List of components containing each line of text

line

@NotNull
@Deprecated
Component line(int index)
        throws IndexOutOfBoundsException

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.line(int).

Gets the line of text at the specified index on the Side.FRONT.

For example, getLine(0) will return the first line of text.

Parameters:

index - Line number to get the text from, starting at 0

Returns:

Text on the given line

Throws:

IndexOutOfBoundsException - Thrown when the line does not exist

line

@Deprecated
void line(int index,
 @NotNull Component line)
   throws IndexOutOfBoundsException

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.line(int, net.kyori.adventure.text.Component).

Sets the line of text at the specified index on the Side.FRONT.

For example, setLine(0, "Line One") will set the first line of text to "Line One".

Parameters:

index - Line number to set the text at, starting from 0

line - New text to set at the specified index

Throws:

IndexOutOfBoundsException - If the index is out of the range 0..3

getLines

@Deprecated
@NotNull
@NotNull String[] getLines()

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.lines().

Gets all the lines of text currently on the Side.FRONT of this sign.

Returns:

Array of Strings containing each line of text

getLine

@Deprecated
@NotNull
@NotNull String getLine(int index)
                 throws IndexOutOfBoundsException

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.line(int).

Gets the line of text at the specified index.

For example, getLine(0) will return the first line of text on the Side.FRONT.

Parameters:

index - Line number to get the text from, starting at 0

Returns:

Text on the given line

Throws:

IndexOutOfBoundsException - Thrown when the line does not exist

setLine

@Deprecated
void setLine(int index,
 @NotNull
 @NotNull String line)
      throws IndexOutOfBoundsException

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.line(int, net.kyori.adventure.text.Component).

Sets the line of text at the specified index.

For example, setLine(0, "Line One") will set the first line of text to "Line One".

Parameters:

index - Line number to set the text at, starting from 0

line - New text to set at the specified index

Throws:

IndexOutOfBoundsException - If the index is out of the range 0..3

isEditable

@Deprecated
boolean isEditable()

Deprecated.

use isWaxed()

Marks whether this sign can be edited by players.
This is a special value, which is not persisted. It should only be set if a placed sign is manipulated during the BlockPlaceEvent. Behaviour outside of this event is undefined.

Returns:

if this sign is currently editable

setEditable

@Deprecated
void setEditable(boolean editable)

Deprecated.

use setWaxed(boolean)

Marks whether this sign can be edited by players.
This is a special value, which is not persisted. It should only be set if a placed sign is manipulated during the BlockPlaceEvent. Behaviour outside of this event is undefined.

Parameters:

editable - if this sign is currently editable

isWaxed

boolean isWaxed()

Gets whether the sign has been waxed and therefore prevents editing.

Returns:

true if waxed

setWaxed

void setWaxed(boolean waxed)

Sets whether the sign is waxed.

Parameters:

waxed - true to wax and therefore prevent editing

isGlowingText

@Deprecated
boolean isGlowingText()

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.isGlowingText().

Gets whether this sign has glowing text. Only affects the Side.FRONT.

Returns:

if this sign has glowing text

setGlowingText

@Deprecated
void setGlowingText(boolean glowing)

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and SignSide.setGlowingText(boolean).

Sets whether this sign has glowing text. Only affects the Side.FRONT.

Parameters:

glowing - if this sign has glowing text

getColor

@NotNull
@Deprecated
@NotNull DyeColor getColor()

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and Colorable.getColor().

Gets the color of this object.
This may be null to represent the default color of an object, if the object has a special default color (e.g Shulkers).

Specified by:

getColor in interface Colorable

Returns:

The DyeColor of this object.

setColor

@Deprecated
void setColor(@NotNull
 @NotNull DyeColor color)

Deprecated.

A sign may have multiple writable sides now. Use getSide(Side) and Colorable.setColor(org.bukkit.DyeColor).

Sets the color of this object to the specified DyeColor.
This may be null to represent the default color of an object, if the object has a special default color (e.g Shulkers).

Specified by:

setColor in interface Colorable

Parameters:

color - The color of the object, as a DyeColor.

getSide

@NotNull
@NotNull SignSide getSide(@NotNull
 @NotNull Side side)

Return the side of the sign.

Parameters:

side - the side of the sign

Returns:

the selected side of the sign