HotbarDialogs

# HotbarDialogs - hotbar items that open native Minecraft dialogs (1.21.6+).
#
# items:  what sits in the hotbar and what a click does.
# menus:  the dialog screens. Buttons use the same actions as items.
#
# Actions:
#   menu:<id>                  open a menu from this file
#   player:/command            run a command as the player ({player} works)
#   console:command {player}   run a command from console
#   message:<green>text</green> send a MiniMessage line
#   sound:entity.experience_orb.pickup:1:1.4   play a sound (name:volume:pitch)
#   server:lobby               send the player to another server of your BungeeCord or Velocity
#                              network. Use this, not player:/server lobby: /server is a proxy
#                              command, and a command run by the plugin never reaches the proxy.
#   close                      close the dialog
# One action goes in "action:", several go in "actions: [a, b, c]" and run in order.
# Text supports MiniMessage, {player}, {world}, {online} and PlaceholderAPI placeholders.
#
# Item pictures: give a button  icon: diamond_sword  and that item is drawn in front of its label.
# Anywhere in text (titles, body lines, labels, tooltips) <icon:diamond_sword> does the same, with
# any item id. They come from the player's own game textures: no resource pack, 1.21.9+ clients.
#
# Forms: a menu can have inputs: (see the "report" menu below). Its buttons then use
# {input:<key>} in their actions for what the player entered. Input types:
#   text     a text field.  max-length, width, initial, required: true, pattern: (a regex the
#            text must match, e.g. "[A-Za-z0-9_]{3,16}" for a player name)
#   choice   a list to pick from.  options: ["value:Shown text", ...], initial: <value>
#   toggle   on or off, gives true or false.  initial: true|false
#   number   a slider.  min, max, step, initial, width
# Keys are lowercase letters, digits and _, and "id" is reserved. Be careful with console:
# actions that use typed text: give text inputs a pattern so nobody can add extra arguments.
# The console checks this file on start and on /hotbardialogs reload and names every mistake.

# Worlds where the hotbar is given. Empty list = every world.
worlds:
  - lobby
  - world

give:
  on-join: true
  on-respawn: true
  on-world-change: true

lock: true                 # menu items cannot be moved, dropped or swapped
select-slot: true          # put the player's hand on selected-slot after giving the items
selected-slot: 0
click-cooldown-ms: 250
open-sound: "ui.button.click:0.6:1"
close-label: "Close"
locked-label: "<gray>{label}</gray>"
locked-tooltip: "<red>You do not have access to this.</red>"

items:
  navigator:
    slot: 0
    material: COMPASS
    name: "<#ff7f50><bold>Navigator</bold></#ff7f50>"
    lore:
      - "<gray>Right-click to pick a game.</gray>"
    action: "menu:games"
  profile:
    slot: 4
    material: PLAYER_HEAD
    name: "<#ff7f50><bold>Profile</bold></#ff7f50>"
    lore:
      - "<gray>Your settings and stats.</gray>"
    action: "menu:profile"
  shop:
    slot: 7
    material: EMERALD
    name: "<#ff7f50><bold>Shop</bold></#ff7f50>"
    lore:
      - "<gray>Ranks and cosmetics.</gray>"
    action: "menu:shop"
  lobby:
    slot: 8
    material: NETHER_STAR
    name: "<#ff7f50><bold>Back to spawn</bold></#ff7f50>"
    lore:
      - "<gray>Teleports you to spawn.</gray>"
    actions:
      - "player:/spawn"
      - "sound:entity.enderman.teleport:0.8:1.2"

