TierTags

# TierTags - tier lists for any server.
#
# Testers set a tier per player per ladder (/tier set <player> <ladder> <tier>). The best tier a
# player holds shows above their head and in the tab list, every ladder has a ranked /tierlist,
# PlaceholderAPI can put tiers anywhere, and a JSON file is written for a website.

# Bare /tier and bare /tierlist open the screens instead of printing lines in chat.
menu: true

# Ladders: key -> label shown to players. Any names you like: kits, game modes, skills.
ladders:
  sword: "Sword"
  axe: "Axe"
  mace: "Mace"
  crystal: "Crystal"
  uhc: "UHC"
  pot: "Pot"
  smp: "SMP"

# The item drawn beside each ladder on the screens: any item id. A ladder missing here gets the
# general tier icon. You can also write a ladder as  sword: { label: "Sword", icon: diamond_sword }
ladder-icons:
  sword: diamond_sword
  axe: diamond_axe
  mace: mace
  crystal: end_crystal
  uhc: golden_apple
  pot: splash_potion
  smp: totem_of_undying

# Tiers, lowest to highest. points feed "best tier" and the global score; colours are MiniMessage.
tiers:
  LT5: { color: "<gray>", points: 1 }
  HT5: { color: "<gray>", points: 2 }
  LT4: { color: "<green>", points: 3 }
  HT4: { color: "<green>", points: 4 }
  LT3: { color: "<aqua>", points: 6 }
  HT3: { color: "<aqua>", points: 8 }
  LT2: { color: "<light_purple>", points: 12 }
  HT2: { color: "<light_purple>", points: 16 }
  LT1: { color: "<gold>", points: 24 }
  HT1: { color: "<gold>", points: 32 }

display:
  # Tag above the head and in tab, as a team prefix. {tier} is the coloured tier, {icon} the item of
  # the ladder that tier is from (the sword for a Sword tier).
  enabled: true
  format: "{icon}<dark_gray>[</dark_gray>{tier}<dark_gray>]</dark_gray> "
  # The ladder's item in the tag. Drawn from the player's own game textures (1.21.9+ clients).
  icon: true
  # Which tier the tag shows: best (the highest tier on any ladder), a ladder name, or off.
  view: best
  # Let every player pick a different view for their own screen: /tier view <best|ladder|off|default>.
  # A player who picks one gets their own scoreboard holding only the tier teams, so for them teams
  # from vanilla /team or other plugins on the main scoreboard are not shown. If another plugin has
  # already given that player their own scoreboard, the tier teams go into that one instead.
  per-viewer: true
  # Also colour the name itself like the tier (only works for named colours like <aqua>).
  color-name: false

announce:
  # Tell the whole server when a tier is set.
  enabled: true

list:
  per-page: 10

export:
  enabled: true
  every-minutes: 5
  # Relative to plugins/TierTags/, or an absolute path such as /var/www/site/tiers.json
  file: "tiers.json"

# ------------------------------------------------------------------------------------------------
# THEME
# ------------------------------------------------------------------------------------------------
# Every message below is written against these names, not against hex codes: <accent>Open</accent>
# rather than <#48adf0>Open</#48adf0>. Change a colour here and it changes on every screen at
# once. Ordinary MiniMessage still works, so <gradient:#a:#b> and <#ff0000> are fine anywhere.
theme:
  accent: "#48adf0"     # your colour: headings and anything the player is meant to click
  accent2: "#9ad2f7"    # a lighter accent, for a second level of emphasis
  title: "#f4f7ff"      # screen titles
  text: "#c2ccdd"       # ordinary prose
  muted: "#6b7a94"      # hints, separators, anything the eye should skip
  value: "#ffffff"      # the numbers and names the player opened the screen to read
  good: "#57e08a"
  warn: "#ffc857"
  bad: "#ff6b6b"
  small-caps: false     # ᴇхᴀᴍᴘʟᴇ - a garnish; whole menus in it read badly
  # Real Minecraft item pictures beside the buttons and in the chest screens. Drawn from the
  # client's own textures, so there is nothing to install and no resource pack: it needs a
  # 1.21.9 or newer client, and older ones simply see the buttons as words.
  item-icons: true

