Class ScoreboardObjective

ReadonlydisplayName

Readonlyid

ReadonlyisValid

addScore

• addScore(
      participant: string | Entity | ScoreboardIdentity,
      scoreToAdd: number,
  ): number

  Parameters

  • participant: string | Entity | ScoreboardIdentity

    Participant to apply the scoreboard value addition to.
  • scoreToAdd: number

  Returns number

  Remarks

  Adds a score to the given participant and objective.

  This function can't be called in restricted-execution mode.

  Throws

  This function can throw errors.

  World Ready

  This function can't be called in early-execution mode.

  Example: addPlayerMoney.js

  import { world } from "@minecraft/server";
  
  const money = world.scoreboard.getObjective("money");
  const player = world.getPlayers()[0];
  const currentScore = money.addScore(player, 100);
  player.sendMessage(`Your current score is ${currentScore}`);
  Copy

  Example: removeScore.js

  import { world } from "@minecraft/server";
  
  const money = world.scoreboard.getObjective("money");
  const player = world.getPlayers()[0];
  const currentScore = money.addScore(player, -100);
  player.sendMessage(`Your current score is ${currentScore}`);
  Copy

getParticipants

• getParticipants(): ScoreboardIdentity[]

  Returns ScoreboardIdentity[]

  Remarks

  Returns all objective participant identities.

  Throws

  This function can throw errors.

  World Ready

  This function can't be called in early-execution mode.

getScore

• getScore(participant: string | Entity | ScoreboardIdentity): number

  Parameters

  • participant: string | Entity | ScoreboardIdentity

    Identifier of the participant to retrieve a score for.

  Returns number

  Remarks

  Returns a specific score for a participant.

  Throws

  This function can throw errors.

  World Ready

  This function can't be called in early-execution mode.

getScores

• getScores(): ScoreboardScoreInfo[]

  Returns ScoreboardScoreInfo[]

  Remarks

  Returns specific scores for this objective for all participants.

  Throws

  This function can throw errors.

  World Ready

  This function can't be called in early-execution mode.

  Example: topPlayer.ts

  import { world } from "@minecraft/server";
  
  const money = world.scoreboard.getObjective("money");
  var scoreArray = money.getScores();
  scoreArray.sort(function (a, b) {
  return b.score - a.score;
  });
  
  console.log(scoreArray.map((score) => score.participant.displayName));
  Copy

hasParticipant

• hasParticipant(participant: string | Entity | ScoreboardIdentity): boolean

  Parameters

  • participant: string | Entity | ScoreboardIdentity

  Returns boolean

  Remarks

  Returns if the specified identity is a participant of the scoreboard objective.

  Throws

  This function can throw errors.

  World Ready

  This function can't be called in early-execution mode.

removeParticipant

• removeParticipant(participant: string | Entity | ScoreboardIdentity): boolean

  Parameters

  • participant: string | Entity | ScoreboardIdentity

    Participant to remove from being tracked with this objective.

  Returns boolean

  Remarks

  Removes a participant from this scoreboard objective.

  This function can't be called in restricted-execution mode.

  Throws

  This function can throw errors.

  World Ready

  This function can't be called in early-execution mode.

setScore

• setScore(participant: string | Entity | ScoreboardIdentity, score: number): void

  Parameters

  • participant: string | Entity | ScoreboardIdentity

    Identity of the participant.
  • score: number

    New value of the score.

  Returns void

  Remarks

  Sets a score for a participant.

  This function can't be called in restricted-execution mode.

  Throws

  This function can throw errors.

  World Ready

  This function can't be called in early-execution mode.

  Example: resetMoney.js

  import { world } from "@minecraft/server";
  
  const money = world.scoreboard.getObjective("money");
  const player = world.getPlayers()[0];
  money.setScore(player, 0);
  player.sendMessage(`Your score has been reset.`);
  Copy