# ============================================================
# MailboxGUI-DiscBridge Configuration
# ============================================================
#
# This plugin connects MailboxGUI delivery events to DiscordSRV notifications.
#
# Standalone / single-server setup:
# - Install MailboxGUI, DiscordSRV, and MailboxGUI-DiscBridge on the same server.
# - Use mode: LOCAL
#
# Velocity / network setup:
# - Install MailboxGUI on every backend that uses mail.
# - Enable MailboxGUI network mode on those backends.
# - Install DiscordSRV and MailboxGUI-DiscBridge on only ONE backend.
# - Use mode: NETWORK_NODE on that one notification backend.
# - Other backend servers do not need DiscordSRV or MailboxGUI-DiscBridge.
#
# DiscBridge does not run on the Velocity proxy.
# DiscBridge does not need MySQL or Redis settings in this config.
# NETWORK_NODE mode reads MailboxGUI network settings from MailboxGUI itself.
#
# ============================================================

# Configuration file version.
# Do not change this unless a future update specifically tells you to.
config-version: 3

# DiscBridge operating mode.
#
# Valid values:
# - LOCAL
# - NETWORK_NODE
#
# LOCAL:
# - Default mode.
# - Use this for standalone/single-backend servers.
# - MailboxGUI, DiscordSRV, and DiscBridge must be installed on the same server.
# - DiscBridge listens to local MailboxGUI delivery events.
#
# NETWORK_NODE:
# - Use this for Velocity/network setups.
# - MailboxGUI must be installed on every backend that uses mail.
# - MailboxGUI network mode must be enabled on the backends.
# - DiscordSRV and DiscBridge should be installed on only one backend.
# - DiscBridge listens to MailboxGUI network notification events from the whole network.
# - Other backend servers do not need DiscordSRV or DiscBridge.
#
# If NETWORK_NODE is selected but MailboxGUI network mode is not enabled,
# DiscBridge will disable itself safely with a console error.
mode: LOCAL

# In-game command language.
# This controls messages from /mbdiscord commands.
#
# Supported values:
# en, de, es, fr, it, ja, ko, nl, pl, ru, sv, uk, zh_cn, zh_hk, zh_tw
language: "en"

# Client locale detection for in-game command messages.
#
# This affects /mbdiscord command messages only.
locale-detection:
  # If true, players receive /mbdiscord command messages in their Minecraft client language when a matching language file exists.
  use-client-locale: true

  # Fallback language if the player locale is unavailable or unsupported.
  fallback-language: "en"

# Discord message language defaults.
#
# Discord message templates are stored in /plugins/MailboxGUI-DiscBridge/disclanguage/.
#
# Individual Discord DMs use the recipient's selected Discord message language
# from /mbdiscord language <language>. If a player has not selected a language,
# individual DMs use this default language.
#
# Admin/API mass-mail channel notices always use this default language.
# Player-selected Discord message languages do not affect channel notices.
#
# Supported values:
# en, de, es, fr, it, ja, ko, nl, pl, ru, sv, uk, zh_cn, zh_hk, zh_tw
discord-messages:
  default-language: "en"

# Server display name used in Discord messages.
# Placeholder: {server}
#
# Generic default to avoid branding a specific server into the plugin.
# Server owners can customize this.
server-name: "Minecraft Server"

# Individual Discord direct-message notifications.
#
# These are used for one-recipient mail deliveries.
#
# LOCAL mode:
# - DMs are based on local MailboxGUI delivery events.
#
# NETWORK_NODE mode:
# - DMs are based on MailboxGUI network notification events.
# - The player may be online on another backend.
# - Online-DM rules still apply using MailboxGUI network presence.
direct-messages:

  # If true, DiscBridge may send Discord DMs for individual mail.
  # If false, individual Discord DMs are disabled globally.
  enabled: true

  # If false, online players will not receive Discord DMs unless they personally enable:
  # /mbdiscord online on
  #
  # Recommended default: false
  # Reason: online players already receive in-game MailboxGUI notifications.
  send-to-online-players-by-default: false

