Start here

Overview

MailboxGUI-DiscBridge 1.1.1 connects MailboxGUI delivery events to DiscordSRV. It tells eligible players about delivered mail; it does not create the mail, process COD payments or replace the in-game mailbox.

1.1.1 includes book-letter notifications, formatted COD item-currency prices, per-player Discord languages and the historical notification-node setup.

Back to top ↑

Start here

MailboxGUI & DiscBridge version compatibility

MailboxGUI version / editionDiscBridge version / editionPairing notes
MailboxGUI 5.1.1 FreeDiscBridge 1.1.1Historical pairing; both versions are no longer supported.
MailboxGUI 6.0.0 FreeDiscBridge 2.0.0 FreeSingle-server pairing.
MailboxGUI 6.1.0 FreeDiscBridge 2.1.0 FreeCurrent Free pairing.
MailboxGUI 6.1.0 PremiumDiscBridge 2.1.0 PremiumCurrent Premium pairing; each product has its own license.

For 6.1.0 / 2.1.0, Free must pair with Free and Premium must pair with Premium. Buying one Premium product does not include the other. DiscBridge 2.1.0 requires the MailboxGUI 6.1.0-era integration and a compatible API protocol; do not install it as a drop-in addon for 5.1.1 or 6.0.0. Check future release requirements before mixing versions.

Back to top ↑

Start here

Features in 1.1.1

FeatureIncluded behavior
Individual mail notificationsDiscord DMs for classic letters, book letters, packages, COD packages, item-currency COD payments, returned COD packages and money mail. Actual mail is delivered by MailboxGUI.
Account linkingUses DiscordSRV’s Minecraft-to-Discord account link. This is separate from the website Discord account link for purchase support.
Recipient preferencesOpt-in/opt-out, online DM preference, language selection, ignored player senders and admin-mail ignore. Saved locally in data/players.yml.
Admin/API batchesOne configured Discord channel notice; optional eligibility-limited, delayed recipient DMs with retry settings.
Languages15 message/template languages. English command keywords and mbdiscord aliases remain unchanged.
Duplicate protectionRecent event-ID deduplication with a configurable memory window.
AdministrationStatus, mode inspection, reload, diagnostic DMs/channel notices and website update staging.
Config maintenanceVersioned config and message synchronization with managed backups.
Free networkingLOCAL or NETWORK_NODE. One DiscBridge + DiscordSRV notification backend subscribes to MailboxGUI’s existing Redis channel and uses its presence information.
Back to top ↑

Start here

Requirements

  • A compatible Bukkit/Spigot/Paper/Purpur backend; the plugin descriptor targets API 1.18. Use a Java runtime compatible with your actual server version.
  • MailboxGUI 5.1.1 and DiscBridge 1.1.1 on the same notification server. DiscBridge is an addon, not a standalone mail plugin.
  • DiscordSRV installed, enabled and connected to Discord on that same server. The historical build dependency targets DiscordSRV 1.28.0; do not treat that dependency as a guarantee for every future DiscordSRV build.
  • Java 17-compatible plugin bytecode; newer Minecraft server versions may require a newer Java runtime.
  • A linked recipient Discord account, notification opt-in, and Discord privacy settings that allow DMs.

Economy/item-currency integrations belong to MailboxGUI. DiscBridge reads delivery metadata rather than requiring an additional economy provider of its own.

Back to top ↑

Start here

Installation

  1. Back up the server’s plugin JARs and both plugin data folders before changing an existing installation.
  2. Install the matching MailboxGUI, DiscordSRV and DiscBridge JARs on the notification backend. Avoid duplicate old/new DiscBridge JARs.
  3. Start the server normally to generate plugins/MailboxGUI-DiscBridge/config.yml, language/, disclanguage/ and data/players.yml.
  4. Configure DiscordSRV’s bot/account-linking system and verify that it is connected. Supply a mass-mail channel ID if you want shared announcements.
  5. Keep mode: LOCAL for a single server. For the historical network setup, follow the separate NETWORK_NODE instructions below.
  6. Run /mbdiscord admin status, then test a linked player with /mbdiscord admin testdm <player> and the configured channel with /mbdiscord admin testchannel.
  7. Have the player run /mbdiscord enable. Test actual mail while the player is offline, or allow online DMs before testing while online.
Back to top ↑

Start here

LOCAL & NETWORK_NODE modes

LOCAL listens to MailboxGUI’s local individual and mass-delivery events. NETWORK_NODE uses the existing MailboxGUI Redis delivery messages and cross-backend presence. Select the mode in DiscBridge config.yml; /mbdiscord admin mode only reports it.

ModeInstallation / behavior
LOCALMailboxGUI, DiscordSRV and DiscBridge together on a single backend.
NETWORK_NODEMailboxGUI on every mail backend; DiscordSRV and DiscBridge together on exactly ONE notification backend. MailboxGUI networking must be enabled there or DiscBridge disables safely.
Back to top ↑

Start here

DiscordSRV & account linking

  1. Configure DiscordSRV and its Discord bot using the documentation for the DiscordSRV version installed on your server.
  2. Use DiscordSRV’s account-linking workflow to link the player’s Minecraft UUID to their Discord account.
  3. For DMs, confirm the bot can reach the Discord user and the user permits private messages. A working guild bot does not guarantee the user accepts DMs.
  4. For shared notices, enable admin-mass-mail-channel and copy the target channel ID with Discord Developer Mode. Give the DiscordSRV bot View Channel and Send Messages there.
  5. Only enable mention-everyone when you intend to ping everyone and the bot has permission to do so.
  6. Test transport with the admin diagnostic commands, then test actual mail with recipient eligibility enabled.

DiscBridge uses the DiscordSRV bot connection; it does not need its own bot token in config.yml. Keep credentials private.

Back to top ↑

Using notifications

Individual notifications & eligibility

Delivery events are filtered before sending a DM. A skipped notification does not cancel, remove or refund the in-game mail. Recipient preferences initially have notifications disabled, online DMs disabled and admin-mail ignore disabled.

  1. direct-messages.enabled must be true.
  2. The delivery needs a recipient UUID with a DiscordSRV account link.
  3. The recipient must have opted in with /mbdiscord enable.
  4. If the recipient is online, the global online-DM default or their /mbdiscord online on preference must allow DMs.
  5. Admin-like deliveries are skipped when the recipient enabled ignoreadmin.
  6. Player-sent deliveries are skipped when the sender UUID is on the recipient’s ignore list.
  7. A usable language template and successful Discord delivery are still required.

NETWORK_NODE determines online status using MailboxGUI’s network presence, so a recipient playing on another backend still counts as online. LOCAL checks the current backend.

Player setup example
/mbdiscord enable
/mbdiscord online on
/mbdiscord language en
/mbdiscord status
Back to top ↑

Using notifications

Admin/API mass mail & the DM queue

MailboxGUI’s mass-delivery event supplies the successful recipient count and UUIDs. DiscBridge can post one shared channel notice and, separately, queue optional recipient DMs. A blank channel-id prevents the shared post.

SettingDefault / behavior
Channel noticeEnabled; channel ID blank until configured.
@everyone mentionDisabled.
Optional recipient DMsDisabled.
Eligible recipient limit10; count after opt-in, linking, online and ignore checks.
Over limitchannel_only: no batch DMs. Alternative send_first_max: first eligible recipients up to the limit.
Queue spacingEnabled; 3 seconds before each send.
Failures1 retry; 30 seconds before the failed job is requeued.
Example — opt into limited batch DMs (merge into config.yml)
admin-mass-mail-direct-messages:
  enabled: true
  max-eligible-recipients: 10
  over-limit-behavior: channel_only
  queue:
    enabled: true
    delay-between-dms-seconds: 3
    max-retries: 1
    retry-delay-seconds: 30
Back to top ↑

Commands & languages

Player commands

These versions register /mbdiscord with /mailboxdiscord and /maildiscord aliases. Command keywords stay English, even when messages are translated. Except help, these player preferences require an in-game player and mailboxguidiscbridge.use.

Command structurePurposePermission / requirement
/mbdiscord [help [1|2]]Show one of the two help pages. Missing or invalid page defaults to 1; numeric pages are clamped to 1–2.Help is also available from console.
/mbdiscord statusShow notification opt-in, online-DM preference, admin-mail ignore state and effective Discord message language.mailboxguidiscbridge.use
/mbdiscord enableEnable notifications after confirming the player has a DiscordSRV account link. If not immediately found, the link is checked again after 40 ticks.mailboxguidiscbridge.use
/mbdiscord disableDisable this player’s Discord mail DMs.mailboxguidiscbridge.use
/mbdiscord online <on|off|toggle>Allow or disallow mail DMs while online. Turning this off does not override a globally enabled online-DM default.mailboxguidiscbridge.use + mailboxguidiscbridge.online
/mbdiscord language [language]Without an argument, show the current Discord language and available choices. With a code or recognized language name, save the Discord DM language.mailboxguidiscbridge.use
/mbdiscord ignore <player>Ignore mail DMs from a known player, identified by UUID. Cannot ignore yourself. This does not block the mail delivery.mailboxguidiscbridge.use + mailboxguidiscbridge.ignore
/mbdiscord unignore <player>Remove that player from the DM ignore list.mailboxguidiscbridge.use + mailboxguidiscbridge.ignore
/mbdiscord ignorelistList ignored senders and the separate admin-mail ignore state.mailboxguidiscbridge.use + mailboxguidiscbridge.ignore
/mbdiscord ignoreadminIgnore individual admin/server/API mail DMs, including optional batch DMs. Does not suppress the shared channel announcement.mailboxguidiscbridge.use + mailboxguidiscbridge.ignoreadmin
/mbdiscord unignoreadminAllow admin/server/API mail DMs again, subject to normal eligibility.mailboxguidiscbridge.use + mailboxguidiscbridge.ignoreadmin
Ignore and language examples
/mbdiscord ignore Alex
/mbdiscord ignorelist
/mbdiscord unignore Alex
/mbdiscord ignoreadmin
/mbdiscord unignoreadmin
/mbdiscord language Deutsch
/mbdiscord help 2
Back to top ↑

Commands & languages

Administrator commands

Command structurePurposePermission / requirement
/mbdiscord admin [status]Inspect dependency hooks, operating mode, locales, delivery settings, queue size, duplicate protection and session delivery/skipped/failure counters.mailboxguidiscbridge.admin + mailboxguidiscbridge.admin.status
/mbdiscord admin modeInspect the operating mode and dependency state. Diagnostic only; does not change the mode.mailboxguidiscbridge.admin + mailboxguidiscbridge.admin.status
/mbdiscord admin reloadSynchronize and reload configuration and both language folders, reload stored preferences, clear queued batch DMs and duplicate-event memory.mailboxguidiscbridge.admin + mailboxguidiscbridge.admin.reload
/mbdiscord admin updatecheckCheck the website update feed for the configured release channel.mailboxguidiscbridge.admin + mailboxguidiscbridge.admin.update
/mbdiscord admin testdm <player>Send a diagnostic DM to a known DiscordSRV-linked player. This checks delivery, not normal opt-in/online/ignore eligibility.mailboxguidiscbridge.admin + mailboxguidiscbridge.admin.test
/mbdiscord admin testchannelSend a diagnostic channel notice; requires an enabled channel configuration and a channel ID.mailboxguidiscbridge.admin + mailboxguidiscbridge.admin.test
/mbdiscord updateFetch the latest update information and prepare the update for confirmation.mailboxguidiscbridge.admin.update
/mbdiscord update confirmDownload and stage the prepared update for the next server restart. This does not hot-reload or restart the server.mailboxguidiscbridge.admin.update
Basic diagnostic sequence
/mbdiscord admin status
/mbdiscord admin mode
/mbdiscord admin testdm Alex
/mbdiscord admin testchannel
/mbdiscord admin reload

The admin branch requires the umbrella permission and the relevant child permission. The separate /mbdiscord update branch checks mailboxguidiscbridge.admin.update directly. Console may use administration and diagnostic commands; it has no player preference profile.

Back to top ↑

Commands & languages

Permissions

These are the permissions registered by this historical plugin.yml. Player permissions default to true; staff permissions default to operator. Configure permission assignments in your server permission manager.

PermissionDefaultPurpose / child permissions
mailboxguidiscbridge.usetrueAllows players to use MailboxGUI Discord notification commands.
mailboxguidiscbridge.onlinetrueAllows players to receive Discord DMs while online if enabled.
mailboxguidiscbridge.ignoretrueAllows players to ignore player senders for Discord DMs.
mailboxguidiscbridge.ignoreadmintrueAllows players to ignore individual admin/server Discord DMs.
mailboxguidiscbridge.adminopAllows admin access to MailboxGUI-DiscBridge commands. Grants: mailboxguidiscbridge.admin.reload, mailboxguidiscbridge.admin.status, mailboxguidiscbridge.admin.test, mailboxguidiscbridge.admin.update.
mailboxguidiscbridge.admin.reloadopAllows reloading MailboxGUI-DiscBridge.
mailboxguidiscbridge.admin.updateopAllows checking, preparing, and staging MailboxGUI-DiscBridge updates from the website release system.
mailboxguidiscbridge.admin.statusopAllows viewing MailboxGUI-DiscBridge status.
mailboxguidiscbridge.admin.testopAllows sending test Discord notifications.
Back to top ↑

Configuration & templates

Configuration & important settings

Edit plugins/MailboxGUI-DiscBridge/config.yml with spaces, not tabs. Keep IDs quoted, maintain YAML nesting and preserve the managed config-version. Apply changes with /mbdiscord admin reload after making a backup.

SettingHow it works
modeLOCAL by default. NETWORK_NODE only with the historical MailboxGUI network setup.
languageEnglish by default; in-game command-message language.
locale-detection.use-client-locale / fallback-languageDetect supported Minecraft client locales; fallback en by default.
discord-messages.default-languageDefault individual DM template language and shared-channel template language; en by default.
server-nameDisplay text substituted into {server}; Minecraft Server by default.
SettingMeaning / limits
direct-messages.enabledGlobal gate for individual DMs; true by default. Players still need a DiscordSRV link and must opt in.
direct-messages.send-to-online-players-by-defaultFalse by default. If false, online recipients need their own online preference enabled. If true, online DMs are allowed regardless of that preference.
duplicate-protection.enabled / remember-event-ids-minutesOn by default; retain recent delivery event IDs for 30 minutes. The configured duration is clamped to at least 1 minute. In-memory protection, not a persistent delivery ledger.
admin-mass-mail-channel.enabled / channel-idChannel notices are enabled, but the default ID is blank, so you must supply your channel ID.
admin-mass-mail-channel.mention-everyoneFalse by default. Enabling it substitutes @everyone into {mention}; the Discord bot also needs the corresponding permission.
admin-mass-mail-direct-messages.enabledOptional batch DMs are disabled by default.
admin-mass-mail-direct-messages.max-eligible-recipients10 by default; clamped to at least 1. Only recipients passing the DM eligibility checks count.
admin-mass-mail-direct-messages.over-limit-behaviorchannel_only skips all batch DMs if eligible recipients exceed the limit. send_first_max queues only the first permitted number; not a random sample. Invalid values fall back to channel_only.
admin-mass-mail-direct-messages.queue.enabledTrue by default. Disabling spacing schedules each queued send after one tick; it does not create simultaneous unbounded sends.
admin-mass-mail-direct-messages.queue.delay-between-dms-seconds3 seconds by default, clamped to at least 1 second. Applied before each queued DM.
admin-mass-mail-direct-messages.queue.max-retries / retry-delay-seconds1 retry after a failure and a 30-second retry delay by default. Retries are clamped to zero or higher; retry delay to at least 1 second. The failed job is returned to the queue.
updates.enabled / channelChecks enabled; channel release by default. Valid channels are release, beta and alpha; unsupported values become release. The update URL is built into the plugin.
updates.check-on-startup / notify-admins-on-join / notify-permissionStartup checks and join notices enabled. Default notice permission: mailboxguidiscbridge.admin.
Back to top ↑

Configuration & templates

Complete default config.yml

The reference below uses the 1.1.1 release defaults, not the latest version’s schema. All supported leaf settings are listed below it.

Complete 1.1.1 config.yml — supported settings and defaults
Download configuration reference
config.yml
# ============================================================
# 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"
SettingReleased default
config-version3
mode"LOCAL"
language"en"
locale-detection.use-client-localetrue
locale-detection.fallback-language"en"
discord-messages.default-language"en"
server-name"Minecraft Server"
direct-messages.enabledtrue
direct-messages.send-to-online-players-by-defaultfalse
duplicate-protection.enabledtrue
duplicate-protection.remember-event-ids-minutes30
admin-mass-mail-channel.enabledtrue
admin-mass-mail-channel.channel-id""
admin-mass-mail-channel.mention-everyonefalse
admin-mass-mail-direct-messages.enabledfalse
admin-mass-mail-direct-messages.max-eligible-recipients10
admin-mass-mail-direct-messages.over-limit-behavior"channel_only"
admin-mass-mail-direct-messages.queue.enabledtrue
admin-mass-mail-direct-messages.queue.delay-between-dms-seconds3
admin-mass-mail-direct-messages.queue.max-retries1
admin-mass-mail-direct-messages.queue.retry-delay-seconds30
updates.enabledtrue
updates.channel"release"
updates.check-on-startuptrue
updates.notify-admins-on-jointrue
updates.notify-permission"mailboxguidiscbridge.admin"
Back to top ↑

Configuration & templates

Discord templates & placeholders

Edit disclanguage/messages_<locale>.yml for Discord notifications. Each messages key contains a YAML list of text lines. Minecraft color codes are stripped from substituted values. Use Discord formatting in the template itself.

Key in disclanguage/messages_xx.ymlPurpose
messages.dm-letterIndividual mail DM.
messages.dm-book-letterIndividual mail DM.
messages.dm-packageIndividual mail DM.
messages.dm-cod-packageIndividual mail DM.
messages.dm-cod-item-currency-paymentIndividual mail DM.
messages.dm-returned-cod-packageIndividual mail DM.
messages.dm-money-mailIndividual mail DM.
messages.admin-mass-mail-channelOne channel notice for an admin/API batch.
PlaceholderValue
{server}Display name from DiscBridge server-name.
{sender}Player or admin/server/API sender display name.
{recipient}Recipient name for an individual DM.
{price}COD price text. Prefers MailboxGUI’s formatted item-currency / money description; falls back to its numeric COD price.
{amount}Money-mail amount, with trailing decimal zeros removed.
{mention}@everyone only when enabled for the shared channel announcement; otherwise empty.
{recipient_count}Successful recipient count reported by the mass-delivery event.
Small template customization (merge into the existing file)
messages:
  dm-package:
    - "📦 {recipient}, you received a package from {sender} on {server}."
    - "Open your mailbox in-game."
  admin-mass-mail-channel:
    - "{mention} 📬 Mail delivered to {recipient_count} players on {server}."

Only some fields have values for a given mail type. {price} belongs to COD-related notifications, {amount} to money mail, and {recipient_count}/{mention} to a shared batch notice. An empty field can be expected, not a delivery failure.

Back to top ↑

Configuration & templates

Languages & complete YAML references

15 languages are bundled: English, German, Spanish, French, Italian, Japanese, Korean, Dutch, Polish, Russian, Swedish, Ukrainian and Simplified/Hong Kong/Taiwan Chinese. No Portuguese command bundle is included in these historical versions.

language/messages_<locale>.yml controls Minecraft responses. disclanguage/messages_<locale>.yml controls Discord templates. Individual DMs use the player’s selection or the configured Discord default; channel notices always use the configured Discord default. Missing/empty selected templates fall back to English.

Example — fixed German in-game responses, English channel notices
language: "de"
locale-detection:
  use-client-locale: false
  fallback-language: "de"
discord-messages:
  default-language: "en"

Players can choose another DM language with /mbdiscord language fr, /mbdiscord language Deutsch or another recognized language name. This does not translate command tokens.

English — en: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_en.yml
# File format version. Used by future language updaters.
file-version: 3

# Prefix used for in-game DiscBridge command messages.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# General command messages.
general:
  no-permission: "{prefix}&cYou do not have permission to use this command."
  players-only: "{prefix}&cOnly players can use this command."
  unknown-command: "{prefix}&cUnknown command. Use &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge reloaded."

# Player status messages.
status:
  header: "&bMailboxGUI-DiscBridge Status"
  notifications-enabled: "&7Discord mail notifications: &aEnabled"
  notifications-disabled: "&7Discord mail notifications: &cDisabled"
  online-dms-enabled: "&7Online Discord DMs: &aEnabled"
  online-dms-disabled: "&7Online Discord DMs: &cDisabled"
  admin-ignored: "&7Admin/server mail DMs: &cIgnored"
  admin-not-ignored: "&7Admin/server mail DMs: &aAllowed"

# Player and admin help menu lines.
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge Commands &7(Page {page}/{total})"
      - "&e/mbdiscord status &7- View your Discord mail notification settings."
      - "&e/mbdiscord enable &7- Enable Discord mail notifications."
      - "&e/mbdiscord disable &7- Disable Discord mail notifications."
      - "&e/mbdiscord online on|off|toggle &7- Control DMs while online."
      - "&e/mbdiscord language <language> &7- Set your Discord DM message language."
      - "&e/mbdiscord ignore <player> &7- Ignore Discord DMs from a sender."
      - "&e/mbdiscord unignore <player> &7- Stop ignoring a sender."
      - "&e/mbdiscord ignorelist &7- View ignored senders."
      - "&e/mbdiscord ignoreadmin &7- Ignore admin/server mail DMs."
      - "&e/mbdiscord unignoreadmin &7- Allow admin/server mail DMs."
    page-2:
      - "&bMailboxGUI-DiscBridge Admin Commands &7(Page {page}/{total})"
      - "&e/mbdiscord admin status &7- View bridge admin status."
      - "&e/mbdiscord admin mode &7- View LOCAL/NETWORK_NODE setup diagnostics."
      - "&e/mbdiscord admin reload &7- Reload bridge config, language, and player data."
      - "&e/mbdiscord admin updatecheck &7- Check the website release system for updates."
      - "&e/mbdiscord update &7- Prepare the latest update."
      - "&e/mbdiscord update confirm &7- Stage the prepared update for next restart."
      - "&e/mbdiscord admin testdm <player> &7- Send a diagnostic Discord DM."
      - "&e/mbdiscord admin testchannel &7- Send a diagnostic channel notice."
    footer: "&7Use &e/mbdiscord help <page> &7to view another page."

# DiscordSRV link and notification toggle messages.
discord:
  not-linked: "{prefix}&cYour Minecraft account is not linked to DiscordSRV yet. If you just linked, wait a few seconds and try &e/mbdiscord enable &cagain."
  link-checking: "{prefix}&eChecking your DiscordSRV link status..."
  enabled: "{prefix}&aDiscord mail notifications enabled."
  disabled: "{prefix}&cDiscord mail notifications disabled."
  online-enabled: "{prefix}&aYou will receive Discord mail DMs while online."
  online-disabled: "{prefix}&eYou will only receive Discord mail DMs while offline."

# Online-DM command messages.
online:
  usage: "{prefix}&cUsage: &e/mbdiscord online <on|off|toggle>"

# Player sender ignore-list command messages.
ignore:
  usage-ignore: "{prefix}&cUsage: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cUsage: &e/mbdiscord unignore <player>"
  added: "{prefix}&aYou will no longer receive Discord mail DMs from &e{player}&a."
  removed: "{prefix}&aYou will now receive Discord mail DMs from &e{player}&a again."
  not-found: "{prefix}&cCould not find a known player named &e{player}&c."
  cannot-ignore-self: "{prefix}&cYou cannot ignore yourself."
  empty: "{prefix}&7You are not ignoring any player senders."
  list-header: "&bIgnored Discord Mail Senders"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7Admin/server mail DMs: &cIgnored"
  list-admin-allowed: "&7Admin/server mail DMs: &aAllowed"
  admin-enabled: "{prefix}&cYou are now ignoring individual admin/server mail DMs."
  admin-disabled: "{prefix}&aYou are now allowing individual admin/server mail DMs."

