Class ScoreComponent


  • public final class ScoreComponent
    extends BaseComponent
    This component displays the score based on a player score on the scoreboard.
    The name is the name of the player stored on the scoreboard, which may be a "fake" player. It can also be a target selector that must resolve to 1 target, and may target non-player entities.
    With a book, /tellraw, or /title, using the wildcard '*' in the place of a name or target selector will cause all players to see their own score in the specified objective.
    Signs cannot use the '*' wildcard
    These values are filled in by the server-side implementation.
    As of 1.12.2, a bug ( MC-56373 ) prevents full usage within hover events.
    • Constructor Detail

      • ScoreComponent

        public ScoreComponent​(String name,
                              String objective)
        Creates a new score component with the specified name and objective.
        If not specifically set, value will default to an empty string; signifying that the scoreboard value should take precedence. If not null, nor empty, value will override any value found in the scoreboard.
        The value defaults to an empty string.
        Parameters:
        name - the name of the entity, or an entity selector, whose score should be displayed
        objective - the internal name of the objective the entity's score is attached to
      • ScoreComponent

        public ScoreComponent​(ScoreComponent original)
        Creates a score component from the original to clone it.
        Parameters:
        original - the original for the new score component
      • ScoreComponent

        public ScoreComponent​(String name,
                              String objective,
                              String value)
    • Method Detail

      • toPlainText

        protected void toPlainText​(StringBuilder builder)
      • toLegacyText

        protected void toLegacyText​(StringBuilder builder)
      • getName

        public String getName()
        The name of the entity whose score should be displayed.
      • getObjective

        public String getObjective()
        The internal name of the objective the score is attached to.
      • getValue

        public String getValue()
        The optional value to use instead of the one present in the Scoreboard.
      • setName

        public void setName​(String name)
        The name of the entity whose score should be displayed.
      • setObjective

        public void setObjective​(String objective)
        The internal name of the objective the score is attached to.
      • setValue

        public void setValue​(String value)
        The optional value to use instead of the one present in the Scoreboard.