# Network-safe duplicate protection.
#
# DiscBridge remembers recent MailboxGUI event IDs so the same Discord
# notification is not sent twice.
#
# LOCAL mode:
# - Protects against duplicate local events.
#
# NETWORK_NODE mode:
# - Protects against duplicate network messages or accidental duplicate nodes.
#
# This does not replace the recommendation to run only one NETWORK_NODE.
# It is a safety layer, not a clustering system.
duplicate-protection:
  # If true, DiscBridge remembers recent MailboxGUI delivery event IDs.
  #
  # Recommended: true
  enabled: true

  # How long event IDs are remembered.
  #
  # This prevents duplicate Discord notifications if the same event is observed twice.
  remember-event-ids-minutes: 30

# Discord channel notification for admin/API mail sent to multiple recipients.
#
# Mass mail means 2 or more recipients.
#
# Recommended behavior:
# - Send one channel message for mass mail.
# - Do not send one immediate DM per recipient.
#
# This works in both LOCAL and NETWORK_NODE mode.
admin-mass-mail-channel:

  # If true, DiscBridge may post one Discord channel message for mass mail.
  enabled: true

  # Discord channel ID where mass mail notices should be posted.
  # To get a channel ID:
  # 1. Enable Discord Developer Mode.
  # 2. Right-click the Discord channel.
  # 3. Click "Copy Channel ID".
  channel-id: ""

  # If true, {mention} becomes @everyone in the mass mail channel message.
  # If false, {mention} becomes blank.
  #
  # Your Discord bot role must have permission to mention everyone if this is true.
  mention-everyone: false

# Optional Discord direct-message notifications for admin/API mass mail.
#
# Default: disabled.
#
# Reason:
# Mass mail can target many players. The safer default is one Discord channel
# post only.
#
# If enabled:
# - DiscBridge checks actual DM eligibility before counting a recipient.
# - Unlinked players do not count.
# - Players who disabled DMs do not count.
# - Players ignoring admin mail do not count.
# - Online players do not count unless online DMs are allowed.
# - In NETWORK_NODE mode, online status comes from MailboxGUI network presence.
#
# DMs are queued and delayed to avoid sending too many Discord messages at once.
admin-mass-mail-direct-messages:

  # If true, eligible recipients may receive individual Discord DMs
  # for admin/API mass mail.
  enabled: false

  # Maximum number of eligible DM recipients for one mass mail event.
  #
  # This counts only players who passed all DM eligibility checks.
  max-eligible-recipients: 10

  # What happens when eligible recipients exceed max-eligible-recipients.
  #
  # channel_only:
  # - Send no mass DMs.
  # - Rely on the admin mass mail channel post.
  #
  # send_first_max:
  # - Send DMs only to the first max-eligible-recipients eligible players.
  over-limit-behavior: channel_only

  queue:
    # If true, DMs are spaced out instead of sent all at once.
    enabled: true

    # Delay between queued DMs.
    delay-between-dms-seconds: 3

    # Number of retry attempts after a failed DM.
    max-retries: 1

    # Delay before retrying a failed DM.
    retry-delay-seconds: 30

# Update checker.
#
# The website update endpoint is built into the plugin and is not shown here.
# Only the update channel is configurable.
#
# This prevents server configs from depending on public URLs while still letting
# admins choose release, beta, or alpha update channels.
updates:
  # Enables or disables update checks.
  enabled: true

  # Release channel to check.
  #
  # Common values:
  # - release
  # - beta
  # - alpha
  channel: release

  # If true, checks for updates when the plugin starts.
  check-on-startup: true

  # If true, admins are notified when they join and an update is available.
  notify-admins-on-join: true

  # Permission required to receive join update notices.
  notify-permission: "mailboxguidiscbridge.admin"