ArenaBots

# ArenaBots - a training bot that fights back.
#
# One bot per player, spawned where they stand. Everything the bot does is tuned here; the code
# never mentions a difficulty by name, so add your own or retune the four shipped ones freely.
# Text uses MiniMessage (<red>, <bold>, <gradient:#hex:#hex>, ...).

# Bare /bot opens the menu instead of printing the help.
menu: true

# Which difficulty /bot spawn uses when none is given.
default-difficulty: medium

# Worlds the bot may be spawned in. Empty means anywhere.
allowed-worlds: []

# Copy the player's armour and held item onto the bot when it spawns (/bot gear does it later too).
copy-gear-on-spawn: true

# Whether other players may hit somebody's bot. Off keeps a training session private.
anyone-can-hit: false

# Show the difficulty name above the bot's head.
show-name: true

# Ticks after a knockout before the bot stands back up.
respawn-ticks: 40

# Hits within this many milliseconds of each other count as one combo.
combo-window-millis: 1500

# If the bot ends up further than this from its owner it is teleported back beside them.
leash-distance: 30

# All-time records per player (best combo and knockouts), kept in plugins/ArenaBots/stats.yml and
# shown by /bot top, the menu and the PlaceholderAPI placeholders. false stops recording; the file is kept.
records: true

# How many places /bot top and the leaderboard screen show.
top-size: 10

# The line above the hotbar while a bot is out.
actionbar: "{bot} {hearts} <gray>combo</gray> <white>{combo}</white> <dark_gray>·</dark_gray> <gray>best</gray> <white>{best}</white> <dark_gray>·</dark_gray> <gray>KO</gray> <white>{ko}</white>"

# Difficulties. Speeds are blocks per tick (a walking player is ~0.22, sprinting ~0.28).
#   speed                  how fast it closes distance
#   strafe                 0..1, how much of its movement is sideways
#   keep-distance          the gap it tries to hold from you
#   attack-interval-ticks  ticks between swings (20 = once a second)
#   accuracy               chance a swing in range connects
#   damage-factor          multiplier on its weapon's damage
#   reach                  how close it must be to swing
#   jump-chance            per-tick chance of a hop while approaching
#   recover-ticks          how long it drifts with your knockback before steering again (low = resets your combo)
#   reaction-ticks         how long after you come into range before its first swing
difficulties:
  easy:
    label: "Easy"
    color: "<green>"
    speed: 0.14
    strafe: 0.1
    keep-distance: 2.4
    attack-interval-ticks: 26
    accuracy: 0.55
    damage-factor: 0.75
    reach: 3.0
    jump-chance: 0.0
    recover-ticks: 16
    reaction-ticks: 16
  medium:
    label: "Medium"
    color: "<yellow>"
    speed: 0.18
    strafe: 0.4
    keep-distance: 2.1
    attack-interval-ticks: 18
    accuracy: 0.75
    damage-factor: 0.9
    reach: 3.0
    jump-chance: 0.015
    recover-ticks: 11
    reaction-ticks: 9
  hard:
    label: "Hard"
    color: "<gold>"
    speed: 0.2158
    strafe: 0.7
    keep-distance: 1.9
    attack-interval-ticks: 13
    accuracy: 0.9
    damage-factor: 1.0
    reach: 3.05
    jump-chance: 0.03
    recover-ticks: 7
    reaction-ticks: 5
  insane:
    label: "Insane"
    color: "<red>"
    speed: 0.2158
    strafe: 0.9
    keep-distance: 1.8
    attack-interval-ticks: 10
    accuracy: 1.0
    damage-factor: 1.0
    reach: 3.2
    jump-chance: 0.05
    recover-ticks: 4
    reaction-ticks: 3

