RexChat

# RexChat Configuration


# Update checker
update-checker:
  enabled: true
  notify-ops-on-join: false
  permission: "rexchat.admin"
  message: "%rc_prefix%&fA new version of &cRexChat &fis available: &c{latest}&7 (current: &f{current}&7). &fDownload: &chttps://www.spigotmc.org/resources/rexchat.122562/"

# Message Settings
messages:
  prefix: "&7[&6RexChat&7] "
  no-permission: "%rc_prefix%&fYou don't have permission to use this command."
  reload-success: "%rc_prefix%&fReloaded successfully!"
  command-not-found: "%rc_prefix%&fCommand not found."
  reload-usage: "%rc_prefix%&fUsage: /%cmd% reload"
  player-only: "%rc_prefix%&fThis command can only be used by players!"
  mention:
    sender: "%rc_prefix%&aYou mentioned &6{targets}"
    target: "%rc_prefix%&eYou were mentioned by &6{sender}"
#     Prevent self-mention triggers (sounds/titles/notifications) while keeping highlight
    prevent-self: true

# Join/Leave Messages (leave blank to disable)
join-leave:
  join-message: ""
  leave-message: ""

# Chat reporting (1.19+). When enabled, RexChat converts player chat into
# system messages to avoid signed chat reporting and validation issues.
chat-reporting:
  disable: true

# Tags System
tags:
  enabled: true
  default: ""
  list:
    free:
      order: 1
      tag: "&7[&aFree&7]"
      description: "This tag is awarded to free players"
      permission: ""
    vip:
      order: 1
      tag: "&7[&eVIP&7]"
      description: "This tag is awarded by getting VIP"
      permission: "group.vip"
    legend:
      order: 2
      tag: "&6[Legend]"
      description: "Exclusive legendary tag"
      permission: "rexchat.tag.legend"
  gui:
    enabled: true
    title: "&6Select Tag"
    rows: 3
    item:
      name: "&e{id} &7=> {tag}"
      lore:
        - "&7{desc}"
        - "&7Status: {status}"
      material:
        available: "NAME_TAG"
        selected: "NAME_TAG"
        locked: "BARRIER"
    status:
      selected: "&aSelected"
      available: "&7Available"
      locked: "&cNo permission"
    fill:
      enabled: false
      material: "BLACK_STAINED_GLASS_PANE"
      name: "&7"
      lore: []
    cooldown:
      seconds: 3
      bypass-permission: "rexchat.bypass"
    pagination:
      enabled: true
      prev:
        material: "ARROW"
        name: "&ePrevious"
      next:
        material: "ARROW"
        name: "&eNext"
      indicator:
        material: "PAPER"
        name: "&7Page &f{page}&7/&f{pages}"
        lore: []

# Chat Formatting
chat-format:
  enabled: true
#   Base format. Available placeholders:
#   {player}, {display_name}, {message}, {world}, {health}, {max_health}, {x}, {y}, {z}, {ping}
#   {prefix} resolves via LuckPerms/Vault directly (no PAPI required)
  format: "{prefix}&7{player} {tag}: &f{message}"
  player:
    hover:
      enabled: true
#       Lines shown on hover over the player's name. Supports same placeholders and colors.
      lines:
        - "&7Health: &c{health}&7/&c{max_health}"
        - "&7World: &f{world}"
        - "&7Location: &f{x}&7, &f{y}&7, &f{z}"
        - "&7Ping: &f{ping}ms"

#   Group-specific overrides (first matching group wins)
#   Uses LuckPerms/Vault primary group via PlaceholderAPI if available,
#   or matches by permission (e.g., group.<name>) or explicit permission below.
  groups:
    helper:
# permission: "group.helper"  # optional, if not using the primary group
      format: "{prefix}&7{player}: &a{message}"
      hover:
        enabled: true
        lines:
          - "&aHelper &7• &fPing: {ping}ms"
    moderator:
#       Optional explicit permission to match this group
#       permission: "group.moderator"
      format: "{prefix}&7{player}: &b{message}"
      hover:
        enabled: true
        lines:
          - "&bModerator &7• &fPing: {ping}ms"
    admin:
#       permission: "group.admin"
      format: "{prefix}&7{player}: &c{message}"
      hover:
        enabled: true
        lines:
          - "&cAdmin &7• &fPing: {ping}ms"

# Chat Emojis (enabled by default). Users can add more in the list below.
chat-emoji:
  enabled: true
  emojis:
    - name: "smile"
      aliases: [":)", ":smile:"]
      replacement: "☺"
    - name: "heart"
      aliases: ["<3", ":heart:"]
      replacement: "❤"
# Mentions: highlight @Name with a default color and optional sound
mention:
  enabled: true
  color: "&6"
  by-name: true
  sound:
    enabled: true
    name: "ENTITY_EXPERIENCE_ORB_PICKUP"
    volume: 0.8
    pitch: 1.2
  notify:
    sender: false
    target: true
  title:
    enabled: true
    title: "&6Mention!"
    subtitle: "&eYou were mentioned by &6{sender}"
    fade-in: 5
    stay: 40
    fade-out: 10


# Chat Management Settings
chat-management:
  mute:
    enabled: true
    permission: "rexchat.mute"
    muted-message: "%rc_prefix%&fThe chat is currently muted."
    mute-announcement: "%rc_prefix%&fThe chat has been muted by {player}"
    unmute-announcement: "%rc_prefix%&fThe chat has been unmuted by {player}"
  clear:
    enabled: true
    permission: "rexchat.clear"
    clear-message: "%rc_prefix%&fThe chat has been cleared by {player}"
    lines: 100

# Commands Configuration
commands:
  discord:
    enabled: true
    command: "discord"
    aliases: ["dc"]
    permission: ""
    message-list:
      - "%rc_prefix%&6Discord Server"
      - "&7• &fJoin our community: &6https://discord.gg/yourserver"
      - "&7• &fOnline Members: &61,234+"

  rules:
    enabled: true
    command: "rules"
    aliases: ["rule"]
    permission: ""
    message-list:
      - "%rc_prefix%&6Server Rules"
      - "&7• &fBe respectful to all players"
      - "&7• &fNo spamming or excessive caps"
      - "&7• &fNo advertising or self-promotion"
      - "&7• &fNo griefing or stealing"
      - "&7• &fUse appropriate language"

  store:
    enabled: true
    command: "store"
    aliases: ["shop"]
    permission: ""
    message: "%rc_prefix%&6Store &7• &fVisit our store: &6https://store.yourserver.com"

  help:
    enabled: true
    command: "help"
    aliases: ["?"]
    permission: ""
    message-list:
      - "%rc_prefix%&6Available Commands"
      - "&7• &#ffa500/discord &7- &fJoin our Discord community"
      - "&7• &#ffa500/rules &7- &fView server rules"
      - "&7• &#ffa500/store &7- &fVisit our store"
      - "&7• &#ffa500/help &7- &fShow this help message"