# Admin command messages and diagnostic output.
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge Mode Diagnostic"
      - "&7Mode: &e{mode}"
      - "&7MailboxGUI hook: {mailboxgui}"
      - "&7DiscordSRV hook: {discordsrv}"
      - "&7MailboxGUI network mode: {mailboxgui_network}"
      - "&7Network notification node: {network_node}"
      - "&aLOCAL mode setup:"
      - "&7Install MailboxGUI, DiscordSRV, and MailboxGUI-DiscBridge on this server."
      - "&7Use this mode for standalone/single-backend servers."
    network-node:
      - "&bMailboxGUI-DiscBridge Mode Diagnostic"
      - "&7Mode: &e{mode}"
      - "&7MailboxGUI hook: {mailboxgui}"
      - "&7DiscordSRV hook: {discordsrv}"
      - "&7MailboxGUI network mode: {mailboxgui_network}"
      - "&7Network notification node: {network_node}"
      - "&aNETWORK_NODE setup:"
      - "&7Install MailboxGUI on every backend that uses mail."
      - "&7Install DiscordSRV and DiscBridge on only this notification backend."
      - "&7This backend listens for MailboxGUI network notification events."

  status:
    - "&bMailboxGUI-DiscBridge Admin Status"
    - "&7MailboxGUI hook: {mailboxgui}"
    - "&7DiscordSRV hook: {discordsrv}"
    - "&7Mode: &e{mode}"
    - "&7MailboxGUI network mode: {mailboxgui_network}"
    - "&7Network notification node: {network_node}"
    - "&7Language: &e{language} &8| &7Client locale: {client_locale} &8| &7Fallback: &e{fallback_language}"
    - "&7Updates: {updates} &8| &7Channel: &e{update_channel}"
    - "&7Direct messages: {direct_messages}"
    - "&7Mass mail channel: {mass_channel}"
    - "&7Mention everyone: {mention_everyone}"
    - "&7Mass mail DMs: {mass_dms} &8| &7Limit: &e{mass_dm_limit} &8| &7Behavior: &e{mass_dm_behavior}"
    - "&7Mass DM queue: {mass_dm_queue} &8| &7Queued: &e{queued_mass_dms}"
    - "&7Duplicate protection: {duplicate_protection} &8| &7TTL: &e{dedupe_minutes}m &8| &7Tracked: &e{dedupe_events}"
    - "&7Loaded player preferences: &e{player_count}"
    - "&7Individual DMs: &a{individual_delivered} delivered &8/ &e{individual_skipped} skipped &8/ &c{individual_failed} failed"
    - "&7Mass notices: &a{mass_delivered} delivered &8/ &e{mass_skipped} skipped &8/ &c{mass_failed} failed"
  test-dm-usage: "{prefix}&cUsage: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cPlayer &e{player}&c is not linked through DiscordSRV."
  test-dm-sent: "{prefix}&aTest DM sent to &e{player}&a."
  test-dm-failed: "{prefix}&cFailed to send test DM to &e{player}&c. Check console for details."
  test-channel-disabled: "{prefix}&cAdmin mass mail channel messages are disabled in config.yml."
  test-channel-missing: "{prefix}&cAdmin mass mail channel-id is missing in config.yml."
  test-channel-sent: "{prefix}&aTest channel message sent."
  test-channel-failed: "{prefix}&cFailed to send test channel message. Check console for details."
Download Discord templates
disclanguage/messages_en.yml
# ============================================================
# MailboxGUI-DiscBridge Discord Message Templates
# ============================================================
#
# These messages are sent to Discord, not Minecraft chat.
# Minecraft color codes are stripped from placeholder values before Discord messages are sent.
#
# Supported placeholders:
# {server}          Server display name from config.yml server-name.
# {sender}          Sender display name.
# {recipient}       Recipient name, available for individual messages.
# {price}           COD package price text. Supports Vault money and item-currency text from MailboxGUI 5.1.0.
# {amount}          Money mail amount.
# {mention}         Used only for admin-mass-mail-channel.
# {recipient_count} Number of successful recipients for mass mail.
#
# ============================================================

messages-version: 2

messages:

  # Discord DM sent when a player receives a classic letter.
  dm-letter:
    - "📬 You received a letter from {sender} on {server}."
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."

  # Discord DM sent when a player receives a Book Letter.
  dm-book-letter:
    - "📬 You received a book letter from {sender} on {server}."
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."

  # Discord DM sent when a player receives a package.
  dm-package:
    - "📦 You received a package from {sender} on {server}."
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."

  # Discord DM sent when a player receives a Cash-on-Delivery package.
  # Uses {price}. In MailboxGUI 5.1.0, {price} can include Vault money and item-currency text.
  dm-cod-package:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."

  # Discord DM sent when a player receives an item-currency COD payment mail.
  # Uses {price}.
  dm-cod-item-currency-payment:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."

  # Discord DM sent when a player's COD package is returned.
  dm-returned-cod-package:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."

  # Discord DM sent when a player receives money mail.
  # Uses {amount}.
  dm-money-mail:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."

  # Discord channel message sent when admin/API mail is delivered to multiple recipients.
  # This channel message always uses discord-messages.default-language from config.yml.
  # Player-selected Discord message languages only affect individual Discord DMs.
  # Uses {mention}; optionally uses {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Server Mail Notice**"
    - "Server mail was sent to multiple players on {server}."
    - "Check your mailbox, a public Post Office box, or a Post Office NPC in-game."
Deutsch — de: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_de.yml
# Dateiformat-Version. Wird von zukünftigen Sprach-Updatern verwendet.
file-version: 3

# Präfix für Ingame-Befehlsnachrichten von DiscBridge.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Allgemeine Befehlsnachrichten.
general:
  no-permission: "{prefix}&cDu hast keine Berechtigung, diesen Befehl zu verwenden."
  players-only: "{prefix}&cNur Spieler können diesen Befehl verwenden."
  unknown-command: "{prefix}&cUnbekannter Befehl. Verwende &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge wurde neu geladen."

# Spieler-Statusmeldungen.
status:
  header: "&bMailboxGUI-DiscBridge-Status"
  notifications-enabled: "&7Discord-Mail-Benachrichtigungen: &aAktiviert"
  notifications-disabled: "&7Discord-Mail-Benachrichtigungen: &cDeaktiviert"
  online-dms-enabled: "&7Discord-DMs im Online-Modus: &aAktiviert"
  online-dms-disabled: "&7Discord-DMs im Online-Modus: &cDeaktiviert"
  admin-ignored: "&7Admin-/Server-Mail-DMs: &cIgnoriert"
  admin-not-ignored: "&7Admin-/Server-Mail-DMs: &aErlaubt"

# Hilfezeilen für Spieler- und Adminbefehle.
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge-Befehle &7(Seite {page}/{total})"
      - "&e/mbdiscord status &7- Zeigt deine Discord-Mail-Benachrichtigungseinstellungen."
      - "&e/mbdiscord enable &7- Aktiviert Discord-Mail-Benachrichtigungen."
      - "&e/mbdiscord disable &7- Deaktiviert Discord-Mail-Benachrichtigungen."
      - "&e/mbdiscord online on|off|toggle &7- Steuert DMs, während du online bist."
      - "&e/mbdiscord language <language> &7- Lege deine Sprache für Discord-DM-Nachrichten fest."
      - "&e/mbdiscord ignore <player> &7- Ignoriert Discord-DMs von einem Absender."
      - "&e/mbdiscord unignore <player> &7- Ignoriert einen Absender nicht mehr."
      - "&e/mbdiscord ignorelist &7- Zeigt ignorierte Absender."
      - "&e/mbdiscord ignoreadmin &7- Ignoriert Admin-/Server-Mail-DMs."
      - "&e/mbdiscord unignoreadmin &7- Erlaubt Admin-/Server-Mail-DMs."
    page-2:
      - "&bMailboxGUI-DiscBridge-Adminbefehle &7(Seite {page}/{total})"
      - "&e/mbdiscord admin status &7- Zeigt den Adminstatus der Bridge."
      - "&e/mbdiscord admin mode &7- Zeigt LOCAL/NETWORK_NODE-Einrichtungsdiagnosen."
      - "&e/mbdiscord admin reload &7- Lädt Bridge-Konfiguration, Sprache und Spielerdaten neu."
      - "&e/mbdiscord admin updatecheck &7- Prüft das Website-Release-System auf Updates."
      - "&e/mbdiscord update &7- Bereitet das neueste Update vor."
      - "&e/mbdiscord update confirm &7- Stellt das vorbereitete Update für den nächsten Neustart bereit."
      - "&e/mbdiscord admin testdm <player> &7- Sendet eine diagnostische Discord-DM."
      - "&e/mbdiscord admin testchannel &7- Sendet eine diagnostische Kanalnachricht."
    footer: "&7Verwende &e/mbdiscord help <page> &7, um eine andere Seite anzuzeigen."

# Nachrichten für DiscordSRV-Verknüpfung und Benachrichtigungsschalter.
discord:
  not-linked: "{prefix}&cDein Minecraft-Konto ist noch nicht mit DiscordSRV verknüpft. Wenn du es gerade verknüpft hast, warte ein paar Sekunden und versuche &e/mbdiscord enable &cerneut."
  link-checking: "{prefix}&eDiscordSRV-Verknüpfungsstatus wird geprüft..."
  enabled: "{prefix}&aDiscord-Mail-Benachrichtigungen aktiviert."
  disabled: "{prefix}&cDiscord-Mail-Benachrichtigungen deaktiviert."
  online-enabled: "{prefix}&aDu erhältst Discord-Mail-DMs, während du online bist."
  online-disabled: "{prefix}&eDu erhältst Discord-Mail-DMs nur, wenn du offline bist."

# Nachrichten für den Online-DM-Befehl.
online:
  usage: "{prefix}&cVerwendung: &e/mbdiscord online <on|off|toggle>"

# Nachrichten für die Ignorierliste von Spieler-Absendern.
ignore:
  usage-ignore: "{prefix}&cVerwendung: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cVerwendung: &e/mbdiscord unignore <player>"
  added: "{prefix}&aDu erhältst keine Discord-Mail-DMs mehr von &e{player}&a."
  removed: "{prefix}&aDu erhältst wieder Discord-Mail-DMs von &e{player}&a."
  not-found: "{prefix}&cEs wurde kein bekannter Spieler namens &e{player}&c gefunden."
  cannot-ignore-self: "{prefix}&cDu kannst dich nicht selbst ignorieren."
  empty: "{prefix}&7Du ignorierst keine Spieler-Absender."
  list-header: "&bIgnorierte Discord-Mail-Absender"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7Admin-/Server-Mail-DMs: &cIgnoriert"
  list-admin-allowed: "&7Admin-/Server-Mail-DMs: &aErlaubt"
  admin-enabled: "{prefix}&cDu ignorierst jetzt einzelne Admin-/Server-Mail-DMs."
  admin-disabled: "{prefix}&aDu erlaubst jetzt einzelne Admin-/Server-Mail-DMs."

# Admin-Befehlsnachrichten und Diagnoseausgabe.
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge-Modusdiagnose"
      - "&7Modus: &e{mode}"
      - "&7MailboxGUI-Hook: {mailboxgui}"
      - "&7DiscordSRV-Hook: {discordsrv}"
      - "&7MailboxGUI-Netzwerkmodus: {mailboxgui_network}"
      - "&7Netzwerk-Benachrichtigungsknoten: {network_node}"
      - "&aLOCAL-Modus-Einrichtung:"
      - "&7Installiere MailboxGUI, DiscordSRV und MailboxGUI-DiscBridge auf diesem Server."
      - "&7Verwende diesen Modus für Standalone-/Einzel-Backend-Server."
    network-node:
      - "&bMailboxGUI-DiscBridge-Modusdiagnose"
      - "&7Modus: &e{mode}"
      - "&7MailboxGUI-Hook: {mailboxgui}"
      - "&7DiscordSRV-Hook: {discordsrv}"
      - "&7MailboxGUI-Netzwerkmodus: {mailboxgui_network}"
      - "&7Netzwerk-Benachrichtigungsknoten: {network_node}"
      - "&aNETWORK_NODE-Einrichtung:"
      - "&7Installiere MailboxGUI auf jedem Backend, das Post verwendet."
      - "&7Installiere DiscordSRV und DiscBridge nur auf diesem Benachrichtigungs-Backend."
      - "&7Dieses Backend lauscht auf MailboxGUI-Netzwerk-Benachrichtigungsereignisse."

  status:
    - "&bMailboxGUI-DiscBridge-Adminstatus"
    - "&7MailboxGUI-Hook: {mailboxgui}"
    - "&7DiscordSRV-Hook: {discordsrv}"
    - "&7Direktnachrichten: {direct_messages}"
    - "&7Massenmail-Kanal: {mass_channel}"
    - "&7Alle erwähnen: {mention_everyone}"
    - "&7Geladene Spielereinstellungen: &e{player_count}"
    - "&7Einzelne DMs: &a{individual_delivered} zugestellt &8/ &e{individual_skipped} übersprungen &8/ &c{individual_failed} fehlgeschlagen"
    - "&7Massenhinweise: &a{mass_delivered} zugestellt &8/ &e{mass_skipped} übersprungen &8/ &c{mass_failed} fehlgeschlagen"
  test-dm-usage: "{prefix}&cVerwendung: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cSpieler &e{player}&c ist nicht über DiscordSRV verknüpft."
  test-dm-sent: "{prefix}&aTest-DM an &e{player}&a gesendet."
  test-dm-failed: "{prefix}&cTest-DM an &e{player}&c konnte nicht gesendet werden. Siehe Konsole für Details."
  test-channel-disabled: "{prefix}&cAdmin-Massenmail-Kanalnachrichten sind in config.yml deaktiviert."
  test-channel-missing: "{prefix}&cDie channel-id für Admin-Massenmail fehlt in config.yml."
  test-channel-sent: "{prefix}&aTest-Kanalnachricht gesendet."
  test-channel-failed: "{prefix}&cTest-Kanalnachricht konnte nicht gesendet werden. Siehe Konsole für Details."
Download Discord templates
disclanguage/messages_de.yml
# ============================================================
# MailboxGUI-DiscBridge Discord-Nachrichtenvorlagen
# ============================================================
#
# Diese Nachrichten werden an Discord gesendet, nicht in den Minecraft-Chat.
# Minecraft-Farbcodes werden aus Platzhalterwerten entfernt, bevor Discord-Nachrichten gesendet werden.
#
# Unterstützte Platzhalter:
# {server}          Server-Anzeigename aus server-name in config.yml.
# {sender}          Anzeigename des Absenders.
# {recipient}       Name des Empfängers, verfügbar für einzelne Nachrichten.
# {price}           Preistext des COD-Pakets. Unterstützt Vault-Geld und Gegenstandswährungen aus MailboxGUI 5.1.0.
# {amount}          Betrag der Geldpost.
# {mention}         Wird nur für admin-mass-mail-channel verwendet.
# {recipient_count} Anzahl erfolgreicher Empfänger bei Massenpost.
#
# ============================================================

messages-version: 2

messages:

  # Discord-DM, wenn ein Spieler einen klassischen Brief erhält.
  dm-letter:
    - "📬 Du hast einen Brief von {sender} auf {server} erhalten."
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."

  # Discord-DM, wenn ein Spieler einen Buchbrief erhält.
  dm-book-letter:
    - "📬 Du hast einen Buchbrief von {sender} auf {server} erhalten."
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."

  # Discord-DM, wenn ein Spieler ein Paket erhält.
  dm-package:
    - "📦 Du hast ein Paket von {sender} auf {server} erhalten."
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."

  # Discord-DM, wenn ein Spieler ein Nachnahme-Paket erhält.
  # Verwendet {price}. In MailboxGUI 5.1.0 kann {price} Vault-Geld und Gegenstandswährungen enthalten.
  dm-cod-package:
    - "📦 Du hast ein Nachnahme-Paket von {sender} auf {server} erhalten."
    - "Preis: {price}"
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."

  # Discord-DM, wenn ein Spieler eine COD-Zahlung in Gegenstandswährung erhält.
  # Verwendet {price}.
  dm-cod-item-currency-payment:
    - "💜 Du hast eine COD-Zahlung in Gegenstandswährung von {sender} auf {server} erhalten."
    - "Zahlung: {price}"
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."

  # Discord-DM, wenn ein COD-Paket eines Spielers zurückgesendet wurde.
  dm-returned-cod-package:
    - "↩️ Dein COD-Paket wurde von {sender} auf {server} zurückgesendet."
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."

  # Discord-DM, wenn ein Spieler Geldpost erhält.
  # Verwendet {amount}.
  dm-money-mail:
    - "💰 Du hast Geldpost von {sender} auf {server} erhalten."
    - "Betrag: {amount}"
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."

  # Discord-Kanalnachricht, wenn Admin-/API-Post an mehrere Empfänger zugestellt wird.
  # Diese Kanalnachricht verwendet immer discord-messages.default-language aus config.yml.
  # Von Spielern ausgewählte Discord-Nachrichtensprachen betreffen nur einzelne Discord-DMs.
  # Verwendet {mention}; optional {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Serverpost-Hinweis**"
    - "Serverpost wurde auf {server} an mehrere Spieler gesendet."
    - "Prüfe deinen Briefkasten, ein öffentliches Postfach oder einen Postamt-NPC im Spiel."
Español — es: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_es.yml
# Versión del formato del archivo. La usan los actualizadores de idioma futuros.
file-version: 3

# Prefijo usado para los mensajes de comandos de DiscBridge en el juego.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Mensajes generales de comandos.
general:
  no-permission: "{prefix}&cNo tienes permiso para usar este comando."
  players-only: "{prefix}&cSolo los jugadores pueden usar este comando."
  unknown-command: "{prefix}&cComando desconocido. Usa &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge recargado."

# Mensajes de estado del jugador.
status:
  header: "&bEstado de MailboxGUI-DiscBridge"
  notifications-enabled: "&7Notificaciones de correo por Discord: &aActivadas"
  notifications-disabled: "&7Notificaciones de correo por Discord: &cDesactivadas"
  online-dms-enabled: "&7DM de Discord estando en línea: &aActivados"
  online-dms-disabled: "&7DM de Discord estando en línea: &cDesactivados"
  admin-ignored: "&7DM de correo de admin/servidor: &cIgnorados"
  admin-not-ignored: "&7DM de correo de admin/servidor: &aPermitidos"

# Líneas de ayuda para comandos de jugadores y administradores.
commands:
  help:
    page-1:
      - "&bComandos de MailboxGUI-DiscBridge &7(Página {page}/{total})"
      - "&e/mbdiscord status &7- Ver tus ajustes de notificaciones de correo por Discord."
      - "&e/mbdiscord enable &7- Activar notificaciones de correo por Discord."
      - "&e/mbdiscord disable &7- Desactivar notificaciones de correo por Discord."
      - "&e/mbdiscord online on|off|toggle &7- Controlar los DM mientras estás en línea."
      - "&e/mbdiscord language <language> &7- Establece el idioma de tus MD de Discord."
      - "&e/mbdiscord ignore <player> &7- Ignorar DM de Discord de un remitente."
      - "&e/mbdiscord unignore <player> &7- Dejar de ignorar a un remitente."
      - "&e/mbdiscord ignorelist &7- Ver remitentes ignorados."
      - "&e/mbdiscord ignoreadmin &7- Ignorar DM de correo de admin/servidor."
      - "&e/mbdiscord unignoreadmin &7- Permitir DM de correo de admin/servidor."
    page-2:
      - "&bComandos de admin de MailboxGUI-DiscBridge &7(Página {page}/{total})"
      - "&e/mbdiscord admin status &7- Ver el estado administrativo del puente."
      - "&e/mbdiscord admin mode &7- Muestra diagnósticos de configuración LOCAL/NETWORK_NODE."
      - "&e/mbdiscord admin reload &7- Recargar configuración, idioma y datos de jugadores del puente."
      - "&e/mbdiscord admin updatecheck &7- Comprueba actualizaciones en el sistema de lanzamientos del sitio."
      - "&e/mbdiscord update &7- Prepara la actualización más reciente."
      - "&e/mbdiscord update confirm &7- Prepara la actualización para el próximo reinicio."
      - "&e/mbdiscord admin testdm <player> &7- Enviar un DM de Discord de diagnóstico."
      - "&e/mbdiscord admin testchannel &7- Enviar un aviso de canal de diagnóstico."
    footer: "&7Usa &e/mbdiscord help <page> &7para ver otra página."

# Mensajes de vinculación de DiscordSRV y ajustes de notificaciones.
discord:
  not-linked: "{prefix}&cTu cuenta de Minecraft aún no está vinculada con DiscordSRV. Si acabas de vincularla, espera unos segundos e intenta &e/mbdiscord enable &cotra vez."
  link-checking: "{prefix}&eComprobando tu estado de vinculación con DiscordSRV..."
  enabled: "{prefix}&aNotificaciones de correo por Discord activadas."
  disabled: "{prefix}&cNotificaciones de correo por Discord desactivadas."
  online-enabled: "{prefix}&aRecibirás DM de correo por Discord mientras estés en línea."
  online-disabled: "{prefix}&eSolo recibirás DM de correo por Discord mientras estés desconectado."

# Mensajes del comando de DM en línea.
online:
  usage: "{prefix}&cUso: &e/mbdiscord online <on|off|toggle>"

# Mensajes de la lista de remitentes ignorados.
ignore:
  usage-ignore: "{prefix}&cUso: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cUso: &e/mbdiscord unignore <player>"
  added: "{prefix}&aYa no recibirás DM de correo por Discord de &e{player}&a."
  removed: "{prefix}&aVolverás a recibir DM de correo por Discord de &e{player}&a."
  not-found: "{prefix}&cNo se encontró ningún jugador conocido llamado &e{player}&c."
  cannot-ignore-self: "{prefix}&cNo puedes ignorarte a ti mismo."
  empty: "{prefix}&7No estás ignorando a ningún remitente jugador."
  list-header: "&bRemitentes de correo de Discord ignorados"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7DM de correo de admin/servidor: &cIgnorados"
  list-admin-allowed: "&7DM de correo de admin/servidor: &aPermitidos"
  admin-enabled: "{prefix}&cAhora ignoras los DM individuales de correo de admin/servidor."
  admin-disabled: "{prefix}&aAhora permites los DM individuales de correo de admin/servidor."

# Mensajes de comandos de administrador y salida de diagnóstico.
admin:
  mode:
    local:
      - "&bDiagnóstico de modo de MailboxGUI-DiscBridge"
      - "&7Modo: &e{mode}"
      - "&7Hook de MailboxGUI: {mailboxgui}"
      - "&7Hook de DiscordSRV: {discordsrv}"
      - "&7Modo de red de MailboxGUI: {mailboxgui_network}"
      - "&7Nodo de notificación de red: {network_node}"
      - "&aConfiguración del modo LOCAL:"
      - "&7Instala MailboxGUI, DiscordSRV y MailboxGUI-DiscBridge en este servidor."
      - "&7Usa este modo para servidores independientes/de un solo backend."
    network-node:
      - "&bDiagnóstico de modo de MailboxGUI-DiscBridge"
      - "&7Modo: &e{mode}"
      - "&7Hook de MailboxGUI: {mailboxgui}"
      - "&7Hook de DiscordSRV: {discordsrv}"
      - "&7Modo de red de MailboxGUI: {mailboxgui_network}"
      - "&7Nodo de notificación de red: {network_node}"
      - "&aConfiguración de NETWORK_NODE:"
      - "&7Instala MailboxGUI en cada backend que use correo."
      - "&7Instala DiscordSRV y DiscBridge solo en este backend de notificaciones."
      - "&7Este backend escucha eventos de notificación de red de MailboxGUI."

  status:
    - "&bEstado administrativo de MailboxGUI-DiscBridge"
    - "&7Hook de MailboxGUI: {mailboxgui}"
    - "&7Hook de DiscordSRV: {discordsrv}"
    - "&7Mensajes directos: {direct_messages}"
    - "&7Canal de correo masivo: {mass_channel}"
    - "&7Mencionar a todos: {mention_everyone}"
    - "&7Preferencias de jugadores cargadas: &e{player_count}"
    - "&7DM individuales: &a{individual_delivered} entregados &8/ &e{individual_skipped} omitidos &8/ &c{individual_failed} fallidos"
    - "&7Avisos masivos: &a{mass_delivered} entregados &8/ &e{mass_skipped} omitidos &8/ &c{mass_failed} fallidos"
  test-dm-usage: "{prefix}&cUso: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cEl jugador &e{player}&c no está vinculado mediante DiscordSRV."
  test-dm-sent: "{prefix}&aDM de prueba enviado a &e{player}&a."
  test-dm-failed: "{prefix}&cNo se pudo enviar el DM de prueba a &e{player}&c. Revisa la consola para más detalles."
  test-channel-disabled: "{prefix}&cLos mensajes de canal de correo masivo de admin están desactivados en config.yml."
  test-channel-missing: "{prefix}&cFalta channel-id para el correo masivo de admin en config.yml."
  test-channel-sent: "{prefix}&aMensaje de prueba de canal enviado."
  test-channel-failed: "{prefix}&cNo se pudo enviar el mensaje de prueba al canal. Revisa la consola para más detalles."