# ------------------------------------------------------------------------------------------------
# THEME
# ------------------------------------------------------------------------------------------------
# Every message below is written against these names, not against hex codes: <accent>Open</accent>
# rather than <#f2b616>Open</#f2b616>. 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: "#f2b616"     # your colour: headings and anything the player is meant to click
  accent2: "#f8d77f"    # 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: "<warn><bold>Bots</bold></warn> <muted>»</muted> "
  help: "<text>/bot spawn [difficulty] [skin] <muted>·</muted> /bot remove <muted>·</muted> /bot difficulty <name> <muted>·</muted> /bot skin <player> <muted>·</muted> /bot gear [clear] <muted>·</muted> /bot tp <muted>·</muted> /bot stats <muted>·</muted> /bot top</text>"
  no-permission: "<bad>You cannot do that.</bad>"
  spawned: "<value>Bot up: </value><warn>{difficulty}</warn><value>. Hit it. </value><text>/bot remove when you are done.</text>"
  spawn-failed: "<bad>The bot could not be spawned here. </bad><text>The server console has the details.</text>"
  no-bot: "<text>You have no bot out. </text><value>/bot spawn</value>"
  difficulty-set: "<value>Difficulty: </value><warn>{difficulty}</warn>"
  unknown-difficulty: "<bad>Pick one of: </bad><value>{list}</value>"
  usage-skin: "<text>/bot skin <player></text>"
  skin-set: "<value>Skin: </value><warn>{name}</warn>"
  skin-unknown: "<bad>No skin found for </bad><value>{name}</value><bad>.</bad>"
  gear-copied: "<value>The bot is wearing what you are wearing.</value>"
  gear-cleared: "<value>The bot is unarmed.</value>"
  brought: "<value>Here it is.</value>"
  knockout: "<warn><bold>Knockout!</bold></warn> <text>That is </text><value>{count}</value><text>. It gets back up in a moment.</text>"
  summary: "<value>Session: best combo </value><warn>{best}</warn><value>, knockouts </value><warn>{ko}</warn><value>.</value>"
  left-behind: "<text>Your bot stayed in the other world.</text>"
  wrong-world: "<bad>Bots are not allowed in this world.</bad>"
  reloaded: "<value>Config reloaded.</value>"
  removed-all: "<value>Removed </value><warn>{count}</warn><value> bot(s).</value>"
  list-header: "<value>Bots out: </value><warn>{count}</warn>"
  list-row: "<text> - </text><value>{owner}</value><text> · {difficulty}</text>"

  # All-time records and the leaderboard.
  record-beaten: "<good><bold>New personal best!</bold></good> <text>A </text><value>{combo}</value><text> hit combo, and counting.</text>"
  summary-record: "<text>All-time: best combo </text><value>{best}</value><text>, knockouts </text><value>{ko}</value><text>.</text>"
  top-header: "<value>Best combos of all time</value>"
  top-row: "<muted>#{place}</muted> <value>{player}</value> <text>combo</text> <warn>{combo}</warn> <muted>·</muted> <text>{ko} KO</text>"
  top-row-you: "<muted>#{place}</muted> <good>{player}</good> <text>combo</text> <warn>{combo}</warn> <muted>·</muted> <text>{ko} KO</text>"
  top-your-place: "<text>You are </text><value>#{place}</value><text> with a best combo of </text><warn>{combo}</warn><text>.</text>"
  top-empty: "<text>No records yet. Spawn a bot and land a combo.</text>"
  usage-resetstats: "<text>/bot resetstats <player></text>"
  stats-reset: "<value>Records of </value><warn>{player}</warn><value> removed.</value>"
  stats-unknown: "<bad>No records for </bad><value>{player}</value><bad>.</bad>"
  # What %arenabots_has_bot% prints. "yes" and "no" stay in quotes: YAML reads them bare as true or false.
  "yes": "yes"
  "no": "no"

  # The /bot screen. Every line here is a screen title, a button label or a tooltip.
  menu-title: "<value>Training bot</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 first screen.</text>"
  menu-no-bot: "<text>No bot out. Spawn one and start hitting it.</text>"
  menu-bot: "<text>Bot out on </text><warn>{difficulty}</warn><text>. Best combo {combo}, knockouts {knockouts}.</text>"
  menu-wrong-world: "<bad>Bots are not allowed in this world.</bad>"
  menu-spawn: "<white><icon:arena></white><good>Spawn the bot</good>"
  menu-respawn: "<good>Spawn it again</good>"
  menu-spawn-tip: "<text>Puts a fresh bot where you stand.</text>"
  menu-remove: "<white><icon:delete></white><bad>Put it away</bad>"
  menu-remove-tip: "<text>Remove the bot and show your session.</text>"
  menu-difficulty: "<white><icon:redstone></white><value>Difficulty: </value><warn>{difficulty}</warn>"
  menu-difficulty-tip: "<text>How fast, how far and how often it hits.</text>"
  menu-difficulty-title: "<value>Difficulty</value>"
  menu-difficulty-intro: "<text>Pick how hard it fights. It changes straight away.</text>"
  menu-difficulty-pick: "<text>{difficulty}</text>"
  menu-difficulty-current: "<good>■</good> {difficulty}"
  menu-difficulty-line: "<text>Speed {speed} · reach {reach} · hits {accuracy}%</text>"
  menu-gear: "<white><icon:kit></white><value>Copy my gear</value>"
  menu-gear-tip: "<text>The bot wears what you are wearing.</text>"
  menu-gear-clear: "<white><icon:delete></white><value>Strip its gear</value>"
  menu-gear-clear-tip: "<text>Fight it unarmed and unarmoured.</text>"
  menu-bring: "<white><icon:link></white><value>Bring it here</value>"
  menu-bring-tip: "<text>Teleport the bot to you.</text>"
  menu-field-skin: "<text>Skin from player</text>"
  menu-skin: "<white><icon:skin></white><value>Wear this skin</value>"
  menu-skin-tip: "<text>Put another player's skin on the bot.</text>"
  menu-stats: "<white><icon:stats></white><value>My session</value>"
  menu-stats-tip: "<text>Best combo and knockouts so far.</text>"
  menu-record: "<text>Your all-time best: combo </text><warn>{best}</warn><text>, knockouts </text><warn>{ko}</warn><text>.</text>"
  menu-top: "<white><icon:top></white><value>Leaderboard</value>"
  menu-top-tip: "<text>The best combos anyone has landed on a bot.</text>"
  menu-top-title: "<value>Leaderboard</value>"

# 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