menus:
  games:
    title: "<#ff7f50><bold>Play</bold></#ff7f50>"
    body:
      - "<gray>Hey <white>{player}</white>, pick a mode.</gray>"
      - "<gray><white>{online}</white> players online.</gray>"
    columns: 2
    button-width: 150
    buttons:
      - label: "<white>Survival</white>"
        icon: oak_sapling
        tooltip: "<gray>The main SMP world.</gray>"
        action: "console:mv tp {player} survival"
      - label: "<white>FFA</white>"
        icon: iron_sword
        tooltip: "<gray>Free for all, no teams.</gray>"
        action: "server:ffa"
      - label: "<white>Duels</white>"
        icon: diamond_sword
        tooltip: "<gray>1v1 with kits.</gray>"
        action: "server:duels"
      - label: "<white>Creative</white>"
        icon: bricks
        tooltip: "<gray>Plots and building.</gray>"
        permission: "rank.vip"
        show-locked: true
        action: "server:creative"
  profile:
    title: "<#ff7f50><bold>Profile</bold></#ff7f50>"
    body:
      - "<gray>Name: <white>{player}</white></gray>"
      - "<gray>World: <white>{world}</white></gray>"
    columns: 1
    buttons:
      - label: "<white>Settings</white>"
        icon: comparator
        action: "player:/settings"
      - label: "<white>Stats</white>"
        icon: book
        action: "player:/stats"
      - label: "<white>Report a player</white>"
        icon: writable_book
        action: "menu:report"
      - label: "<white>Back</white>"
        icon: arrow
        action: "menu:games"
  # A form: the player fills in the fields, the button uses what they entered.
  report:
    title: "<#ff7f50><bold>Report a player</bold></#ff7f50>"
    body:
      - "<gray>Staff read every report.</gray>"
    columns: 1
    inputs:
      - key: target
        type: text
        label: "<white>Player name</white>"
        max-length: 16
        required: true
        pattern: "[A-Za-z0-9_]{3,16}"
      - key: reason
        type: choice
        label: "<white>Reason</white>"
        options:
          - "cheating:Cheating"
          - "chat:Chat abuse"
          - "griefing:Griefing"
          - "other:Something else"
    # The report goes to players with the "staff" tag (/tag <name> add staff). Swap the console:
    # line for your own report or ticket command if you have one.
    buttons:
      - label: "<white>Send report</white>"
        tooltip: "<gray>Sends the report to online staff.</gray>"
        actions:
          - "console:tellraw @a[tag=staff] {\"text\":\"[Report] {player} reported {input:target} for {input:reason}\",\"color\":\"red\"}"
          - "message:<green>Thanks, your report about {input:target} was sent.</green>"
          - "close"
  shop:
    title: "<#ff7f50><bold>Shop</bold></#ff7f50>"
    body:
      - "<gray>Ranks, cosmetics and more on the website.</gray>"
    columns: 1
    buttons:
      - label: "<white>Open store link in chat</white>"
        actions:
          - "message:<#ff7f50>Store:</#ff7f50> <white><click:open_url:'https://store.example.com'>store.example.com</click></white>"
          - "close"

# ------------------------------------------------------------------------------------------------
# THEME
# ------------------------------------------------------------------------------------------------
# Every message below is written against these names, not against hex codes: <accent>Open</accent>
# rather than <#ff8a5c>Open</#ff8a5c>. 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: "#ff8a5c"     # your colour: headings and anything the player is meant to click
  accent2: "#ffbfa5"    # 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: "<#ff7f50><bold>Menu</bold></#ff7f50> <muted>»</muted> "
  no-permission: "<bad>You cannot do that.</bad>"
  unknown-menu: "<bad>No menu called </bad><value>{menu}</value><bad>.</bad>"
  unknown-player: "<bad>Unknown player: </bad><value>{name}</value>"
  usage-menu: "<text>/menu <id> [player]  ·  menus: </text><value>{menus}</value>"
  admin-help: "<text>/hotbardialogs reload · give [player] · clear [player] · list</text>"
  reloaded: "<value>Reloaded: {items} item(s), {menus} menu(s).</value>"
  gave: "<text>Hotbar given to </text><value>{player}</value><text>.</text>"
  cleared: "<text>Hotbar cleared for </text><value>{player}</value><text>.</text>"
  list: "<text>Items: </text><value>{items}</value><text>  ·  Menus: </text><value>{menus}</value>"
  # After /hotbardialogs reload: what the config check found.
  config-ok: "<good>config.yml checked: no problems.</good>"
  config-problems: "<warn>{count} problem(s) in config.yml.</warn><text> The console lists each one and where it is.</text>"
  # Forms: a required field left empty, or a text that does not match its pattern.
  input-required: "<bad>Fill in </bad><value>{field}</value><bad> first.</bad>"
  input-invalid: "<bad>That is not a valid </bad><value>{field}</value><bad>.</bad>"

# 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