Download Discord templates
disclanguage/messages_es.yml
# ============================================================
# Plantillas de mensajes de Discord de MailboxGUI-DiscBridge
# ============================================================
#
# Estos mensajes se envían a Discord, no al chat de Minecraft.
# Los códigos de color de Minecraft se eliminan de los valores de los marcadores antes de enviar los mensajes a Discord.
#
# Marcadores compatibles:
# {server}          Nombre visible del servidor desde server-name en config.yml.
# {sender}          Nombre visible del remitente.
# {recipient}       Nombre del destinatario, disponible para mensajes individuales.
# {price}           Texto del precio del paquete COD. Soporta dinero de Vault y moneda por objetos de MailboxGUI 5.1.0.
# {amount}          Cantidad de correo de dinero.
# {mention}         Solo se usa para admin-mass-mail-channel.
# {recipient_count} Número de destinatarios correctos para correo masivo.
#
# ============================================================

messages-version: 2

messages:

  # MD de Discord cuando un jugador recibe una carta clásica.
  dm-letter:
    - "📬 Has recibido una carta de {sender} en {server}."
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."

  # MD de Discord cuando un jugador recibe una carta tipo libro.
  dm-book-letter:
    - "📬 Has recibido una carta tipo libro de {sender} en {server}."
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."

  # MD de Discord cuando un jugador recibe un paquete.
  dm-package:
    - "📦 Has recibido un paquete de {sender} en {server}."
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."

  # MD de Discord cuando un jugador recibe un paquete de pago contra entrega.
  # Usa {price}. En MailboxGUI 5.1.0, {price} puede incluir dinero de Vault y moneda por objetos.
  dm-cod-package:
    - "📦 Has recibido un paquete COD de {sender} en {server}."
    - "Precio: {price}"
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."

  # MD de Discord cuando un jugador recibe un pago COD con moneda por objetos.
  # Usa {price}.
  dm-cod-item-currency-payment:
    - "💜 Has recibido un pago COD con moneda por objetos de {sender} en {server}."
    - "Pago: {price}"
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."

  # MD de Discord cuando se devuelve el paquete COD de un jugador.
  dm-returned-cod-package:
    - "↩️ Tu paquete COD fue devuelto por {sender} en {server}."
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."

  # MD de Discord cuando un jugador recibe correo de dinero.
  # Usa {amount}.
  dm-money-mail:
    - "💰 Has recibido correo de dinero de {sender} en {server}."
    - "Cantidad: {amount}"
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."

  # Mensaje de canal de Discord cuando se entrega correo de admin/API a varios destinatarios.
  # Este mensaje de canal siempre usa discord-messages.default-language de config.yml.
  # Los idiomas de mensajes de Discord elegidos por jugadores solo afectan los MD individuales de Discord.
  # Usa {mention}; opcionalmente usa {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Aviso de correo del servidor**"
    - "Se envió correo del servidor a varios jugadores en {server}."
    - "Revisa tu buzón, un buzón público de la oficina postal o un NPC de oficina postal dentro del juego."
Français — fr: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_fr.yml
# Version du format de fichier. Utilisée par les futurs outils de mise à jour linguistique.
file-version: 3

# Préfixe utilisé pour les messages de commandes DiscBridge en jeu.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Messages généraux des commandes.
general:
  no-permission: "{prefix}&cVous n’avez pas la permission d’utiliser cette commande."
  players-only: "{prefix}&cSeuls les joueurs peuvent utiliser cette commande."
  unknown-command: "{prefix}&cCommande inconnue. Utilisez &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge rechargé."

# Messages de statut du joueur.
status:
  header: "&bStatut de MailboxGUI-DiscBridge"
  notifications-enabled: "&7Notifications de courrier Discord : &aActivées"
  notifications-disabled: "&7Notifications de courrier Discord : &cDésactivées"
  online-dms-enabled: "&7DM Discord en ligne : &aActivés"
  online-dms-disabled: "&7DM Discord en ligne : &cDésactivés"
  admin-ignored: "&7DM de courrier admin/serveur : &cIgnorés"
  admin-not-ignored: "&7DM de courrier admin/serveur : &aAutorisés"

# Lignes d’aide pour les commandes joueur et administrateur.
commands:
  help:
    page-1:
      - "&bCommandes MailboxGUI-DiscBridge &7(Page {page}/{total})"
      - "&e/mbdiscord status &7- Affiche vos paramètres de notification Discord."
      - "&e/mbdiscord enable &7- Active les notifications de courrier Discord."
      - "&e/mbdiscord disable &7- Désactive les notifications de courrier Discord."
      - "&e/mbdiscord online on|off|toggle &7- Contrôle les DM quand vous êtes en ligne."
      - "&e/mbdiscord language <language> &7- Définir la langue de vos MP Discord."
      - "&e/mbdiscord ignore <player> &7- Ignore les DM Discord d’un expéditeur."
      - "&e/mbdiscord unignore <player> &7- N’ignore plus un expéditeur."
      - "&e/mbdiscord ignorelist &7- Affiche les expéditeurs ignorés."
      - "&e/mbdiscord ignoreadmin &7- Ignore les DM de courrier admin/serveur."
      - "&e/mbdiscord unignoreadmin &7- Autorise les DM de courrier admin/serveur."
    page-2:
      - "&bCommandes admin MailboxGUI-DiscBridge &7(Page {page}/{total})"
      - "&e/mbdiscord admin status &7- Affiche le statut administrateur du bridge."
      - "&e/mbdiscord admin mode &7- Affiche le diagnostic de configuration LOCAL/NETWORK_NODE."
      - "&e/mbdiscord admin reload &7- Recharge la config, la langue et les données joueur du bridge."
      - "&e/mbdiscord admin updatecheck &7- Recherche les mises à jour via le système de versions du site."
      - "&e/mbdiscord update &7- Prépare la dernière mise à jour."
      - "&e/mbdiscord update confirm &7- Prépare la mise à jour pour le prochain redémarrage."
      - "&e/mbdiscord admin testdm <player> &7- Envoie un DM Discord de diagnostic."
      - "&e/mbdiscord admin testchannel &7- Envoie une notification de canal de diagnostic."
    footer: "&7Utilisez &e/mbdiscord help <page> &7pour afficher une autre page."

# Messages de liaison DiscordSRV et de réglage des notifications.
discord:
  not-linked: "{prefix}&cVotre compte Minecraft n’est pas encore lié à DiscordSRV. Si vous venez de le lier, attendez quelques secondes puis réessayez &e/mbdiscord enable&c."
  link-checking: "{prefix}&eVérification de votre liaison DiscordSRV..."
  enabled: "{prefix}&aNotifications de courrier Discord activées."
  disabled: "{prefix}&cNotifications de courrier Discord désactivées."
  online-enabled: "{prefix}&aVous recevrez des DM de courrier Discord même en ligne."
  online-disabled: "{prefix}&eVous recevrez des DM de courrier Discord uniquement hors ligne."

# Messages de la commande de DM en ligne.
online:
  usage: "{prefix}&cUtilisation : &e/mbdiscord online <on|off|toggle>"

# Messages de la liste des expéditeurs ignorés.
ignore:
  usage-ignore: "{prefix}&cUtilisation : &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cUtilisation : &e/mbdiscord unignore <player>"
  added: "{prefix}&aVous ne recevrez plus de DM de courrier Discord de &e{player}&a."
  removed: "{prefix}&aVous recevrez de nouveau des DM de courrier Discord de &e{player}&a."
  not-found: "{prefix}&cAucun joueur connu nommé &e{player}&c n’a été trouvé."
  cannot-ignore-self: "{prefix}&cVous ne pouvez pas vous ignorer vous-même."
  empty: "{prefix}&7Vous n’ignorez aucun expéditeur joueur."
  list-header: "&bExpéditeurs de courrier Discord ignorés"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7DM de courrier admin/serveur : &cIgnorés"
  list-admin-allowed: "&7DM de courrier admin/serveur : &aAutorisés"
  admin-enabled: "{prefix}&cVous ignorez maintenant les DM individuels de courrier admin/serveur."
  admin-disabled: "{prefix}&aVous autorisez maintenant les DM individuels de courrier admin/serveur."

# Messages de commandes administrateur et sortie de diagnostic.
admin:
  mode:
    local:
      - "&bDiagnostic du mode MailboxGUI-DiscBridge"
      - "&7Mode : &e{mode}"
      - "&7Hook MailboxGUI : {mailboxgui}"
      - "&7Hook DiscordSRV : {discordsrv}"
      - "&7Mode réseau MailboxGUI : {mailboxgui_network}"
      - "&7Nœud de notification réseau : {network_node}"
      - "&aConfiguration du mode LOCAL :"
      - "&7Installez MailboxGUI, DiscordSRV et MailboxGUI-DiscBridge sur ce serveur."
      - "&7Utilisez ce mode pour les serveurs autonomes/à backend unique."
    network-node:
      - "&bDiagnostic du mode MailboxGUI-DiscBridge"
      - "&7Mode : &e{mode}"
      - "&7Hook MailboxGUI : {mailboxgui}"
      - "&7Hook DiscordSRV : {discordsrv}"
      - "&7Mode réseau MailboxGUI : {mailboxgui_network}"
      - "&7Nœud de notification réseau : {network_node}"
      - "&aConfiguration NETWORK_NODE :"
      - "&7Installez MailboxGUI sur chaque backend qui utilise le courrier."
      - "&7Installez DiscordSRV et DiscBridge uniquement sur ce backend de notification."
      - "&7Ce backend écoute les événements de notification réseau de MailboxGUI."

  status:
    - "&bStatut administrateur de MailboxGUI-DiscBridge"
    - "&7Hook MailboxGUI : {mailboxgui}"
    - "&7Hook DiscordSRV : {discordsrv}"
    - "&7Messages directs : {direct_messages}"
    - "&7Canal de courrier de masse : {mass_channel}"
    - "&7Mentionner tout le monde : {mention_everyone}"
    - "&7Préférences joueur chargées : &e{player_count}"
    - "&7DM individuels : &a{individual_delivered} livrés &8/ &e{individual_skipped} ignorés &8/ &c{individual_failed} échoués"
    - "&7Notifications de masse : &a{mass_delivered} livrées &8/ &e{mass_skipped} ignorées &8/ &c{mass_failed} échouées"
  test-dm-usage: "{prefix}&cUtilisation : &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cLe joueur &e{player}&c n’est pas lié via DiscordSRV."
  test-dm-sent: "{prefix}&aDM de test envoyé à &e{player}&a."
  test-dm-failed: "{prefix}&cImpossible d’envoyer le DM de test à &e{player}&c. Consultez la console pour les détails."
  test-channel-disabled: "{prefix}&cLes messages de canal de courrier de masse admin sont désactivés dans config.yml."
  test-channel-missing: "{prefix}&cLe channel-id du courrier de masse admin est manquant dans config.yml."
  test-channel-sent: "{prefix}&aMessage de test envoyé au canal."
  test-channel-failed: "{prefix}&cImpossible d’envoyer le message de test au canal. Consultez la console pour les détails."
Download Discord templates
disclanguage/messages_fr.yml
# ============================================================
# Modèles de messages Discord de MailboxGUI-DiscBridge
# ============================================================
#
# Ces messages sont envoyés sur Discord, pas dans le chat Minecraft.
# Les codes couleur Minecraft sont retirés des valeurs des espaces réservés avant l'envoi des messages Discord.
#
# Espaces réservés pris en charge :
# {server}          Nom d'affichage du serveur depuis server-name dans config.yml.
# {sender}          Nom d'affichage de l'expéditeur.
# {recipient}       Nom du destinataire, disponible pour les messages individuels.
# {price}           Texte du prix du colis COD. Prend en charge l'argent Vault et les monnaies d'objets de MailboxGUI 5.1.0.
# {amount}          Montant du courrier d'argent.
# {mention}         Utilisé uniquement pour admin-mass-mail-channel.
# {recipient_count} Nombre de destinataires ayant reçu le courrier de masse.
#
# ============================================================

messages-version: 2

messages:

  # MP Discord envoyé lorsqu'un joueur reçoit une lettre classique.
  dm-letter:
    - "📬 Vous avez reçu une lettre de {sender} sur {server}."
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."

  # MP Discord envoyé lorsqu'un joueur reçoit une lettre-livre.
  dm-book-letter:
    - "📬 Vous avez reçu une lettre-livre de {sender} sur {server}."
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."

  # MP Discord envoyé lorsqu'un joueur reçoit un colis.
  dm-package:
    - "📦 Vous avez reçu un colis de {sender} sur {server}."
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."

  # MP Discord envoyé lorsqu'un joueur reçoit un colis COD.
  # Utilise {price}. Dans MailboxGUI 5.1.0, {price} peut inclure de l'argent Vault et des monnaies d'objets.
  dm-cod-package:
    - "📦 Vous avez reçu un colis COD de {sender} sur {server}."
    - "Prix : {price}"
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."

  # MP Discord envoyé lorsqu'un joueur reçoit un paiement COD en monnaie d'objets.
  # Utilise {price}.
  dm-cod-item-currency-payment:
    - "💜 Vous avez reçu un paiement COD en monnaie d'objets de {sender} sur {server}."
    - "Paiement : {price}"
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."

  # MP Discord envoyé lorsque le colis COD d'un joueur est retourné.
  dm-returned-cod-package:
    - "↩️ Votre colis COD a été retourné par {sender} sur {server}."
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."

  # MP Discord envoyé lorsqu'un joueur reçoit du courrier d'argent.
  # Utilise {amount}.
  dm-money-mail:
    - "💰 Vous avez reçu du courrier d'argent de {sender} sur {server}."
    - "Montant : {amount}"
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."

  # Message de salon Discord envoyé lorsqu'un courrier admin/API est livré à plusieurs destinataires.
  # Ce message de salon utilise toujours discord-messages.default-language depuis config.yml.
  # Les langues de messages Discord choisies par les joueurs ne concernent que les MP Discord individuels.
  # Utilise {mention}; utilise éventuellement {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Avis de courrier du serveur**"
    - "Un courrier du serveur a été envoyé à plusieurs joueurs sur {server}."
    - "Consultez votre boîte aux lettres, une boîte postale publique ou un PNJ de bureau de poste en jeu."
Italiano — it: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_it.yml
# Versione del formato del file. Usata dai futuri aggiornatori della lingua.
file-version: 3

# Prefisso usato per i messaggi dei comandi DiscBridge in gioco.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Messaggi generali dei comandi.
general:
  no-permission: "{prefix}&cNon hai il permesso di usare questo comando."
  players-only: "{prefix}&cSolo i giocatori possono usare questo comando."
  unknown-command: "{prefix}&cComando sconosciuto. Usa &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge ricaricato."

# Messaggi di stato del giocatore.
status:
  header: "&bStato di MailboxGUI-DiscBridge"
  notifications-enabled: "&7Notifiche mail Discord: &aAttivate"
  notifications-disabled: "&7Notifiche mail Discord: &cDisattivate"
  online-dms-enabled: "&7DM Discord mentre online: &aAttivati"
  online-dms-disabled: "&7DM Discord mentre online: &cDisattivati"
  admin-ignored: "&7DM mail admin/server: &cIgnorati"
  admin-not-ignored: "&7DM mail admin/server: &aConsentiti"

# Righe di aiuto per comandi giocatore e amministratore.
commands:
  help:
    page-1:
      - "&bComandi MailboxGUI-DiscBridge &7(Pagina {page}/{total})"
      - "&e/mbdiscord status &7- Mostra le impostazioni delle notifiche mail Discord."
      - "&e/mbdiscord enable &7- Attiva le notifiche mail Discord."
      - "&e/mbdiscord disable &7- Disattiva le notifiche mail Discord."
      - "&e/mbdiscord online on|off|toggle &7- Controlla i DM mentre sei online."
      - "&e/mbdiscord language <language> &7- Imposta la lingua dei tuoi DM Discord."
      - "&e/mbdiscord ignore <player> &7- Ignora i DM Discord da un mittente."
      - "&e/mbdiscord unignore <player> &7- Smetti di ignorare un mittente."
      - "&e/mbdiscord ignorelist &7- Mostra i mittenti ignorati."
      - "&e/mbdiscord ignoreadmin &7- Ignora i DM mail admin/server."
      - "&e/mbdiscord unignoreadmin &7- Consenti i DM mail admin/server."
    page-2:
      - "&bComandi admin MailboxGUI-DiscBridge &7(Pagina {page}/{total})"
      - "&e/mbdiscord admin status &7- Mostra lo stato admin del bridge."
      - "&e/mbdiscord admin mode &7- Mostra la diagnostica LOCAL/NETWORK_NODE."
      - "&e/mbdiscord admin reload &7- Ricarica config, lingua e dati giocatore del bridge."
      - "&e/mbdiscord admin updatecheck &7- Controlla gli aggiornamenti nel sistema release del sito."
      - "&e/mbdiscord update &7- Prepara l’ultimo aggiornamento."
      - "&e/mbdiscord update confirm &7- Prepara l’aggiornamento per il prossimo riavvio."
      - "&e/mbdiscord admin testdm <player> &7- Invia un DM Discord diagnostico."
      - "&e/mbdiscord admin testchannel &7- Invia un avviso canale diagnostico."
    footer: "&7Usa &e/mbdiscord help <page> &7per vedere un’altra pagina."

# Messaggi di collegamento DiscordSRV e impostazioni notifiche.
discord:
  not-linked: "{prefix}&cIl tuo account Minecraft non è ancora collegato a DiscordSRV. Se lo hai appena collegato, attendi qualche secondo e riprova &e/mbdiscord enable&c."
  link-checking: "{prefix}&eControllo dello stato del collegamento DiscordSRV..."
  enabled: "{prefix}&aNotifiche mail Discord attivate."
  disabled: "{prefix}&cNotifiche mail Discord disattivate."
  online-enabled: "{prefix}&aRiceverai DM mail Discord mentre sei online."
  online-disabled: "{prefix}&eRiceverai DM mail Discord solo quando sei offline."

# Messaggi del comando DM online.
online:
  usage: "{prefix}&cUso: &e/mbdiscord online <on|off|toggle>"

# Messaggi della lista dei mittenti ignorati.
ignore:
  usage-ignore: "{prefix}&cUso: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cUso: &e/mbdiscord unignore <player>"
  added: "{prefix}&aNon riceverai più DM mail Discord da &e{player}&a."
  removed: "{prefix}&aRiceverai di nuovo DM mail Discord da &e{player}&a."
  not-found: "{prefix}&cNessun giocatore conosciuto chiamato &e{player}&c trovato."
  cannot-ignore-self: "{prefix}&cNon puoi ignorare te stesso."
  empty: "{prefix}&7Non stai ignorando alcun mittente giocatore."
  list-header: "&bMittenti mail Discord ignorati"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7DM mail admin/server: &cIgnorati"
  list-admin-allowed: "&7DM mail admin/server: &aConsentiti"
  admin-enabled: "{prefix}&cOra ignori i DM individuali di mail admin/server."
  admin-disabled: "{prefix}&aOra consenti i DM individuali di mail admin/server."

# Messaggi dei comandi amministratore e output diagnostico.
admin:
  mode:
    local:
      - "&bDiagnostica modalità MailboxGUI-DiscBridge"
      - "&7Modalità: &e{mode}"
      - "&7Hook MailboxGUI: {mailboxgui}"
      - "&7Hook DiscordSRV: {discordsrv}"
      - "&7Modalità rete MailboxGUI: {mailboxgui_network}"
      - "&7Nodo notifiche di rete: {network_node}"
      - "&aConfigurazione modalità LOCAL:"
      - "&7Installa MailboxGUI, DiscordSRV e MailboxGUI-DiscBridge su questo server."
      - "&7Usa questa modalità per server standalone/a singolo backend."
    network-node:
      - "&bDiagnostica modalità MailboxGUI-DiscBridge"
      - "&7Modalità: &e{mode}"
      - "&7Hook MailboxGUI: {mailboxgui}"
      - "&7Hook DiscordSRV: {discordsrv}"
      - "&7Modalità rete MailboxGUI: {mailboxgui_network}"
      - "&7Nodo notifiche di rete: {network_node}"
      - "&aConfigurazione NETWORK_NODE:"
      - "&7Installa MailboxGUI su ogni backend che usa la posta."
      - "&7Installa DiscordSRV e DiscBridge solo su questo backend di notifica."
      - "&7Questo backend ascolta gli eventi di notifica di rete di MailboxGUI."

  status:
    - "&bStato admin MailboxGUI-DiscBridge"
    - "&7Hook MailboxGUI: {mailboxgui}"
    - "&7Hook DiscordSRV: {discordsrv}"
    - "&7Messaggi diretti: {direct_messages}"
    - "&7Canale mail di massa: {mass_channel}"
    - "&7Menziona tutti: {mention_everyone}"
    - "&7Preferenze giocatore caricate: &e{player_count}"
    - "&7DM individuali: &a{individual_delivered} consegnati &8/ &e{individual_skipped} saltati &8/ &c{individual_failed} falliti"
    - "&7Avvisi di massa: &a{mass_delivered} consegnati &8/ &e{mass_skipped} saltati &8/ &c{mass_failed} falliti"
  test-dm-usage: "{prefix}&cUso: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cIl giocatore &e{player}&c non è collegato tramite DiscordSRV."
  test-dm-sent: "{prefix}&aDM di test inviato a &e{player}&a."
  test-dm-failed: "{prefix}&cImpossibile inviare il DM di test a &e{player}&c. Controlla la console per i dettagli."
  test-channel-disabled: "{prefix}&cI messaggi canale della mail di massa admin sono disattivati in config.yml."
  test-channel-missing: "{prefix}&cManca il channel-id della mail di massa admin in config.yml."
  test-channel-sent: "{prefix}&aMessaggio di test del canale inviato."
  test-channel-failed: "{prefix}&cImpossibile inviare il messaggio di test al canale. Controlla la console per i dettagli."
Download Discord templates
disclanguage/messages_it.yml
# ============================================================
# Modelli dei messaggi Discord di MailboxGUI-DiscBridge
# ============================================================
#
# Questi messaggi vengono inviati su Discord, non nella chat di Minecraft.
# I codici colore di Minecraft vengono rimossi dai valori dei segnaposto prima dell'invio dei messaggi Discord.
#
# Segnaposto supportati:
# {server}          Nome visualizzato del server da server-name in config.yml.
# {sender}          Nome visualizzato del mittente.
# {recipient}       Nome del destinatario, disponibile per i messaggi individuali.
# {price}           Testo del prezzo del pacco COD. Supporta denaro Vault e valuta oggetti da MailboxGUI 5.1.0.
# {amount}          Importo della posta di denaro.
# {mention}         Usato solo per admin-mass-mail-channel.
# {recipient_count} Numero di destinatari riusciti per la posta di massa.
#
# ============================================================

messages-version: 2

messages:

  # DM Discord inviato quando un giocatore riceve una lettera classica.
  dm-letter:
    - "📬 Hai ricevuto una lettera da {sender} su {server}."
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."

  # DM Discord inviato quando un giocatore riceve una lettera libro.
  dm-book-letter:
    - "📬 Hai ricevuto una lettera libro da {sender} su {server}."
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."

  # DM Discord inviato quando un giocatore riceve un pacco.
  dm-package:
    - "📦 Hai ricevuto un pacco da {sender} su {server}."
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."

  # DM Discord inviato quando un giocatore riceve un pacco COD.
  # Usa {price}. In MailboxGUI 5.1.0, {price} può includere denaro Vault e valuta oggetti.
  dm-cod-package:
    - "📦 Hai ricevuto un pacco COD da {sender} su {server}."
    - "Prezzo: {price}"
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."

  # DM Discord inviato quando un giocatore riceve un pagamento COD in valuta oggetti.
  # Usa {price}.
  dm-cod-item-currency-payment:
    - "💜 Hai ricevuto un pagamento COD in valuta oggetti da {sender} su {server}."
    - "Pagamento: {price}"
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."

  # DM Discord inviato quando il pacco COD di un giocatore viene restituito.
  dm-returned-cod-package:
    - "↩️ Il tuo pacco COD è stato restituito da {sender} su {server}."
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."

  # DM Discord inviato quando un giocatore riceve posta di denaro.
  # Usa {amount}.
  dm-money-mail:
    - "💰 Hai ricevuto posta di denaro da {sender} su {server}."
    - "Importo: {amount}"
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."

  # Messaggio di canale Discord inviato quando una posta admin/API viene consegnata a più destinatari.
  # Questo messaggio di canale usa sempre discord-messages.default-language da config.yml.
  # Le lingue dei messaggi Discord scelte dai giocatori influiscono solo sui DM Discord individuali.
  # Usa {mention}; facoltativamente usa {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Avviso posta del server**"
    - "La posta del server è stata inviata a più giocatori su {server}."
    - "Controlla la tua cassetta postale, una casella postale pubblica o un NPC dell'ufficio postale in gioco."