messages:
  prefix: "<accent2><bold>Tiers</bold></accent2> <muted>»</muted> "
  none: "<muted>none</muted>"
  help: "<text>/tier [player] · /tier set <player> <ladder> <tier> · /tier remove <player> <ladder> · /tierlist <ladder|overall> [page] · /lb [ladder] · /tier view <best|ladder|off> · /tier ladders</text>"
  no-permission: "<bad>You cannot do that.</bad>"
  usage-set: "<text>/tier set <player> <ladder> <tier></text>"
  usage-remove: "<text>/tier remove <player> <ladder></text>"
  unknown-ladder: "<bad>Ladders: </bad><value>{list}</value>"
  unknown-tier: "<bad>Tiers: </bad><value>{list}</value>"
  unknown-player: "<bad>Unknown player: </bad><value>{name}</value>"
  set: "<value>{player}</value><text> is now </text>{tier}<text> on </text><value>{ladder}</value><text>.</text>"
  you-were-tiered: "<text>You are now </text>{tier}<text> on </text><value>{ladder}</value><text>.</text>"
  announce: "<value>{player}</value><text> was tiered </text>{tier}<text> on </text><value>{ladder}</value><text>.</text>"
  removed: "<text>Removed </text><value>{player}</value><text>'s tier on </text><value>{ladder}</value><text>.</text>"
  nothing-to-remove: "<text>{player} had no tier on {ladder}.</text>"
  view-header: "<value>{player}</value><text>: best </text>{best}<text>, </text><value>{points}</value><text> points</text>"
  view-row: "<text> - </text><value>{ladder}</value><text>: </text>{tier}"
  list-header: "<value>{ladder}</value><text> tier list, page {page}/{pages} ({count} players)</text>"
  list-row: "<muted>#{place}</muted> <value>{player}</value> {tier}"
  list-empty: "<text>Nobody is tiered here yet.</text>"
  # /tierlist overall: everybody ranked by the sum of their tier points across every ladder.
  list-overall-header: "<value>Overall</value><text> ranking, page {page}/{pages} ({count} players)</text>"
  list-overall-row: "<muted>#{place}</muted> <value>{player}</value> <text>{points} points, best</text> {best}"
  # Placeholders: an empty leaderboard slot (%tiertags_top_..%) and a player with no place (%tiertags_rank..%).
  placeholder-empty: "-"
  placeholder-unranked: "-"
  ladders: "<text>Ladders: </text><value>{list}</value>"
  reloaded: "<value>Config reloaded.</value>"
  exported: "<value>Written to </value><text>{file}</text>"

  # The tier screens. Every line here is a screen title, a button label or a tooltip.
  menu-title: "<value>Tiers</value>"
  menu-close: "<white><icon:close></white><text>Close</text>"
  menu-back: "<white><icon:back></white><text>Back</text>"
  menu-back-tip: "<text>Back to the screen before.</text>"
  menu-home-me: "<value>{player}</value><text>: best </text>{best}<text>, {points} points</text>"
  menu-home-untiered: "<text>You hold no tier yet. Ask a tester for a test.</text>"
  menu-ladders: "<white><icon:tier></white><accent2>Tier lists</accent2>"
  menu-ladders-tip: "<text>The ranked list of every ladder.</text>"
  menu-ladders-title: "<value>Tier lists</value>"
  menu-ladders-intro: "<text>Pick a ladder to see who is on top.</text>"
  # {icon} is the ladder's own item from ladder-icons above.
  menu-ladder: "<white>{icon}</white><value>{ladder}</value> <muted>({count})</muted>"
  menu-ladder-tip: "<text>The ranked list for {ladder}.</text>"
  menu-list-title: "<value>{ladder}</value>"
  # The button under the ladders that opens the overall ranking.
  menu-overall: "<white><icon:top></white><accent2>Overall</accent2> <muted>({count})</muted>"
  menu-overall-tip: "<text>Everybody across every ladder, by tier points.</text>"
  menu-overall-title: "<value>Overall ranking</value>"
  # Every place on a list is a button that opens that player's tiers; the search field finds a name.
  list-hint: "<muted>Search a name, or click one to see all their tiers.</muted>"
  # The rows of the list screens. {tiers} is every tier the player holds, each with its ladder's item.
  list-overall-entry: "<muted>#{place}</muted> <value>{player}</value> {tiers}"
  list-entry: "<muted>#{place}</muted> <value>{player}</value> {tier}"
  # /tier view: which tier you see on everyone, in tab and above heads. Only your screen changes.
  menu-tags: "<white><icon:spyglass></white><accent2>Tags I see</accent2>"
  menu-tags-tip: "<text>Pick which tier you see on everyone. Only your screen changes.</text>"
  menu-tags-title: "<value>Tags I see</value>"
  menu-tags-intro: "<text>Pick which tier you see next to every player's name, in tab and above heads. Nobody else's screen changes.</text>"
  menu-tags-current: "<good>✔</good> {mode}"
  menu-tags-pick-tip: "<text>Show this on everyone, for you only.</text>"
  view-mode-best: "<value>Best tier</value>"
  view-mode-off: "<value>No tags</value>"
  view-set: "<text>You now see </text>{mode}<text> on everyone.</text>"
  view-unknown: "<bad>Pick one of: </bad><value>{list}</value>"
  players-only: "<bad>Only players can do that.</bad>"
  list-row-tip: "<text>Every tier {player} holds.</text>"
  menu-field-search: "<text>Search a player</text>"
  menu-search: "<white><icon:search></white><accent2>Search</accent2>"
  menu-search-tip: "<text>Find the name typed above (the start of it is enough).</text>"
  search-none: "<text>Nobody tiered is called </text><value>{name}</value><text>.</text>"
  menu-prev: "<white><icon:back></white><text>« Page back</text>"
  menu-prev-tip: "<text>The page before.</text>"
  menu-next: "<white><icon:next></white><text>Page on »</text>"
  menu-next-tip: "<text>The next page.</text>"
  menu-set: "<white><icon:nick></white><accent2>Set a tier</accent2>"
  menu-set-tip: "<text>Testers only: give or take a tier.</text>"
  menu-set-title: "<value>Set a tier</value>"
  menu-set-intro: "<text>Type the name, pick the ladder and the tier, then set it.</text>"
  menu-set-nothing: "<text>There are no ladders or no tiers in config.yml yet.</text>"
  menu-field-player: "<text>Player</text>"
  menu-field-ladder: "<text>Ladder</text>"
  menu-field-tier: "<text>Tier</text>"
  menu-set-apply: "<white><icon:yes></white><good>Set this tier</good>"
  menu-set-apply-tip: "<text>Give the player the tier above.</text>"
  menu-set-remove: "<white><icon:delete></white><bad>Remove from this ladder</bad>"
  menu-set-remove-tip: "<text>Take away whatever they hold on that ladder.</text>"
  menu-set-view: "<white><icon:yes></white><value>Show their tiers</value>"
  menu-set-view-tip: "<text>Every ladder for the player above.</text>"
  menu-view-title: "<value>{player}</value>"
  menu-export: "<white><icon:save></white><text>Export now</text>"
  menu-export-tip: "<text>Write the JSON file for the website.</text>"
  menu-reload: "<white><icon:reload></white><text>Reload config</text>"
  menu-reload-tip: "<text>Read config.yml again.</text>"

# One thank-you line with the BuiltByBit review link: once in the console after install and once
# in chat for the first operator who joins. It never repeats and sends nothing anywhere. false turns it off.
review-reminder: true