Alias

# Alias - nicknames that hold up.
#
# /nick <name> changes the name in chat, in the tab list and above the head, and brings the matching
# skin with it. Everything here is MiniMessage: <red>, <bold>, <#ff9900>, <gradient:#a:#b>.

format: "{nick}"                 # how a nicked name is shown. {nick} and {real} both work.
tab-list: true                   # also change the tab list name
above-head: true                 # also change the name above the head
rename-in-chat: true             # rewrite the chat line so the nickname is what people see
skins: true                      # allow skins to change with the nickname
skin-follows-nick: true          # /nick Notch also puts Notch's skin on (needs alias.skin)
tell-staff: true                 # staff with alias.see are told who nicked as what
hide-real-name-in-join-message: true
nicklist-online-only: true

menu: true                       # bare /nick opens the nickname screen instead of printing help

min-length: 3
max-length: 16
pattern: "[A-Za-z0-9_]+"         # what a nickname may contain, before colours
blacklist: [admin, owner, staff, mod, notch, herobrine, console, server]
block-real-names: true           # nobody may take a name that belongs to a real account

# Seconds a player waits between changing their own nickname or skin, so nobody spams name changes
# (each skin change is a lookup at Mojang). 0 = no wait. Taking the nickname off is always allowed,
# staff changing somebody else never wait, and alias.cooldown.bypass skips it.
cooldown-seconds: 0

auto-nick:
  enabled: false                 # players with alias.autonick get a random nickname on join

random-names:
  - Ashen
  - Brimstone
  - Cinder
  - Dusk
  - Ember
  - Flint
  - Frost
  - Gale
  - Hollow
  - Kite
  - Lumen
  - Mirage
  - Nomad
  - Onyx
  - Pike
  - Quartz
  - Rift
  - Sable
  - Talon
  - Vesper

# ------------------------------------------------------------------------------------------------
# THEME
# ------------------------------------------------------------------------------------------------
# Every message below is written against these names, not against hex codes: <accent>Open</accent>
# rather than <#a98bf5>Open</#a98bf5>. 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: "#a98bf5"     # your colour: headings and anything the player is meant to click
  accent2: "#d0bffa"    # 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: "<#7f5af0><bold>Alias</bold></#7f5af0> <muted>»</muted> "
  no-permission: "<bad>You cannot do that.</bad>"
  players-only: "<text>Players only.</text>"
  unknown-player: "<bad>Unknown player: </bad><value>{name}</value>"
  reloaded: "<value>Config reloaded.</value>"
  admin-help: "<text>/alias reload</text>"
  # "yes" and "no" stay in quotes: YAML reads a bare yes or no as true or false.
  "yes": "yes"
  "no": "no"
  online: "<good>online</good>"
  offline: "<text>offline</text>"

  nick-help: "<text>/nick <name> · /nick off · /nick random · /nick <player> <name></text>"
  nicked: "<text>You are now </text>{nick}<text>.</text>"
  nicked-other: "<value>{player}</value><text> is now </text><value>{nick}</value><text>.</text>"
  unnicked: "<text>Nickname of </text><value>{player}</value><text> removed.</text>"
  auto-nicked: "<text>You joined as </text><value>{nick}</value><text>.</text>"
  staff-notice: "<muted>{player} is nicked as {nick}</muted>"
  no-random: "<text>No random names are configured.</text>"
  bad-length: "<bad>Nicknames are {min} to {max} characters.</bad>"
  bad-characters: "<bad>Letters, numbers and underscores only.</bad>"
  blacklisted: "<bad>That nickname is not allowed.</bad>"
  no-colour: "<bad>You cannot use colours in your nickname.</bad>"
  taken: "<bad>{nick} is taken.</bad>"
  cooldown: "<text>You can change your name again in </text><value>{seconds}s</value><text>.</text>"

  skin-help: "<text>/skin <player> · /skin reset</text>"
  skin-set: "<text>Skin of </text><value>{name}</value><text> applied.</text>"
  skin-reset: "<text>Your own skin is back.</text>"
  skin-unknown: "<bad>No skin found for </bad><value>{name}</value>"

  realname-help: "<text>/realname <nick></text>"
  realname: "<value>{nick}</value><text> is really </text><value>{player}</value>"
  realname-none: "<text>Nobody is nicked as </text><value>{nick}</value>"
  nicklist: "<text>Nicknames:</text><newline>{list}"
  nicklist-row: "<text> - </text><value>{nick}</value><text> = </text><value>{player}</value><text> ({state})</text>"
  nicklist-empty: "<text>Nobody is nicked.</text>"

  # The /nick screen. Every line here is a button label, a tooltip or a line of text on the screen.
  menu-title: "<value>Nickname</value>"
  menu-who-title: "<value>Who is who</value>"
  menu-current: "<text>You are wearing </text>{nick}<text>.</text>"
  menu-none: "<text>You are playing as </text><value>{player}</value><text>, your own name.</text>"
  menu-rules: "<muted>{min} to {max} characters, letters, numbers and underscores.</muted>"
  menu-field-name: "<text>Nickname</text>"
  menu-field-skin: "<text>Skin from player</text>"
  menu-apply: "<white><icon:yes></white><good>Use this name</good>"
  menu-apply-tip: "<text>Take the name from the field above.</text>"
  menu-random: "<white><icon:rtp></white><value>Surprise me</value>"
  menu-random-tip: "<text>Pick a random name from the list in the config.</text>"
  menu-remove: "<white><icon:delete></white><bad>Back to my own name</bad>"
  menu-remove-tip: "<text>Drop the nickname and the skin with it.</text>"
  menu-skin: "<white><icon:skin></white><value>Wear this skin</value>"
  menu-skin-tip: "<text>Take the skin from the field above.</text>"
  menu-skin-reset: "<white><icon:skin></white><value>My own skin</value>"
  menu-skin-reset-tip: "<text>Put your real skin back on.</text>"
  menu-who: "<white><icon:players></white><#7f5af0>Who is who</#7f5af0>"
  menu-who-tip: "<text>Staff only: every nickname in use.</text>"
  menu-unnick: "<white><icon:delete></white><bad>Unnick {player}</bad>"
  menu-unnick-tip: "<text>Take the nickname off {player}.</text>"
  menu-back: "<white><icon:back></white><text>Back</text>"
  menu-back-tip: "<text>Back to the nickname screen.</text>"
  menu-close: "<white><icon:close></white><text>Close</text>"
  menu-empty: "<text>Type something in the field first.</text>"

  join-message: "<warn>{nick} joined the game</warn>"
  quit-message: "<warn>{nick} left the game</warn>"

# 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