日本語 — ja: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_ja.yml
# ファイル形式のバージョンです。今後の言語アップデーターで使用されます。
file-version: 3

# ゲーム内のDiscBridgeコマンドメッセージに使用される接頭辞です。
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# 一般的なコマンドメッセージです。
general:
  no-permission: "{prefix}&cこのコマンドを使用する権限がありません。"
  players-only: "{prefix}&cこのコマンドはプレイヤーのみ使用できます。"
  unknown-command: "{prefix}&c不明なコマンドです。&e/mbdiscord help &cを使用してください。"
  reload-complete: "{prefix}&aMailboxGUI-DiscBridgeを再読み込みしました。"

# プレイヤーの状態メッセージです。
status:
  header: "&bMailboxGUI-DiscBridge ステータス"
  notifications-enabled: "&7Discordメール通知: &a有効"
  notifications-disabled: "&7Discordメール通知: &c無効"
  online-dms-enabled: "&7オンライン中のDiscord DM: &a有効"
  online-dms-disabled: "&7オンライン中のDiscord DM: &c無効"
  admin-ignored: "&7管理者/サーバーメールDM: &c無視"
  admin-not-ignored: "&7管理者/サーバーメールDM: &a許可"

# プレイヤーおよび管理者コマンドのヘルプ行です。
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge コマンド &7(ページ {page}/{total})"
      - "&e/mbdiscord status &7- Discordメール通知設定を表示します。"
      - "&e/mbdiscord enable &7- Discordメール通知を有効にします。"
      - "&e/mbdiscord disable &7- Discordメール通知を無効にします。"
      - "&e/mbdiscord online on|off|toggle &7- オンライン中のDMを制御します。"
      - "&e/mbdiscord language <language> &7- Discord DM メッセージの言語を設定します。"
      - "&e/mbdiscord ignore <player> &7- 送信者からのDiscord DMを無視します。"
      - "&e/mbdiscord unignore <player> &7- 送信者の無視を解除します。"
      - "&e/mbdiscord ignorelist &7- 無視中の送信者を表示します。"
      - "&e/mbdiscord ignoreadmin &7- 管理者/サーバーメールDMを無視します。"
      - "&e/mbdiscord unignoreadmin &7- 管理者/サーバーメールDMを許可します。"
    page-2:
      - "&bMailboxGUI-DiscBridge 管理者コマンド &7(ページ {page}/{total})"
      - "&e/mbdiscord admin status &7- ブリッジの管理者ステータスを表示します。"
      - "&e/mbdiscord admin mode &7- LOCAL/NETWORK_NODE 設定診断を表示します。"
      - "&e/mbdiscord admin reload &7- ブリッジの設定、言語、プレイヤーデータを再読み込みします。"
      - "&e/mbdiscord admin updatecheck &7- Webサイトのリリースシステムで更新を確認します。"
      - "&e/mbdiscord update &7- 最新アップデートを準備します。"
      - "&e/mbdiscord update confirm &7- 次回再起動用に準備済みアップデートをステージします。"
      - "&e/mbdiscord admin testdm <player> &7- 診断用Discord DMを送信します。"
      - "&e/mbdiscord admin testchannel &7- 診断用チャンネル通知を送信します。"
    footer: "&7別のページを表示するには &e/mbdiscord help <page> &7を使用してください。"

# DiscordSRVの連携と通知設定のメッセージです。
discord:
  not-linked: "{prefix}&cあなたのMinecraftアカウントはまだDiscordSRVに連携されていません。連携したばかりの場合は数秒待ってから &e/mbdiscord enable &cを再実行してください。"
  link-checking: "{prefix}&eDiscordSRV連携状態を確認しています..."
  enabled: "{prefix}&aDiscordメール通知を有効にしました。"
  disabled: "{prefix}&cDiscordメール通知を無効にしました。"
  online-enabled: "{prefix}&aオンライン中もDiscordメールDMを受け取ります。"
  online-disabled: "{prefix}&eオフライン中のみDiscordメールDMを受け取ります。"

# オンラインDMコマンドのメッセージです。
online:
  usage: "{prefix}&c使い方: &e/mbdiscord online <on|off|toggle>"

# プレイヤー送信者の無視リスト用メッセージです。
ignore:
  usage-ignore: "{prefix}&c使い方: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&c使い方: &e/mbdiscord unignore <player>"
  added: "{prefix}&a&e{player}&a からのDiscordメールDMを受け取らないようにしました。"
  removed: "{prefix}&a&e{player}&a からのDiscordメールDMを再び受け取ります。"
  not-found: "{prefix}&c&e{player}&c という既知のプレイヤーが見つかりません。"
  cannot-ignore-self: "{prefix}&c自分自身は無視できません。"
  empty: "{prefix}&7無視しているプレイヤー送信者はいません。"
  list-header: "&b無視中のDiscordメール送信者"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7管理者/サーバーメールDM: &c無視"
  list-admin-allowed: "&7管理者/サーバーメールDM: &a許可"
  admin-enabled: "{prefix}&c個別の管理者/サーバーメールDMを無視するようにしました。"
  admin-disabled: "{prefix}&a個別の管理者/サーバーメールDMを許可するようにしました。"

# 管理者コマンドメッセージと診断出力です。
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge モード診断"
      - "&7モード: &e{mode}"
      - "&7MailboxGUI フック: {mailboxgui}"
      - "&7DiscordSRV フック: {discordsrv}"
      - "&7MailboxGUI ネットワークモード: {mailboxgui_network}"
      - "&7ネットワーク通知ノード: {network_node}"
      - "&aLOCAL モード設定:"
      - "&7このサーバーに MailboxGUI、DiscordSRV、MailboxGUI-DiscBridge をインストールします。"
      - "&7単体/単一バックエンドサーバーではこのモードを使用します。"
    network-node:
      - "&bMailboxGUI-DiscBridge モード診断"
      - "&7モード: &e{mode}"
      - "&7MailboxGUI フック: {mailboxgui}"
      - "&7DiscordSRV フック: {discordsrv}"
      - "&7MailboxGUI ネットワークモード: {mailboxgui_network}"
      - "&7ネットワーク通知ノード: {network_node}"
      - "&aNETWORK_NODE 設定:"
      - "&7メールを使用するすべてのバックエンドに MailboxGUI をインストールします。"
      - "&7DiscordSRV と DiscBridge はこの通知バックエンドにのみインストールします。"
      - "&7このバックエンドは MailboxGUI のネットワーク通知イベントを監視します。"

  status:
    - "&bMailboxGUI-DiscBridge 管理者ステータス"
    - "&7MailboxGUIフック: {mailboxgui}"
    - "&7DiscordSRVフック: {discordsrv}"
    - "&7ダイレクトメッセージ: {direct_messages}"
    - "&7一括メールチャンネル: {mass_channel}"
    - "&7全員にメンション: {mention_everyone}"
    - "&7読み込み済みプレイヤー設定: &e{player_count}"
    - "&7個別DM: &a{individual_delivered} 送信済み &8/ &e{individual_skipped} スキップ &8/ &c{individual_failed} 失敗"
    - "&7一括通知: &a{mass_delivered} 送信済み &8/ &e{mass_skipped} スキップ &8/ &c{mass_failed} 失敗"
  test-dm-usage: "{prefix}&c使い方: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cプレイヤー &e{player}&c はDiscordSRVに連携されていません。"
  test-dm-sent: "{prefix}&aテストDMを &e{player}&a に送信しました。"
  test-dm-failed: "{prefix}&c&e{player}&c へのテストDM送信に失敗しました。詳細はコンソールを確認してください。"
  test-channel-disabled: "{prefix}&c管理者一括メールのチャンネルメッセージはconfig.ymlで無効です。"
  test-channel-missing: "{prefix}&cconfig.ymlに管理者一括メールのchannel-idがありません。"
  test-channel-sent: "{prefix}&aテストチャンネルメッセージを送信しました。"
  test-channel-failed: "{prefix}&cテストチャンネルメッセージの送信に失敗しました。詳細はコンソールを確認してください。"
Download Discord templates
disclanguage/messages_ja.yml
# ============================================================
# MailboxGUI-DiscBridge Discord メッセージテンプレート
# ============================================================
#
# これらのメッセージは Minecraft チャットではなく Discord に送信されます。
# Discord メッセージを送信する前に、プレースホルダー値から Minecraft のカラーコードが削除されます。
#
# 使用できるプレースホルダー:
# {server}          config.yml の server-name から取得したサーバー表示名。
# {sender}          送信者の表示名。
# {recipient}       受信者名。個別メッセージで使用できます。
# {price}           COD パッケージの価格テキスト。MailboxGUI 5.1.0 の Vault 通貨とアイテム通貨に対応します。
# {amount}          お金メールの金額。
# {mention}         admin-mass-mail-channel でのみ使用されます。
# {recipient_count} 一斉メールで正常に送信された受信者数。
#
# ============================================================

messages-version: 2

messages:

  # プレイヤーが通常の手紙を受け取ったときに送信される Discord DM。
  dm-letter:
    - "📬 {server} で {sender} から手紙を受け取りました。"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"

  # プレイヤーがブックレターを受け取ったときに送信される Discord DM。
  dm-book-letter:
    - "📬 {server} で {sender} からブックレターを受け取りました。"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"

  # プレイヤーがパッケージを受け取ったときに送信される Discord DM。
  dm-package:
    - "📦 {server} で {sender} からパッケージを受け取りました。"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"

  # プレイヤーが代引きパッケージを受け取ったときに送信される Discord DM。
  # {price} を使用します。MailboxGUI 5.1.0 では、{price} に Vault 通貨とアイテム通貨を含めることができます。
  dm-cod-package:
    - "📦 {server} で {sender} から COD パッケージを受け取りました。"
    - "価格: {price}"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"

  # プレイヤーがアイテム通貨の COD 支払いメールを受け取ったときに送信される Discord DM。
  # {price} を使用します。
  dm-cod-item-currency-payment:
    - "💜 {server} で {sender} からアイテム通貨の COD 支払いを受け取りました。"
    - "支払い: {price}"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"

  # プレイヤーの COD パッケージが返送されたときに送信される Discord DM。
  dm-returned-cod-package:
    - "↩️ {server} であなたの COD パッケージが {sender} によって返送されました。"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"

  # プレイヤーがお金メールを受け取ったときに送信される Discord DM。
  # {amount} を使用します。
  dm-money-mail:
    - "💰 {server} で {sender} からお金メールを受け取りました。"
    - "金額: {amount}"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"

  # 管理者/API メールが複数の受信者に配信されたときに送信される Discord チャンネルメッセージ。
  # このチャンネルメッセージは常に config.yml の discord-messages.default-language を使用します。
  # プレイヤーが選択した Discord メッセージ言語は、個別の Discord DM のみに適用されます。
  # {mention} を使用します。任意で {recipient_count} も使用できます。
  admin-mass-mail-channel:
    - "{mention} 📬 **サーバーメール通知**"
    - "{server} で複数のプレイヤーにサーバーメールが送信されました。"
    - "ゲーム内のメールボックス、公共の郵便箱、または郵便局 NPC を確認してください。"
한국어 — ko: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_ko.yml
# 파일 형식 버전입니다. 향후 언어 업데이트에서 사용됩니다.
file-version: 3

# 게임 내 DiscBridge 명령어 메시지에 사용되는 접두사입니다.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# 일반 명령어 메시지입니다.
general:
  no-permission: "{prefix}&c이 명령어를 사용할 권한이 없습니다."
  players-only: "{prefix}&c플레이어만 이 명령어를 사용할 수 있습니다."
  unknown-command: "{prefix}&c알 수 없는 명령어입니다. &e/mbdiscord help&c 를 사용하세요."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge를 다시 불러왔습니다."

# 플레이어 상태 메시지입니다.
status:
  header: "&bMailboxGUI-DiscBridge 상태"
  notifications-enabled: "&7Discord 메일 알림: &a활성화"
  notifications-disabled: "&7Discord 메일 알림: &c비활성화"
  online-dms-enabled: "&7온라인 중 Discord DM: &a활성화"
  online-dms-disabled: "&7온라인 중 Discord DM: &c비활성화"
  admin-ignored: "&7관리자/서버 메일 DM: &c무시됨"
  admin-not-ignored: "&7관리자/서버 메일 DM: &a허용됨"

# 플레이어 및 관리자 명령어 도움말 줄입니다.
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge 명령어 &7(페이지 {page}/{total})"
      - "&e/mbdiscord status &7- Discord 메일 알림 설정을 봅니다."
      - "&e/mbdiscord enable &7- Discord 메일 알림을 활성화합니다."
      - "&e/mbdiscord disable &7- Discord 메일 알림을 비활성화합니다."
      - "&e/mbdiscord online on|off|toggle &7- 온라인 중 DM을 제어합니다."
      - "&e/mbdiscord language <language> &7- Discord DM 메시지 언어를 설정합니다."
      - "&e/mbdiscord ignore <player> &7- 해당 발신자의 Discord DM을 무시합니다."
      - "&e/mbdiscord unignore <player> &7- 발신자 무시를 해제합니다."
      - "&e/mbdiscord ignorelist &7- 무시 중인 발신자를 봅니다."
      - "&e/mbdiscord ignoreadmin &7- 관리자/서버 메일 DM을 무시합니다."
      - "&e/mbdiscord unignoreadmin &7- 관리자/서버 메일 DM을 허용합니다."
    page-2:
      - "&bMailboxGUI-DiscBridge 관리자 명령어 &7(페이지 {page}/{total})"
      - "&e/mbdiscord admin status &7- 브리지 관리자 상태를 봅니다."
      - "&e/mbdiscord admin mode &7- LOCAL/NETWORK_NODE 설정 진단을 표시합니다."
      - "&e/mbdiscord admin reload &7- 브리지 설정, 언어, 플레이어 데이터를 다시 불러옵니다."
      - "&e/mbdiscord admin updatecheck &7- 웹사이트 릴리스 시스템에서 업데이트를 확인합니다."
      - "&e/mbdiscord update &7- 최신 업데이트를 준비합니다."
      - "&e/mbdiscord update confirm &7- 다음 재시작을 위해 준비된 업데이트를 스테이징합니다."
      - "&e/mbdiscord admin testdm <player> &7- 진단용 Discord DM을 보냅니다."
      - "&e/mbdiscord admin testchannel &7- 진단용 채널 알림을 보냅니다."
    footer: "&7다른 페이지를 보려면 &e/mbdiscord help <page> &7를 사용하세요."

# DiscordSRV 연결 및 알림 설정 메시지입니다.
discord:
  not-linked: "{prefix}&cMinecraft 계정이 아직 DiscordSRV에 연결되지 않았습니다. 방금 연결했다면 몇 초 기다린 뒤 &e/mbdiscord enable &c을 다시 시도하세요."
  link-checking: "{prefix}&eDiscordSRV 연결 상태를 확인하는 중..."
  enabled: "{prefix}&aDiscord 메일 알림이 활성화되었습니다."
  disabled: "{prefix}&cDiscord 메일 알림이 비활성화되었습니다."
  online-enabled: "{prefix}&a온라인 중에도 Discord 메일 DM을 받습니다."
  online-disabled: "{prefix}&e오프라인일 때만 Discord 메일 DM을 받습니다."

# 온라인 DM 명령어 메시지입니다.
online:
  usage: "{prefix}&c사용법: &e/mbdiscord online <on|off|toggle>"

# 플레이어 발신자 무시 목록 명령어 메시지입니다.
ignore:
  usage-ignore: "{prefix}&c사용법: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&c사용법: &e/mbdiscord unignore <player>"
  added: "{prefix}&a이제 &e{player}&a 님의 Discord 메일 DM을 받지 않습니다."
  removed: "{prefix}&a이제 다시 &e{player}&a 님의 Discord 메일 DM을 받습니다."
  not-found: "{prefix}&c&e{player}&c 이름의 알려진 플레이어를 찾을 수 없습니다."
  cannot-ignore-self: "{prefix}&c자기 자신은 무시할 수 없습니다."
  empty: "{prefix}&7무시 중인 플레이어 발신자가 없습니다."
  list-header: "&b무시 중인 Discord 메일 발신자"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7관리자/서버 메일 DM: &c무시됨"
  list-admin-allowed: "&7관리자/서버 메일 DM: &a허용됨"
  admin-enabled: "{prefix}&c개별 관리자/서버 메일 DM을 무시합니다."
  admin-disabled: "{prefix}&a개별 관리자/서버 메일 DM을 허용합니다."

# 관리자 명령어 메시지 및 진단 출력입니다.
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge 모드 진단"
      - "&7모드: &e{mode}"
      - "&7MailboxGUI 후크: {mailboxgui}"
      - "&7DiscordSRV 후크: {discordsrv}"
      - "&7MailboxGUI 네트워크 모드: {mailboxgui_network}"
      - "&7네트워크 알림 노드: {network_node}"
      - "&aLOCAL 모드 설정:"
      - "&7이 서버에 MailboxGUI, DiscordSRV, MailboxGUI-DiscBridge를 설치하세요."
      - "&7독립/단일 백엔드 서버에는 이 모드를 사용하세요."
    network-node:
      - "&bMailboxGUI-DiscBridge 모드 진단"
      - "&7모드: &e{mode}"
      - "&7MailboxGUI 후크: {mailboxgui}"
      - "&7DiscordSRV 후크: {discordsrv}"
      - "&7MailboxGUI 네트워크 모드: {mailboxgui_network}"
      - "&7네트워크 알림 노드: {network_node}"
      - "&aNETWORK_NODE 설정:"
      - "&7메일을 사용하는 모든 백엔드에 MailboxGUI를 설치하세요."
      - "&7DiscordSRV와 DiscBridge는 이 알림 백엔드에만 설치하세요."
      - "&7이 백엔드는 MailboxGUI 네트워크 알림 이벤트를 수신합니다."

  status:
    - "&bMailboxGUI-DiscBridge 관리자 상태"
    - "&7MailboxGUI 후크: {mailboxgui}"
    - "&7DiscordSRV 후크: {discordsrv}"
    - "&7다이렉트 메시지: {direct_messages}"
    - "&7대량 메일 채널: {mass_channel}"
    - "&7모두 멘션: {mention_everyone}"
    - "&7불러온 플레이어 설정: &e{player_count}"
    - "&7개별 DM: &a{individual_delivered} 전달됨 &8/ &e{individual_skipped} 건너뜀 &8/ &c{individual_failed} 실패"
    - "&7대량 알림: &a{mass_delivered} 전달됨 &8/ &e{mass_skipped} 건너뜀 &8/ &c{mass_failed} 실패"
  test-dm-usage: "{prefix}&c사용법: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&c플레이어 &e{player}&c 님은 DiscordSRV에 연결되어 있지 않습니다."
  test-dm-sent: "{prefix}&a테스트 DM을 &e{player}&a 님에게 보냈습니다."
  test-dm-failed: "{prefix}&c&e{player}&c 님에게 테스트 DM을 보내지 못했습니다. 자세한 내용은 콘솔을 확인하세요."
  test-channel-disabled: "{prefix}&c관리자 대량 메일 채널 메시지가 config.yml에서 비활성화되어 있습니다."
  test-channel-missing: "{prefix}&cconfig.yml에 관리자 대량 메일 channel-id가 없습니다."
  test-channel-sent: "{prefix}&a테스트 채널 메시지를 보냈습니다."
  test-channel-failed: "{prefix}&c테스트 채널 메시지를 보내지 못했습니다. 자세한 내용은 콘솔을 확인하세요."
Download Discord templates
disclanguage/messages_ko.yml
# ============================================================
# MailboxGUI-DiscBridge Discord 메시지 템플릿
# ============================================================
#
# 이 메시지는 Minecraft 채팅이 아니라 Discord로 전송됩니다.
# Discord 메시지를 보내기 전에 자리표시자 값에서 Minecraft 색상 코드가 제거됩니다.
#
# 지원되는 자리표시자:
# {server}          config.yml의 server-name에서 가져온 서버 표시 이름입니다.
# {sender}          보낸 사람 표시 이름입니다.
# {recipient}       받는 사람 이름이며, 개별 메시지에서 사용할 수 있습니다.
# {price}           COD 소포 가격 텍스트입니다. MailboxGUI 5.1.0의 Vault 돈과 아이템 통화를 지원합니다.
# {amount}          돈 우편 금액입니다.
# {mention}         admin-mass-mail-channel에서만 사용됩니다.
# {recipient_count} 대량 우편을 성공적으로 받은 대상 수입니다.
#
# ============================================================

messages-version: 2

messages:

  # 플레이어가 일반 편지를 받을 때 전송되는 Discord DM입니다.
  dm-letter:
    - "📬 {server}에서 {sender}님에게서 편지를 받았습니다."
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."

  # 플레이어가 책 편지를 받을 때 전송되는 Discord DM입니다.
  dm-book-letter:
    - "📬 {server}에서 {sender}님에게서 책 편지를 받았습니다."
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."

  # 플레이어가 소포를 받을 때 전송되는 Discord DM입니다.
  dm-package:
    - "📦 {server}에서 {sender}님에게서 소포를 받았습니다."
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."

  # 플레이어가 COD 소포를 받을 때 전송되는 Discord DM입니다.
  # {price}를 사용합니다. MailboxGUI 5.1.0에서는 {price}에 Vault 돈과 아이템 통화가 포함될 수 있습니다.
  dm-cod-package:
    - "📦 {server}에서 {sender}님에게서 COD 소포를 받았습니다."
    - "가격: {price}"
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."

  # 플레이어가 아이템 통화 COD 결제 우편을 받을 때 전송되는 Discord DM입니다.
  # {price}를 사용합니다.
  dm-cod-item-currency-payment:
    - "💜 {server}에서 {sender}님에게서 아이템 통화 COD 결제를 받았습니다."
    - "결제: {price}"
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."

  # 플레이어의 COD 소포가 반송될 때 전송되는 Discord DM입니다.
  dm-returned-cod-package:
    - "↩️ {server}에서 당신의 COD 소포가 {sender}님에 의해 반송되었습니다."
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."

  # 플레이어가 돈 우편을 받을 때 전송되는 Discord DM입니다.
  # {amount}를 사용합니다.
  dm-money-mail:
    - "💰 {server}에서 {sender}님에게서 돈 우편을 받았습니다."
    - "금액: {amount}"
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."

  # 관리자/API 우편이 여러 대상에게 배달될 때 전송되는 Discord 채널 메시지입니다.
  # 이 채널 메시지는 항상 config.yml의 discord-messages.default-language를 사용합니다.
  # 플레이어가 선택한 Discord 메시지 언어는 개별 Discord DM에만 적용됩니다.
  # {mention}을 사용하며, 선택적으로 {recipient_count}를 사용할 수 있습니다.
  admin-mass-mail-channel:
    - "{mention} 📬 **서버 우편 알림**"
    - "{server}에서 여러 플레이어에게 서버 우편이 전송되었습니다."
    - "게임 내 우편함, 공용 우체국 상자 또는 우체국 NPC를 확인하세요."
Nederlands — nl: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_nl.yml
# Bestandsformaatversie. Gebruikt door toekomstige taalupdaters.
file-version: 3

# Voorvoegsel voor DiscBridge-opdrachtberichten in het spel.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Algemene opdrachtberichten.
general:
  no-permission: "{prefix}&cJe hebt geen toestemming om dit commando te gebruiken."
  players-only: "{prefix}&cAlleen spelers kunnen dit commando gebruiken."
  unknown-command: "{prefix}&cOnbekend commando. Gebruik &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge opnieuw geladen."

