Skip to main content

Language Configuration

Creating custom scoreboards​

You can create custom scoreboards per Arena Groups. So, let's suppose you have an arena group called 4v4v4v4, then you can create a custom scoreboard for the arenas using this arena group. You can edit the scoreboard for each arena state (waiting, starting, playing). So let's suppose you want to have a custom playing scoreboard. Just go in the language file, under the scoreboard section and add yur arena group name and under it, the arena status name:

scoreboard:
  4v4v4v4:
    playing:
    - "&f&lBED WARS"
    - "&7{date}"
    - ""
    - "{TeamRedColor}&lB&f {TeamRedName}&f: {TeamRedStatus}"
    - "{TeamBlueColor}&lB&f {TeamBlueName}&f: {TeamBlueStatus}"
    - "{TeamGreenColor}&lG&f {TeamGreenName}&f: {TeamGreenStatus}"
    - "{TeamYellowColor}&lY &f{TeamYellowName}&f: {TeamYellowStatus}"
    - ""
    - "&6{server_ip}"

Player list configuration​

It is possible to add multiple lines to the header and footer of the player list by adding more lines as shown below. Make sure to add |- on the first row.

format-sb-tab-header:
  lobby: |-
    just put anything.
    &bplaying on: &a{serverIp}
    it
    can
    go
    quite
    far 
    down
    And you dont need to use quotes like this: ""

scoreboard_example_multiline.png All placeholders that are listed under Global Placeholders are supported.

Scoreboard placeholders​

Team placeholders:​

Using team placeholders is easy. Let's suppose that you have a team called Red, then your team's placeholders are:

  • {TeamRedColor} - shows the team color.
  • {TeamRedName} - shows the team name.
  • {TeamRedLetter} - shows the first letter of the team name.
  • {TeamRedStatus} - shows the team status (Alive, Bed Destroyed, Eliminated).

An easier alternative is using {team} placeholder which will take the team format from the message at path: format-sb-team-generic (by default {TeamColor}{TeamLetter}&f {TeamName}: {TeamStatus}). This placeholder can be used in multiple lines and it will iterate the team list of the arena and will asign it a team. When the placeholder is used more than team list size the scoreboard line with {team} in it will be skipped.

Upgrade placeholders:​

Upgrades are divided in tiers each upgrade will have a corresponding line containing the cost and currency and the tier color, this makes the tier show up as purchased or not. All variables mentioned below are gathered from upgrades2.yml.

  • {tier_x_color} - changes the color based on purchased or not.
  • {tier_x_cost} - shows the cost of the upgrade.
  • {tier_x_currency} - shows the currency used to buy the upgrade.

When adding a tier to upgrades2.yml you should add another line in each of the language files used. and replace the x with the corresponding tier number.

Global placeholders:​
  • {date} - shows the date with the player's date format taken from his language file.
  • {level} - shows the player level.
  • {levelUnformatted} - shows the plain player level without formatting.
  • {currentXp} - shows the player's current xp (formatted).
  • {requiredXp} - shows the required xp to rankup (formatted).
  • {progress} - shows the progress bar.
  • {losses} - shows the player's total losses.
  • {kills} - shows the player's total kills (regular).
  • {finalKills} - show player's total final kills.
  • {deaths} - shows the player's total deaths.
  • {finalDeaths} - show player's total final deaths.
  • {beds} - show total beds destroyed by player (when not used in game).
  • {bedsDestroyed} - show total beds destroyed by player (alias for {beds}).
  • {wins} - show the number of games won by player.
  • {gamesPlayed} - show total games played by player.
  • {player} - shows the player display name.
  • {playerName} - shows the player custom name (if set).
  • {money} - shows the player's money (Vault).
  • {on} - show the total number of players online on the server.
  • {serverIp} - shows the server IP taken from config.yml.
  • {server} - shows the server ID taken from config.yml.
  • {version} - shows the plugin version.
  • {poweredBy} - shows the "powered by" text from config.yml.
  • {prefix} - shows the plugin prefix.
In Game placeholders:​
  • {deaths} - shows the player's deaths in current game.
  • {kills} - shows the player's kills in current game.
  • {finalKills} - show player's final kills in current game.
  • {beds} - show beds destroyed by player in current game.
  • {on} - show the number of players in current game.
  • {max} - shows the maximum slots of the current arena.
  • {map} - shows the display name of the current arena.
  • {map_name} - shows the technical name (folder name) of the current arena.
  • {group} - shows the arena group name.
  • {time} - shows the time remaining before the arena starts, or the next event timer during gameplay.
  • {nextEvent} - shows the name of the next game event (e.g., Bed Destruction, Sudden Death).
  • {spectatorTarget} - shows information about the player being spectated (for spectators).
  • {teamStatus} - shows the status of the player's own team (Alive, Bed Destroyed, Eliminated).
  • {winnerTeamName} - shows the name of the winning team at game end.
  • {winnerTeamLetter} - shows the first letter of the winning team name.
  • {winnerTeamColor} - shows the color of the winning team.
  • {team} - generic team placeholder for scoreboards.
  • {teamColor} - shows the player team color on the teleporter.
Kill/Bed-Destroy Message placeholders:​
  • {PlayerColor} - shows the player's team color.
  • {PlayerName} - shows the name of the player .
  • {PlayerNameUnformatted} - shows the name of the player without formatting.
  • {KillerColor} - shows the color of the killer's team.
  • {PlayerTeamName} - shows the name of the player's team.
  • {KillerName} - shows the name of the killer.
  • {KillerNameUnformatted} - shows the name of the killer without formatting.
  • {KillerTeamName} - shows the name of the killer's team.

Animations and timers​

For more configuration options check the config.yml wiki.

Custom title/ sub-title for arena countdown​

You can add a custom title for certain second by adding this to the language file arena-start-countdown-title-[second] where [second] can be 4 etc. For adding a custom subTitle use this path: arena-start-countdown-subtitle-[second]. Available placeholder: {second}.

Countdown titles and subtitles are shown when the current second is currentSecond % 10 == 0 || currentSecond <= 5.