ByteChat

• Added new interactive chat tags system
• Added new global chat mute command

# ------------------------------
# ByteChat - Main Configuration
# ------------------------------
# Global settings for chat rendering and behavior.

settings:
  # Format engine used to parse and render messages.
  # Options:
  #  - MINI_MESSAGE : <gray>, <bold>, <gradient:...>
  #  - LEGACY_AMPERSAND : &a, &b, &l, etc.
  serializer: "MINI_MESSAGE"

chat:
  # Enables ByteChat's chat system.
  # If false, the server's default chat will be used.
  enabled: true

  # Default format used when no permission-based format matches.
  default-format: "default"

  # Allows players to use color and format codes in messages.
  # MINI_MESSAGE → <gradient:...>, <bold>, etc.
  # LEGACY_AMPERSAND → &a, &b, &l, etc.
  text-formatting: true

  mentions:
    # Enables the mention system.
    # When disabled, no mentions will be detected,
    # and messages will be sent without highlight or sound.
    enabled: true

    # Character that triggers a player mention.
    # Must be a visible, non-whitespace ASCII character.
    # Typical options: '@', '!', '#', etc.
    trigger-char: '@'

    # Format applied when a mention is detected.
    # Variables available:
    #   - input_name  : The name typed by the user (raw, case as written)
    #   - player_name : The real, exact in-game player name (with correct casing)
    #
    # NOTE: Mentions are case-insensitive, but the resolved player_name
    #       will always use the player's real capitalization.
    format: '<yellow>@{player_name}</yellow>'

    # Whether players are allowed to mention themselves.
    # If false, "@PlayerName" written by that same player will NOT trigger.
    allow-self-mention: true

    # Whether the mention sound should also play when a player mentions themselves.
    # Only applies if 'allow-self-mention = true'.
    self-mention-sound: true

    sound:
      # Sound played ONLY to the mentioned player.
      # Set key: "" to disable sound.
      #
      # Recommended values:
      #   "entity.player.levelup"
      #   "block.note_block.pling"
      key: "entity.player.levelup"

      # Volume from 0.0 to 1.0+
      volume: 1.0

      # Pitch from 0.5 to 2.0
      pitch: 2.0

  tags:
    # Enables the tag resolution system.
    # When disabled, tags like {item}, {inv}, {armor} will not be processed.
    enabled: true

    # Maximum number of total tags a player can use in a single message.
    # Set to -1 for unlimited.
    max-tags-per-message: 1

    item:
      # Enables the {item} tag to show the item in the player's main hand.
      enabled: true

      # Format displayed when the player's hand is empty.
      empty-hand-text: '[Empty Hand]'

      # Color of the empty hand text.
      # Options: GRAY, RED, YELLOW, etc.
      empty-hand-color: 'GRAY'

    inventory:
      # Enables the {inv} tag to show a clickable inventory preview.
      enabled: true

      # Text displayed for the inventory link.
      display-text: '[Inventory]'

      # Color of the inventory link text.
      display-color: 'AQUA'

      # Title of the inventory preview GUI.
      preview-title: 'Inventory of a{player_name}'

      # Maximum number of times the inventory link can be clicked.
      max-clicks: 10

      # Duration (in seconds) before the inventory link expires.
      # After this time, clicking the link will no longer work.
      expiration-seconds: 70

    armor:
      # Enables the {armor} tag to show a clickable armor/equipment preview.
      enabled: true

      # Text displayed for the armor inventory link.
      display-text: '[Armor Inventory]'

      # Color of the armor inventory link text.
      display-color: 'AQUA'

      # Title of the armor preview GUI.
      preview-title: 'Armor of {player_name}'

      # Maximum number of times the armor link can be clicked.
      max-clicks: 10

      # Duration (in seconds) before the armor link expires.
      expiration-seconds: 3600