# Spelerstatusberichten.
status:
  header: "&bMailboxGUI-DiscBridge-status"
  notifications-enabled: "&7Discord-mailmeldingen: &aIngeschakeld"
  notifications-disabled: "&7Discord-mailmeldingen: &cUitgeschakeld"
  online-dms-enabled: "&7Discord-DM’s online: &aIngeschakeld"
  online-dms-disabled: "&7Discord-DM’s online: &cUitgeschakeld"
  admin-ignored: "&7Admin/server-mail-DM’s: &cGenegeerd"
  admin-not-ignored: "&7Admin/server-mail-DM’s: &aToegestaan"

# Helpregels voor speler- en beheerdersopdrachten.
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge-opdrachten &7(Pagina {page}/{total})"
      - "&e/mbdiscord status &7- Bekijk je Discord-mailmeldingsinstellingen."
      - "&e/mbdiscord enable &7- Schakel Discord-mailmeldingen in."
      - "&e/mbdiscord disable &7- Schakel Discord-mailmeldingen uit."
      - "&e/mbdiscord online on|off|toggle &7- Beheer DM’s terwijl je online bent."
      - "&e/mbdiscord language <language> &7- Stel je Discord-DM-berichttaal in."
      - "&e/mbdiscord ignore <player> &7- Negeer Discord-DM’s van een afzender."
      - "&e/mbdiscord unignore <player> &7- Stop met negeren van een afzender."
      - "&e/mbdiscord ignorelist &7- Bekijk genegeerde afzenders."
      - "&e/mbdiscord ignoreadmin &7- Negeer admin/server-mail-DM’s."
      - "&e/mbdiscord unignoreadmin &7- Sta admin/server-mail-DM’s toe."
    page-2:
      - "&bMailboxGUI-DiscBridge adminopdrachten &7(Pagina {page}/{total})"
      - "&e/mbdiscord admin status &7- Bekijk de adminstatus van de bridge."
      - "&e/mbdiscord admin mode &7- Toont LOCAL/NETWORK_NODE setupdiagnose."
      - "&e/mbdiscord admin reload &7- Herlaad bridge-configuratie, taal en spelerdata."
      - "&e/mbdiscord admin updatecheck &7- Controleert het website-releasesysteem op updates."
      - "&e/mbdiscord update &7- Bereidt de nieuwste update voor."
      - "&e/mbdiscord update confirm &7- Zet de update klaar voor de volgende herstart."
      - "&e/mbdiscord admin testdm <player> &7- Stuur een diagnostische Discord-DM."
      - "&e/mbdiscord admin testchannel &7- Stuur een diagnostisch kanaalbericht."
    footer: "&7Gebruik &e/mbdiscord help <page> &7om een andere pagina te bekijken."

# Berichten voor DiscordSRV-koppeling en meldingsinstellingen.
discord:
  not-linked: "{prefix}&cJe Minecraft-account is nog niet gekoppeld aan DiscordSRV. Als je net hebt gekoppeld, wacht een paar seconden en probeer &e/mbdiscord enable &copnieuw."
  link-checking: "{prefix}&eJe DiscordSRV-koppelingsstatus wordt gecontroleerd..."
  enabled: "{prefix}&aDiscord-mailmeldingen ingeschakeld."
  disabled: "{prefix}&cDiscord-mailmeldingen uitgeschakeld."
  online-enabled: "{prefix}&aJe ontvangt Discord-mail-DM’s terwijl je online bent."
  online-disabled: "{prefix}&eJe ontvangt Discord-mail-DM’s alleen terwijl je offline bent."

# Berichten voor de online-DM-opdracht.
online:
  usage: "{prefix}&cGebruik: &e/mbdiscord online <on|off|toggle>"

# Berichten voor de negeerlijst van spelerafzenders.
ignore:
  usage-ignore: "{prefix}&cGebruik: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cGebruik: &e/mbdiscord unignore <player>"
  added: "{prefix}&aJe ontvangt geen Discord-mail-DM’s meer van &e{player}&a."
  removed: "{prefix}&aJe ontvangt weer Discord-mail-DM’s van &e{player}&a."
  not-found: "{prefix}&cGeen bekende speler gevonden met de naam &e{player}&c."
  cannot-ignore-self: "{prefix}&cJe kunt jezelf niet negeren."
  empty: "{prefix}&7Je negeert geen spelerafzenders."
  list-header: "&bGenegeerde Discord-mailafzenders"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7Admin/server-mail-DM’s: &cGenegeerd"
  list-admin-allowed: "&7Admin/server-mail-DM’s: &aToegestaan"
  admin-enabled: "{prefix}&cJe negeert nu individuele admin/server-mail-DM’s."
  admin-disabled: "{prefix}&aJe staat nu individuele admin/server-mail-DM’s toe."

# Beheerdersopdrachtberichten en diagnostische uitvoer.
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge modusdiagnose"
      - "&7Modus: &e{mode}"
      - "&7MailboxGUI-hook: {mailboxgui}"
      - "&7DiscordSRV-hook: {discordsrv}"
      - "&7MailboxGUI-netwerkmodus: {mailboxgui_network}"
      - "&7Netwerkmeldingsnode: {network_node}"
      - "&aLOCAL-modus setup:"
      - "&7Installeer MailboxGUI, DiscordSRV en MailboxGUI-DiscBridge op deze server."
      - "&7Gebruik deze modus voor standalone/single-backend servers."
    network-node:
      - "&bMailboxGUI-DiscBridge modusdiagnose"
      - "&7Modus: &e{mode}"
      - "&7MailboxGUI-hook: {mailboxgui}"
      - "&7DiscordSRV-hook: {discordsrv}"
      - "&7MailboxGUI-netwerkmodus: {mailboxgui_network}"
      - "&7Netwerkmeldingsnode: {network_node}"
      - "&aNETWORK_NODE setup:"
      - "&7Installeer MailboxGUI op elke backend die mail gebruikt."
      - "&7Installeer DiscordSRV en DiscBridge alleen op deze notificatie-backend."
      - "&7Deze backend luistert naar MailboxGUI-netwerkmeldingen."

  status:
    - "&bMailboxGUI-DiscBridge-adminstatus"
    - "&7MailboxGUI-hook: {mailboxgui}"
    - "&7DiscordSRV-hook: {discordsrv}"
    - "&7Directe berichten: {direct_messages}"
    - "&7Massamailkanaal: {mass_channel}"
    - "&7Iedereen vermelden: {mention_everyone}"
    - "&7Geladen spelervoorkeuren: &e{player_count}"
    - "&7Individuele DM’s: &a{individual_delivered} afgeleverd &8/ &e{individual_skipped} overgeslagen &8/ &c{individual_failed} mislukt"
    - "&7Massaberichten: &a{mass_delivered} afgeleverd &8/ &e{mass_skipped} overgeslagen &8/ &c{mass_failed} mislukt"
  test-dm-usage: "{prefix}&cGebruik: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cSpeler &e{player}&c is niet gekoppeld via DiscordSRV."
  test-dm-sent: "{prefix}&aTest-DM verzonden naar &e{player}&a."
  test-dm-failed: "{prefix}&cTest-DM naar &e{player}&c is mislukt. Controleer de console voor details."
  test-channel-disabled: "{prefix}&cAdmin-massamailkanaalberichten zijn uitgeschakeld in config.yml."
  test-channel-missing: "{prefix}&cAdmin-massamail channel-id ontbreekt in config.yml."
  test-channel-sent: "{prefix}&aTestkanaalbericht verzonden."
  test-channel-failed: "{prefix}&cTestkanaalbericht verzenden mislukt. Controleer de console voor details."
Download Discord templates
disclanguage/messages_nl.yml
# ============================================================
# MailboxGUI-DiscBridge Discord-berichtsjablonen
# ============================================================
#
# Deze berichten worden naar Discord gestuurd, niet naar de Minecraft-chat.
# Minecraft-kleurcodes worden uit plaatsaanduidingswaarden verwijderd voordat Discord-berichten worden verzonden.
#
# Ondersteunde plaatsaanduidingen:
# {server}          Weergavenaam van de server uit server-name in config.yml.
# {sender}          Weergavenaam van de afzender.
# {recipient}       Naam van de ontvanger, beschikbaar voor individuele berichten.
# {price}           Prijstekst van het COD-pakket. Ondersteunt Vault-geld en itemvaluta uit MailboxGUI 5.1.0.
# {amount}          Bedrag van geldpost.
# {mention}         Alleen gebruikt voor admin-mass-mail-channel.
# {recipient_count} Aantal succesvolle ontvangers voor massamail.
#
# ============================================================

messages-version: 2

messages:

  # Discord-DM wanneer een speler een klassieke brief ontvangt.
  dm-letter:
    - "📬 Je hebt een brief ontvangen van {sender} op {server}."
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."

  # Discord-DM wanneer een speler een boekbrief ontvangt.
  dm-book-letter:
    - "📬 Je hebt een boekbrief ontvangen van {sender} op {server}."
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."

  # Discord-DM wanneer een speler een pakket ontvangt.
  dm-package:
    - "📦 Je hebt een pakket ontvangen van {sender} op {server}."
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."

  # Discord-DM wanneer een speler een COD-pakket ontvangt.
  # Gebruikt {price}. In MailboxGUI 5.1.0 kan {price} Vault-geld en itemvaluta bevatten.
  dm-cod-package:
    - "📦 Je hebt een COD-pakket ontvangen van {sender} op {server}."
    - "Prijs: {price}"
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."

  # Discord-DM wanneer een speler een COD-betaling in itemvaluta ontvangt.
  # Gebruikt {price}.
  dm-cod-item-currency-payment:
    - "💜 Je hebt een COD-betaling in itemvaluta ontvangen van {sender} op {server}."
    - "Betaling: {price}"
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."

  # Discord-DM wanneer het COD-pakket van een speler wordt teruggestuurd.
  dm-returned-cod-package:
    - "↩️ Je COD-pakket is teruggestuurd door {sender} op {server}."
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."

  # Discord-DM wanneer een speler geldpost ontvangt.
  # Gebruikt {amount}.
  dm-money-mail:
    - "💰 Je hebt geldpost ontvangen van {sender} op {server}."
    - "Bedrag: {amount}"
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."

  # Discord-kanaalbericht wanneer admin/API-mail aan meerdere ontvangers wordt geleverd.
  # Dit kanaalbericht gebruikt altijd discord-messages.default-language uit config.yml.
  # Door spelers gekozen Discord-berichttalen gelden alleen voor individuele Discord-DM's.
  # Gebruikt {mention}; optioneel {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Servermailmelding**"
    - "Servermail is verzonden naar meerdere spelers op {server}."
    - "Controleer je mailbox, een openbare postbus of een Post Office NPC in-game."
Polski — pl: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_pl.yml
# Wersja formatu pliku. Używana przez przyszłe aktualizatory językowe.
file-version: 3

# Prefiks używany w wiadomościach komend DiscBridge w grze.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Ogólne wiadomości komend.
general:
  no-permission: "{prefix}&cNie masz uprawnień do użycia tej komendy."
  players-only: "{prefix}&cTylko gracze mogą używać tej komendy."
  unknown-command: "{prefix}&cNieznana komenda. Użyj &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge przeładowany."

# Wiadomości statusu gracza.
status:
  header: "&bStatus MailboxGUI-DiscBridge"
  notifications-enabled: "&7Powiadomienia Discord o poczcie: &aWłączone"
  notifications-disabled: "&7Powiadomienia Discord o poczcie: &cWyłączone"
  online-dms-enabled: "&7DM Discord podczas online: &aWłączone"
  online-dms-disabled: "&7DM Discord podczas online: &cWyłączone"
  admin-ignored: "&7DM poczty admina/serwera: &cIgnorowane"
  admin-not-ignored: "&7DM poczty admina/serwera: &aDozwolone"

# Linie pomocy dla komend gracza i administratora.
commands:
  help:
    page-1:
      - "&bPolecenia MailboxGUI-DiscBridge &7(Strona {page}/{total})"
      - "&e/mbdiscord status &7- Wyświetla ustawienia powiadomień Discord."
      - "&e/mbdiscord enable &7- Włącza powiadomienia Discord o poczcie."
      - "&e/mbdiscord disable &7- Wyłącza powiadomienia Discord o poczcie."
      - "&e/mbdiscord online on|off|toggle &7- Kontroluje DM, gdy jesteś online."
      - "&e/mbdiscord language <language> &7- Ustaw język wiadomości prywatnych Discord."
      - "&e/mbdiscord ignore <player> &7- Ignoruje DM Discord od nadawcy."
      - "&e/mbdiscord unignore <player> &7- Przestaje ignorować nadawcę."
      - "&e/mbdiscord ignorelist &7- Wyświetla ignorowanych nadawców."
      - "&e/mbdiscord ignoreadmin &7- Ignoruje DM poczty admina/serwera."
      - "&e/mbdiscord unignoreadmin &7- Zezwala na DM poczty admina/serwera."
    page-2:
      - "&bPolecenia admina MailboxGUI-DiscBridge &7(Strona {page}/{total})"
      - "&e/mbdiscord admin status &7- Wyświetla status administracyjny bridge."
      - "&e/mbdiscord admin mode &7- Pokazuje diagnostykę konfiguracji LOCAL/NETWORK_NODE."
      - "&e/mbdiscord admin reload &7- Przeładowuje konfigurację, język i dane graczy bridge."
      - "&e/mbdiscord admin updatecheck &7- Sprawdza aktualizacje w systemie wydań witryny."
      - "&e/mbdiscord update &7- Przygotowuje najnowszą aktualizację."
      - "&e/mbdiscord update confirm &7- Przygotowuje aktualizację na następny restart."
      - "&e/mbdiscord admin testdm <player> &7- Wysyła diagnostyczny DM Discord."
      - "&e/mbdiscord admin testchannel &7- Wysyła diagnostyczne powiadomienie kanału."
    footer: "&7Użyj &e/mbdiscord help <page> &7aby zobaczyć inną stronę."

# Wiadomości łączenia DiscordSRV i ustawień powiadomień.
discord:
  not-linked: "{prefix}&cTwoje konto Minecraft nie jest jeszcze połączone z DiscordSRV. Jeśli właśnie je połączyłeś, poczekaj kilka sekund i spróbuj ponownie &e/mbdiscord enable&c."
  link-checking: "{prefix}&eSprawdzanie statusu połączenia DiscordSRV..."
  enabled: "{prefix}&aPowiadomienia Discord o poczcie włączone."
  disabled: "{prefix}&cPowiadomienia Discord o poczcie wyłączone."
  online-enabled: "{prefix}&aBędziesz otrzymywać DM Discord o poczcie, gdy jesteś online."
  online-disabled: "{prefix}&eBędziesz otrzymywać DM Discord o poczcie tylko offline."

# Wiadomości komendy DM podczas gry online.
online:
  usage: "{prefix}&cUżycie: &e/mbdiscord online <on|off|toggle>"

# Wiadomości listy ignorowanych nadawców graczy.
ignore:
  usage-ignore: "{prefix}&cUżycie: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cUżycie: &e/mbdiscord unignore <player>"
  added: "{prefix}&aNie będziesz już otrzymywać DM Discord o poczcie od &e{player}&a."
  removed: "{prefix}&aPonownie będziesz otrzymywać DM Discord o poczcie od &e{player}&a."
  not-found: "{prefix}&cNie znaleziono znanego gracza o nazwie &e{player}&c."
  cannot-ignore-self: "{prefix}&cNie możesz ignorować samego siebie."
  empty: "{prefix}&7Nie ignorujesz żadnych nadawców-graczy."
  list-header: "&bIgnorowani nadawcy poczty Discord"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7DM poczty admina/serwera: &cIgnorowane"
  list-admin-allowed: "&7DM poczty admina/serwera: &aDozwolone"
  admin-enabled: "{prefix}&cTeraz ignorujesz pojedyncze DM poczty admina/serwera."
  admin-disabled: "{prefix}&aTeraz zezwalasz na pojedyncze DM poczty admina/serwera."

# Wiadomości komend administratora i dane diagnostyczne.
admin:
  mode:
    local:
      - "&bDiagnostyka trybu MailboxGUI-DiscBridge"
      - "&7Tryb: &e{mode}"
      - "&7Hook MailboxGUI: {mailboxgui}"
      - "&7Hook DiscordSRV: {discordsrv}"
      - "&7Tryb sieciowy MailboxGUI: {mailboxgui_network}"
      - "&7Węzeł powiadomień sieciowych: {network_node}"
      - "&aKonfiguracja trybu LOCAL:"
      - "&7Zainstaluj MailboxGUI, DiscordSRV i MailboxGUI-DiscBridge na tym serwerze."
      - "&7Użyj tego trybu dla serwerów samodzielnych/jednego backendu."
    network-node:
      - "&bDiagnostyka trybu MailboxGUI-DiscBridge"
      - "&7Tryb: &e{mode}"
      - "&7Hook MailboxGUI: {mailboxgui}"
      - "&7Hook DiscordSRV: {discordsrv}"
      - "&7Tryb sieciowy MailboxGUI: {mailboxgui_network}"
      - "&7Węzeł powiadomień sieciowych: {network_node}"
      - "&aKonfiguracja NETWORK_NODE:"
      - "&7Zainstaluj MailboxGUI na każdym backendzie używającym poczty."
      - "&7Zainstaluj DiscordSRV i DiscBridge tylko na tym backendzie powiadomień."
      - "&7Ten backend nasłuchuje zdarzeń powiadomień sieciowych MailboxGUI."

  status:
    - "&bStatus administratora MailboxGUI-DiscBridge"
    - "&7Hook MailboxGUI: {mailboxgui}"
    - "&7Hook DiscordSRV: {discordsrv}"
    - "&7Wiadomości bezpośrednie: {direct_messages}"
    - "&7Kanał masowej poczty: {mass_channel}"
    - "&7Wzmianka everyone: {mention_everyone}"
    - "&7Wczytane preferencje graczy: &e{player_count}"
    - "&7Pojedyncze DM: &a{individual_delivered} dostarczone &8/ &e{individual_skipped} pominięte &8/ &c{individual_failed} nieudane"
    - "&7Masowe powiadomienia: &a{mass_delivered} dostarczone &8/ &e{mass_skipped} pominięte &8/ &c{mass_failed} nieudane"
  test-dm-usage: "{prefix}&cUżycie: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cGracz &e{player}&c nie jest połączony przez DiscordSRV."
  test-dm-sent: "{prefix}&aTestowy DM wysłany do &e{player}&a."
  test-dm-failed: "{prefix}&cNie udało się wysłać testowego DM do &e{player}&c. Sprawdź konsolę."
  test-channel-disabled: "{prefix}&cWiadomości kanału masowej poczty admina są wyłączone w config.yml."
  test-channel-missing: "{prefix}&cBrakuje channel-id masowej poczty admina w config.yml."
  test-channel-sent: "{prefix}&aTestowa wiadomość kanału wysłana."
  test-channel-failed: "{prefix}&cNie udało się wysłać testowej wiadomości kanału. Sprawdź konsolę."
Download Discord templates
disclanguage/messages_pl.yml
# ============================================================
# Szablony wiadomości Discord MailboxGUI-DiscBridge
# ============================================================
#
# Te wiadomości są wysyłane do Discorda, a nie na czat Minecrafta.
# Kody kolorów Minecrafta są usuwane z wartości symboli zastępczych przed wysłaniem wiadomości Discord.
#
# Obsługiwane symbole zastępcze:
# {server}          Wyświetlana nazwa serwera z server-name w config.yml.
# {sender}          Wyświetlana nazwa nadawcy.
# {recipient}       Nazwa odbiorcy, dostępna dla wiadomości indywidualnych.
# {price}           Tekst ceny paczki COD. Obsługuje pieniądze Vault i walutę przedmiotową z MailboxGUI 5.1.0.
# {amount}          Kwota wiadomości pieniężnej.
# {mention}         Używane tylko dla admin-mass-mail-channel.
# {recipient_count} Liczba odbiorców, którzy pomyślnie otrzymali wiadomość masową.
#
# ============================================================

messages-version: 2

messages:

  # Prywatna wiadomość Discord wysyłana, gdy gracz otrzyma klasyczny list.
  dm-letter:
    - "📬 Otrzymałeś list od {sender} na {server}."
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."

  # Prywatna wiadomość Discord wysyłana, gdy gracz otrzyma list książkowy.
  dm-book-letter:
    - "📬 Otrzymałeś list książkowy od {sender} na {server}."
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."

  # Prywatna wiadomość Discord wysyłana, gdy gracz otrzyma paczkę.
  dm-package:
    - "📦 Otrzymałeś paczkę od {sender} na {server}."
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."

  # Prywatna wiadomość Discord wysyłana, gdy gracz otrzyma paczkę COD.
  # Używa {price}. W MailboxGUI 5.1.0 {price} może zawierać pieniądze Vault i walutę przedmiotową.
  dm-cod-package:
    - "📦 Otrzymałeś paczkę COD od {sender} na {server}."
    - "Cena: {price}"
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."

  # Prywatna wiadomość Discord wysyłana, gdy gracz otrzyma płatność COD w walucie przedmiotowej.
  # Używa {price}.
  dm-cod-item-currency-payment:
    - "💜 Otrzymałeś płatność COD w walucie przedmiotowej od {sender} na {server}."
    - "Płatność: {price}"
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."

  # Prywatna wiadomość Discord wysyłana, gdy paczka COD gracza zostanie zwrócona.
  dm-returned-cod-package:
    - "↩️ Twoja paczka COD została zwrócona przez {sender} na {server}."
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."

  # Prywatna wiadomość Discord wysyłana, gdy gracz otrzyma wiadomość pieniężną.
  # Używa {amount}.
  dm-money-mail:
    - "💰 Otrzymałeś wiadomość pieniężną od {sender} na {server}."
    - "Kwota: {amount}"
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."

  # Wiadomość kanału Discord wysyłana, gdy poczta admin/API trafia do wielu odbiorców.
  # Ta wiadomość kanału zawsze używa discord-messages.default-language z config.yml.
  # Języki wiadomości Discord wybrane przez graczy dotyczą tylko indywidualnych wiadomości prywatnych Discord.
  # Używa {mention}; opcjonalnie używa {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Powiadomienie o poczcie serwerowej**"
    - "Poczta serwerowa została wysłana do wielu graczy na {server}."
    - "Sprawdź swoją skrzynkę pocztową, publiczną skrzynkę pocztową lub NPC poczty w grze."
Русский — ru: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_ru.yml
# Версия формата файла. Используется будущими обновлениями языка.
file-version: 3

# Префикс для игровых сообщений команд DiscBridge.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Общие сообщения команд.
general:
  no-permission: "{prefix}&cУ вас нет прав на использование этой команды."
  players-only: "{prefix}&cЭту команду могут использовать только игроки."
  unknown-command: "{prefix}&cНеизвестная команда. Используйте &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge перезагружен."

# Сообщения статуса игрока.
status:
  header: "&bСтатус MailboxGUI-DiscBridge"
  notifications-enabled: "&7Уведомления о почте в Discord: &aВключены"
  notifications-disabled: "&7Уведомления о почте в Discord: &cОтключены"
  online-dms-enabled: "&7Discord DM онлайн: &aВключены"
  online-dms-disabled: "&7Discord DM онлайн: &cОтключены"
  admin-ignored: "&7DM почты администратора/сервера: &cИгнорируются"
  admin-not-ignored: "&7DM почты администратора/сервера: &aРазрешены"

# Строки помощи для команд игрока и администратора.
commands:
  help:
    page-1:
      - "&bКоманды MailboxGUI-DiscBridge &7(Страница {page}/{total})"
      - "&e/mbdiscord status &7- Показать настройки уведомлений Discord."
      - "&e/mbdiscord enable &7- Включить уведомления о почте в Discord."
      - "&e/mbdiscord disable &7- Отключить уведомления о почте в Discord."
      - "&e/mbdiscord online on|off|toggle &7- Управлять DM, когда вы онлайн."
      - "&e/mbdiscord language <language> &7- Установить язык личных сообщений Discord."
      - "&e/mbdiscord ignore <player> &7- Игнорировать Discord DM от отправителя."
      - "&e/mbdiscord unignore <player> &7- Перестать игнорировать отправителя."
      - "&e/mbdiscord ignorelist &7- Показать игнорируемых отправителей."
      - "&e/mbdiscord ignoreadmin &7- Игнорировать DM почты администратора/сервера."
      - "&e/mbdiscord unignoreadmin &7- Разрешить DM почты администратора/сервера."
    page-2:
      - "&bАдмин-команды MailboxGUI-DiscBridge &7(Страница {page}/{total})"
      - "&e/mbdiscord admin status &7- Показать статус bridge для администратора."
      - "&e/mbdiscord admin mode &7- Показывает диагностику настройки LOCAL/NETWORK_NODE."
      - "&e/mbdiscord admin reload &7- Перезагрузить конфиг, язык и данные игроков bridge."
      - "&e/mbdiscord admin updatecheck &7- Проверяет обновления в системе релизов сайта."
      - "&e/mbdiscord update &7- Подготавливает последнее обновление."
      - "&e/mbdiscord update confirm &7- Подготавливает обновление к следующему перезапуску."
      - "&e/mbdiscord admin testdm <player> &7- Отправить диагностический Discord DM."
      - "&e/mbdiscord admin testchannel &7- Отправить диагностическое сообщение в канал."
    footer: "&7Используйте &e/mbdiscord help <page> &7для просмотра другой страницы."

# Сообщения привязки DiscordSRV и настроек уведомлений.
discord:
  not-linked: "{prefix}&cВаш аккаунт Minecraft еще не привязан к DiscordSRV. Если вы только что привязали его, подождите несколько секунд и попробуйте &e/mbdiscord enable &cснова."
  link-checking: "{prefix}&eПроверка статуса привязки DiscordSRV..."
  enabled: "{prefix}&aУведомления о почте в Discord включены."
  disabled: "{prefix}&cУведомления о почте в Discord отключены."
  online-enabled: "{prefix}&aВы будете получать Discord DM о почте, когда вы онлайн."
  online-disabled: "{prefix}&eВы будете получать Discord DM о почте только офлайн."

# Сообщения команды DM для игроков онлайн.
online:
  usage: "{prefix}&cИспользование: &e/mbdiscord online <on|off|toggle>"

# Сообщения списка игнорируемых отправителей-игроков.
ignore:
  usage-ignore: "{prefix}&cИспользование: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cИспользование: &e/mbdiscord unignore <player>"
  added: "{prefix}&aВы больше не будете получать Discord DM о почте от &e{player}&a."
  removed: "{prefix}&aВы снова будете получать Discord DM о почте от &e{player}&a."
  not-found: "{prefix}&cИзвестный игрок с именем &e{player}&c не найден."
  cannot-ignore-self: "{prefix}&cВы не можете игнорировать себя."
  empty: "{prefix}&7Вы не игнорируете ни одного отправителя-игрока."
  list-header: "&bИгнорируемые отправители почты Discord"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7DM почты администратора/сервера: &cИгнорируются"
  list-admin-allowed: "&7DM почты администратора/сервера: &aРазрешены"
  admin-enabled: "{prefix}&cТеперь вы игнорируете отдельные DM почты администратора/сервера."
  admin-disabled: "{prefix}&aТеперь вы разрешаете отдельные DM почты администратора/сервера."

# Сообщения команд администратора и диагностический вывод.
admin:
  mode:
    local:
      - "&bДиагностика режима MailboxGUI-DiscBridge"
      - "&7Режим: &e{mode}"
      - "&7Хук MailboxGUI: {mailboxgui}"
      - "&7Хук DiscordSRV: {discordsrv}"
      - "&7Сетевой режим MailboxGUI: {mailboxgui_network}"
      - "&7Узел сетевых уведомлений: {network_node}"
      - "&aНастройка режима LOCAL:"
      - "&7Установите MailboxGUI, DiscordSRV и MailboxGUI-DiscBridge на этот сервер."
      - "&7Используйте этот режим для одиночных серверов/одного backend-сервера."
    network-node:
      - "&bДиагностика режима MailboxGUI-DiscBridge"
      - "&7Режим: &e{mode}"
      - "&7Хук MailboxGUI: {mailboxgui}"
      - "&7Хук DiscordSRV: {discordsrv}"
      - "&7Сетевой режим MailboxGUI: {mailboxgui_network}"
      - "&7Узел сетевых уведомлений: {network_node}"
      - "&aНастройка NETWORK_NODE:"
      - "&7Установите MailboxGUI на каждый backend, где используется почта."
      - "&7Установите DiscordSRV и DiscBridge только на этот backend уведомлений."
      - "&7Этот backend слушает сетевые события уведомлений MailboxGUI."

  status:
    - "&bСтатус администратора MailboxGUI-DiscBridge"
    - "&7Хук MailboxGUI: {mailboxgui}"
    - "&7Хук DiscordSRV: {discordsrv}"
    - "&7Личные сообщения: {direct_messages}"
    - "&7Канал массовой почты: {mass_channel}"
    - "&7Упоминать всех: {mention_everyone}"
    - "&7Загружено настроек игроков: &e{player_count}"
    - "&7Индивидуальные DM: &a{individual_delivered} доставлено &8/ &e{individual_skipped} пропущено &8/ &c{individual_failed} ошибок"
    - "&7Массовые уведомления: &a{mass_delivered} доставлено &8/ &e{mass_skipped} пропущено &8/ &c{mass_failed} ошибок"
  test-dm-usage: "{prefix}&cИспользование: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cИгрок &e{player}&c не привязан через DiscordSRV."
  test-dm-sent: "{prefix}&aТестовый DM отправлен игроку &e{player}&a."
  test-dm-failed: "{prefix}&cНе удалось отправить тестовый DM игроку &e{player}&c. Подробности в консоли."
  test-channel-disabled: "{prefix}&cСообщения канала массовой почты администратора отключены в config.yml."
  test-channel-missing: "{prefix}&cВ config.yml отсутствует channel-id для массовой почты администратора."
  test-channel-sent: "{prefix}&aТестовое сообщение в канал отправлено."
  test-channel-failed: "{prefix}&cНе удалось отправить тестовое сообщение в канал. Подробности в консоли."
Download Discord templates
disclanguage/messages_ru.yml
# ============================================================
# Шаблоны сообщений Discord для MailboxGUI-DiscBridge
# ============================================================
#
# Эти сообщения отправляются в Discord, а не в чат Minecraft.
# Цветовые коды Minecraft удаляются из значений заполнителей перед отправкой сообщений Discord.
#
# Поддерживаемые заполнители:
# {server}          Отображаемое имя сервера из server-name в config.yml.
# {sender}          Отображаемое имя отправителя.
# {recipient}       Имя получателя, доступно для индивидуальных сообщений.
# {price}           Текст цены COD-посылки. Поддерживает деньги Vault и предметную валюту из MailboxGUI 5.1.0.
# {amount}          Сумма денежной почты.
# {mention}         Используется только для admin-mass-mail-channel.
# {recipient_count} Количество успешных получателей массовой почты.
#
# ============================================================

messages-version: 2

messages:

  # Личное сообщение Discord, когда игрок получает обычное письмо.
  dm-letter:
    - "📬 Вы получили письмо от {sender} на {server}."
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."

  # Личное сообщение Discord, когда игрок получает книжное письмо.
  dm-book-letter:
    - "📬 Вы получили книжное письмо от {sender} на {server}."
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."

  # Личное сообщение Discord, когда игрок получает посылку.
  dm-package:
    - "📦 Вы получили посылку от {sender} на {server}."
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."

  # Личное сообщение Discord, когда игрок получает COD-посылку.
  # Использует {price}. В MailboxGUI 5.1.0 {price} может включать деньги Vault и предметную валюту.
  dm-cod-package:
    - "📦 Вы получили COD-посылку от {sender} на {server}."
    - "Цена: {price}"
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."

  # Личное сообщение Discord, когда игрок получает COD-платёж предметной валютой.
  # Использует {price}.
  dm-cod-item-currency-payment:
    - "💜 Вы получили COD-платёж предметной валютой от {sender} на {server}."
    - "Платёж: {price}"
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."

  # Личное сообщение Discord, когда COD-посылка игрока возвращена.
  dm-returned-cod-package:
    - "↩️ Ваша COD-посылка была возвращена игроком {sender} на {server}."
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."

  # Личное сообщение Discord, когда игрок получает денежную почту.
  # Использует {amount}.
  dm-money-mail:
    - "💰 Вы получили денежную почту от {sender} на {server}."
    - "Сумма: {amount}"
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."

  # Сообщение канала Discord, когда админ/API-почта доставлена нескольким получателям.
  # Это сообщение канала всегда использует discord-messages.default-language из config.yml.
  # Языки сообщений Discord, выбранные игроками, применяются только к индивидуальным личным сообщениям Discord.
  # Использует {mention}; при необходимости использует {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Уведомление о серверной почте**"
    - "Серверная почта была отправлена нескольким игрокам на {server}."
    - "Проверьте свой почтовый ящик, публичный почтовый ящик или NPC почтового отделения в игре."
Svenska — sv: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_sv.yml
# Filformatversion. Används av framtida språkuppdateringar.
file-version: 3

# Prefix som används för DiscBridge-kommandon i spelet.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Allmänna kommandemeddelanden.
general:
  no-permission: "{prefix}&cDu har inte behörighet att använda detta kommando."
  players-only: "{prefix}&cEndast spelare kan använda detta kommando."
  unknown-command: "{prefix}&cOkänt kommando. Använd &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge laddades om."

# Spelarstatusmeddelanden.
status:
  header: "&bMailboxGUI-DiscBridge-status"
  notifications-enabled: "&7Discord-mailaviseringar: &aAktiverade"
  notifications-disabled: "&7Discord-mailaviseringar: &cInaktiverade"
  online-dms-enabled: "&7Discord-DM online: &aAktiverade"
  online-dms-disabled: "&7Discord-DM online: &cInaktiverade"
  admin-ignored: "&7Admin/server-mail-DM: &cIgnoreras"
  admin-not-ignored: "&7Admin/server-mail-DM: &aTillåtna"

# Hjälprader för spelar- och administratörskommandon.
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge-kommandon &7(Sida {page}/{total})"
      - "&e/mbdiscord status &7- Visa dina Discord-mailinställningar."
      - "&e/mbdiscord enable &7- Aktivera Discord-mailaviseringar."
      - "&e/mbdiscord disable &7- Inaktivera Discord-mailaviseringar."
      - "&e/mbdiscord online on|off|toggle &7- Styr DM när du är online."
      - "&e/mbdiscord language <language> &7- Ställ in språket för dina Discord-DM."
      - "&e/mbdiscord ignore <player> &7- Ignorera Discord-DM från en avsändare."
      - "&e/mbdiscord unignore <player> &7- Sluta ignorera en avsändare."
      - "&e/mbdiscord ignorelist &7- Visa ignorerade avsändare."
      - "&e/mbdiscord ignoreadmin &7- Ignorera admin/server-mail-DM."
      - "&e/mbdiscord unignoreadmin &7- Tillåt admin/server-mail-DM."
    page-2:
      - "&bMailboxGUI-DiscBridge adminkommandon &7(Sida {page}/{total})"
      - "&e/mbdiscord admin status &7- Visa bridge-adminstatus."
      - "&e/mbdiscord admin mode &7- Visar LOCAL/NETWORK_NODE setupdiagnostik."
      - "&e/mbdiscord admin reload &7- Ladda om bridge-konfig, språk och spelardata."
      - "&e/mbdiscord admin updatecheck &7- Kontrollerar webbplatsens releasesystem efter uppdateringar."
      - "&e/mbdiscord update &7- Förbereder den senaste uppdateringen."
      - "&e/mbdiscord update confirm &7- Förbereder uppdateringen för nästa omstart."
      - "&e/mbdiscord admin testdm <player> &7- Skicka ett diagnostiskt Discord-DM."
      - "&e/mbdiscord admin testchannel &7- Skicka ett diagnostiskt kanalmeddelande."
    footer: "&7Använd &e/mbdiscord help <page> &7för att visa en annan sida."

# Meddelanden för DiscordSRV-länkning och aviseringar.
discord:
  not-linked: "{prefix}&cDitt Minecraft-konto är inte länkat till DiscordSRV ännu. Om du just länkade det, vänta några sekunder och försök &e/mbdiscord enable &cigen."
  link-checking: "{prefix}&eKontrollerar din DiscordSRV-länkstatus..."
  enabled: "{prefix}&aDiscord-mailaviseringar aktiverade."
  disabled: "{prefix}&cDiscord-mailaviseringar inaktiverade."
  online-enabled: "{prefix}&aDu får Discord-mail-DM medan du är online."
  online-disabled: "{prefix}&eDu får bara Discord-mail-DM medan du är offline."

# Meddelanden för online-DM-kommandot.
online:
  usage: "{prefix}&cAnvändning: &e/mbdiscord online <on|off|toggle>"

# Meddelanden för ignoreringslistan över spelaravsändare.
ignore:
  usage-ignore: "{prefix}&cAnvändning: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cAnvändning: &e/mbdiscord unignore <player>"
  added: "{prefix}&aDu kommer inte längre få Discord-mail-DM från &e{player}&a."
  removed: "{prefix}&aDu kommer åter få Discord-mail-DM från &e{player}&a."
  not-found: "{prefix}&cKunde inte hitta en känd spelare med namnet &e{player}&c."
  cannot-ignore-self: "{prefix}&cDu kan inte ignorera dig själv."
  empty: "{prefix}&7Du ignorerar inga spelaravsändare."
  list-header: "&bIgnorerade Discord-mailavsändare"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7Admin/server-mail-DM: &cIgnoreras"
  list-admin-allowed: "&7Admin/server-mail-DM: &aTillåtna"
  admin-enabled: "{prefix}&cDu ignorerar nu individuella admin/server-mail-DM."
  admin-disabled: "{prefix}&aDu tillåter nu individuella admin/server-mail-DM."

# Administratörskommandon och diagnostisk utdata.
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge lägesdiagnostik"
      - "&7Läge: &e{mode}"
      - "&7MailboxGUI-hook: {mailboxgui}"
      - "&7DiscordSRV-hook: {discordsrv}"
      - "&7MailboxGUI nätverksläge: {mailboxgui_network}"
      - "&7Nätverksaviseringsnod: {network_node}"
      - "&aLOCAL-läge setup:"
      - "&7Installera MailboxGUI, DiscordSRV och MailboxGUI-DiscBridge på den här servern."
      - "&7Använd detta läge för fristående/single-backend-servrar."
    network-node:
      - "&bMailboxGUI-DiscBridge lägesdiagnostik"
      - "&7Läge: &e{mode}"
      - "&7MailboxGUI-hook: {mailboxgui}"
      - "&7DiscordSRV-hook: {discordsrv}"
      - "&7MailboxGUI nätverksläge: {mailboxgui_network}"
      - "&7Nätverksaviseringsnod: {network_node}"
      - "&aNETWORK_NODE setup:"
      - "&7Installera MailboxGUI på varje backend som använder post."
      - "&7Installera DiscordSRV och DiscBridge endast på denna notifierings-backend."
      - "&7Denna backend lyssnar på MailboxGUI-nätverksnotifieringar."

  status:
    - "&bMailboxGUI-DiscBridge-adminstatus"
    - "&7MailboxGUI-hook: {mailboxgui}"
    - "&7DiscordSRV-hook: {discordsrv}"
    - "&7Direktmeddelanden: {direct_messages}"
    - "&7Massmailkanal: {mass_channel}"
    - "&7Nämn alla: {mention_everyone}"
    - "&7Laddade spelarinställningar: &e{player_count}"
    - "&7Individuella DM: &a{individual_delivered} levererade &8/ &e{individual_skipped} hoppade över &8/ &c{individual_failed} misslyckade"
    - "&7Massaviseringar: &a{mass_delivered} levererade &8/ &e{mass_skipped} hoppade över &8/ &c{mass_failed} misslyckade"
  test-dm-usage: "{prefix}&cAnvändning: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cSpelaren &e{player}&c är inte länkad via DiscordSRV."
  test-dm-sent: "{prefix}&aTest-DM skickat till &e{player}&a."
  test-dm-failed: "{prefix}&cKunde inte skicka test-DM till &e{player}&c. Kontrollera konsolen för detaljer."
  test-channel-disabled: "{prefix}&cAdmin-massmailkanalmeddelanden är inaktiverade i config.yml."
  test-channel-missing: "{prefix}&cAdmin-massmail channel-id saknas i config.yml."
  test-channel-sent: "{prefix}&aTestkanalmeddelande skickat."
  test-channel-failed: "{prefix}&cKunde inte skicka testkanalmeddelande. Kontrollera konsolen för detaljer."
Download Discord templates
disclanguage/messages_sv.yml
# ============================================================
# MailboxGUI-DiscBridge Discord-meddelandemallar
# ============================================================
#
# Dessa meddelanden skickas till Discord, inte till Minecraft-chatten.
# Minecraft-färgkoder tas bort från platshållarvärden innan Discord-meddelanden skickas.
#
# Platshållare som stöds:
# {server}          Serverns visningsnamn från server-name i config.yml.
# {sender}          Avsändarens visningsnamn.
# {recipient}       Mottagarens namn, tillgängligt för individuella meddelanden.
# {price}           Pristext för COD-paket. Stöder Vault-pengar och föremålsvaluta från MailboxGUI 5.1.0.
# {amount}          Belopp för pengapost.
# {mention}         Används endast för admin-mass-mail-channel.
# {recipient_count} Antal lyckade mottagare för masspost.
#
# ============================================================

messages-version: 2

messages:

  # Discord-DM som skickas när en spelare får ett klassiskt brev.
  dm-letter:
    - "📬 Du fick ett brev från {sender} på {server}."
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."

  # Discord-DM som skickas när en spelare får ett bokbrev.
  dm-book-letter:
    - "📬 Du fick ett bokbrev från {sender} på {server}."
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."

  # Discord-DM som skickas när en spelare får ett paket.
  dm-package:
    - "📦 Du fick ett paket från {sender} på {server}."
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."

  # Discord-DM som skickas när en spelare får ett COD-paket.
  # Använder {price}. I MailboxGUI 5.1.0 kan {price} innehålla Vault-pengar och föremålsvaluta.
  dm-cod-package:
    - "📦 Du fick ett COD-paket från {sender} på {server}."
    - "Pris: {price}"
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."

  # Discord-DM som skickas när en spelare får en COD-betalning i föremålsvaluta.
  # Använder {price}.
  dm-cod-item-currency-payment:
    - "💜 Du fick en COD-betalning i föremålsvaluta från {sender} på {server}."
    - "Betalning: {price}"
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."

  # Discord-DM som skickas när en spelares COD-paket returneras.
  dm-returned-cod-package:
    - "↩️ Ditt COD-paket returnerades av {sender} på {server}."
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."

  # Discord-DM som skickas när en spelare får pengapost.
  # Använder {amount}.
  dm-money-mail:
    - "💰 Du fick pengapost från {sender} på {server}."
    - "Belopp: {amount}"
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."

  # Discord-kanalmeddelande som skickas när admin/API-post levereras till flera mottagare.
  # Detta kanalmeddelande använder alltid discord-messages.default-language från config.yml.
  # Discord-meddelandespråk som spelare väljer gäller endast individuella Discord-DM.
  # Använder {mention}; använder valfritt {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Serverpostmeddelande**"
    - "Serverpost skickades till flera spelare på {server}."
    - "Kontrollera din brevlåda, en offentlig postlåda eller en postkontors-NPC i spelet."
Українська — uk: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_uk.yml
# Версія формату файлу. Використовується майбутніми оновлювачами мови.
file-version: 3

# Префікс для ігрових повідомлень команд DiscBridge.
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# Загальні повідомлення команд.
general:
  no-permission: "{prefix}&cУ вас немає дозволу використовувати цю команду."
  players-only: "{prefix}&cЛише гравці можуть використовувати цю команду."
  unknown-command: "{prefix}&cНевідома команда. Використайте &e/mbdiscord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge перезавантажено."

# Повідомлення статусу гравця.
status:
  header: "&bСтатус MailboxGUI-DiscBridge"
  notifications-enabled: "&7Сповіщення про пошту в Discord: &aУвімкнено"
  notifications-disabled: "&7Сповіщення про пошту в Discord: &cВимкнено"
  online-dms-enabled: "&7Discord DM онлайн: &aУвімкнено"
  online-dms-disabled: "&7Discord DM онлайн: &cВимкнено"
  admin-ignored: "&7DM пошти адміністратора/сервера: &cІгноруються"
  admin-not-ignored: "&7DM пошти адміністратора/сервера: &aДозволені"

# Рядки довідки для команд гравця та адміністратора.
commands:
  help:
    page-1:
      - "&bКоманди MailboxGUI-DiscBridge &7(Сторінка {page}/{total})"
      - "&e/mbdiscord status &7- Переглянути налаштування Discord-сповіщень про пошту."
      - "&e/mbdiscord enable &7- Увімкнути Discord-сповіщення про пошту."
      - "&e/mbdiscord disable &7- Вимкнути Discord-сповіщення про пошту."
      - "&e/mbdiscord online on|off|toggle &7- Керувати DM, коли ви онлайн."
      - "&e/mbdiscord language <language> &7- Установіть мову приватних повідомлень Discord."
      - "&e/mbdiscord ignore <player> &7- Ігнорувати Discord DM від відправника."
      - "&e/mbdiscord unignore <player> &7- Припинити ігнорування відправника."
      - "&e/mbdiscord ignorelist &7- Переглянути ігнорованих відправників."
      - "&e/mbdiscord ignoreadmin &7- Ігнорувати DM пошти адміністратора/сервера."
      - "&e/mbdiscord unignoreadmin &7- Дозволити DM пошти адміністратора/сервера."
    page-2:
      - "&bАдмін-команди MailboxGUI-DiscBridge &7(Сторінка {page}/{total})"
      - "&e/mbdiscord admin status &7- Переглянути адміністраторський статус bridge."
      - "&e/mbdiscord admin mode &7- Показує діагностику LOCAL/NETWORK_NODE."
      - "&e/mbdiscord admin reload &7- Перезавантажити конфіг, мову та дані гравців bridge."
      - "&e/mbdiscord admin updatecheck &7- Перевіряє оновлення через систему релізів сайту."
      - "&e/mbdiscord update &7- Готує останнє оновлення."
      - "&e/mbdiscord update confirm &7- Готує оновлення до наступного перезапуску."
      - "&e/mbdiscord admin testdm <player> &7- Надіслати діагностичний Discord DM."
      - "&e/mbdiscord admin testchannel &7- Надіслати діагностичне повідомлення в канал."
    footer: "&7Використовуйте &e/mbdiscord help <page> &7, щоб переглянути іншу сторінку."

# Повідомлення прив’язки DiscordSRV і налаштувань сповіщень.
discord:
  not-linked: "{prefix}&cВаш обліковий запис Minecraft ще не прив’язаний до DiscordSRV. Якщо ви щойно прив’язали його, зачекайте кілька секунд і спробуйте &e/mbdiscord enable &cще раз."
  link-checking: "{prefix}&eПеревірка статусу прив’язки DiscordSRV..."
  enabled: "{prefix}&aDiscord-сповіщення про пошту увімкнено."
  disabled: "{prefix}&cDiscord-сповіщення про пошту вимкнено."
  online-enabled: "{prefix}&aВи отримуватимете Discord DM про пошту, коли ви онлайн."
  online-disabled: "{prefix}&eВи отримуватимете Discord DM про пошту лише офлайн."

# Повідомлення команди DM для гравців онлайн.
online:
  usage: "{prefix}&cВикористання: &e/mbdiscord online <on|off|toggle>"

# Повідомлення списку ігнорованих відправників-гравців.
ignore:
  usage-ignore: "{prefix}&cВикористання: &e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&cВикористання: &e/mbdiscord unignore <player>"
  added: "{prefix}&aВи більше не отримуватимете Discord DM про пошту від &e{player}&a."
  removed: "{prefix}&aВи знову отримуватимете Discord DM про пошту від &e{player}&a."
  not-found: "{prefix}&cНе знайдено відомого гравця з іменем &e{player}&c."
  cannot-ignore-self: "{prefix}&cВи не можете ігнорувати себе."
  empty: "{prefix}&7Ви не ігноруєте жодних відправників-гравців."
  list-header: "&bІгноровані відправники пошти Discord"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7DM пошти адміністратора/сервера: &cІгноруються"
  list-admin-allowed: "&7DM пошти адміністратора/сервера: &aДозволені"
  admin-enabled: "{prefix}&cТепер ви ігноруєте окремі DM пошти адміністратора/сервера."
  admin-disabled: "{prefix}&aТепер ви дозволяєте окремі DM пошти адміністратора/сервера."

# Повідомлення команд адміністратора та діагностичний вивід.
admin:
  mode:
    local:
      - "&bДіагностика режиму MailboxGUI-DiscBridge"
      - "&7Режим: &e{mode}"
      - "&7Хук MailboxGUI: {mailboxgui}"
      - "&7Хук DiscordSRV: {discordsrv}"
      - "&7Мережевий режим MailboxGUI: {mailboxgui_network}"
      - "&7Вузол мережевих сповіщень: {network_node}"
      - "&aНалаштування режиму LOCAL:"
      - "&7Встановіть MailboxGUI, DiscordSRV і MailboxGUI-DiscBridge на цьому сервері."
      - "&7Використовуйте цей режим для автономних серверів/одного backend-сервера."
    network-node:
      - "&bДіагностика режиму MailboxGUI-DiscBridge"
      - "&7Режим: &e{mode}"
      - "&7Хук MailboxGUI: {mailboxgui}"
      - "&7Хук DiscordSRV: {discordsrv}"
      - "&7Мережевий режим MailboxGUI: {mailboxgui_network}"
      - "&7Вузол мережевих сповіщень: {network_node}"
      - "&aНалаштування NETWORK_NODE:"
      - "&7Встановіть MailboxGUI на кожному backend, де використовується пошта."
      - "&7Встановіть DiscordSRV і DiscBridge лише на цьому backend сповіщень."
      - "&7Цей backend слухає мережеві події сповіщень MailboxGUI."

  status:
    - "&bАдміністраторський статус MailboxGUI-DiscBridge"
    - "&7Хук MailboxGUI: {mailboxgui}"
    - "&7Хук DiscordSRV: {discordsrv}"
    - "&7Прямі повідомлення: {direct_messages}"
    - "&7Канал масової пошти: {mass_channel}"
    - "&7Згадувати всіх: {mention_everyone}"
    - "&7Завантажені налаштування гравців: &e{player_count}"
    - "&7Індивідуальні DM: &a{individual_delivered} доставлено &8/ &e{individual_skipped} пропущено &8/ &c{individual_failed} невдало"
    - "&7Масові сповіщення: &a{mass_delivered} доставлено &8/ &e{mass_skipped} пропущено &8/ &c{mass_failed} невдало"
  test-dm-usage: "{prefix}&cВикористання: &e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&cГравець &e{player}&c не прив’язаний через DiscordSRV."
  test-dm-sent: "{prefix}&aТестовий DM надіслано гравцю &e{player}&a."
  test-dm-failed: "{prefix}&cНе вдалося надіслати тестовий DM гравцю &e{player}&c. Перевірте консоль."
  test-channel-disabled: "{prefix}&cПовідомлення каналу масової пошти адміністратора вимкнено в config.yml."
  test-channel-missing: "{prefix}&cУ config.yml відсутній channel-id для масової пошти адміністратора."
  test-channel-sent: "{prefix}&aТестове повідомлення в канал надіслано."
  test-channel-failed: "{prefix}&cНе вдалося надіслати тестове повідомлення в канал. Перевірте консоль."
Download Discord templates
disclanguage/messages_uk.yml
# ============================================================
# Шаблони повідомлень Discord для MailboxGUI-DiscBridge
# ============================================================
#
# Ці повідомлення надсилаються в Discord, а не в чат Minecraft.
# Коди кольорів Minecraft видаляються зі значень заповнювачів перед надсиланням повідомлень Discord.
#
# Підтримувані заповнювачі:
# {server}          Відображувана назва сервера з server-name у config.yml.
# {sender}          Відображуване ім'я відправника.
# {recipient}       Ім'я отримувача, доступне для індивідуальних повідомлень.
# {price}           Текст ціни COD-посилки. Підтримує гроші Vault і предметну валюту з MailboxGUI 5.1.0.
# {amount}          Сума грошової пошти.
# {mention}         Використовується лише для admin-mass-mail-channel.
# {recipient_count} Кількість успішних отримувачів масової пошти.
#
# ============================================================

messages-version: 2

messages:

  # Приватне повідомлення Discord, коли гравець отримує класичний лист.
  dm-letter:
    - "📬 Ви отримали лист від {sender} на {server}."
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."

  # Приватне повідомлення Discord, коли гравець отримує книжковий лист.
  dm-book-letter:
    - "📬 Ви отримали книжковий лист від {sender} на {server}."
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."

  # Приватне повідомлення Discord, коли гравець отримує посилку.
  dm-package:
    - "📦 Ви отримали посилку від {sender} на {server}."
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."

  # Приватне повідомлення Discord, коли гравець отримує COD-посилку.
  # Використовує {price}. У MailboxGUI 5.1.0 {price} може містити гроші Vault і предметну валюту.
  dm-cod-package:
    - "📦 Ви отримали COD-посилку від {sender} на {server}."
    - "Ціна: {price}"
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."

  # Приватне повідомлення Discord, коли гравець отримує COD-платіж предметною валютою.
  # Використовує {price}.
  dm-cod-item-currency-payment:
    - "💜 Ви отримали COD-платіж предметною валютою від {sender} на {server}."
    - "Платіж: {price}"
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."

  # Приватне повідомлення Discord, коли COD-посилку гравця повернуто.
  dm-returned-cod-package:
    - "↩️ Вашу COD-посилку було повернуто гравцем {sender} на {server}."
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."

  # Приватне повідомлення Discord, коли гравець отримує грошову пошту.
  # Використовує {amount}.
  dm-money-mail:
    - "💰 Ви отримали грошову пошту від {sender} на {server}."
    - "Сума: {amount}"
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."

  # Повідомлення каналу Discord, коли адмін/API-пошта доставлена кільком отримувачам.
  # Це повідомлення каналу завжди використовує discord-messages.default-language з config.yml.
  # Мови повідомлень Discord, вибрані гравцями, застосовуються лише до індивідуальних приватних повідомлень Discord.
  # Використовує {mention}; за потреби використовує {recipient_count}.
  admin-mass-mail-channel:
    - "{mention} 📬 **Сповіщення про серверну пошту**"
    - "Серверну пошту було надіслано кільком гравцям на {server}."
    - "Перевірте свою поштову скриньку, публічну поштову скриньку або NPC поштового відділення в грі."
简体中文 — zh_cn: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_zh_cn.yml
# 文件格式版本。供后续语言文件更新器识别使用。
# Contributor: nice
file-version: 3

# 游戏内 DiscBridge 指令消息使用的前缀。
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# 通用指令消息。
general:
  no-permission: "{prefix}&c你没有权限使用此指令。"
  players-only: "{prefix}&c只有玩家可以使用此指令。"
  unknown-command: "{prefix}&c未知指令。请使用 &e/mbdiscord help&c。"
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge 已重载。"

# 玩家状态消息。
status:
  header: "&bMailboxGUI-DiscBridge 状态"
  notifications-enabled: "&7Discord 邮件通知:&a已开启"
  notifications-disabled: "&7Discord 邮件通知:&c已关闭"
  online-dms-enabled: "&7在线时接收 Discord 私信:&a已开启"
  online-dms-disabled: "&7在线时接收 Discord 私信:&c已关闭"
  admin-ignored: "&7管理员/系统邮件私信:&c已屏蔽"
  admin-not-ignored: "&7管理员/系统邮件私信:&a已允许"

# 玩家和管理员帮助菜单文本。
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge 指令 &7(第 {page}/{total} 页)"
      - "&e/mbdiscord status &7- 查看你的 Discord 邮件通知设置。"
      - "&e/mbdiscord enable &7- 开启 Discord 邮件通知。"
      - "&e/mbdiscord disable &7- 关闭 Discord 邮件通知。"
      - "&e/mbdiscord online on|off|toggle &7- 设置在线时是否接收私信。"
      - "&e/mbdiscord language <language> &7- 设置 Discord 私信消息语言。"
      - "&e/mbdiscord ignore <player> &7- 屏蔽指定寄件人的 Discord 私信。"
      - "&e/mbdiscord unignore <player> &7- 取消屏蔽指定寄件人。"
      - "&e/mbdiscord ignorelist &7- 查看已屏蔽的寄件人。"
      - "&e/mbdiscord ignoreadmin &7- 屏蔽管理员/系统邮件私信。"
      - "&e/mbdiscord unignoreadmin &7- 允许管理员/系统邮件私信。"
    page-2:
      - "&bMailboxGUI-DiscBridge 管理员指令 &7(第 {page}/{total} 页)"
      - "&e/mbdiscord admin status &7- 查看桥接插件管理员状态。"
      - "&e/mbdiscord admin mode &7- 查看 LOCAL/NETWORK_NODE 模式诊断。"
      - "&e/mbdiscord admin reload &7- 重载桥接插件配置、语言和玩家数据。"
      - "&e/mbdiscord admin updatecheck &7- 检查官网发布系统中的更新。"
      - "&e/mbdiscord update &7- 准备最新更新。"
      - "&e/mbdiscord update confirm &7- 将已准备的更新加入下次重启安装队列。"
      - "&e/mbdiscord admin testdm <player> &7- 发送诊断用 Discord 私信。"
      - "&e/mbdiscord admin testchannel &7- 发送诊断用频道通知。"
    footer: "&7使用 &e/mbdiscord help <page> &7查看其他页面。"

# DiscordSRV 绑定状态和通知开关相关消息。
discord:
  not-linked: "{prefix}&c你的 Minecraft 账号尚未绑定 DiscordSRV。如果你刚刚完成绑定,请等待几秒后再尝试使用 &e/mbdiscord enable&c。"
  link-checking: "{prefix}&e正在检查你的 DiscordSRV 绑定状态..."
  enabled: "{prefix}&aDiscord 邮件通知已开启。"
  disabled: "{prefix}&cDiscord 邮件通知已关闭。"
  online-enabled: "{prefix}&a你在线时也会收到 Discord 邮件私信。"
  online-disabled: "{prefix}&e你只会在离线时收到 Discord 邮件私信。"

# 在线私信开关指令消息。
online:
  usage: "{prefix}&c用法:&e/mbdiscord online <on|off|toggle>"

# 玩家寄件人屏蔽列表相关指令消息。
ignore:
  usage-ignore: "{prefix}&c用法:&e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&c用法:&e/mbdiscord unignore <player>"
  added: "{prefix}&a你将不再接收来自 &e{player}&a 的 Discord 邮件私信。"
  removed: "{prefix}&a你现在会重新接收来自 &e{player}&a 的 Discord 邮件私信。"
  not-found: "{prefix}&c找不到名为 &e{player}&c 的已知玩家。"
  cannot-ignore-self: "{prefix}&c你不能屏蔽自己。"
  empty: "{prefix}&7你目前没有屏蔽任何玩家寄件人。"
  list-header: "&b已屏蔽的 Discord 邮件寄件人"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7管理员/系统邮件私信:&c已屏蔽"
  list-admin-allowed: "&7管理员/系统邮件私信:&a已允许"
  admin-enabled: "{prefix}&c你已屏蔽单独发送的管理员/系统邮件私信。"
  admin-disabled: "{prefix}&a你已允许单独发送的管理员/系统邮件私信。"

# 管理员指令消息和诊断输出。
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge 模式诊断"
      - "&7模式:&e{mode}"
      - "&7MailboxGUI 挂钩:{mailboxgui}"
      - "&7DiscordSRV 挂钩:{discordsrv}"
      - "&7MailboxGUI 网络模式:{mailboxgui_network}"
      - "&7网络通知节点:{network_node}"
      - "&aLOCAL 模式配置:"
      - "&7请在当前服务器安装 MailboxGUI、DiscordSRV 和 MailboxGUI-DiscBridge。"
      - "&7独立服务器或单后端服务器请使用此模式。"
    network-node:
      - "&bMailboxGUI-DiscBridge 模式诊断"
      - "&7模式:&e{mode}"
      - "&7MailboxGUI 挂钩:{mailboxgui}"
      - "&7DiscordSRV 挂钩:{discordsrv}"
      - "&7MailboxGUI 网络模式:{mailboxgui_network}"
      - "&7网络通知节点:{network_node}"
      - "&aNETWORK_NODE 模式配置:"
      - "&7请在每个使用邮件功能的后端服务器安装 MailboxGUI。"
      - "&7只在此通知后端安装 DiscordSRV 和 DiscBridge。"
      - "&7此后端会监听 MailboxGUI 的网络通知事件。"

  status:
    - "&bMailboxGUI-DiscBridge 管理员状态"
    - "&7MailboxGUI 挂钩:{mailboxgui}"
    - "&7DiscordSRV 挂钩:{discordsrv}"
    - "&7模式:&e{mode}"
    - "&7MailboxGUI 网络模式:{mailboxgui_network}"
    - "&7网络通知节点:{network_node}"
    - "&7语言:&e{language} &8| &7客户端语言:{client_locale} &8| &7备用语言:&e{fallback_language}"
    - "&7更新:{updates} &8| &7频道:&e{update_channel}"
    - "&7私信:{direct_messages}"
    - "&7群发邮件频道:{mass_channel}"
    - "&7@所有人:{mention_everyone}"
    - "&7群发邮件私信:{mass_dms} &8| &7上限:&e{mass_dm_limit} &8| &7处理方式:&e{mass_dm_behavior}"
    - "&7群发私信队列:{mass_dm_queue} &8| &7排队中:&e{queued_mass_dms}"
    - "&7重复保护:{duplicate_protection} &8| &7TTL:&e{dedupe_minutes} 分钟 &8| &7已追踪:&e{dedupe_events}"
    - "&7已加载玩家偏好:&e{player_count}"
    - "&7单独私信:&a{individual_delivered} 已送达 &8/ &e{individual_skipped} 已跳过 &8/ &c{individual_failed} 失败"
    - "&7群发通知:&a{mass_delivered} 已送达 &8/ &e{mass_skipped} 已跳过 &8/ &c{mass_failed} 失败"
  test-dm-usage: "{prefix}&c用法:&e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&c玩家 &e{player}&c 尚未通过 DiscordSRV 绑定。"
  test-dm-sent: "{prefix}&a已向 &e{player}&a 发送测试私信。"
  test-dm-failed: "{prefix}&c向 &e{player}&c 发送测试私信失败。请查看控制台获取详细信息。"
  test-channel-disabled: "{prefix}&cconfig.yml 中已关闭管理员群发邮件频道消息。"
  test-channel-missing: "{prefix}&cconfig.yml 中缺少管理员群发邮件 channel-id。"
  test-channel-sent: "{prefix}&a已发送测试频道消息。"
  test-channel-failed: "{prefix}&c发送测试频道消息失败。请查看控制台获取详细信息。"
Download Discord templates
disclanguage/messages_zh_cn.yml
# ============================================================
# MailboxGUI-DiscBridge Discord 消息模板
# Contributor: nice
# ============================================================
#
# 这些消息会发送到 Discord,不会发送到 Minecraft 聊天栏。
# Discord 消息发送前,插件会先移除占位符内容中的 Minecraft 颜色代码。
#
# 支持的占位符:
# {server}          config.yml 中 server-name 设置的服务器显示名称。
# {sender}          发件人显示名称。
# {recipient}       收件人名称,仅适用于单独发送的消息。
# {price}           货到付款包裹价格文本。支持 MailboxGUI 5.1.0 的 Vault 货币与物品付款文本。
# {amount}          货币邮件金额。
# {mention}         仅用于 admin-mass-mail-channel。
# {recipient_count} 群发邮件成功送达的收件人数。
#
# ============================================================

messages-version: 2

messages:

  # 玩家收到普通信件时发送的 Discord 私信。
  dm-letter:
    - "📬 你在 {server} 收到了来自 {sender} 的信件。"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"

  # 玩家收到书本信件时发送的 Discord 私信。
  dm-book-letter:
    - "📬 你在 {server} 收到了来自 {sender} 的书本信件。"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"

  # 玩家收到包裹时发送的 Discord 私信。
  dm-package:
    - "📦 你在 {server} 收到了来自 {sender} 的包裹。"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"

  # 玩家收到货到付款包裹时发送的 Discord 私信。
  # 使用 {price}。在 MailboxGUI 5.1.0 中,{price} 可以包含 Vault 货币与物品付款文本。
  dm-cod-package:
    - "📦 你在 {server} 收到了来自 {sender} 的货到付款包裹。"
    - "价格:{price}"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"

  # 玩家收到货到付款的物品付款邮件时发送的 Discord 私信。
  # 使用 {price}。
  dm-cod-item-currency-payment:
    - "💜 你在 {server} 收到了来自 {sender} 的货到付款物品支付款项。"
    - "付款内容:{price}"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"

  # 玩家的货到付款包裹被退回时发送的 Discord 私信。
  dm-returned-cod-package:
    - "↩️ 你的货到付款包裹已被 {sender} 在 {server} 退回。"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"

  # 玩家收到货币邮件时发送的 Discord 私信。
  # 使用 {amount}。
  dm-money-mail:
    - "💰 你在 {server} 收到了来自 {sender} 的货币邮件。"
    - "金额:{amount}"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"

  # 管理员/API 邮件送达多名玩家时发送到 Discord 频道的消息。
  # 此频道消息始终使用 config.yml 中 discord-messages.default-language 设置的语言。
  # 玩家自行选择的 Discord 消息语言只影响单独发送的 Discord 私信。
  # 使用 {mention};可选使用 {recipient_count}。
  admin-mass-mail-channel:
    - "{mention} 📬 **系统邮件通知**"
    - "系统邮件已在 {server} 发送给多名玩家。"
    - "请进入游戏,在“我的邮箱”、公共邮局信箱或邮局 NPC 处查看。"
繁體中文(香港) — zh_hk: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_zh_hk.yml
# 檔案格式版本。供日後語言檔更新器識別使用。
# Contributor: nice
file-version: 3

# 遊戲內 DiscBridge 指令訊息使用嘅前綴。
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# 通用指令訊息。
general:
  no-permission: "{prefix}&c你冇權限使用呢個指令。"
  players-only: "{prefix}&c只有玩家先可以使用呢個指令。"
  unknown-command: "{prefix}&c未知指令。請使用 &e/mbdiscord help&c。"
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge 已重新載入。"

# 玩家狀態訊息。
status:
  header: "&bMailboxGUI-DiscBridge 狀態"
  notifications-enabled: "&7Discord 郵件通知:&a已開啟"
  notifications-disabled: "&7Discord 郵件通知:&c已關閉"
  online-dms-enabled: "&7在線時接收 Discord 私訊:&a已開啟"
  online-dms-disabled: "&7在線時接收 Discord 私訊:&c已關閉"
  admin-ignored: "&7管理員/系統郵件私訊:&c已封鎖"
  admin-not-ignored: "&7管理員/系統郵件私訊:&a已允許"

# 玩家同管理員幫助選單文字。
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge 指令 &7(第 {page}/{total} 頁)"
      - "&e/mbdiscord status &7- 查看你嘅 Discord 郵件通知設定。"
      - "&e/mbdiscord enable &7- 開啟 Discord 郵件通知。"
      - "&e/mbdiscord disable &7- 關閉 Discord 郵件通知。"
      - "&e/mbdiscord online on|off|toggle &7- 設定在線時是否接收私訊。"
      - "&e/mbdiscord language <language> &7- 設定 Discord 私訊訊息語言。"
      - "&e/mbdiscord ignore <player> &7- 封鎖指定寄件人嘅 Discord 私訊。"
      - "&e/mbdiscord unignore <player> &7- 解除封鎖指定寄件人。"
      - "&e/mbdiscord ignorelist &7- 查看已封鎖嘅寄件人。"
      - "&e/mbdiscord ignoreadmin &7- 封鎖管理員/系統郵件私訊。"
      - "&e/mbdiscord unignoreadmin &7- 允許管理員/系統郵件私訊。"
    page-2:
      - "&bMailboxGUI-DiscBridge 管理員指令 &7(第 {page}/{total} 頁)"
      - "&e/mbdiscord admin status &7- 查看橋接插件管理員狀態。"
      - "&e/mbdiscord admin mode &7- 查看 LOCAL/NETWORK_NODE 模式診斷。"
      - "&e/mbdiscord admin reload &7- 重新載入橋接插件設定、語言同玩家資料。"
      - "&e/mbdiscord admin updatecheck &7- 檢查官方發佈系統入面嘅更新。"
      - "&e/mbdiscord update &7- 準備最新更新。"
      - "&e/mbdiscord update confirm &7- 將已準備好嘅更新加入下次重啟安裝隊列。"
      - "&e/mbdiscord admin testdm <player> &7- 發送診斷用 Discord 私訊。"
      - "&e/mbdiscord admin testchannel &7- 發送診斷用頻道通知。"
    footer: "&7使用 &e/mbdiscord help <page> &7查看其他頁面。"

# DiscordSRV 綁定狀態同通知開關相關訊息。
discord:
  not-linked: "{prefix}&c你嘅 Minecraft 帳號尚未綁定 DiscordSRV。如果你啱啱完成綁定,請等幾秒後再試用 &e/mbdiscord enable&c。"
  link-checking: "{prefix}&e正在檢查你嘅 DiscordSRV 綁定狀態..."
  enabled: "{prefix}&aDiscord 郵件通知已開啟。"
  disabled: "{prefix}&cDiscord 郵件通知已關閉。"
  online-enabled: "{prefix}&a你在線時亦會收到 Discord 郵件私訊。"
  online-disabled: "{prefix}&e你只會喺離線時收到 Discord 郵件私訊。"

# 在線私訊開關指令訊息。
online:
  usage: "{prefix}&c用法:&e/mbdiscord online <on|off|toggle>"

# 玩家寄件人封鎖列表相關指令訊息。
ignore:
  usage-ignore: "{prefix}&c用法:&e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&c用法:&e/mbdiscord unignore <player>"
  added: "{prefix}&a你將唔會再接收來自 &e{player}&a 嘅 Discord 郵件私訊。"
  removed: "{prefix}&a你而家會重新接收來自 &e{player}&a 嘅 Discord 郵件私訊。"
  not-found: "{prefix}&c搵唔到名為 &e{player}&c 嘅已知玩家。"
  cannot-ignore-self: "{prefix}&c你唔可以封鎖自己。"
  empty: "{prefix}&7你目前未有封鎖任何玩家寄件人。"
  list-header: "&b已封鎖嘅 Discord 郵件寄件人"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7管理員/系統郵件私訊:&c已封鎖"
  list-admin-allowed: "&7管理員/系統郵件私訊:&a已允許"
  admin-enabled: "{prefix}&c你已封鎖單獨發送嘅管理員/系統郵件私訊。"
  admin-disabled: "{prefix}&a你已允許單獨發送嘅管理員/系統郵件私訊。"

# 管理員指令訊息同診斷輸出。
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge 模式診斷"
      - "&7模式:&e{mode}"
      - "&7MailboxGUI 掛鉤:{mailboxgui}"
      - "&7DiscordSRV 掛鉤:{discordsrv}"
      - "&7MailboxGUI 網絡模式:{mailboxgui_network}"
      - "&7網絡通知節點:{network_node}"
      - "&aLOCAL 模式設定:"
      - "&7請喺目前伺服器安裝 MailboxGUI、DiscordSRV 同 MailboxGUI-DiscBridge。"
      - "&7獨立伺服器或單一後端伺服器請使用此模式。"
    network-node:
      - "&bMailboxGUI-DiscBridge 模式診斷"
      - "&7模式:&e{mode}"
      - "&7MailboxGUI 掛鉤:{mailboxgui}"
      - "&7DiscordSRV 掛鉤:{discordsrv}"
      - "&7MailboxGUI 網絡模式:{mailboxgui_network}"
      - "&7網絡通知節點:{network_node}"
      - "&aNETWORK_NODE 模式設定:"
      - "&7請喺每個使用郵件功能嘅後端伺服器安裝 MailboxGUI。"
      - "&7只需要喺此通知後端安裝 DiscordSRV 同 DiscBridge。"
      - "&7此後端會監聽 MailboxGUI 嘅網絡通知事件。"

  status:
    - "&bMailboxGUI-DiscBridge 管理員狀態"
    - "&7MailboxGUI 掛鉤:{mailboxgui}"
    - "&7DiscordSRV 掛鉤:{discordsrv}"
    - "&7模式:&e{mode}"
    - "&7MailboxGUI 網絡模式:{mailboxgui_network}"
    - "&7網絡通知節點:{network_node}"
    - "&7語言:&e{language} &8| &7用戶端語言:{client_locale} &8| &7備用語言:&e{fallback_language}"
    - "&7更新:{updates} &8| &7頻道:&e{update_channel}"
    - "&7私訊:{direct_messages}"
    - "&7群發郵件頻道:{mass_channel}"
    - "&7@所有人:{mention_everyone}"
    - "&7群發郵件私訊:{mass_dms} &8| &7上限:&e{mass_dm_limit} &8| &7處理方式:&e{mass_dm_behavior}"
    - "&7群發私訊隊列:{mass_dm_queue} &8| &7等待中:&e{queued_mass_dms}"
    - "&7重複保護:{duplicate_protection} &8| &7TTL:&e{dedupe_minutes} 分鐘 &8| &7已追蹤:&e{dedupe_events}"
    - "&7已載入玩家偏好:&e{player_count}"
    - "&7單獨私訊:&a{individual_delivered} 已送達 &8/ &e{individual_skipped} 已略過 &8/ &c{individual_failed} 失敗"
    - "&7群發通知:&a{mass_delivered} 已送達 &8/ &e{mass_skipped} 已略過 &8/ &c{mass_failed} 失敗"
  test-dm-usage: "{prefix}&c用法:&e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&c玩家 &e{player}&c 尚未透過 DiscordSRV 綁定。"
  test-dm-sent: "{prefix}&a已向 &e{player}&a 發送測試私訊。"
  test-dm-failed: "{prefix}&c向 &e{player}&c 發送測試私訊失敗。請查看控制台取得詳細資訊。"
  test-channel-disabled: "{prefix}&cconfig.yml 入面已關閉管理員群發郵件頻道訊息。"
  test-channel-missing: "{prefix}&cconfig.yml 入面缺少管理員群發郵件 channel-id。"
  test-channel-sent: "{prefix}&a已發送測試頻道訊息。"
  test-channel-failed: "{prefix}&c發送測試頻道訊息失敗。請查看控制台取得詳細資訊。"
Download Discord templates
disclanguage/messages_zh_hk.yml
# ============================================================
# MailboxGUI-DiscBridge Discord 訊息模板
# Contributor: nice
# ============================================================
#
# 以下訊息會發送到 Discord,不會發送到 Minecraft 聊天欄。
# 發送 Discord 訊息前,插件會先移除占位符內容入面嘅 Minecraft 顏色代碼。
#
# 支援嘅占位符:
# {server}          config.yml 入面 server-name 設定嘅伺服器顯示名稱。
# {sender}          寄件人顯示名稱。
# {recipient}       收件人名稱,只適用於單獨發送嘅訊息。
# {price}           貨到付款包裹價格文字。支援 MailboxGUI 5.1.0 嘅 Vault 貨幣同物品付款文字。
# {amount}          貨幣郵件金額。
# {mention}         只用於 admin-mass-mail-channel。
# {recipient_count} 群發郵件成功送達嘅收件人數。
#
# ============================================================

messages-version: 2

messages:

  # 玩家收到普通信件時發送嘅 Discord 私訊。
  dm-letter:
    - "📬 你喺 {server} 收到來自 {sender} 嘅信件。"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"

  # 玩家收到書本信件時發送嘅 Discord 私訊。
  dm-book-letter:
    - "📬 你喺 {server} 收到來自 {sender} 嘅書本信件。"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"

  # 玩家收到包裹時發送嘅 Discord 私訊。
  dm-package:
    - "📦 你喺 {server} 收到來自 {sender} 嘅包裹。"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"

  # 玩家收到貨到付款包裹時發送嘅 Discord 私訊。
  # 使用 {price}。喺 MailboxGUI 5.1.0 入面,{price} 可以包含 Vault 貨幣同物品付款文字。
  dm-cod-package:
    - "📦 你喺 {server} 收到來自 {sender} 嘅貨到付款包裹。"
    - "價格:{price}"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"

  # 玩家收到貨到付款嘅物品付款郵件時發送嘅 Discord 私訊。
  # 使用 {price}。
  dm-cod-item-currency-payment:
    - "💜 你喺 {server} 收到來自 {sender} 嘅貨到付款物品付款款項。"
    - "付款內容:{price}"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"

  # 玩家嘅貨到付款包裹被退回時發送嘅 Discord 私訊。
  dm-returned-cod-package:
    - "↩️ 你嘅貨到付款包裹已被 {sender} 喺 {server} 退回。"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"

  # 玩家收到貨幣郵件時發送嘅 Discord 私訊。
  # 使用 {amount}。
  dm-money-mail:
    - "💰 你喺 {server} 收到來自 {sender} 嘅貨幣郵件。"
    - "金額:{amount}"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"

  # 管理員/API 郵件送達多名玩家時,發送到 Discord 頻道嘅訊息。
  # 呢個頻道訊息一律使用 config.yml 入面 discord-messages.default-language 設定嘅語言。
  # 玩家自行選擇嘅 Discord 訊息語言,只會影響單獨發送嘅 Discord 私訊。
  # 使用 {mention};可選使用 {recipient_count}。
  admin-mass-mail-channel:
    - "{mention} 📬 **系統郵件通知**"
    - "系統郵件已喺 {server} 發送畀多名玩家。"
    - "請入遊戲,到「我的信箱」、公眾郵局信箱或郵局 NPC 查看。"
繁體中文(台灣) — zh_tw: complete in-game messages & Discord templates

Command keywords remain English in this version. These files translate the responses and Discord notifications, not the command structure.

Download in-game messages
language/messages_zh_tw.yml
# 檔案格式版本。供未來的語言更新程式使用。
file-version: 3

# 遊戲內 DiscBridge 指令訊息使用的前綴。
prefix: "&8[&bMailboxGUI-DiscBridge&8] "

# 一般指令訊息。
general:
  no-permission: "{prefix}&c你沒有權限使用此指令。"
  players-only: "{prefix}&c只有玩家可以使用此指令。"
  unknown-command: "{prefix}&c未知指令。請使用 &e/mbdiscord help&c。"
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge 已重新載入。"

# 玩家狀態訊息。
status:
  header: "&bMailboxGUI-DiscBridge 狀態"
  notifications-enabled: "&7Discord 郵件通知:&a已啟用"
  notifications-disabled: "&7Discord 郵件通知:&c已停用"
  online-dms-enabled: "&7線上時 Discord DM:&a已啟用"
  online-dms-disabled: "&7線上時 Discord DM:&c已停用"
  admin-ignored: "&7管理員/伺服器郵件 DM:&c已忽略"
  admin-not-ignored: "&7管理員/伺服器郵件 DM:&a已允許"

# 玩家與管理員指令說明文字。
commands:
  help:
    page-1:
      - "&bMailboxGUI-DiscBridge 命令 &7(第 {page}/{total} 頁)"
      - "&e/mbdiscord status &7- 查看你的 Discord 郵件通知設定。"
      - "&e/mbdiscord enable &7- 啟用 Discord 郵件通知。"
      - "&e/mbdiscord disable &7- 停用 Discord 郵件通知。"
      - "&e/mbdiscord online on|off|toggle &7- 控制線上時是否接收 DM。"
      - "&e/mbdiscord language <language> &7- 設定你的 Discord 私訊訊息語言。"
      - "&e/mbdiscord ignore <player> &7- 忽略某個寄件者的 Discord DM。"
      - "&e/mbdiscord unignore <player> &7- 取消忽略某個寄件者。"
      - "&e/mbdiscord ignorelist &7- 查看已忽略的寄件者。"
      - "&e/mbdiscord ignoreadmin &7- 忽略管理員/伺服器郵件 DM。"
      - "&e/mbdiscord unignoreadmin &7- 允許管理員/伺服器郵件 DM。"
    page-2:
      - "&bMailboxGUI-DiscBridge 管理命令 &7(第 {page}/{total} 頁)"
      - "&e/mbdiscord admin status &7- 查看橋接外掛管理狀態。"
      - "&e/mbdiscord admin mode &7- 查看 LOCAL/NETWORK_NODE 設定診斷。"
      - "&e/mbdiscord admin reload &7- 重新載入橋接外掛設定、語言與玩家資料。"
      - "&e/mbdiscord admin updatecheck &7- 檢查網站發佈系統中的更新。"
      - "&e/mbdiscord update &7- 準備最新更新。"
      - "&e/mbdiscord update confirm &7- 為下次重啟暫存準備好的更新。"
      - "&e/mbdiscord admin testdm <player> &7- 傳送診斷 Discord DM。"
      - "&e/mbdiscord admin testchannel &7- 傳送診斷頻道通知。"
    footer: "&7使用 &e/mbdiscord help <page> &7查看其他頁面。"

# DiscordSRV 綁定與通知開關訊息。
discord:
  not-linked: "{prefix}&c你的 Minecraft 帳號尚未綁定 DiscordSRV。如果你剛剛綁定,請等待幾秒後再嘗試 &e/mbdiscord enable&c。"
  link-checking: "{prefix}&e正在檢查你的 DiscordSRV 綁定狀態..."
  enabled: "{prefix}&aDiscord 郵件通知已啟用。"
  disabled: "{prefix}&cDiscord 郵件通知已停用。"
  online-enabled: "{prefix}&a你在線上時也會收到 Discord 郵件 DM。"
  online-disabled: "{prefix}&e你只會在離線時收到 Discord 郵件 DM。"

# 線上 DM 指令訊息。
online:
  usage: "{prefix}&c用法:&e/mbdiscord online <on|off|toggle>"

# 玩家寄件者忽略清單指令訊息。
ignore:
  usage-ignore: "{prefix}&c用法:&e/mbdiscord ignore <player>"
  usage-unignore: "{prefix}&c用法:&e/mbdiscord unignore <player>"
  added: "{prefix}&a你將不再收到來自 &e{player}&a 的 Discord 郵件 DM。"
  removed: "{prefix}&a你將再次收到來自 &e{player}&a 的 Discord 郵件 DM。"
  not-found: "{prefix}&c找不到名為 &e{player}&c 的已知玩家。"
  cannot-ignore-self: "{prefix}&c你不能忽略自己。"
  empty: "{prefix}&7你沒有忽略任何玩家寄件者。"
  list-header: "&b已忽略的 Discord 郵件寄件者"
  list-entry: "&7- &e{player}"
  list-admin-ignored: "&7管理員/伺服器郵件 DM:&c已忽略"
  list-admin-allowed: "&7管理員/伺服器郵件 DM:&a已允許"
  admin-enabled: "{prefix}&c你現在會忽略單獨的管理員/伺服器郵件 DM。"
  admin-disabled: "{prefix}&a你現在會允許單獨的管理員/伺服器郵件 DM。"

# 管理員指令訊息與診斷輸出。
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge 模式診斷"
      - "&7模式: &e{mode}"
      - "&7MailboxGUI 掛鉤: {mailboxgui}"
      - "&7DiscordSRV 掛鉤: {discordsrv}"
      - "&7MailboxGUI 網路模式: {mailboxgui_network}"
      - "&7網路通知節點: {network_node}"
      - "&aLOCAL 模式設定:"
      - "&7在此伺服器上安裝 MailboxGUI、DiscordSRV 和 MailboxGUI-DiscBridge。"
      - "&7獨立/單後端伺服器使用此模式。"
    network-node:
      - "&bMailboxGUI-DiscBridge 模式診斷"
      - "&7模式: &e{mode}"
      - "&7MailboxGUI 掛鉤: {mailboxgui}"
      - "&7DiscordSRV 掛鉤: {discordsrv}"
      - "&7MailboxGUI 網路模式: {mailboxgui_network}"
      - "&7網路通知節點: {network_node}"
      - "&aNETWORK_NODE 設定:"
      - "&7在每個使用郵件的後端上安裝 MailboxGUI。"
      - "&7只在此通知後端安裝 DiscordSRV 和 DiscBridge。"
      - "&7此後端監聽 MailboxGUI 網路通知事件。"

  status:
    - "&bMailboxGUI-DiscBridge 管理狀態"
    - "&7MailboxGUI 掛鉤:{mailboxgui}"
    - "&7DiscordSRV 掛鉤:{discordsrv}"
    - "&7私人訊息:{direct_messages}"
    - "&7群發郵件頻道:{mass_channel}"
    - "&7提及所有人:{mention_everyone}"
    - "&7已載入玩家偏好:&e{player_count}"
    - "&7單獨 DM:&a{individual_delivered} 已送達 &8/ &e{individual_skipped} 已跳過 &8/ &c{individual_failed} 失敗"
    - "&7群發通知:&a{mass_delivered} 已送達 &8/ &e{mass_skipped} 已跳過 &8/ &c{mass_failed} 失敗"
  test-dm-usage: "{prefix}&c用法:&e/mbdiscord admin testdm <player>"
  test-dm-not-linked: "{prefix}&c玩家 &e{player}&c 未透過 DiscordSRV 綁定。"
  test-dm-sent: "{prefix}&a測試 DM 已傳送給 &e{player}&a。"
  test-dm-failed: "{prefix}&c無法向 &e{player}&c 傳送測試 DM。請查看控制台了解詳情。"
  test-channel-disabled: "{prefix}&c管理員群發郵件頻道訊息已在 config.yml 中停用。"
  test-channel-missing: "{prefix}&cconfig.yml 中缺少管理員群發郵件的 channel-id。"
  test-channel-sent: "{prefix}&a測試頻道訊息已傳送。"
  test-channel-failed: "{prefix}&c無法傳送測試頻道訊息。請查看控制台了解詳情。"
Download Discord templates
disclanguage/messages_zh_tw.yml
# ============================================================
# MailboxGUI-DiscBridge Discord 訊息範本
# ============================================================
#
# 這些訊息會傳送到 Discord,而不是 Minecraft 聊天。
# 在傳送 Discord 訊息之前,會從預留位置值中移除 Minecraft 顏色代碼。
#
# 支援的預留位置:
# {server}          config.yml 中 server-name 的伺服器顯示名稱。
# {sender}          寄件者顯示名稱。
# {recipient}       收件者名稱,可用於個別訊息。
# {price}           COD 包裹價格文字。支援 MailboxGUI 5.1.0 的 Vault 金錢與物品貨幣文字。
# {amount}          金錢郵件金額。
# {mention}         僅用於 admin-mass-mail-channel。
# {recipient_count} 群發郵件成功送達的收件者數量。
#
# ============================================================

messages-version: 2

messages:

  # 玩家收到經典信件時傳送的 Discord 私訊。
  dm-letter:
    - "📬 你在 {server} 收到了來自 {sender} 的信件。"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"

  # 玩家收到書本信件時傳送的 Discord 私訊。
  dm-book-letter:
    - "📬 你在 {server} 收到了來自 {sender} 的書本信件。"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"

  # 玩家收到包裹時傳送的 Discord 私訊。
  dm-package:
    - "📦 你在 {server} 收到了來自 {sender} 的包裹。"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"

  # 玩家收到 COD 包裹時傳送的 Discord 私訊。
  # 使用 {price}。在 MailboxGUI 5.1.0 中,{price} 可以包含 Vault 金錢與物品貨幣。
  dm-cod-package:
    - "📦 你在 {server} 收到了來自 {sender} 的 COD 包裹。"
    - "價格:{price}"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"

  # 玩家收到物品貨幣 COD 付款郵件時傳送的 Discord 私訊。
  # 使用 {price}。
  dm-cod-item-currency-payment:
    - "💜 你在 {server} 收到了來自 {sender} 的物品貨幣 COD 付款。"
    - "付款:{price}"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"

  # 玩家的 COD 包裹被退回時傳送的 Discord 私訊。
  dm-returned-cod-package:
    - "↩️ 你在 {server} 的 COD 包裹已被 {sender} 退回。"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"

  # 玩家收到金錢郵件時傳送的 Discord 私訊。
  # 使用 {amount}。
  dm-money-mail:
    - "💰 你在 {server} 收到了來自 {sender} 的金錢郵件。"
    - "金額:{amount}"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"

  # 管理員/API 郵件傳送給多名收件者時傳送的 Discord 頻道訊息。
  # 此頻道訊息一律使用 config.yml 中的 discord-messages.default-language。
  # 玩家選擇的 Discord 訊息語言只會影響個別 Discord 私訊。
  # 使用 {mention};也可使用 {recipient_count}。
  admin-mass-mail-channel:
    - "{mention} 📬 **伺服器郵件通知**"
    - "伺服器郵件已在 {server} 傳送給多名玩家。"
    - "請在遊戲中查看你的信箱、公共郵局信箱或郵局 NPC。"
Back to top ↑

Free networking

Historical Free network setup

  1. Install MailboxGUI 5.1.1 on every backend that uses mail, with consistent storage/item compatibility and a unique backend server-id.
  2. Configure shared MySQL/MariaDB storage in each MailboxGUI main config, then enable MailboxGUI network mode using the same Redis service/channel on each backend. YAML and SQLite cannot be the shared network storage.
  3. Choose exactly ONE notification backend. Install DiscordSRV and DiscBridge 1.1.1 beside MailboxGUI on that backend only; do not install them on the proxy or every backend.
  4. Set mode: NETWORK_NODE in DiscBridge config.yml. DiscBridge obtains the backend’s Redis settings and online presence from MailboxGUI itself; do not add separate database/Redis credentials to DiscBridge config.
  5. Keep direct-message opt-in and language preferences on the notification node. There is no shared preference database or remote integrated player-command system in 1.1.1.
  6. Run /mbdiscord admin mode and /mbdiscord admin status on the node. Send actual individual and admin/API mass mail from a different backend and verify notifications.
  7. Check offline and online cases separately. Network presence considers players online on other backends too.
DiscBridge 1.1.1 — mode selection
mode: NETWORK_NODE
MailboxGUI 5.1.1 network/config.yml — excerpt, not a complete file
network:
  enabled: true
  server-id: survival
  server-display-name: "Survival"
  require-shared-storage: true
mysql:
  require-active-storage-type: MYSQL
redis:
  host: 127.0.0.1
  port: 6379
  password: ""
  database: 0
  use-ssl: false
  channels:
    network: "mailboxgui:network"
Complete MailboxGUI 5.1.1 Free networking instructions
Back to top ↑

Free networking

Network diagnostics & limits

  • NETWORK_NODE disables safely if MailboxGUI network mode is off on the notification backend.
  • Check the MailboxGUI Redis host, port, password, TLS setting and network channel; the subscriber reuses these settings and reconnects using MailboxGUI’s configured delay.
  • Both individual mail_delivered and mass_mail_delivered messages are processed. Incomplete payloads or unsupported delivery types are skipped.
  • The node reads MailboxGUI presence for online-DM decisions, including optional batch DMs.
  • Only the node’s local data/players.yml contains DiscBridge preferences. Do not assume all backends share opt-ins just because mail storage is shared.
  • Run only one node. An independent node has its own duplicate-event memory; running several is not reliable duplicate prevention.

After changing the underlying MailboxGUI network configuration, refresh MailboxGUI appropriately and reload DiscBridge on the notification backend so its subscriber reads the current settings.

Back to top ↑

Maintenance & support

Update checking & safe upgrades

  1. Back up the JAR and plugin data before upgrading. Review MailboxGUI/DiscBridge compatibility before staging either product.
  2. Run /mbdiscord admin updatecheck to inspect the configured website channel.
  3. Run /mbdiscord update to prepare the proposed release.
  4. Only run /mbdiscord update confirm when the proposed target is appropriate for your MailboxGUI installation.
  5. The updater downloads the JAR to Bukkit’s update folder for the next normal server restart. It does not replace the running plugin immediately.
Historical update sequence
/mbdiscord admin updatecheck
/mbdiscord update
/mbdiscord update confirm

Startup checks and permission-gated join notices are controlled by updates settings. /mbdiscord admin reload is not an installation mechanism for a newly staged JAR.

Back to top ↑

Maintenance & support

Upgrading & historical migration

  1. Back up config.yml, data/players.yml, language/, disclanguage/ and the old JAR before starting a newer compatible build.
  2. Older templates embedded in config.yml or a root messages.yml are migrated to English disclanguage messages. The former root messages file is backed up and removed after migration.
  3. Missing bundled config/message keys are synchronized. Version changes use the bundled structure while preserving compatible custom values; selected unchanged older defaults may be refreshed.
  4. 1.1.1 uses config-version 3, language and locale-detection. Do not copy the later locale schema into this version.
  5. Review the managed backups and actual generated files after migration. Do not arbitrarily increase schema version markers or delete the preference data to fix a language issue.
Back to top ↑

Maintenance & support

Configuration & language synchronization

Startup and /mbdiscord admin reload synchronize the local configuration and both language folders with this version’s bundled defaults. This is local file maintenance, not a website synchronization service.

LocationPurpose
backups/config/Managed config backup before supported synchronization.
backups/language/messages_<locale>-before-sync.ymlIn-game language file before its synchronization.
backups/disclanguage/messages_<locale>-before-sync.ymlDiscord template file before its synchronization.
backups/disclanguage/messages-before-disclanguage.ymlOld root messages.yml before migration.
Back to top ↑

Maintenance & support

Files, player data & privacy

Path under plugins/MailboxGUI-DiscBridge/Contains
config.ymlDelivery/update settings and this version’s locale configuration.
language/messages_<locale>.ymlIn-game command text.
disclanguage/messages_<locale>.ymlDiscord delivery templates.
data/players.ymlUUID-keyed names, opt-in, online preference, admin ignore, DM language and ignored sender UUID/name entries.
backups/Managed synchronization backups.

Preferences are saved when commands change them and loaded on startup/reload. Do not publish player data or real bot/database credentials when sharing a configuration. Use sanitized excerpts for support.

Delivery counters, recent event IDs and the batch-DM queue are runtime state, not persistent delivery receipts. Do not interpret a successful Discord message as proof the player collected or paid for the in-game mail.

Back to top ↑

Maintenance & support

MailboxGUI API integrations

DiscBridge listens to MailboxGUI individual and mass-delivery events. Compatible addons should send mail through the matching MailboxGUI API so delivery metadata is emitted correctly; posting a Discord message directly does not deliver in-game mail.

MailboxGUI 5.1.1 public API guide
Back to top ↑

Maintenance & support

Troubleshooting & verification checklist

SymptomCheck
Plugin disabled on startupConfirm MailboxGUI and DiscordSRV are present and enabled, the release pair matches, and no duplicate JAR is installed. Read the first console startup error.
Test DM works but real mail is silentCheck opt-in, global DMs, online preference, ignored sender/admin state and actual delivery events. Diagnostic sends bypass normal eligibility.
Book-letter notification missingUse the matching MailboxGUI delivery types and ensure dm-book-letter exists in the effective Discord language.
Wrong Discord DM language/mbdiscord language changes the saved Discord template language. Client locale only affects in-game responses.
Wrong mass-channel languageEdit discord-messages.default-language, then reload. Player selections do not affect the shared channel.
COD price blank/incompleteUse matching MailboxGUI metadata and {price}, not just a money-only assumption. Type-specific placeholders can be empty on unrelated mail.
No batch DMsDisabled by default. Enable the setting, inspect eligible count and the over-limit behavior, and check recipients’ normal DM eligibility.
No channel announcementEnable the setting, supply a channel ID, confirm bot access/send permissions and run testchannel.
Online player gets no DMAllow online DMs via the global default or /mbdiscord online on; notifications must still be enabled.
Duplicate / lost batch noticesUse only the supported notification setup and remember duplicate protection and queues are in memory; reload clears them.
Update staged but version unchangedA staged JAR is applied on the next normal server restart, not by admin reload. Check compatibility before restarting.
  1. Verify startup, /mbdiscord admin status and mode diagnostics.
  2. Link a test player using DiscordSRV; opt in and test offline/online delivery separately.
  3. Test each supported mail type, including item-currency COD payment and returned COD notifications.
  4. Test a shared admin/API batch, then the optional batch-DM limit and over-limit policy.
  5. Test a second Discord language and compare its DM with the configured shared-channel language.
  6. For NETWORK_NODE, send mail from another backend and confirm cross-backend presence affects online-DM eligibility.
  7. Back up edited files, reload, and confirm your intended changes remain.
Back to top ↑

Maintenance & support

Support & choosing a newer release

For setup questions, configuration help or migration advice, visit the ImagineCraft Plugin Support page. Include the exact versions of MailboxGUI, DiscBridge, DiscordSRV, server platform and Java, a sanitized config excerpt and relevant startup errors.

ImagineCraft Plugin Support Discord information Current DiscBridge 2.1.0 guide

Historical version behavior is documented here for reference. Use a current compatible release pair for current features and supported troubleshooting.

Back to top ↑