Start here

Overview & edition pairing

Source-reviewed October 10, 2026 against the current 2.1.0 Free/Premium code, bundled defaults and 2.1.0 patch notes. This guide is text-only; the clean references below are bundled defaults, not private server configuration.

MailboxGUI-DiscBridge 2.1.0 is a separate DiscordSRV notification addon. MailboxGUI owns mail storage, delivery, inboxes, COD, claims and scheduling; DiscBridge turns delivery events into Discord DMs or channel notices. It does not deliver items through Discord, provide a separate bot, replace MailboxGUI or run on your proxy.

This guide describes the supplied 2.1.0 implementation, not a release announcement. Check Downloads for the editions/builds actually available. Older 2.0.0/1.1.1 documentation remains available in the Wiki Version selector.

MailboxGUI editionDiscBridge edition / result
6.1.0+ Free2.1.0 Free — supported LOCAL pairing
6.1.0+ Premium2.1.0 Premium — supported LOCAL or Premium NETWORK_NODE
Free + Premium, or Premium + FreeUnsupported: DiscBridge disables itself before configuration/data migration.
MailboxGUI 6.0.0 or 5.xNot supported by DiscBridge 2.1.0. Upgrade the matched pair safely.
Download Free / Premium builds MailboxGUI 6.1.0 guide
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

Free & Premium feature comparison

The two columns below compare the full notification workflow. Every multi-backend networking feature is Premium only. Premium also works standalone when MailboxGUI networking is disabled. DiscBridge has no independent network toggle.

Free EditionPremium Edition
Edition pairingMailboxGUI 6.1.0+ Free, subject to the release’s compatibility contract.Edition pairingMailboxGUI 6.1.0+ Premium, subject to the release’s compatibility contract.
Minecraft account linkingUses DiscordSRV, not website Discord linking.Minecraft account linkingUses DiscordSRV on the notifier; website linking is separate.
Single-backend operationLOCAL, no network configuration or network features.Single-backend operationLOCAL when MailboxGUI network/config.yml disables networking; no companion toggle.
Letters and Book LettersIndividual delivery DMs.Letters and Book LettersSame, plus Premium network delivery events.
Packages and COD packagesIndividual package and price notifications.Packages and COD packagesSame, plus Premium origin/routing context.
COD payment/return mailItem-currency payments and returned package notifications.COD payment/return mailSame, plus Premium network metadata.
Money mailAmount notifications.Money mailSame, plus Premium network metadata.
Attached messagesIndependent message/no-message variants for five non-letter mail types.Attached messagesSame variants with Premium network sections.
Expiration-aware DMsSeparate expiration templates and localized server-time dates.Expiration-aware DMsSame, plus Premium expiration_remaining seconds.
Notification opt-inPer-player enabled/disabled; off initially.Notification opt-inSame; network preferences are authoritative shared records.
Online-DM controlsPer-player on/off/toggle and server default.Online-DM controlsSame, checked against network-wide presence in Premium NETWORK_NODE.
Sender/admin ignoreIgnore known player senders or individual admin/server mail.Sender/admin ignoreSame, persisted through the single Premium host and usable from participating MailboxGUI backends.
Individual DM languagesSaved Discord language first; otherwise MailboxGUI locale.default. Never selected by Minecraft client locale.Individual DM languagesSame 16 locales, including translated Premium diagnostics/templates.
Channel notice languageMailboxGUI config.yml locale.default.Channel notice languageSame; not selected by individual recipients.
Admin/API mass mailOne channel notice for a mass delivery; individual mass DMs optional.Admin/API mass mailSame, dispatched only by the designated ready Premium notifier.
Mass-DM recipient limitsEligibility checks, caps and channel_only/send_first_max policies.Mass-DM recipient limitsSame, including checks again before durable retries.
Mass-DM pacing/retriesOptional queue, pacing and configurable additional retries.Mass-DM pacing/retriesSame; Premium network journal polls every five seconds.
Discord templates26 bundled template keys per locale; Discord Markdown supported.Discord templatesSame keys with Premium optional backend/routing sections.
Safe placeholder substitutionMinecraft formatting stripped; untrusted payload formatting/mentions escaped.Safe placeholder substitutionSame safety, including Premium metadata.
Duplicate protectionLOCAL recent event-ID cache and separate durable notification outbox; no exactly-once guarantee.Duplicate protectionSame outbox, plus independent stable shared network dispatch identities in NETWORK_NODE; not exactly-once.
Automatic/manual updatesFree release channel; no website credentials.Automatic/manual updatesProtected Premium channel with valid product entitlement and console-set credentials.
Safe update stagingEdition/product/version jar validation; apply on planned restart.Safe update stagingSame, with trusted-host authentication.
Config/language synchronizationBacked-up updates preserve custom values/comments while retiring duplicated locale settings.Config/language synchronizationSame; mode and backend identity inherit MailboxGUI networking.
Installation snapshotsLocal pre-upgrade backup before version/edition synchronization.Installation snapshotsSame; does not back up remote MySQL/Redis state.
Commands and completionIntegrated /mb settings discord and /mba discord; six-entry help pages, a player guide and MailboxGUI-owned syntax.Commands and completionSame plus paged Premium administration entries.
Metrics and diagnosticsbStats and session delivered/skipped/failed counts.Metrics and diagnosticsSame plus Premium network status and sanitized support reports.
Network notificationsNot included.Network notificationsPremium only: local/remote MailboxGUI network events.
Single notifier backendNot included.Single notifier backendPremium only: exactly ONE backend with DiscBridge + DiscordSRV; inherited identity, duplicate-host guards and no automatic failover.
Shared notification preferencesLocal players.yml records.Shared notification preferencesPremium only in NETWORK_NODE: shared revision-safe preferences; local choices imported safely.
Origin/notifier distinctionNot included.Origin/notifier distinctionPremium only: origin backend differs from the backend sending Discord messages.
Backend targeting/groupsNot included.Backend targeting/groupsPremium only: displays MailboxGUI target backends, backend groups and restriction reason; does not change claim rules.
Multiverse contextNo network features.Multiverse contextPremium notifications can describe MailboxGUI logical backends/groups; world/backend mapping is configured in MailboxGUI, not DiscBridge.
Unknown routing/presenceLocal eligibility checks.Unknown routing/presencePremium only: unknown routing warns users; unavailable presence/preferences pause affected sends.
Network dispatch recoveryLocal outbox retention.Network dispatch recoveryPremium only: durable staging/shared jobs and bounded retries; jobs age out after 24 hours.
Sanitized support reportsNot included.Sanitized support reportsPremium only: network/diagnostics JSON without credentials, tokens, mail bodies, item contents or customer IDs.
Optional Spigot linkingNo Premium entitlement linking.Optional Spigot linkingPremium only: product-specific website verification; never grants MailboxGUI Premium automatically.
Player command setup gateOff by default; explicit enable requires connected DiscordSRV and a ready account-link manager.Player command setup gateSame; remote requests use the companion host’s setup state.
Compatibility preflightMailboxGUI-owned minimum companion version and protocol checked before migration, independent of update-check settings.Compatibility preflightSame; incompatible host status blocks remote normal commands.
Integrated remote commandsLocal companion installation required; no network transport.Integrated remote commandsPremium: one companion host can serve commands on participating MailboxGUI Premium backends.
Disabled-build update recoverySupported builds retain authorized update-only recovery; older jars may need manual replacement.Disabled-build update recoverySame plus remote recovery through a compatible Premium host/transport.
Back to top ↑

Start here

Requirements & compatibility

  • Spigot/Paper/Purpur-compatible Bukkit backend, not a Velocity/BungeeCord proxy.
  • MailboxGUI 6.1.0 or later in the matching Free/Premium edition, with compatible integration services. The current semantic-version gate has a minimum, not a 6.x-only maximum; future releases must still satisfy their actual protocol/API requirements.
  • DiscordSRV installed and enabled beside DiscBridge on the standalone backend, or on exactly ONE companion backend in Premium network mode. The project builds against DiscordSRV 1.28.0; your installed DiscordSRV must provide the Discord API expected by this build and support your server runtime.
  • Plugin bytecode targets Java 17. Use the Java required by your server jar: the project README lists Java 21 for 1.20.5–1.21.11 and Java 25 for 26.1–26.3.
  • The project targets 1.18.2–1.21.11 and 26.1–26.3 backends. Experimental/beta server builds and real Discord connectivity still require server testing; a build-time API check is not certification.
  • Premium network notifications additionally require MailboxGUI Premium’s ready public network API, shared MySQL/MariaDB and Redis. DiscBridge uses that API; it has no separate database/Redis connection configuration.

Use the final shaded release jar for your edition, not a Maven original-* artifact. The supplied plugin descriptors do not declare Folia support. DiscordSRV being installed is not the same as its bot being connected; player-command readiness also requires a working account-link manager.

MailboxGUI also owns a release-specific minimum DiscBridge version and allowed integration protocol range. The audited MailboxGUI 6.1.0 source requires DiscBridge 2.1.0 or newer with protocol 1; DiscBridge 2.1.0 reports protocol 1. It checks that contract before data migration or normal service registration, even when updates.enabled is false. Compatible releases do not require lockstep updates; incompatible DiscBridge disables itself while MailboxGUI remains enabled and stored companion data is preserved. Check status/console for installed version, required minimum and protocol range.

Back to top ↑

Start here

Install Free on a standalone server

  1. Back up your plugins and existing MailboxGUI/DiscBridge data. Use the server’s normal planned shutdown/start procedure for jar installation.
  2. Install matching MailboxGUI Free and DiscBridge Free alongside a compatible DiscordSRV jar in the same backend plugins folder. Keep only one DiscBridge edition jar.
  3. Configure DiscordSRV’s bot and Minecraft linking. Start the backend and confirm all three plugins are enabled.
  4. Edit plugins/MailboxGUI-DiscBridge/config.yml if desired; Free always runs in LOCAL mode and has no network.enabled option to turn on networking.
  5. Run /mba discord reload for config/template edits, then follow the player opt-in steps and real-mail test below.
Free backend plugin layout
plugins/
├── MailboxGUI-6.1.0.jar
├── DiscordSRV.jar
└── MailboxGUI-DiscBridge-2.1.0.jar
First checks and deliberate player-command enablement
/mba discord help
/mba discord status
/mba discord mode
/mba discord playercommands on
/mb settings discord help
DiscBridge config.yml — player command gate
player-commands:
  enabled: false
Back to top ↑

Start here

Install Premium without networking

  1. Install MailboxGUI Premium, DiscBridge Premium and DiscordSRV on the same backend. Do not mix editions or keep both edition jars.
  2. Set network.enabled: false in plugins/MailboxGUI/network/config.yml. DiscBridge inherits LOCAL mode; do not add a network switch or notifier ID to its own config.yml.
  3. After MailboxGUI networking edits, run /mba reload: Premium automatically refreshes the enabled local DiscBridge network state without reloading companion files. Run /mba discord reload separately when companion configuration, languages or templates need reloading. Configure DiscordSRV; check /mba discord status and enable player commands after connection/link-manager readiness. Confirm LOCAL and test real individual and mass mail.
  4. Configure website update credentials from the server console only if you want protected Premium updates. Buying/linking one Premium product does not unlock the other.
MailboxGUI network/config.yml — Premium standalone fragment
network:
  enabled: false

Premium network installation — one host only

Single-backend DiscBridge host: full Premium network setup
Back to top ↑

Start here

Operating modes: LOCAL & Premium NETWORK_NODE

ModeCurrent 2.1.0 behavior
Free LOCALAlways local. No network switch or remote notifications.
Premium LOCALMailboxGUI network/config.yml network.enabled: false. Local delivery/preferences.
Premium NETWORK_NODEMailboxGUI network/config.yml network.enabled: true. Waits for MailboxGUI network readiness and single-host ownership.

DiscBridge inherits mode from MailboxGUI Premium and the notifier identity from its cached local backend ID. Do not add mode, network.enabled or network-node.notifier-backend-id to DiscBridge config.yml. After changing MailboxGUI networking, run /mba reload: Premium automatically refreshes the enabled local DiscBridge network state only. It does not reload companion configuration, language files or templates; use /mba discord reload for those files. The mode command reports diagnostics; it does not change the mode. Unknown/unready networking waits instead of enabling unsafe local sends.

Back to top ↑

Using notifications

DiscordSRV & player account linking

Before players use the commands below, an administrator must enable player-commands after DiscordSRV setup. This server-wide gate is separate from each player’s notification opt-in and from the direct-messages master switch. Turning commands off hides help/completion and blocks preference edits; it does not erase saved preferences or automatically stop otherwise eligible existing DMs.

  1. Configure the DiscordSRV bot using DiscordSRV’s own instructions and keep its token private. DiscBridge does not have a bot-token setting.
  2. Invite/configure the bot and confirm DiscordSRV reports a ready Discord connection.
  3. For mass notices, choose a Discord TEXT channel and give the bot View Channel and Send Messages; allow Mention Everyone only if you intentionally enable it. DiscBridge’s current transport does not target a forum channel or create support threads.
  4. Link the player’s Minecraft identity through DiscordSRV. The usual command is /discord link; follow the link-code instructions shown by your configured DiscordSRV setup.
  5. Run /mb settings discord enable. A recently linked account may need a few seconds for the DiscordSRV lookup to refresh; enable performs a delayed recheck if the account was not immediately found.
  6. Check /mb settings discord status, choose a DM language, and optionally allow DMs while online. Enable Discord privacy settings that permit messages from the server bot.
Player setup — DiscordSRV commands followed by DiscBridge preferences
/discordsrv link
/discordsrv linked
/mb settings discord enable
/mb settings discord language en
/mb settings discord online on
/mb settings discord status

DiscordSRV supplies /discordsrv link and /discordsrv linked; /discord is its alternate root unless another plugin has claimed it. Its link command gives your server’s linking instructions. Send the code privately as instructed, never into a public channel. DiscordSRV’s linked command checks the Minecraft link; DiscBridge status only reports notification preferences. Your permission setup must allow the relevant DiscordSRV linking commands.

DiscordSRV official setup documentation DiscordSRV official linking commands Plugin support & Discord access guide
Back to top ↑

Using notifications

Mail types & notification eligibility

Individual delivery notifications cover player, admin, API and system-origin mail. Supported types are classic Letters, Book Letters, packages, COD packages, COD item-currency payment mail, returned COD packages and money mail. DiscBridge listens to actual delivery events: composing/scheduling mail is not the same as delivering it.

A real DM must pass every check

  • The direct-messages master switch is enabled and a recipient UUID is present.
  • DiscordSRV resolves that Minecraft UUID to a Discord account.
  • The player has opted in; new preferences start with notifications disabled and online-DM preference off.
  • The recipient is offline OR the global online-DM default permits it OR the player enabled online DMs.
  • The player is not ignoring this player-origin sender, and is not ignoring admin-like mail for an admin/API/system notification.
  • For Premium NETWORK_NODE, notifier ownership/readiness, authoritative shared preferences and network-wide presence must also be available. Unknown remote presence is not treated as offline.

Receiving a Discord message does not claim the mail, settle COD, extend expiration or prove the recipient can claim on the current backend. Open MailboxGUI in-game to inspect and claim it. Ignoring a sender changes notification delivery, not MailboxGUI’s actual mail storage or delivery.

Admin/API deliveries to two or more recipients use the mass-delivery workflow. Per-recipient events belonging to admin-like mass mail are not sent again as ordinary individual DMs.

Normal DMs resolve cold DiscordSRV link caches asynchronously rather than immediately skipping an actually linked player. Retry/dispatch resolves the current link again and rechecks notification, online-DM and ignore choices. A temporary presence/preference read failure retains admitted work without authorizing a send to an old or unknown account. Link changes and stale callbacks must not redirect notifications to an obsolete link.

Player notification permissions do not replace these eligibility checks. Conversely, removing a preference-command permission does not erase an existing opt-in or turn off delivery automatically. Use the player disable command or the appropriate master notification switch when you intend to stop DMs.

Mail typeStandard keyExpiration keyAttached-message keys
Classic letterdm-letterdm-letter-expireNo attached-message variants
Book letterdm-book-letterdm-book-letter-expireNo attached-message variants
Packagedm-packagedm-package-expiredm-package-with-message / dm-package-with-message-expire
COD packagedm-cod-packagedm-cod-package-expiredm-cod-package-with-message / dm-cod-package-with-message-expire
COD item-currency paymentdm-cod-item-currency-paymentdm-cod-item-currency-payment-expiredm-cod-item-currency-payment-with-message / dm-cod-item-currency-payment-with-message-expire
Returned COD packagedm-returned-cod-packagedm-returned-cod-package-expiredm-returned-cod-package-with-message / dm-returned-cod-package-with-message-expire
Money maildm-money-maildm-money-mail-expiredm-money-mail-with-message / dm-money-mail-with-message-expire
Back to top ↑

Using notifications

Attached messages, COD & expiration

Packages, COD packages, item-currency COD payments, returned COD packages and money mail have four independent template variants: normal, expiration, with-message, and with-message-expire. Letters and Book Letters have normal/expiration variants only; DiscBridge does not copy the whole letter/book body into a DM.

Select the appropriate package variant
messages:
  dm-package:
    - "Package from {sender} on {server}."
  dm-package-expire:
    - "Package from {sender} on {server}."
    - "Expires: {expiration}"
  dm-package-with-message:
    - "Package from {sender} on {server}."
    - "Message: {message}"
  dm-package-with-message-expire:
    - "Package from {sender} on {server}."
    - "Expires: {expiration}"
    - "Message: {message}"

Variant selection uses the actual event’s expiration and visible attached message. A formatting-only/blank message does not select a message variant. Newline tokens are normalized by MailboxGUI’s message rules. Missing localized templates fall back to English; if an expiration/message-specific template is empty, DiscBridge tries supported simpler variants before reporting a missing template.

The price placeholder prefers MailboxGUI’s codPriceText, so Vault/custom money, item currency, XP, templates and combined prices can be represented without reducing everything to one number. DiscBridge only displays those values; MailboxGUI handles payment and return behavior.

Expiration dates use the recipient’s saved Discord language (otherwise the host’s MailboxGUI locale.default) for a DM, that MailboxGUI default for a channel notice, and the Minecraft server JVM timezone. Minecraft client locale does not choose a DM language. Premium’s expiration_remaining value is remaining seconds rather than a formatted date. A notification does not guarantee mail is still claimable when read later.

Expiration and remaining-seconds text is a snapshot when the notification is rendered, not a live Discord countdown. The durable outbox stores those rendered lines. A delayed or retried notification can arrive after the underlying mail expires; it never renews the mail or overrides in-game claim checks.

Back to top ↑

Using notifications

Admin/API mass mail & queued DMs

By default, admin/API mass delivery posts one channel notice, not an immediate DM for every recipient. Set a real TEXT channel ID; the default ID is blank. The channel always uses the companion host’s MailboxGUI locale.default. Each optional individual mass DM uses the recipient’s saved Discord language, otherwise that same default—not the Minecraft client language.

Channel-only default pattern
admin-mass-mail-channel:
  enabled: true
  channel-id: "YOUR_TEXT_CHANNEL_ID"
  mention-everyone: false
admin-mass-mail-direct-messages:
  enabled: false
Optional capped, paced mass DMs
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
  • Only eligible players count toward the cap: unlinked, opted-out, admin-ignoring or disallowed online recipients are excluded.
  • channel_only means no mass DMs when the eligible count exceeds the cap. send_first_max sends only the first eligible capped subset, not everyone.
  • Queue delay is a minimum, not a precise delivery-time promise. Premium network polling is every five seconds and may extend spacing.
  • Pending mass DMs and retries recheck the enable switch and recipient policy. Disabling DMs/notifications or changing a link can stop pending sends.
  • Premium does not let a channel job older than 24 hours create new recipient jobs. The age/retry limits prevent permanent backlog.

Queue durability and actual pacing

In LOCAL, the mass-DM waiting queue is in memory until each job reaches the durable notification outbox. A full /mba discord reload clears that waiting queue, and a stop/crash can lose not-yet-admitted jobs. Already admitted outbox work is retained. Premium NETWORK_NODE stages eligible recipient jobs durably in its network journal. Durability starts at successful admission, not at composing the mail or adding an arbitrary local waiting entry.

LOCAL sends sequentially: with pacing enabled it waits the configured delay before each job; with pacing disabled it still waits at least one server tick and follows the previous job’s completion. Premium polling can make a configured three-second interval five seconds or longer. Avoid planning exact-second announcements around these delays.

Mass-DM eligibility is checked before admission, including DiscordSRV’s link lookup. A lookup that cannot resolve a link during that pass does not qualify the recipient. Normal individual DMs have an asynchronous cold-link recheck, but do not assume a skipped mass recipient will be automatically replayed. Confirm linking/opt-in and test a fresh small delivery before a large campaign. Unknown over-limit-behavior values fall back to channel_only.

Examples using MailboxGUI to generate deliveries

Run these MailboxGUI commands, not DiscBridge send commands
/mba sl Alex "Welcome!/nCheck your mailbox." --from "Server" --delay 0
/mba sp Alex DIAMOND:1 --message "Your reward"
/mba sl allplayers "Server update!/nRead your in-game mail." --from "Server"

MailboxGUI’s commands and recipient groups control the mail itself. DiscBridge observes resulting events. Confirm MailboxGUI send permissions and quote payloads correctly; see the main guide for all send flags and scheduled mail.

MailboxGUI command and scheduling guide
Back to top ↑

Commands & languages

Player command reference

MailboxGUI owns the base /mb settings discord; DiscBridge supplies the following subcommands only when the detected companion is compatible and player commands are enabled with DiscordSRV connection/link-manager readiness. Use spaces between tokens. These are in-game player preferences, not console commands. Angle brackets identify required values; do not type the brackets. The old separate Discord roots are no longer registered.

Command structurePurpose / requirements
/mb settings discord guide [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/mb settings discord help [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/mb settings discord statusView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/mb settings discord enableOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/mb settings discord disableOpt out of mail DMs, including eligibility for queued mass DMs.
/mb settings discord online onAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/mb settings discord online offDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/mb settings discord online toggleToggle your online-DM preference.
/mb settings discord language <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/mb settings discord languageShow your current effective DM language, usage and supported language choices without changing a preference.
/mb settings discord ignore <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/mb settings discord unignore <player>Remove that sender from your ignore list.
/mb settings discord ignorelistList ignored Minecraft senders.
/mb settings discord ignoreadminIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/mb settings discord unignoreadminAllow admin/API/server DMs again, subject to other notification checks.
Common player examples
/mb settings discord help
/mb settings discord help 2
/mb settings discord guide
/mb settings discord guide 2
/mb settings discord enable
/mb settings discord online on
/mb settings discord language pt_br
/mb settings discord ignore Alex
/mb settings discord ignorelist
/mb settings discord ignoreadmin
/mb settings discord unignoreadmin

Player help, the guide and administrator help use six entries per page with the companion name/version and a Page current/total footer. Omitted or nonnumeric page values open page 1; numbers below/above the range are clamped. Tab completion offers the actual available page numbers. Owner-customized help/guide lists and Premium additions can change the total: use the displayed footer rather than assuming a fixed page count.

How to use the new Discord mail guide

Run language without an argument to inspect the effective language and supported choices. There is no player language reset/default subcommand in this build; selecting a language saves an explicit DM preference. ignore, unignore and testdm require a known Minecraft player name resolved from server history, loaded preferences or MailboxGUI’s recipient directory—not a Discord username. ignore cannot target yourself; ignorelist shows sender filters and the admin-mail filter.

Back to top ↑

Commands & languages

Discord mail guide & first-time player setup

Run /mb settings discord guide or add a page number to read the in-game guide. This is a player instruction menu, not a link to website support roles or a second Discord account-linking system. It uses your configured MailboxGUI syntax and the DiscBridge message language context. It requires the same compatible companion, player-command setup gate and player access as the other integrated player commands.

Read the guide and review your preferences
/mb settings discord guide
/mb settings discord guide 2
/mb settings discord status
  1. Link your Minecraft player through the server’s existing DiscordSRV account-linking workflow. The bundled guide uses /discordsrv link, then asks you to send its code privately to the server bot in a Discord DM. Follow your server’s DiscordSRV setup; do not post codes publicly.
  2. Allow DMs from the server bot and enable your notifications with /mb settings discord enable. DiscBridge reuses the existing DiscordSRV player link; no separate player link is required.
  3. Choose whether you want online DMs using /mb settings discord online on, off or toggle. The server’s global online-DM default still applies.
  4. Choose a supported DM language with /mb settings discord language <language>. This preference is separate from ordinary in-game text and command syntax.
  5. Use ignore/unignore for player senders and ignoreadmin/unignoreadmin for individual server/admin-origin mail. Admin mass-mail channel notices remain independent.
  6. Run /mb settings discord status to review your choices, then test a real letter, Book Letter, package, COD or money delivery where the server enables that mail type. A successful account link alone does not override server notification switches or eligibility.

The default guide covers those topics across two six-entry pages (the final page is shorter). Owners can edit discord-guide.title, discord-guide.help and discord-guide.lines in language/messages_<locale>.yml; existing wording is preserved and the page total follows the list length. New guide/page text is provided in all 16 locales. The player status DM-language line is formatted consistently with neighboring fields without repeating the universal message tag.

All player command syntax and permission notes DiscordSRV server setup and player-command enablement
Back to top ↑

Commands & languages

Administrator command reference

All companion administration now starts with /mba discord. Do not insert an extra admin token after discord. MailboxGUI also accepts its /mailbox admin discord route and registered localized aliases. Admin setup is independent of the player-command gate. Commands on a Premium remote backend operate against the selected companion host; update files and configuration changes occur there.

Command structurePurpose / requirements
/mba discord help [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/mba discord statusShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/mba discord modeRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/mba discord reloadSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/mba discord playercommands on|offPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/mba discord updatecheckCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/mba discord updatePrepare an available edition-matched update. Requires admin and admin.update.
/mba discord update confirmDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/mba discord testdm <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/mba discord testchannelSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

MailboxGUI reload versus DiscBridge reload

CommandWhat it reloads
/mba reload — MailboxGUI commandReloads MailboxGUI’s own supported settings. On Premium, also refreshes inherited network mode, backend identity and network services for the enabled local DiscBridge companion. Does not reload companion config.yml, language files, Discord templates or other companion configuration.
/mba discord reload — DiscBridge commandFull companion reload: synchronize/reload config.yml, in-game language files and Discord templates, preserve/rebind preferences and refresh notification/network services. Use after editing companion files. Available in the matching Free or Premium edition.

A network-only refresh preserves companion configuration, languages, templates, the waiting mass-DM queue and normally in-flight preference writes. Changing LOCAL/NETWORK_NODE mode saves/rebinds preference storage. A failed refresh pauses preference access and notifications, including LOCAL sending, instead of silently demoting to LOCAL. Fix the reported issue and retry /mba reload on the host; a full /mba discord reload is a separate operation and clears the waiting in-memory mass queue.

Premium-only administration

Command structurePurpose / requirements
/mba discord updatelogin statusPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/mba discord updatelogin set <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/mba discord updatelogin clearPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/mba discord spigotlink <account-link-code>Premium only: optional product-specific verified marketplace linking. Requires admin and admin.spigotlink, real injected identifiers and ready website verification.
/mba discord networkstatusPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/mba discord networksupportPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.
Paged help, diagnostics and reload examples
/mba discord help
/mba discord help 2
/mba discord status
/mba discord mode
/mba discord testdm Alex
/mba discord testchannel
/mba discord reload
/mba discord networkstatus
/mba discord networksupport

The last two commands require Premium network-notification mode. A diagnostic test DM bypasses ordinary opt-in/online/ignore eligibility, so success proves bot transport/linking—not that a real delivery will pass every notification check. Test a real MailboxGUI delivery afterward.

testdm sends a fixed English diagnostic payload, not your configured mail template, and still needs a resolvable linked target and working bot transport. testchannel uses the default-language channel list with basic sample sender/recipient/server/price/amount substitutions; optional Premium markers and other event-specific placeholders can remain literal. It can mention everyone when that channel setting is enabled, so use a safe test channel.

Back to top ↑

Commands & languages

Command syntax in all 16 languages

MailboxGUI owns command roots and passes command-syntax and message-locale context into DiscBridge. Configure locale.default, locale.auto-detect-player-locale and locale.command-syntax only in plugins/MailboxGUI/config.yml. Local notices inherit that display-locale policy; integrated responses use the supplied message locale. DiscBridge no longer has its own locale or discord-messages default settings. Saved player Discord language wins for DMs; otherwise the companion host’s MailboxGUI locale.default is used. Channel notices use that default. Client language detection never selects Discord DM language, even for online recipients.

MailboxGUI config.yml — Spanish integrated command syntax
locale:
  default: en
  auto-detect-player-locale: true
  command-syntax:
    default: es
    auto-detect-player-locale: false
  1. Set locale.command-syntax.default in MailboxGUI config.yml. MailboxGUI registers English plus its selected language roots during startup; changing that root language requires your normal planned restart.
  2. Use /mb settings discord or /mba discord on the English roots, or the corresponding registered MailboxGUI localized root/settings prefix below. DiscBridge no longer registers separate roots.
  3. MailboxGUI client syntax detection changes structural words/help/completion, not root registration. With detection disabled, console or unsupported client locales, syntax follows the invoked MailboxGUI root.
  4. Integrated replies use the message locale supplied by MailboxGUI. Saved player Discord DM language remains independent; unsaved DM preferences and channel notices use the host MailboxGUI locale.default.
  5. Keep player names, language-code values, permissions, config keys, backend IDs, credentials and purchase codes unchanged. English canonical subcommands remain accepted. playercommands has no localized structural alias in the current dictionary and stays English.

Select a language below for full player/admin/Premium syntax, paged help/guide examples and accepted aliases. guide is translated in all supported command dictionaries; page numbers and payload values are not translated. The last example in each language requires Premium. The English marketplace command remains /mba discord spigotlink <account-link-code>.

Language / localePlayer baseAdministrative base
English (en)/mb settings discord/mba discord
Deutsch (de)/pf einstellungen discord/apf discord
Español (es)/bz ajustes discord/bza discord
Français (fr)/bal paramètres discord/bala discord
Italiano (it)/cp impostazioni discord/cpa discord
Nederlands (nl)/bb instellingen discord/bbb discord
Polski (pl)/skp ustawienia discord/ska discord
Русский (ru)/пя настройки discord/яа discord
Svenska (sv)/bl inställningar discord/abl discord
Українська (uk)/пс налаштування discord/са discord
日本語 (ja)/郵箱 設定 discord/管郵 discord
한국어 (ko)/우함 설정 discord/관우 discord
简体中文 (zh_cn)/邮 设置 discord/管邮 discord
繁體中文(香港) (zh_hk)/郵 設定 discord/管郵 discord
Português (Brasil) (pt_br)/cc configurações discord/cca discord
繁體中文(臺灣) (zh_tw)/郵 設定 discord/管郵 discord
English — en: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

English command examples
/mb settings discord help 2
/mb settings discord guide 2
/mb settings discord enable
/mb settings discord language en
/mb settings discord online on
/mba discord testdm Alex
/mba discord networkstatus

Player

Localized structurePurpose / requirements
/mb settings discord guide [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/mb settings discord help [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/mb settings discord statusView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/mb settings discord enableOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/mb settings discord disableOpt out of mail DMs, including eligibility for queued mass DMs.
/mb settings discord online onAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/mb settings discord online offDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/mb settings discord online toggleToggle your online-DM preference.
/mb settings discord language <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/mb settings discord languageShow your current effective DM language, usage and supported language choices without changing a preference.
/mb settings discord ignore <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/mb settings discord unignore <player>Remove that sender from your ignore list.
/mb settings discord ignorelistList ignored Minecraft senders.
/mb settings discord ignoreadminIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/mb settings discord unignoreadminAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/mba discord help [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/mba discord statusShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/mba discord modeRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/mba discord reloadSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/mba discord playercommands on|offPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/mba discord updatecheckCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/mba discord updatePrepare an available edition-matched update. Requires admin and admin.update.
/mba discord update confirmDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/mba discord testdm <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/mba discord testchannelSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/mba discord updatelogin statusPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/mba discord updatelogin set <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/mba discord updatelogin clearPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/mba discord networkstatusPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/mba discord networksupportPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helphelpShared
guideguideShared
statusstatusShared
enableenableShared
disabledisableShared
onlineonlineShared
languagelanguageShared
ignoreignoreShared
unignoreunignoreShared
ignorelistignorelistShared
ignoreadminignoreadminShared
unignoreadminunignoreadminShared
updateupdateShared
ononShared
offoffShared
toggletoggleShared
confirmconfirmShared
modemodeShared
reloadreloadShared
updatecheckupdatecheckShared
testdmtestdirectmessage / testdmShared
testchanneltestchannelShared
updateloginupdatelogin / ulPremium only
spigotlinkSpigotlink / splPremium only
setsetPremium only
clearclearPremium only
networkstatusnetworkstatus / nwsPremium only
networksupportnetworksupport / nwrPremium only
Deutsch — de: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Deutsch command examples
/pf einstellungen discord hilfe 2
/pf einstellungen discord anleitung 2
/pf einstellungen discord aktivieren
/pf einstellungen discord sprache de
/pf einstellungen discord online an
/apf discord direktnachrichtprüfen Alex
/apf discord netzwerkstatus

Player

Localized structurePurpose / requirements
/pf einstellungen discord anleitung [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/pf einstellungen discord hilfe [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/pf einstellungen discord statusView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/pf einstellungen discord aktivierenOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/pf einstellungen discord deaktivierenOpt out of mail DMs, including eligibility for queued mass DMs.
/pf einstellungen discord online anAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/pf einstellungen discord online ausDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/pf einstellungen discord online umschaltenToggle your online-DM preference.
/pf einstellungen discord sprache <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/pf einstellungen discord spracheShow your current effective DM language, usage and supported language choices without changing a preference.
/pf einstellungen discord ignorieren <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/pf einstellungen discord entignorieren <player>Remove that sender from your ignore list.
/pf einstellungen discord ignorierlisteList ignored Minecraft senders.
/pf einstellungen discord adminignorierenIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/pf einstellungen discord adminzulassenAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/apf discord hilfe [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/apf discord statusShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/apf discord modusRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/apf discord neuladenSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/apf discord playercommands an|ausPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/apf discord updatesuchenCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/apf discord aktualisierenPrepare an available edition-matched update. Requires admin and admin.update.
/apf discord aktualisieren bestätigenDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/apf discord direktnachrichtprüfen <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/apf discord prüfen-kanalSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/apf discord aktualisierungsanmeldung statusPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/apf discord aktualisierungsanmeldung setzen <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/apf discord aktualisierungsanmeldung löschenPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/apf discord netzwerkstatusPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/apf discord netzwerkberichtPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helphilfeShared
guideanleitungShared
statusstatusShared
enableaktivierenShared
disabledeaktivierenShared
onlineonlineShared
languagespracheShared
ignoreignorierenShared
unignoreentignorierenShared
ignorelistignorierlisteShared
ignoreadminadminignorierenShared
unignoreadminadminzulassenShared
updateaktualisierenShared
onanShared
offausShared
toggleumschaltenShared
confirmbestätigenShared
modemodusShared
reloadneuladenShared
updatecheckupdatesuchenShared
testdmdirektnachrichtprüfen / dnprüfenShared
testchannelprüfen-kanalShared
updateloginaktualisierungsanmeldung / aanPremium only
spigotlinkSpigotverknüpfen / SpigotvPremium only
setsetzenPremium only
clearlöschenPremium only
networkstatusnetzwerkstatus / nstPremium only
networksupportnetzwerkbericht / nberPremium only
Español — es: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Español command examples
/bz ajustes discord ayuda 2
/bz ajustes discord guía 2
/bz ajustes discord activar
/bz ajustes discord idioma es
/bz ajustes discord conectado sí
/bza discord probarmensajedirecto Alex
/bza discord estadored

Player

Localized structurePurpose / requirements
/bz ajustes discord guía [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/bz ajustes discord ayuda [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/bz ajustes discord estadoView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/bz ajustes discord activarOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/bz ajustes discord desactivarOpt out of mail DMs, including eligibility for queued mass DMs.
/bz ajustes discord conectado síAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/bz ajustes discord conectado noDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/bz ajustes discord conectado alternarToggle your online-DM preference.
/bz ajustes discord idioma <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/bz ajustes discord idiomaShow your current effective DM language, usage and supported language choices without changing a preference.
/bz ajustes discord ignorar <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/bz ajustes discord dejarignorar <player>Remove that sender from your ignore list.
/bz ajustes discord ignoradosList ignored Minecraft senders.
/bz ajustes discord ignoraradminIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/bz ajustes discord permitiradminAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/bza discord ayuda [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/bza discord estadoShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/bza discord modoRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/bza discord recargarSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/bza discord playercommands sí|noPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/bza discord buscaractualizaciónCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/bza discord actualizarPrepare an available edition-matched update. Requires admin and admin.update.
/bza discord actualizar confirmarDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/bza discord probarmensajedirecto <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/bza discord probar-canalSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/bza discord accesoactualización estadoPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/bza discord accesoactualización establecer <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/bza discord accesoactualización borrarPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/bza discord estadoredPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/bza discord informeredPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helpayudaShared
guideguíaShared
statusestadoShared
enableactivarShared
disabledesactivarShared
onlineconectadoShared
languageidiomaShared
ignoreignorarShared
unignoredejarignorarShared
ignorelistignoradosShared
ignoreadminignoraradminShared
unignoreadminpermitiradminShared
updateactualizarShared
onsíShared
offnoShared
togglealternarShared
confirmconfirmarShared
modemodoShared
reloadrecargarShared
updatecheckbuscaractualizaciónShared
testdmprobarmensajedirecto / pmdShared
testchannelprobar-canalShared
updateloginaccesoactualización / aaPremium only
spigotlinkvincularSpigot / vSpigotPremium only
setestablecerPremium only
clearborrarPremium only
networkstatusestadored / erPremium only
networksupportinformered / irPremium only
Français — fr: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Français command examples
/bal paramètres discord aide 2
/bal paramètres discord guide 2
/bal paramètres discord activer
/bal paramètres discord langue fr
/bal paramètres discord connecté oui
/bala discord testermessagedirect Alex
/bala discord étatréseau

Player

Localized structurePurpose / requirements
/bal paramètres discord guide [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/bal paramètres discord aide [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/bal paramètres discord étatView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/bal paramètres discord activerOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/bal paramètres discord désactiverOpt out of mail DMs, including eligibility for queued mass DMs.
/bal paramètres discord connecté ouiAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/bal paramètres discord connecté nonDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/bal paramètres discord connecté basculerToggle your online-DM preference.
/bal paramètres discord langue <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/bal paramètres discord langueShow your current effective DM language, usage and supported language choices without changing a preference.
/bal paramètres discord ignorer <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/bal paramètres discord neplusignorer <player>Remove that sender from your ignore list.
/bal paramètres discord ignorésList ignored Minecraft senders.
/bal paramètres discord ignoreradminIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/bal paramètres discord autoriseradminAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/bala discord aide [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/bala discord étatShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/bala discord modeRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/bala discord rechargerSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/bala discord playercommands oui|nonPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/bala discord vérifiermiseàjourCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/bala discord mettreàjourPrepare an available edition-matched update. Requires admin and admin.update.
/bala discord mettreàjour confirmerDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/bala discord testermessagedirect <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/bala discord tester-canalSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/bala discord connexionmiseàjour étatPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/bala discord connexionmiseàjour définir <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/bala discord connexionmiseàjour effacerPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/bala discord étatréseauPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/bala discord rapportréseauPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helpaideShared
guideguideShared
statusétatShared
enableactiverShared
disabledésactiverShared
onlineconnectéShared
languagelangueShared
ignoreignorerShared
unignoreneplusignorerShared
ignorelistignorésShared
ignoreadminignoreradminShared
unignoreadminautoriseradminShared
updatemettreàjourShared
onouiShared
offnonShared
togglebasculerShared
confirmconfirmerShared
modemodeShared
reloadrechargerShared
updatecheckvérifiermiseàjourShared
testdmtestermessagedirect / tmdShared
testchanneltester-canalShared
updateloginconnexionmiseàjour / cmajPremium only
spigotlinklierSpigot / lSpigotPremium only
setdéfinirPremium only
cleareffacerPremium only
networkstatusétatréseau / érPremium only
networksupportrapportréseau / rrPremium only
Italiano — it: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Italiano command examples
/cp impostazioni discord aiuto 2
/cp impostazioni discord guida 2
/cp impostazioni discord abilita
/cp impostazioni discord lingua it
/cp impostazioni discord online sì
/cpa discord provamessaggiodiretto Alex
/cpa discord statorete

Player

Localized structurePurpose / requirements
/cp impostazioni discord guida [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/cp impostazioni discord aiuto [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/cp impostazioni discord statoView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/cp impostazioni discord abilitaOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/cp impostazioni discord disabilitaOpt out of mail DMs, including eligibility for queued mass DMs.
/cp impostazioni discord online sìAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/cp impostazioni discord online noDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/cp impostazioni discord online alternaToggle your online-DM preference.
/cp impostazioni discord lingua <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/cp impostazioni discord linguaShow your current effective DM language, usage and supported language choices without changing a preference.
/cp impostazioni discord ignora <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/cp impostazioni discord nonignorare <player>Remove that sender from your ignore list.
/cp impostazioni discord ignoratiList ignored Minecraft senders.
/cp impostazioni discord ignoraadminIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/cp impostazioni discord accettaadminAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/cpa discord aiuto [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/cpa discord statoShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/cpa discord modalitàRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/cpa discord ricaricaSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/cpa discord playercommands sì|noPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/cpa discord verificaaggiornamentiCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/cpa discord aggiornaPrepare an available edition-matched update. Requires admin and admin.update.
/cpa discord aggiorna confermaDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/cpa discord provamessaggiodiretto <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/cpa discord prova-canaleSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/cpa discord accessoaggiornamenti statoPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/cpa discord accessoaggiornamenti imposta <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/cpa discord accessoaggiornamenti cancellaPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/cpa discord statoretePremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/cpa discord rapportoretePremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helpaiutoShared
guideguidaShared
statusstatoShared
enableabilitaShared
disabledisabilitaShared
onlineonlineShared
languagelinguaShared
ignoreignoraShared
unignorenonignorareShared
ignorelistignoratiShared
ignoreadminignoraadminShared
unignoreadminaccettaadminShared
updateaggiornaShared
onsìShared
offnoShared
togglealternaShared
confirmconfermaShared
modemodalitàShared
reloadricaricaShared
updatecheckverificaaggiornamentiShared
testdmprovamessaggiodiretto / pmdShared
testchannelprova-canaleShared
updateloginaccessoaggiornamenti / aaPremium only
spigotlinkcollegaSpigot / cSpigotPremium only
setimpostaPremium only
clearcancellaPremium only
networkstatusstatorete / srPremium only
networksupportrapportorete / rrPremium only
Nederlands — nl: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Nederlands command examples
/bb instellingen discord hulp 2
/bb instellingen discord gids 2
/bb instellingen discord inschakelen
/bb instellingen discord taal nl
/bb instellingen discord online aan
/bbb discord testdirectbericht Alex
/bbb discord netwerkstatus

Player

Localized structurePurpose / requirements
/bb instellingen discord gids [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/bb instellingen discord hulp [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/bb instellingen discord statusView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/bb instellingen discord inschakelenOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/bb instellingen discord uitschakelenOpt out of mail DMs, including eligibility for queued mass DMs.
/bb instellingen discord online aanAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/bb instellingen discord online uitDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/bb instellingen discord online wisselenToggle your online-DM preference.
/bb instellingen discord taal <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/bb instellingen discord taalShow your current effective DM language, usage and supported language choices without changing a preference.
/bb instellingen discord negeren <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/bb instellingen discord toelaten <player>Remove that sender from your ignore list.
/bb instellingen discord negeerlijstList ignored Minecraft senders.
/bb instellingen discord beheerdernegerenIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/bb instellingen discord beheerdertoelatenAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/bbb discord hulp [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/bbb discord statusShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/bbb discord modusRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/bbb discord herladenSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/bbb discord playercommands aan|uitPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/bbb discord updatecontrolerenCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/bbb discord bijwerkenPrepare an available edition-matched update. Requires admin and admin.update.
/bbb discord bijwerken bevestigenDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/bbb discord testdirectbericht <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/bbb discord test-kanaalSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/bbb discord updateaanmelding statusPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/bbb discord updateaanmelding instellen <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/bbb discord updateaanmelding wissenPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/bbb discord netwerkstatusPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/bbb discord netwerkrapportPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helphulpShared
guidegidsShared
statusstatusShared
enableinschakelenShared
disableuitschakelenShared
onlineonlineShared
languagetaalShared
ignorenegerenShared
unignoretoelatenShared
ignorelistnegeerlijstShared
ignoreadminbeheerdernegerenShared
unignoreadminbeheerdertoelatenShared
updatebijwerkenShared
onaanShared
offuitShared
togglewisselenShared
confirmbevestigenShared
modemodusShared
reloadherladenShared
updatecheckupdatecontrolerenShared
testdmtestdirectbericht / tdbShared
testchanneltest-kanaalShared
updateloginupdateaanmelding / uaPremium only
spigotlinkSpigotkoppelen / SpigotkPremium only
setinstellenPremium only
clearwissenPremium only
networkstatusnetwerkstatus / nsPremium only
networksupportnetwerkrapport / nrPremium only
Polski — pl: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Polski command examples
/skp ustawienia discord pomoc 2
/skp ustawienia discord poradnik 2
/skp ustawienia discord włącz
/skp ustawienia discord język pl
/skp ustawienia discord online tak
/ska discord testujwiadomośćprywatną Alex
/ska discord stansieci

Player

Localized structurePurpose / requirements
/skp ustawienia discord poradnik [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/skp ustawienia discord pomoc [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/skp ustawienia discord stanView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/skp ustawienia discord włączOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/skp ustawienia discord wyłączOpt out of mail DMs, including eligibility for queued mass DMs.
/skp ustawienia discord online takAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/skp ustawienia discord online nieDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/skp ustawienia discord online przełączToggle your online-DM preference.
/skp ustawienia discord język <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/skp ustawienia discord językShow your current effective DM language, usage and supported language choices without changing a preference.
/skp ustawienia discord ignoruj <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/skp ustawienia discord odignoruj <player>Remove that sender from your ignore list.
/skp ustawienia discord ignorowaniList ignored Minecraft senders.
/skp ustawienia discord ignorujadminaIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/skp ustawienia discord akceptujadminaAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/ska discord pomoc [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/ska discord stanShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/ska discord trybRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/ska discord przeładujSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/ska discord playercommands tak|niePersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/ska discord sprawdźaktualizacjęCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/ska discord aktualizujPrepare an available edition-matched update. Requires admin and admin.update.
/ska discord aktualizuj potwierdźDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/ska discord testujwiadomośćprywatną <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/ska discord testuj-kanałuSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/ska discord logowanieaktualizacji stanPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/ska discord logowanieaktualizacji ustaw <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/ska discord logowanieaktualizacji wyczyśćPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/ska discord stansieciPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/ska discord raportsieciPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helppomocShared
guideporadnikShared
statusstanShared
enablewłączShared
disablewyłączShared
onlineonlineShared
languagejęzykShared
ignoreignorujShared
unignoreodignorujShared
ignorelistignorowaniShared
ignoreadminignorujadminaShared
unignoreadminakceptujadminaShared
updateaktualizujShared
ontakShared
offnieShared
toggleprzełączShared
confirmpotwierdźShared
modetrybShared
reloadprzeładujShared
updatechecksprawdźaktualizacjęShared
testdmtestujwiadomośćprywatną / twpShared
testchanneltestuj-kanałuShared
updateloginlogowanieaktualizacji / laPremium only
spigotlinkpołączSpigot / pSpigotPremium only
setustawPremium only
clearwyczyśćPremium only
networkstatusstansieci / ssPremium only
networksupportraportsieci / rsPremium only
Русский — ru: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Русский command examples
/пя настройки discord помощь 2
/пя настройки discord руководство 2
/пя настройки discord включить
/пя настройки discord язык ru
/пя настройки discord онлайн да
/яа discord тестличногосообщения Alex
/яа discord состояниесети

Player

Localized structurePurpose / requirements
/пя настройки discord руководство [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/пя настройки discord помощь [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/пя настройки discord статусView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/пя настройки discord включитьOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/пя настройки discord отключитьOpt out of mail DMs, including eligibility for queued mass DMs.
/пя настройки discord онлайн даAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/пя настройки discord онлайн нетDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/пя настройки discord онлайн переключитьToggle your online-DM preference.
/пя настройки discord язык <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/пя настройки discord языкShow your current effective DM language, usage and supported language choices without changing a preference.
/пя настройки discord игнорировать <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/пя настройки discord неигнорировать <player>Remove that sender from your ignore list.
/пя настройки discord списокигнораList ignored Minecraft senders.
/пя настройки discord игнорироватьадминаIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/пя настройки discord разрешитьадминаAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/яа discord помощь [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/яа discord статусShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/яа discord режимRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/яа discord перезагрузитьSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/яа discord playercommands да|нетPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/яа discord проверитьобновленияCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/яа discord обновитьPrepare an available edition-matched update. Requires admin and admin.update.
/яа discord обновить подтвердитьDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/яа discord тестличногосообщения <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/яа discord тест-каналаSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/яа discord входобновлений статусPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/яа discord входобновлений задать <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/яа discord входобновлений очиститьPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/яа discord состояниесетиPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/яа discord отчётсетиPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helpпомощьShared
guideруководствоShared
statusстатусShared
enableвключитьShared
disableотключитьShared
onlineонлайнShared
languageязыкShared
ignoreигнорироватьShared
unignoreнеигнорироватьShared
ignorelistсписокигнораShared
ignoreadminигнорироватьадминаShared
unignoreadminразрешитьадминаShared
updateобновитьShared
onдаShared
offнетShared
toggleпереключитьShared
confirmподтвердитьShared
modeрежимShared
reloadперезагрузитьShared
updatecheckпроверитьобновленияShared
testdmтестличногосообщения / тлсShared
testchannelтест-каналаShared
updateloginвходобновлений / воPremium only
spigotlinkсвязатьSpigot / сSpigotPremium only
setзадатьPremium only
clearочиститьPremium only
networkstatusсостояниесети / ссPremium only
networksupportотчётсети / осPremium only
Svenska — sv: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Svenska command examples
/bl inställningar discord hjälp 2
/bl inställningar discord guide 2
/bl inställningar discord aktivera
/bl inställningar discord språk sv
/bl inställningar discord online på
/abl discord testadirektmeddelande Alex
/abl discord nätverksstatus

Player

Localized structurePurpose / requirements
/bl inställningar discord guide [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/bl inställningar discord hjälp [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/bl inställningar discord statusView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/bl inställningar discord aktiveraOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/bl inställningar discord inaktiveraOpt out of mail DMs, including eligibility for queued mass DMs.
/bl inställningar discord online påAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/bl inställningar discord online avDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/bl inställningar discord online växlaToggle your online-DM preference.
/bl inställningar discord språk <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/bl inställningar discord språkShow your current effective DM language, usage and supported language choices without changing a preference.
/bl inställningar discord ignorera <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/bl inställningar discord slutaignorera <player>Remove that sender from your ignore list.
/bl inställningar discord ignoreradeList ignored Minecraft senders.
/bl inställningar discord ignoreraadminIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/bl inställningar discord tillåtadminAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/abl discord hjälp [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/abl discord statusShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/abl discord lägeRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/abl discord laddaomSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/abl discord playercommands på|avPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/abl discord sökuppdateringCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/abl discord uppdateraPrepare an available edition-matched update. Requires admin and admin.update.
/abl discord uppdatera bekräftaDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/abl discord testadirektmeddelande <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/abl discord testa-kanalSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/abl discord uppdateringsinloggning statusPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/abl discord uppdateringsinloggning ange <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/abl discord uppdateringsinloggning rensaPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/abl discord nätverksstatusPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/abl discord nätverksrapportPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helphjälpShared
guideguideShared
statusstatusShared
enableaktiveraShared
disableinaktiveraShared
onlineonlineShared
languagespråkShared
ignoreignoreraShared
unignoreslutaignoreraShared
ignorelistignoreradeShared
ignoreadminignoreraadminShared
unignoreadmintillåtadminShared
updateuppdateraShared
onpåShared
offavShared
toggleväxlaShared
confirmbekräftaShared
modelägeShared
reloadladdaomShared
updatechecksökuppdateringShared
testdmtestadirektmeddelande / tdmShared
testchanneltesta-kanalShared
updateloginuppdateringsinloggning / uiPremium only
spigotlinkSpigotkoppling / SpigotkPremium only
setangePremium only
clearrensaPremium only
networkstatusnätverksstatus / nsPremium only
networksupportnätverksrapport / nrPremium only
Українська — uk: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Українська command examples
/пс налаштування discord допомога 2
/пс налаштування discord посібник 2
/пс налаштування discord увімкнути
/пс налаштування discord мова uk
/пс налаштування discord онлайн так
/са discord тестприватногоповідомлення Alex
/са discord станмережі

Player

Localized structurePurpose / requirements
/пс налаштування discord посібник [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/пс налаштування discord допомога [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/пс налаштування discord станView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/пс налаштування discord увімкнутиOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/пс налаштування discord вимкнутиOpt out of mail DMs, including eligibility for queued mass DMs.
/пс налаштування discord онлайн такAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/пс налаштування discord онлайн ніDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/пс налаштування discord онлайн перемкнутиToggle your online-DM preference.
/пс налаштування discord мова <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/пс налаштування discord моваShow your current effective DM language, usage and supported language choices without changing a preference.
/пс налаштування discord ігнорувати <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/пс налаштування discord неігнорувати <player>Remove that sender from your ignore list.
/пс налаштування discord списокігноруванняList ignored Minecraft senders.
/пс налаштування discord ігноруватиадмінаIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/пс налаштування discord дозволитиадмінаAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/са discord допомога [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/са discord станShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/са discord режимRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/са discord перезавантажитиSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/са discord playercommands так|ніPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/са discord перевіритионовленняCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/са discord оновитиPrepare an available edition-matched update. Requires admin and admin.update.
/са discord оновити підтвердитиDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/са discord тестприватногоповідомлення <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/са discord тест-каналуSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/са discord вхідоновлень станPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/са discord вхідоновлень встановити <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/са discord вхідоновлень очиститиPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/са discord станмережіPremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/са discord звітмережіPremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helpдопомогаShared
guideпосібникShared
statusстанShared
enableувімкнутиShared
disableвимкнутиShared
onlineонлайнShared
languageмоваShared
ignoreігноруватиShared
unignoreнеігноруватиShared
ignorelistсписокігноруванняShared
ignoreadminігноруватиадмінаShared
unignoreadminдозволитиадмінаShared
updateоновитиShared
onтакShared
offніShared
toggleперемкнутиShared
confirmпідтвердитиShared
modeрежимShared
reloadперезавантажитиShared
updatecheckперевіритионовленняShared
testdmтестприватногоповідомлення / тппShared
testchannelтест-каналуShared
updateloginвхідоновлень / воPremium only
spigotlinkпривʼязатиSpigot / пSpigotPremium only
setвстановитиPremium only
clearочиститиPremium only
networkstatusстанмережі / смPremium only
networksupportзвітмережі / змPremium only
日本語 — ja: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

日本語 command examples
/郵箱 設定 discord ヘルプ 2
/郵箱 設定 discord ガイド 2
/郵箱 設定 discord 有効化
/郵箱 設定 discord 言語 ja
/郵箱 設定 discord オンライン オン
/管郵 discord 直接メッセージ試験 Alex
/管郵 discord ネットワーク状態

Player

Localized structurePurpose / requirements
/郵箱 設定 discord ガイド [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/郵箱 設定 discord ヘルプ [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/郵箱 設定 discord 状態View notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/郵箱 設定 discord 有効化Opt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/郵箱 設定 discord 無効化Opt out of mail DMs, including eligibility for queued mass DMs.
/郵箱 設定 discord オンライン オンAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/郵箱 設定 discord オンライン オフDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/郵箱 設定 discord オンライン 切替Toggle your online-DM preference.
/郵箱 設定 discord 言語 <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/郵箱 設定 discord 言語Show your current effective DM language, usage and supported language choices without changing a preference.
/郵箱 設定 discord 無視 <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/郵箱 設定 discord 無視解除 <player>Remove that sender from your ignore list.
/郵箱 設定 discord 無視一覧List ignored Minecraft senders.
/郵箱 設定 discord 管理者無視Ignore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/郵箱 設定 discord 管理者許可Allow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/管郵 discord ヘルプ [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/管郵 discord 状態Show hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/管郵 discord モードRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/管郵 discord 再読込Save preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/管郵 discord playercommands オン|オフPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/管郵 discord 更新確認Check the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/管郵 discord 更新Prepare an available edition-matched update. Requires admin and admin.update.
/管郵 discord 更新 確認Download and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/管郵 discord 直接メッセージ試験 <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/管郵 discord 試験-チャンネルテストSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/管郵 discord 更新ログイン 状態Premium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/管郵 discord 更新ログイン 設定 <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/管郵 discord 更新ログイン 消去Premium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/管郵 discord ネットワーク状態Premium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/管郵 discord ネットワーク報告Premium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helpヘルプShared
guideガイドShared
status状態Shared
enable有効化Shared
disable無効化Shared
onlineオンラインShared
language言語Shared
ignore無視Shared
unignore無視解除Shared
ignorelist無視一覧Shared
ignoreadmin管理者無視Shared
unignoreadmin管理者許可Shared
update更新Shared
onオンShared
offオフShared
toggle切替Shared
confirm確認Shared
modeモードShared
reload再読込Shared
updatecheck更新確認Shared
testdm直接メッセージ試験 / 直接試験Shared
testchannel試験-チャンネルテストShared
updatelogin更新ログイン / 更新認証Premium only
spigotlinkSpigot連携 / Spigot接続Premium only
set設定Premium only
clear消去Premium only
networkstatusネットワーク状態 / ネット状態Premium only
networksupportネットワーク報告 / ネット報告Premium only
한국어 — ko: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

한국어 command examples
/우함 설정 discord 도움말 2
/우함 설정 discord 안내 2
/우함 설정 discord 활성화
/우함 설정 discord 언어 ko
/우함 설정 discord 온라인 켜기
/관우 discord 개인메시지테스트 Alex
/관우 discord 네트워크상태

Player

Localized structurePurpose / requirements
/우함 설정 discord 안내 [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/우함 설정 discord 도움말 [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/우함 설정 discord 상태View notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/우함 설정 discord 활성화Opt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/우함 설정 discord 비활성화Opt out of mail DMs, including eligibility for queued mass DMs.
/우함 설정 discord 온라인 켜기Allow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/우함 설정 discord 온라인 끄기Disable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/우함 설정 discord 온라인 전환Toggle your online-DM preference.
/우함 설정 discord 언어 <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/우함 설정 discord 언어Show your current effective DM language, usage and supported language choices without changing a preference.
/우함 설정 discord 무시 <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/우함 설정 discord 무시해제 <player>Remove that sender from your ignore list.
/우함 설정 discord 무시목록List ignored Minecraft senders.
/우함 설정 discord 관리자무시Ignore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/우함 설정 discord 관리자허용Allow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/관우 discord 도움말 [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/관우 discord 상태Show hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/관우 discord 모드Read LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/관우 discord 다시로드Save preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/관우 discord playercommands 켜기|끄기Persist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/관우 discord 업데이트확인Check the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/관우 discord 업데이트Prepare an available edition-matched update. Requires admin and admin.update.
/관우 discord 업데이트 확인Download and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/관우 discord 개인메시지테스트 <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/관우 discord 테스트-채널테스트Send a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/관우 discord 업데이트로그인 상태Premium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/관우 discord 업데이트로그인 설정 <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/관우 discord 업데이트로그인 지우기Premium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/관우 discord 네트워크상태Premium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/관우 discord 네트워크보고서Premium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
help도움말Shared
guide안내Shared
status상태Shared
enable활성화Shared
disable비활성화Shared
online온라인Shared
language언어Shared
ignore무시Shared
unignore무시해제Shared
ignorelist무시목록Shared
ignoreadmin관리자무시Shared
unignoreadmin관리자허용Shared
update업데이트Shared
on켜기Shared
off끄기Shared
toggle전환Shared
confirm확인Shared
mode모드Shared
reload다시로드Shared
updatecheck업데이트확인Shared
testdm개인메시지테스트 / 개인테스트Shared
testchannel테스트-채널테스트Shared
updatelogin업데이트로그인 / 업데이트인증Premium only
spigotlinkSpigot연결 / Spigot연동Premium only
set설정Premium only
clear지우기Premium only
networkstatus네트워크상태 / 망상태Premium only
networksupport네트워크보고서 / 망보고서Premium only
简体中文 — zh_cn: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

简体中文 command examples
/邮 设置 discord 帮助 2
/邮 设置 discord 指南 2
/邮 设置 discord 启用
/邮 设置 discord 语言 zh_cn
/邮 设置 discord 在线 开
/管邮 discord 测试私信 Alex
/管邮 discord 网络状态

Player

Localized structurePurpose / requirements
/邮 设置 discord 指南 [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/邮 设置 discord 帮助 [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/邮 设置 discord 状态View notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/邮 设置 discord 启用Opt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/邮 设置 discord 禁用Opt out of mail DMs, including eligibility for queued mass DMs.
/邮 设置 discord 在线 开Allow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/邮 设置 discord 在线 关Disable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/邮 设置 discord 在线 切换Toggle your online-DM preference.
/邮 设置 discord 语言 <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/邮 设置 discord 语言Show your current effective DM language, usage and supported language choices without changing a preference.
/邮 设置 discord 忽略 <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/邮 设置 discord 取消忽略 <player>Remove that sender from your ignore list.
/邮 设置 discord 忽略列表List ignored Minecraft senders.
/邮 设置 discord 忽略管理员Ignore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/邮 设置 discord 允许管理员Allow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/管邮 discord 帮助 [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/管邮 discord 状态Show hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/管邮 discord 模式Read LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/管邮 discord 重载Save preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/管邮 discord playercommands 开|关Persist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/管邮 discord 检查更新Check the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/管邮 discord 更新Prepare an available edition-matched update. Requires admin and admin.update.
/管邮 discord 更新 确认Download and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/管邮 discord 测试私信 <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/管邮 discord 测试-频道测试Send a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/管邮 discord 更新登录 状态Premium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/管邮 discord 更新登录 设置 <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/管邮 discord 更新登录 清除Premium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/管邮 discord 网络状态Premium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/管邮 discord 网络报告Premium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
help帮助Shared
guide指南Shared
status状态Shared
enable启用Shared
disable禁用Shared
online在线Shared
language语言Shared
ignore忽略Shared
unignore取消忽略Shared
ignorelist忽略列表Shared
ignoreadmin忽略管理员Shared
unignoreadmin允许管理员Shared
update更新Shared
on开Shared
off关Shared
toggle切换Shared
confirm确认Shared
mode模式Shared
reload重载Shared
updatecheck检查更新Shared
testdm测试私信 / 私信测试Shared
testchannel测试-频道测试Shared
updatelogin更新登录 / 更新认证Premium only
spigotlinkSpigot关联 / Spigot绑定Premium only
set设置Premium only
clear清除Premium only
networkstatus网络状态 / 网状态Premium only
networksupport网络报告 / 网报告Premium only
繁體中文(香港) — zh_hk: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

繁體中文(香港) command examples
/郵 設定 discord 幫助 2
/郵 設定 discord 指南 2
/郵 設定 discord 啟用
/郵 設定 discord 語言 zh_hk
/郵 設定 discord 在線 開
/管郵 discord 測試私訊 Alex
/管郵 discord 網絡狀態

Player

Localized structurePurpose / requirements
/郵 設定 discord 指南 [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/郵 設定 discord 幫助 [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/郵 設定 discord 狀態View notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/郵 設定 discord 啟用Opt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/郵 設定 discord 停用Opt out of mail DMs, including eligibility for queued mass DMs.
/郵 設定 discord 在線 開Allow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/郵 設定 discord 在線 關Disable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/郵 設定 discord 在線 切換Toggle your online-DM preference.
/郵 設定 discord 語言 <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/郵 設定 discord 語言Show your current effective DM language, usage and supported language choices without changing a preference.
/郵 設定 discord 忽略 <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/郵 設定 discord 取消忽略 <player>Remove that sender from your ignore list.
/郵 設定 discord 忽略列表List ignored Minecraft senders.
/郵 設定 discord 忽略管理員Ignore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/郵 設定 discord 允許管理員Allow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/管郵 discord 幫助 [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/管郵 discord 狀態Show hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/管郵 discord 模式Read LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/管郵 discord 重新載入Save preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/管郵 discord playercommands 開|關Persist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/管郵 discord 檢查更新Check the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/管郵 discord 更新Prepare an available edition-matched update. Requires admin and admin.update.
/管郵 discord 更新 確認Download and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/管郵 discord 測試私訊 <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/管郵 discord 測試-頻道測試Send a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/管郵 discord 更新登入 狀態Premium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/管郵 discord 更新登入 設定 <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/管郵 discord 更新登入 清除Premium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/管郵 discord 網絡狀態Premium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/管郵 discord 網絡報告Premium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
help幫助Shared
guide指南Shared
status狀態Shared
enable啟用Shared
disable停用Shared
online在線Shared
language語言Shared
ignore忽略Shared
unignore取消忽略Shared
ignorelist忽略列表Shared
ignoreadmin忽略管理員Shared
unignoreadmin允許管理員Shared
update更新Shared
on開Shared
off關Shared
toggle切換Shared
confirm確認Shared
mode模式Shared
reload重新載入Shared
updatecheck檢查更新Shared
testdm測試私訊 / 私訊測試Shared
testchannel測試-頻道測試Shared
updatelogin更新登入 / 更新驗證Premium only
spigotlinkSpigot連結 / Spigot綁定Premium only
set設定Premium only
clear清除Premium only
networkstatus網絡狀態 / 網狀態Premium only
networksupport網絡報告 / 網報告Premium only
Português (Brasil) — pt_br: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

Português (Brasil) command examples
/cc configurações discord ajuda 2
/cc configurações discord guia 2
/cc configurações discord ativar
/cc configurações discord idioma pt_br
/cc configurações discord online ligado
/cca discord testarmensagemdireta Alex
/cca discord estadorede

Player

Localized structurePurpose / requirements
/cc configurações discord guia [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/cc configurações discord ajuda [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/cc configurações discord estadoView notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/cc configurações discord ativarOpt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/cc configurações discord desativarOpt out of mail DMs, including eligibility for queued mass DMs.
/cc configurações discord online ligadoAllow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/cc configurações discord online desligadoDisable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/cc configurações discord online alternarToggle your online-DM preference.
/cc configurações discord idioma <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/cc configurações discord idiomaShow your current effective DM language, usage and supported language choices without changing a preference.
/cc configurações discord ignorar <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/cc configurações discord designorar <player>Remove that sender from your ignore list.
/cc configurações discord ignoradosList ignored Minecraft senders.
/cc configurações discord ignoraradminIgnore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/cc configurações discord permitiradminAllow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/cca discord ajuda [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/cca discord estadoShow hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/cca discord modoRead LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/cca discord recarregarSave preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/cca discord playercommands ligado|desligadoPersist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/cca discord verificaratualizaçãoCheck the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/cca discord atualizarPrepare an available edition-matched update. Requires admin and admin.update.
/cca discord atualizar confirmarDownload and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/cca discord testarmensagemdireta <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/cca discord testar-arcanalSend a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/cca discord loginatualização estadoPremium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/cca discord loginatualização definir <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/cca discord loginatualização limparPremium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/cca discord estadoredePremium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/cca discord relatórioredePremium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
helpajudaShared
guideguiaShared
statusestadoShared
enableativarShared
disabledesativarShared
onlineonlineShared
languageidiomaShared
ignoreignorarShared
unignoredesignorarShared
ignorelistignoradosShared
ignoreadminignoraradminShared
unignoreadminpermitiradminShared
updateatualizarShared
onligadoShared
offdesligadoShared
togglealternarShared
confirmconfirmarShared
modemodoShared
reloadrecarregarShared
updatecheckverificaratualizaçãoShared
testdmtestarmensagemdireta / tmdShared
testchanneltestar-arcanalShared
updateloginloginatualização / laPremium only
spigotlinkvincularSpigot / vSpigotPremium only
setdefinirPremium only
clearlimparPremium only
networkstatusestadorede / erPremium only
networksupportrelatóriorede / rrPremium only
繁體中文(臺灣) — zh_tw: full commands, aliases & examples

MailboxGUI registers English plus its selected startup-language roots. It also supplies the settings token and command-language context. These are not separate DiscBridge roots. The last example requires Premium; player commands require enabled setup.

繁體中文(臺灣) command examples
/郵 設定 discord 幫助 2
/郵 設定 discord 指南 2
/郵 設定 discord 啟用
/郵 設定 discord 語言 zh_tw
/郵 設定 discord 線上 開
/管郵 discord 測試私訊 Alex
/管郵 discord 網路狀態

Player

Localized structurePurpose / requirements
/郵 設定 discord 指南 [page]Open paged instructions for DiscordSRV linking, mail notifications, online DMs, sender filters and Discord language.
/郵 設定 discord 幫助 [page]Show integrated player command help, six entries per page, with guide as the first help entry. /mb settings discord with no arguments opens the first page.
/郵 設定 discord 狀態View notification opt-in, online-DM preference, admin-ignore and effective DM language. This does not verify a Discord account link; use DiscordSRV linked. Requires mailboxguidiscbridge.use.
/郵 設定 discord 啟用Opt in to mail DMs after DiscordSRV Minecraft linking. Unlinked players cannot enable delivery.
/郵 設定 discord 停用Opt out of mail DMs, including eligibility for queued mass DMs.
/郵 設定 discord 線上 開Allow mail DMs while online. Requires mailboxguidiscbridge.online in addition to use.
/郵 設定 discord 線上 關Disable your online-DM preference. The global send-to-online-players-by-default setting still applies.
/郵 設定 discord 線上 切換Toggle your online-DM preference.
/郵 設定 discord 語言 <language>Select your individual Discord DM language by supported code or recognized language name. Does not change command roots or channel notices.
/郵 設定 discord 語言Show your current effective DM language, usage and supported language choices without changing a preference.
/郵 設定 discord 忽略 <player>Ignore player-origin mail DMs from a known Minecraft sender. Requires mailboxguidiscbridge.ignore.
/郵 設定 discord 取消忽略 <player>Remove that sender from your ignore list.
/郵 設定 discord 忽略清單List ignored Minecraft senders.
/郵 設定 discord 忽略管理員Ignore individual admin/API/server mail DMs. Requires mailboxguidiscbridge.ignoreadmin. Channel notices remain independent.
/郵 設定 discord 允許管理員Allow admin/API/server DMs again, subject to other notification checks.

Admin

Localized structurePurpose / requirements
/管郵 discord 幫助 [page]Show paged integrated administrative help, including additional Premium entries in Premium. /mba discord with no arguments opens the first page.
/管郵 discord 狀態Show hooks, DiscordSRV connection/link-manager readiness, player-command availability, version/protocol requirements, mode, policies, queues and session counters. Requires admin and admin.status.
/管郵 discord 模式Read LOCAL/NETWORK_NODE setup diagnostics; does not change the mode. Requires admin and admin.mode.
/管郵 discord 重新載入Save preferences, synchronize/reload config and both language folders, reset update preparation and reload notification services. Requires admin and admin.reload.
/管郵 discord playercommands 開|關Persist player-commands.enabled. Enabling requires a connected DiscordSRV bot and ready account-link manager. Requires admin and admin.playercommands.
/管郵 discord 檢查更新Check the matching edition/channel. Requires admin and admin.update (or explicit admin.updatecheck). Premium needs saved website credentials.
/管郵 discord 更新Prepare an available edition-matched update. Requires admin and admin.update.
/管郵 discord 更新 確認Download and validate the prepared jar, then stage it for the next planned server restart. Requires admin.update. Does not hot-swap the running plugin.
/管郵 discord 測試私訊 <player>Send a diagnostic DM; English display alias testdirectmessage is also accepted. Tests transport/linking, not normal eligibility. Requires admin and admin.test.
/管郵 discord 測試-頻道測試Send a diagnostic notice to the configured mass-mail TEXT channel. Requires its switch/ID, plus admin and admin.test.

Premium only

Localized structurePurpose / requirements
/管郵 discord 更新登入 狀態Premium only: report whether credentials are set without displaying the password. Requires admin and admin.updatelogin.
/管郵 discord 更新登入 設定 <username> <password>Premium and SERVER CONSOLE ONLY: store protected-update credentials. Requires admin and admin.updatelogin.
/管郵 discord 更新登入 清除Premium and SERVER CONSOLE ONLY: clear credentials. Requires admin and admin.updatelogin.
/管郵 discord 網路狀態Premium only: notifier state/reason, backend, shared preference readiness and local pending work. Requires admin and admin.networkstatus.
/管郵 discord 網路報告Premium only: sanitized network report, available in network-notification mode. Requires admin and admin.networksupport.

Use the exact English marketplace command /mba discord spigotlink <account-link-code> when website verification is available.

All accepted structural aliases
English tokenAccepted localized formsEdition
playercommandsplayercommandsShared
help幫助Shared
guide指南Shared
status狀態Shared
enable啟用Shared
disable停用Shared
online線上Shared
language語言Shared
ignore忽略Shared
unignore取消忽略Shared
ignorelist忽略清單Shared
ignoreadmin忽略管理員Shared
unignoreadmin允許管理員Shared
update更新Shared
on開Shared
off關Shared
toggle切換Shared
confirm確認Shared
mode模式Shared
reload重新載入Shared
updatecheck檢查更新Shared
testdm測試私訊 / 私訊測試Shared
testchannel測試-頻道測試Shared
updatelogin更新登入 / 更新驗證Premium only
spigotlinkSpigot連結 / Spigot綁定Premium only
set設定Premium only
clear清除Premium only
networkstatus網路狀態 / 網狀態Premium only
networksupport網路報告 / 網報告Premium only
Back to top ↑

Commands & languages

Message languages & complete references

All 16 languages are available for in-game messages and Discord templates: en, de, es, fr, it, ja, ko, nl, pl, pt_br, ru, sv, uk, zh_cn, zh_hk and zh_tw. Portuguese (Brazil) also accepts ptBR/pt-br language input. Supported full/native names are recognized by /mb settings discord language.

Edit language/messages_<locale>.yml for in-game text; edit disclanguage/messages_<locale>.yml for Discord text. Keep file-version/messages-version, template-profile, keys and placeholder tokens intact. Select the proper edition reference—Premium has additional commands/diagnostics and network templates.

MailboxGUI config.yml — inherited locale and independent command syntax
locale:
  default: en
  auto-detect-player-locale: true
  command-syntax:
    default: es
    auto-detect-player-locale: false

A player setting /mb settings discord language es affects that player’s individual DMs, including optional mass DMs. It does not change the global channel language, other players, command syntax or Minecraft client language. A missing/empty selected template can fall back to English.

Some preserved language defaults contain historical command spellings internally. DiscBridge rewrites them into the integrated command paths when displaying them, before inserting player values. The reference files below show that integrated path form; keys and wording remain source-derived. Historical root definitions are omitted from the shared grammar reference because they are migration data, not executable roots.

English — en: YAML examples & all four edition references
language/messages_en.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord message language set to &f{language}&a.'
disclanguage/messages_en.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 You received a book letter from {sender} on {server}.
    - Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game.
  dm-package-with-message-expire:
    - 📦 You received a package from {sender} on {server}.
    - 'Expires: {expiration}'
    - 'Message: {message}'
    - Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game.
  admin-mass-mail-channel:
    - '{mention} 📬 **Server Mail Notice**'
    - Server mail was sent to multiple players on {server}.
    - Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Deutsch — de: YAML examples & all four edition references
language/messages_de.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord-Nachrichtensprache auf &f{language}&a gesetzt.'
disclanguage/messages_de.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Du hast einen Buchbrief von {sender} auf {server} erhalten.
    - Prüfe deinen Briefkasten, einen öffentlich zugänglichen Briefkasten oder einen öffentlich zugänglichen NPC im Spiel.
  dm-package-with-message-expire:
    - 📦 Du hast ein Paket von {sender} auf {server} erhalten.
    - 'Läuft ab: {expiration}'
    - 'Nachricht: {message}'
    - Prüfe deinen Briefkasten, einen öffentlich zugänglichen Briefkasten oder einen öffentlich zugänglichen NPC im Spiel.
  admin-mass-mail-channel:
    - '{mention} 📬 **Serverpost-Hinweis**'
    - Serverpost wurde auf {server} an mehrere Spieler gesendet.
    - Prüfe deinen Briefkasten, einen öffentlich zugänglichen Briefkasten oder einen öffentlich zugänglichen NPC im Spiel.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Español — es: YAML examples & all four edition references
language/messages_es.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aIdioma de mensajes de Discord cambiado a &f{language}&a.'
disclanguage/messages_es.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Has recibido una carta tipo libro de {sender} en {server}.
    - Revisa tu buzón, un buzón de acceso público o un NPC de acceso público dentro del juego.
  dm-package-with-message-expire:
    - 📦 Has recibido un paquete de {sender} en {server}.
    - 'Caduca: {expiration}'
    - 'Mensaje: {message}'
    - Revisa tu buzón, un buzón de acceso público o un NPC de acceso público dentro del juego.
  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 de acceso público o un NPC de acceso público dentro del juego.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Français — fr: YAML examples & all four edition references
language/messages_fr.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aLangue des messages Discord définie sur &f{language}&a.'
disclanguage/messages_fr.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Vous avez reçu une lettre-livre de {sender} sur {server}.
    - Consultez votre boîte aux lettres, une boîte aux lettres en accès public ou un PNJ en accès public en jeu.
  dm-package-with-message-expire:
    - 📦 Vous avez reçu un colis de {sender} sur {server}.
    - 'Expiration: {expiration}'
    - 'Message: {message}'
    - Consultez votre boîte aux lettres, une boîte aux lettres en accès public ou un PNJ en accès public en jeu.
  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 aux lettres en accès public ou un PNJ en accès public en jeu.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Italiano — it: YAML examples & all four edition references
language/messages_it.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aLingua messaggi Discord impostata su &f{language}&a.'
disclanguage/messages_it.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Hai ricevuto una lettera libro da {sender} su {server}.
    - Controlla la tua cassetta postale, una cassetta postale ad accesso pubblico o un NPC ad accesso pubblico in gioco.
  dm-package-with-message-expire:
    - 📦 Hai ricevuto un pacco da {sender} su {server}.
    - 'Scadenza: {expiration}'
    - 'Messaggio: {message}'
    - Controlla la tua cassetta postale, una cassetta postale ad accesso pubblico o un NPC ad accesso pubblico in gioco.
  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 cassetta postale ad accesso pubblico o un NPC ad accesso pubblico in gioco.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Nederlands — nl: YAML examples & all four edition references
language/messages_nl.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord-berichttaal ingesteld op &f{language}&a.'
disclanguage/messages_nl.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Je hebt een boekbrief ontvangen van {sender} op {server}.
    - Controleer je mailbox, een openbaar toegankelijke mailbox of een openbaar toegankelijke NPC in het spel.
  dm-package-with-message-expire:
    - 📦 Je hebt een pakket ontvangen van {sender} op {server}.
    - 'Verloopt: {expiration}'
    - 'Bericht: {message}'
    - Controleer je mailbox, een openbaar toegankelijke mailbox of een openbaar toegankelijke NPC in het spel.
  admin-mass-mail-channel:
    - '{mention} 📬 **Servermailmelding**'
    - Servermail is verzonden naar meerdere spelers op {server}.
    - Controleer je mailbox, een openbaar toegankelijke mailbox of een openbaar toegankelijke NPC in het spel.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Polski — pl: YAML examples & all four edition references
language/messages_pl.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aJęzyk wiadomości Discord ustawiono na &f{language}&a.'
disclanguage/messages_pl.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Otrzymałeś list książkowy od {sender} na {server}.
    - Sprawdź swoją skrzynkę pocztową, ogólnodostępną skrzynkę pocztową lub ogólnodostępnego NPC w grze.
  dm-package-with-message-expire:
    - 📦 Otrzymałeś paczkę od {sender} na {server}.
    - 'Wygasa: {expiration}'
    - 'Wiadomość: {message}'
    - Sprawdź swoją skrzynkę pocztową, ogólnodostępną skrzynkę pocztową lub ogólnodostępnego NPC w grze.
  admin-mass-mail-channel:
    - '{mention} 📬 **Powiadomienie o poczcie serwerowej**'
    - Poczta serwerowa została wysłana do wielu graczy na {server}.
    - Sprawdź swoją skrzynkę pocztową, ogólnodostępną skrzynkę pocztową lub ogólnodostępnego NPC w grze.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Русский — ru: YAML examples & all four edition references
language/messages_ru.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aЯзык сообщений Discord установлен на &f{language}&a.'
disclanguage/messages_ru.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Вы получили книжное письмо от {sender} на {server}.
    - Проверьте свой почтовый ящик, общедоступный почтовый ящик или общедоступного NPC в игре.
  dm-package-with-message-expire:
    - 📦 Вы получили посылку от {sender} на {server}.
    - 'Срок действия: {expiration}'
    - 'Сообщение: {message}'
    - Проверьте свой почтовый ящик, общедоступный почтовый ящик или общедоступного NPC в игре.
  admin-mass-mail-channel:
    - '{mention} 📬 **Уведомление о серверной почте**'
    - Серверная почта была отправлена нескольким игрокам на {server}.
    - Проверьте свой почтовый ящик, общедоступный почтовый ящик или общедоступного NPC в игре.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Svenska — sv: YAML examples & all four edition references
language/messages_sv.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord-meddelandespråk satt till &f{language}&a.'
disclanguage/messages_sv.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Du fick ett bokbrev från {sender} på {server}.
    - Kontrollera din brevlåda, en allmänt tillgänglig brevlåda eller en allmänt tillgänglig NPC i spelet.
  dm-package-with-message-expire:
    - 📦 Du fick ett paket från {sender} på {server}.
    - 'Förfaller: {expiration}'
    - 'Meddelande: {message}'
    - Kontrollera din brevlåda, en allmänt tillgänglig brevlåda eller en allmänt tillgänglig NPC i spelet.
  admin-mass-mail-channel:
    - '{mention} 📬 **Serverpostmeddelande**'
    - Serverpost skickades till flera spelare på {server}.
    - Kontrollera din brevlåda, en allmänt tillgänglig brevlåda eller en allmänt tillgänglig NPC i spelet.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Українська — uk: YAML examples & all four edition references
language/messages_uk.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aМову повідомлень Discord встановлено на &f{language}&a.'
disclanguage/messages_uk.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 Ви отримали книжковий лист від {sender} на {server}.
    - Перевірте свою поштову скриньку, загальнодоступну поштову скриньку або загальнодоступного NPC у грі.
  dm-package-with-message-expire:
    - 📦 Ви отримали посилку від {sender} на {server}.
    - 'Термін дії: {expiration}'
    - 'Повідомлення: {message}'
    - Перевірте свою поштову скриньку, загальнодоступну поштову скриньку або загальнодоступного NPC у грі.
  admin-mass-mail-channel:
    - '{mention} 📬 **Сповіщення про серверну пошту**'
    - Серверну пошту було надіслано кільком гравцям на {server}.
    - Перевірте свою поштову скриньку, загальнодоступну поштову скриньку або загальнодоступного NPC у грі.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

日本語 — ja: YAML examples & all four edition references
language/messages_ja.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord メッセージ言語を &f{language}&a に設定しました。'
disclanguage/messages_ja.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 {server} で {sender} からブックレターを受け取りました。
    - ゲーム内のメールボックス、公共アクセス用メールボックス、または公共アクセス用 NPC を確認してください。
  dm-package-with-message-expire:
    - 📦 {server} で {sender} からパッケージを受け取りました。
    - '有効期限: {expiration}'
    - 'メッセージ: {message}'
    - ゲーム内のメールボックス、公共アクセス用メールボックス、または公共アクセス用 NPC を確認してください。
  admin-mass-mail-channel:
    - '{mention} 📬 **サーバーメール通知**'
    - '{server} で複数のプレイヤーにサーバーメールが送信されました。'
    - ゲーム内のメールボックス、公共アクセス用メールボックス、または公共アクセス用 NPC を確認してください。

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

한국어 — ko: YAML examples & all four edition references
language/messages_ko.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord 메시지 언어가 &f{language}&a 로 설정되었습니다.'
disclanguage/messages_ko.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 {server}에서 {sender}님에게서 책 편지를 받았습니다.
    - 게임 내 우편함, 공용 접근 우편함 또는 공용 접근 NPC를 확인하세요.
  dm-package-with-message-expire:
    - 📦 {server}에서 {sender}님에게서 소포를 받았습니다.
    - '만료: {expiration}'
    - '메시지: {message}'
    - 게임 내 우편함, 공용 접근 우편함 또는 공용 접근 NPC를 확인하세요.
  admin-mass-mail-channel:
    - '{mention} 📬 **서버 우편 알림**'
    - '{server}에서 여러 플레이어에게 서버 우편이 전송되었습니다.'
    - 게임 내 우편함, 공용 접근 우편함 또는 공용 접근 NPC를 확인하세요.

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

简体中文 — zh_cn: YAML examples & all four edition references
language/messages_zh_cn.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord 消息语言已设置为 &f{language}&a。'
disclanguage/messages_zh_cn.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 你在 {server} 收到了来自 {sender} 的书本信件。
    - 请进入游戏,在你的邮箱、公共访问邮箱或公共访问 NPC 处查看。
  dm-package-with-message-expire:
    - 📦 你在 {server} 收到了来自 {sender} 的包裹。
    - '到期时间: {expiration}'
    - '留言: {message}'
    - 请进入游戏,在你的邮箱、公共访问邮箱或公共访问 NPC 处查看。
  admin-mass-mail-channel:
    - '{mention} 📬 **系统邮件通知**'
    - 系统邮件已在 {server} 发送给多名玩家。
    - 请进入游戏,在你的邮箱、公共访问邮箱或公共访问 NPC 处查看。

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

繁體中文(香港) — zh_hk: YAML examples & all four edition references
language/messages_zh_hk.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord 訊息語言已設定為 &f{language}&a。'
disclanguage/messages_zh_hk.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 你喺 {server} 收到來自 {sender} 嘅書本信件。
    - 請入遊戲,到你的信箱、公共存取信箱或公共存取 NPC 查看。
  dm-package-with-message-expire:
    - 📦 你喺 {server} 收到來自 {sender} 嘅包裹。
    - '到期時間: {expiration}'
    - '留言: {message}'
    - 請入遊戲,到你的信箱、公共存取信箱或公共存取 NPC 查看。
  admin-mass-mail-channel:
    - '{mention} 📬 **系統郵件通知**'
    - 系統郵件已喺 {server} 發送畀多名玩家。
    - 請入遊戲,到你的信箱、公共存取信箱或公共存取 NPC 查看。

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Português (Brasil) — pt_br: YAML examples & all four edition references
language/messages_pt_br.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}<dark_green>✔ <green>As mensagens do Discord agora serão exibidas em <white>{language}<green>.'
disclanguage/messages_pt_br.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 **Você recebeu uma carta em formato de livro** de **{sender}** no servidor **{server}**.
    - '*Confira sua correspondência na sua caixa de correio, em uma caixa de correio pública ou com um NPC de acesso público no jogo.*'
  dm-package-with-message-expire:
    - 📦 **Você recebeu uma encomenda** de **{sender}** no servidor **{server}**.
    - ⏳ **Expira em:** {expiration}
    - 💬 **Mensagem:** {message}
    - '*Confira sua correspondência na sua caixa de correio, em uma caixa de correio pública ou com um NPC de acesso público no jogo.*'
  admin-mass-mail-channel:
    - '{mention} 📬 **Aviso do Correio do servidor**'
    - Uma correspondência do servidor foi enviada a vários jogadores de **{server}**.
    - '*Confira sua correspondência na sua caixa de correio, em uma caixa de correio pública ou com um NPC de acesso público no jogo.*'

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

繁體中文(臺灣) — zh_tw: YAML examples & all four edition references
language/messages_zh_tw.yml — excerpt
file-version: 4
general: {}
language:
  set: '{prefix}&aDiscord 訊息語言已設定為 &f{language}&a。'
disclanguage/messages_zh_tw.yml — Free excerpt
messages-version: 4
template-profile: standard
messages:
  dm-book-letter:
    - 📬 你在 {server} 收到了來自 {sender} 的書本信件。
    - 請在遊戲中查看你的信箱、公共存取信箱或公共存取 NPC。
  dm-package-with-message-expire:
    - 📦 你在 {server} 收到了來自 {sender} 的包裹。
    - '到期時間: {expiration}'
    - '留言: {message}'
    - 請在遊戲中查看你的信箱、公共存取信箱或公共存取 NPC。
  admin-mass-mail-channel:
    - '{mention} 📬 **伺服器郵件通知**'
    - 伺服器郵件已在 {server} 傳送給多名玩家。
    - 請在遊戲中查看你的信箱、公共存取信箱或公共存取 NPC。

Examples are excerpts. Merge only intended text changes, keeping your other keys. Download the complete file for the edition you use:

Official support page
Back to top ↑

Commands & languages

Complete permissions by edition

Player preference permissions default to true; administrator nodes default to op. Permissions authorize commands, not Discord delivery: Minecraft linking, opt-in, privacy and notifier readiness still apply. Premium has additional nodes and extends the admin umbrella; granting those nodes to Free cannot add Premium code.

Free / shared permissions
PermissionDefaultDescription / grants
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.
  • mailboxguidiscbridge.admin.reload: true
  • mailboxguidiscbridge.admin.status: true
  • mailboxguidiscbridge.admin.mode: true
  • mailboxguidiscbridge.admin.playercommands: true
  • mailboxguidiscbridge.admin.test: true
  • mailboxguidiscbridge.admin.update: true
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.
mailboxguidiscbridge.admin.modeopAllows viewing DiscBridge setup diagnostics.
mailboxguidiscbridge.admin.playercommandsopAllows enabling or disabling integrated player Discord commands.
Premium-only additions
PermissionDefaultDescription / grants
mailboxguidiscbridge.admin.updateloginopAllows managing Premium website update credentials.
mailboxguidiscbridge.admin.spigotlinkopAllows optionally linking this SpigotMC purchase to a website account.
mailboxguidiscbridge.admin.networkstatusopAllows read-only Premium network notifier diagnostics.
mailboxguidiscbridge.admin.networksupportopAllows exporting sanitized Premium network support reports.
Premium complete permissions & umbrella children
PermissionDefaultDescription / grants
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.
  • mailboxguidiscbridge.admin.reload: true
  • mailboxguidiscbridge.admin.status: true
  • mailboxguidiscbridge.admin.mode: true
  • mailboxguidiscbridge.admin.playercommands: true
  • mailboxguidiscbridge.admin.test: true
  • mailboxguidiscbridge.admin.update: true
  • mailboxguidiscbridge.admin.updatelogin: true
  • mailboxguidiscbridge.admin.spigotlink: true
  • mailboxguidiscbridge.admin.networkstatus: true
  • mailboxguidiscbridge.admin.networksupport: true
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.
mailboxguidiscbridge.admin.modeopAllows viewing DiscBridge setup diagnostics.
mailboxguidiscbridge.admin.playercommandsopAllows enabling or disabling integrated player Discord commands.
mailboxguidiscbridge.admin.updateloginopAllows managing Premium website update credentials.
mailboxguidiscbridge.admin.spigotlinkopAllows optionally linking this SpigotMC purchase to a website account.
mailboxguidiscbridge.admin.networkstatusopAllows read-only Premium network notifier diagnostics.
mailboxguidiscbridge.admin.networksupportopAllows exporting sanitized Premium network support reports.

MailboxGUI’s player gateway requires mailboxgui.player.use and mailboxgui.player.discord, plus enabled/ready player commands. It supplies companion use access; focused online/ignore/admin-ignore checks still apply. On remote backends without companion permission definitions, explicitly deny focused nodes when needed rather than relying on missing definitions.

The administrative gateway accepts mailboxgui.admin.discord or appropriate companion staff permissions. mailboxgui.admin.discord delegates the broad companion admin umbrella, so grant it only to staff intended to have full Discord administration. When using focused mailboxguidiscbridge.admin.* nodes, retain the required admin access and grant only intended actions. Integrated update and update confirm require admin access plus admin.update; mode now uses admin.mode, and playercommands uses admin.playercommands. Premium auth/link/diagnostics also enforce their focused permissions.

Gateway permissionPurpose
mailboxgui.player.discordMailboxGUI player entry point; does not enable the setup gate or opt into DMs.
mailboxgui.admin.discordBroad delegation to companion administration; use only for trusted staff.

Review inherited umbrella permissions as well as focused nodes and explicit negative overrides in your permission manager. The runtime also accepts mailboxguidiscbridge.admin.updatecheck for checking updates; it is not declared in plugin.yml. Preparing/confirming an update still requires the update permission and administrative access.

Back to top ↑

Configuration & templates

Configuration key reference

The companion file is plugins/MailboxGUI-DiscBridge/config.yml. Shared config-version remains 4; Premium adds protected update credentials in updates.auth, not duplicate locale/network settings. Keep the player-command gate, server-name, notification policies, mass-mail channel/queue settings, duplicate protection and update options here. The table below lists every current companion setting.

Owner fileCurrent settingsDiscBridge effect
MailboxGUI/config.ymllocale.default / locale.auto-detect-player-localeIn-game local-notice policy. locale.default also supplies the Discord DM fallback and channel language; saved Discord languages remain independent of client locale.
MailboxGUI/config.ymllocale.command-syntax.default / auto-detect-player-localeRegistered roots and integrated help/command syntax. Root-language changes still need a planned restart.
MailboxGUI/network/config.yml — Premium onlynetwork.enabled / network.server-idLOCAL or NETWORK_NODE mode and the identity of the ONE backend hosting DiscBridge + DiscordSRV.
MailboxGUI-DiscBridge/config.ymlNotification controls, player-commands, server-name, updatesCompanion-specific behavior; Premium credentials remain server-side and private.
MailboxGUI-DiscBridge/data/players.yml or Premium shared preferencesSaved player Discord language and notification choicesPreserved player preferences; do not reset them to change configuration ownership.
MailboxGUI full configuration defaults
KeyBundled defaultPurpose / requirements
config-version4Migration/schema marker; leave at the bundled value.
player-commands.enabledfalseOff by default. Server-wide preference-command gate; enabling requires connected DiscordSRV and a ready account-link manager. Existing choices are retained.
server-name"Minecraft Server"Friendly {server} value. Minecraft formatting becomes plain text on Discord.
direct-messages.enabledtrueMaster switch for individual DMs and eligibility of optional mass DMs.
direct-messages.send-to-online-players-by-defaultfalseWhen false, online recipients must enable their own online-DM preference.
duplicate-protection.enabledtrueLOCAL recent-event cache only; cleared by full companion reload/restart. Does not disable durable outbox identities or Premium shared dispatch identities; not exactly-once delivery.
duplicate-protection.remember-event-ids-minutes30LOCAL in-memory event-ID retention, minimum 1 minute. Separate from the outbox/job retention limits.
admin-mass-mail-channel.enabledtrueEnable channel notices for admin/API mass delivery.
admin-mass-mail-channel.channel-id""Discord TEXT channel ID; blank prevents channel dispatch.
admin-mass-mail-channel.mention-everyonefalseAllow the notice to mention @everyone; Discord permission is also required.
admin-mass-mail-direct-messages.enabledfalseEnable optional mass DMs; also checked for pending sends and retries.
admin-mass-mail-direct-messages.max-eligible-recipients10Cap actually eligible recipients, minimum 1.
admin-mass-mail-direct-messages.over-limit-behavior"channel_only"channel_only sends none over the cap; send_first_max sends the first eligible capped subset. Any other value falls back to channel_only. Channel notices still need their own switch/ID.
admin-mass-mail-direct-messages.queue.enabledtruePace mass DMs. LOCAL still dispatches sequentially when false, with a minimum one-tick delay; this is not an unlimited simultaneous broadcast.
admin-mass-mail-direct-messages.queue.delay-between-dms-seconds3Minimum pacing delay, at least 1 second. Premium journal polling can make it longer.
admin-mass-mail-direct-messages.queue.max-retries1Additional failed-transport attempts for mass DMs, minimum 0; initial attempt is separate.
admin-mass-mail-direct-messages.queue.retry-delay-seconds30Retry delay for failed mass DMs, minimum 1 second.
updates.enabledtrueEnable manual/automatic website update checks and staging.
updates.channel"release"release, beta or alpha; an unrecognized value falls back to release.
updates.check-on-startuptrueCheck on startup; Premium requires saved update credentials.
updates.notify-admins-on-jointrueShow available-update notices to joining administrators.
updates.notify-permission"mailboxguidiscbridge.admin"Permission needed for join-time update notices.
updates.auth.username""Premium only: website username for protected updates; set from server console.
updates.auth.password""Premium only: website password stored in plain text; protect config and backups.
Back to top ↑

Configuration & templates

Complete bundled default files

Expand each file to inspect its clean source default or download it as plain text. In-game language references normalize preserved historical paths into their current integrated display form; Discord templates and operational settings are unchanged. Premium credentials are blank. Generated files on your server can contain private settings—never post them without redaction.

config.yml — Free
Download clean reference text
# ============================================================
# MailboxGUI-DiscBridge Configuration
# ============================================================
#
# This plugin connects MailboxGUI delivery events to DiscordSRV notifications.
#
# Single-server setup:
# - Install MailboxGUI, DiscordSRV, and MailboxGUI-DiscBridge on the same server.
# - Use matching MailboxGUI Free and DiscBridge Free editions.
# - Save edits, then run /mba discord reload to reload settings and templates.
# MailboxGUI owns /mb settings discord and /mba discord, including localized roots.
# DiscBridge registers a local command service; it does not register separate roots.
# Synchronization adds missing settings and keeps owner values, unknown keys and comments.
# Changed configuration files are backed up under backups/config before synchronization.
#
# ============================================================

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

# Integrated player commands are disabled for new and upgraded installations.
# Enabling requires a connected DiscordSRV bot and an available account link manager.
player-commands:
  enabled: false

# Languages and command syntax are inherited from MailboxGUI config.yml.
# In-game notices follow locale.default and locale.auto-detect-player-locale.
# Command syntax follows MailboxGUI's locale.command-syntax settings.
# Discord templates remain customizable in disclanguage/messages_<language>.yml.
# DMs use the player's saved /mb settings discord language choice, otherwise
# MailboxGUI locale.default. Minecraft client language NEVER selects a Discord DM,
# including when the recipient is online. Channel notices use locale.default.
# Old independent locale defaults are backed up and retired during synchronization.
# Saved player languages and notification preferences are preserved.

# Server display name used in Discord messages.
# Placeholder: {server}
#
# Text supports legacy & codes, compact HEX (&#4498DB), and visual MiniMessage
# tags such as <gradient:#4498DB:#C3E8EF>Server</gradient>.
# In-game messages render colors. Discord receives readable plain text without
# Minecraft colors/tags; Discord template Markdown remains supported.
# Interactive click/hover tags and custom font tags are not supported.
#
# 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.
#
# DMs are based on local MailboxGUI delivery events.
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:
  # /mb settings discord online on
  #
  # Recommended default: false
  # Reason: online players already receive in-game MailboxGUI notifications.
  send-to-online-players-by-default: false

# Duplicate protection.
#
# DiscBridge remembers recent MailboxGUI event IDs so the same Discord
# notification can be suppressed when the same event is observed again.
# Discord may accept a send before its result can be saved; retries can duplicate
# that external send. Duplicate protection is not an exactly-once guarantee.
#
# Protects against duplicate local delivery events.
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 LOCAL 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.
#
# 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.
  # Checked again before sending and retrying; false blocks pending mass DMs too.
  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

    # Additional attempts after a failed mass DM (0 means no transport retries).
    max-retries: 1

    # Delay before retrying a failed mass DM; minimum 1 second.
    # Temporarily unavailable recipient policy is retried separately, without sending.
    retry-delay-seconds: 30

# Update checker.
#
# The website update endpoint is built into the plugin and is not shown here.
# Settings below control the channel, automatic checks and administrator notices.
# Free downloads do not require website credentials.
#
# 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"
config.yml — Premium
Download clean reference text
# ============================================================
# MailboxGUI-DiscBridge Configuration
# ============================================================
#
# This plugin connects MailboxGUI delivery events to DiscordSRV notifications.
#
# Premium setup:
# - Install DiscBridge Premium on exactly ONE backend with DiscordSRV and linked accounts.
# - All backends use MailboxGUI Premium; remote Discord commands use its network API.
# - Network mode and backend identity are inherited automatically from MailboxGUI.
# - Save edits, then run /mba discord reload to reload settings and templates.
# MailboxGUI owns /mb settings discord and /mba discord, including localized roots.
# DiscBridge registers a local command service; it does not register separate roots.
# Synchronization adds missing settings and keeps owner values, unknown keys and comments.
# Changed configuration files are backed up under backups/config before synchronization.
#
# ============================================================

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

# Integrated player commands are disabled for new and upgraded installations.
# Enabling requires a connected DiscordSRV bot and an available account link manager.
player-commands:
  enabled: false

# Languages and command syntax are inherited from MailboxGUI config.yml.
# In-game notices follow locale.default and locale.auto-detect-player-locale.
# Command syntax follows MailboxGUI's locale.command-syntax settings.
# Discord templates remain customizable in disclanguage/messages_<language>.yml.
# DMs use the player's saved /mb settings discord language choice, otherwise
# MailboxGUI locale.default. Minecraft client language NEVER selects a Discord DM,
# including when the recipient is online. Channel notices use locale.default.
# Old independent locale defaults are backed up and retired during synchronization.
# Saved player languages and notification preferences are preserved.

# Server display name used in Discord messages.
# Placeholder: {server}
#
# Text supports legacy & codes, compact HEX (&#4498DB), and visual MiniMessage
# tags such as <gradient:#4498DB:#C3E8EF>Server</gradient>.
# In-game messages render colors. Discord receives readable plain text without
# Minecraft colors/tags; Discord template Markdown remains supported.
# Interactive click/hover tags and custom font tags are not supported.
#
# 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.
#
# DMs use local and remote MailboxGUI network delivery events on the designated notifier.
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:
  # /mb settings discord online on
  #
  # Recommended default: false
  # Reason: online players already receive in-game MailboxGUI notifications.
  send-to-online-players-by-default: false

# Duplicate protection.
#
# DiscBridge remembers recent MailboxGUI event IDs so the same Discord
# notification can be suppressed when the same event is observed again.
# Discord may accept a send before its result can be saved; retries can duplicate
# that external send. Duplicate protection is not an exactly-once guarantee.
#
# This event-ID cache supplements the durable network dispatch journal.
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.
#
# In NETWORK_NODE mode, only the designated ready notifier posts these messages.
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.
#
# 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.
  # Checked again before dispatch and retries; disabling this blocks pending mass DMs.
  # Channel jobs older than 24 hours do not stage new mass DMs.
  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

    # Minimum delay between queued DMs. The network journal polls every 5 seconds,
    # so actual spacing may be longer. Durable retries may repeat an external send
    # if Discord accepted it before its result could be saved.
    delay-between-dms-seconds: 3

    # Additional attempts after a failed mass DM (0 means no transport retries).
    max-retries: 1

    # Delay before retrying a failed mass DM; minimum 1 second.
    # Temporarily unavailable recipient policy is retried separately, without sending.
    retry-delay-seconds: 30

# Update checker.
#
# The website update endpoint is built into the plugin and is not shown here.
# Settings below control the channel, automatic checks and administrator notices.
# Protected Premium downloads require the website credentials configured below.
#
# 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"

  # Website purchase credentials. Set or clear from the server console only.
  # Protect this file and its backups; passwords are stored in plain text.
  auth:
    username: ""
    password: ""

# Premium networking is inherited from MailboxGUI network/config.yml.
# Network disabled: LOCAL mode. Network enabled: NETWORK_NODE mode.
# After changing MailboxGUI networking, reload MailboxGUI and then /mba discord reload.
# Install DiscBridge and DiscordSRV on ONE backend only. The notifier automatically
# uses that MailboxGUI backend's server-id; no duplicate identity setting is needed.
# Network sends wait for the MailboxGUI API, storage and presence to become ready.
# Multiple fresh DiscBridge hosts pause dispatch and produce a console warning.
# Remove the extra installation; stale host registrations expire after 45 seconds.
# A shared renewable lease also guards overlapping instances during restarts.
# Keep backend clocks synchronized, for example with NTP.
# Shared player preferences are preserved. Unknown presence or unavailable preferences
# pause affected sends rather than bypassing player notification choices.
# Protect data/network-dispatch-staging.yml and the Discord outbox as private mail;
# keep them during upgrades and reloads. Unreadable staging pauses new admissions.
# Admitted notifications have durable retries. An external Discord send may succeed
# before its result is saved, so retries are not an exactly-once delivery guarantee.
# Use /mba discord networkstatus for state and /mba discord networksupport for a
# sanitized report. Reports exclude credentials, tokens, mail bodies and items.
# Pending retries counts this instance's work, not a network-wide total.
language/messages_en.yml — Free, integrated command-path display
Download clean reference text
# In-game text supports legacy & colors, HEX (&#RRGGBB or <#RRGGBB>) and restricted visual MiniMessage formatting. Interactive click/hover/command tags are not supported.
# Discord output removes Minecraft colors and formatting tags while retaining Discord Markdown in custom templates. Keep placeholders such as {message} and {expiration} unchanged.
compatibility:
  status-requirements: "&7DiscBridge: &f{installed} &8| &7Requirement: &f{minimum} or newer &8| &7Protocol: &f{protocol} &7(supported {min_protocol}-{max_protocol})"
  discord-requirements-failed: "DiscBridge {installed} (protocol {protocol}) is incompatible: requires version {minimum} or newer, protocols {protocols}. Only DiscBridge is disabled; MailboxGUI remains enabled and existing data is preserved."

# ============================================================
# MailboxGUI-DiscBridge | General
# ============================================================
# Edit displayed text only; preserve keys, placeholders and color codes.
# Version fields and legacy language snapshots are migration references. Keep owner translations during upgrades; do not delete files or reset settings.

# ------------------------------------------------------------
# Command syntax
# ------------------------------------------------------------
# Command syntax settings belong to MailboxGUI's config.yml, not DiscBridge's config.yml.
# Integrated commands use MailboxGUI's supplied command locale; local notices derive syntax from MailboxGUI.

# Integrated Discord commands. Keep keys and placeholders; existing customized text is preserved.
integration:
  playercommands-disabled: "{prefix}&cPlayer Discord commands are disabled on this server."
  playercommands-unavailable: "{prefix}&cCannot enable player commands: DiscordSRV must be connected and account linking available."
  playercommands-set: "{prefix}&aPlayer commands: {state}"
  playercommands-save-failed: "{prefix}&cCould not save settings. Existing data was preserved."
  playercommands-usage: "{prefix}&e/mba discord playercommands on|off"
integrated-help:
  header: "&6&lMailboxGUI-DiscBridge v{version}"
  line-top: "&8&m------------------------------------------------&r"
  title-player: "&e&lPlayer Discord Commands"
  title-admin: "&e&lAdmin Discord Commands"
  playercommands: "&7  &f/mba discord playercommands on|off &8- &7Control player Discord commands."
  status: "&7Discord connection: {connected} | Account linking: {linking} | Player commands: {playercommands}"
  footer: "&fPage {page}/{total} - {command} {help}"

file-version: 4
discord-guide:
  title: "&e&lDiscord Mail Guide"
  help: "&7  &f/mb settings discord guide &8- &7Open the Discord mail guide."
  lines:
    - "&7  DiscBridge uses the same DiscordSRV account link; no separate player link is needed."
    - "&7  Account linking: /discordsrv link; send the code to the server bot in a Discord DM."
    - "&7  Notifications: /mb settings discord enable or /mb settings discord disable."
    - "&7  All mail types: letters, books, server letters, packages, COD and money; server settings apply."
    - "&7  Online DMs: /mb settings discord online on|off|toggle."
    - "&7  DM language: /mb settings discord language <language>; independent of in-game text."
    - "&7  Sender filters: /mb settings discord ignore <player> or /mb settings discord unignore <player>."
    - "&7  Admin mail: /mb settings discord ignoreadmin or /mb settings discord unignoreadmin; channel notices are unaffected."
    - "&7  Review settings: /mb settings discord status. Allow DMs from the server bot in Discord."
prefix: "<gradient:#FF8758:#ECE9E1:#FF8758>[MailboxGUI-DiscBridge]</gradient> <reset>"

# ------------------------------------------------------------
# General
# ------------------------------------------------------------
general:
  state-active: "&aActive"
  state-inactive: "&cInactive"
  state-enabled: "&aEnabled"
  state-disabled: "&cDisabled"
  state-channel-missing: "&cMissing channel ID"
  state-configured: "&aConfigured"
  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/mb settings discord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge reloaded."

# ------------------------------------------------------------
# Command syntax
# ------------------------------------------------------------
language:
  current: "{prefix}&7Discord message language: &f{language}"
  usage: "{prefix}&7Usage: &f/mb settings discord language <language>"
  supported: "{prefix}&7Supported: &f{supported}"
  unknown: "{prefix}&cUnknown Discord message language: &f{input}"
  set: "{prefix}&aDiscord message language set to &f{language}&a."

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

# ------------------------------------------------------------
# Administration
# ------------------------------------------------------------
admin:
  mode:
    local:
      - "&bMailboxGUI-DiscBridge Mode Diagnostic"
      - "&7Mode: &e{mode}"
      - "&7MailboxGUI hook: {mailboxgui}"
      - "&7DiscordSRV hook: {discordsrv}"
      - "&aLOCAL mode setup:"
      - "&7Install MailboxGUI, DiscordSRV, and MailboxGUI-DiscBridge on this server."
      - "&7Use this mode for standalone/single-backend servers."

  status:
    - "&bMailboxGUI-DiscBridge Admin Status"
    - "&7MailboxGUI hook: {mailboxgui}"
    - "&7DiscordSRV hook: {discordsrv}"
    - "&7Mode: &e{mode}"
    - "&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/mba discord 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."

# ------------------------------------------------------------
# Notifications
# ------------------------------------------------------------
ignore:
  usage-ignore: "{prefix}&cUsage: &e/mb settings discord ignore <player>"
  usage-unignore: "{prefix}&cUsage: &e/mb settings discord 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."
online:
  usage: "{prefix}&cUsage: &e/mb settings discord online <on|off|toggle>"
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"

# ------------------------------------------------------------
# Integrations
# ------------------------------------------------------------
discord:
  not-linked: "{prefix}&cYour Minecraft account is not linked to DiscordSRV yet. If you just linked, wait a few seconds and try &e/mb settings discord 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."

# ------------------------------------------------------------
# Updates
# ------------------------------------------------------------
update:
  manager-unavailable: "{prefix}&cUpdate manager is unavailable."
updates:
  failure-cleanup: "{prefix}&cCould not remove the temporary update file: {value}"
  not-checked: "&7Not checked"
  disabled: "{prefix}&cUpdate checker is disabled in config.yml."
  checking: "{prefix}&eChecking the website release system for DiscBridge updates..."
  no-pending: "{prefix}&cNo pending update is ready to install."
  prepare: "{prefix}&eRun &f/mba discord update &eto prepare this update."
  already-staged: "{prefix}&aMailboxGUI-DiscBridge {version} is already staged for the next restart."
  restart: "{prefix}&eRestart the server to complete the update."
  no-download: "{prefix}&cThe website release did not provide a direct jar download URL."
  download: "&7Download: &f{value}"
  downloading: "{prefix}&eDownloading DiscBridge {version} for the next restart..."
  download-failed: "{prefix}&cUpdate download failed."
  unchanged: "&7Your current jar was not changed."
  staged: "{prefix}&aUpdate staged successfully."
  target: "&7Target version: &f{value}"
  file: "&7Staged file: &f{value}"
  available: "{prefix}&eUpdate available: &f{version}"
  current: "&7Current: &f{value}"
  details: "&7Run &f/mba discord updatecheck &7for details."
  failure-unusable: "{prefix}&cThe website endpoint did not return a usable release response."
  failure-http: "{prefix}&cThe website returned HTTP {value}."
  failure-json: "{prefix}&cThe website returned non-JSON content. Check the update.json route."
  failure-version: "{prefix}&cThe release response did not include a latest version."
  failure-product: "{prefix}&cThe website returned release data for the wrong product."
  failure-edition: "{prefix}&cRelease edition {actual} does not match this jar's edition {expected}."
  failure-channel: "{prefix}&cRelease channel {actual} does not match configured channel {expected}."
  failure-api: "{prefix}&cThe website endpoint is not using DiscBridge release API v2."
  failure-check: "{prefix}&cCould not check the website release system. Check console/connectivity."
  type: "&7Type: &f{value}"
  summary: "&7Summary: &f{value}"
  check-title: "{prefix}&eUpdate Check"
  source: "&7Website Release System"
  latest: "&7Latest: &f{value}"
  title: "&7Title: &f{value}"
  update-title: "{prefix}&eUpdate"
  status-current: "{prefix}&aMailboxGUI-DiscBridge is up to date."
  confirm: "{prefix}&eRun &f/mba discord update confirm &eto download and stage the update for the next restart."
  failure-folder: "{prefix}&cCould not create the Bukkit update folder: {value}"
  failure-jar: "{prefix}&cThe downloaded file is not a valid MailboxGUI-DiscBridge jar for this edition/version. Check the download URL."
  failure-download: "{prefix}&cCould not download/stage the update. Check connectivity and file permissions."
  failure-unknown: "{prefix}&cUnknown update failure."
  status-newer: "{prefix}&eRunning a newer/development build."
  status-major: "{prefix}&eMajor update available."
  status-feature: "{prefix}&eFeature update available."
  status-maintenance: "{prefix}&eMaintenance update available."
  type-release: "&7Type: &fRelease"
  type-beta: "&7Type: &fBeta"
  type-alpha: "&7Type: &fAlpha"
language/messages_en.yml — Premium, integrated command-path display
Download clean reference text
# In-game text supports legacy & colors, HEX (&#RRGGBB or <#RRGGBB>) and restricted visual MiniMessage formatting. Interactive click/hover/command tags are not supported.
# Discord output removes Minecraft colors and formatting tags while retaining Discord Markdown in custom templates. Keep placeholders such as {message} and {expiration} unchanged.
compatibility:
  status-requirements: "&7DiscBridge: &f{installed} &8| &7Requirement: &f{minimum} or newer &8| &7Protocol: &f{protocol} &7(supported {min_protocol}-{max_protocol})"
  discord-requirements-failed: "DiscBridge {installed} (protocol {protocol}) is incompatible: requires version {minimum} or newer, protocols {protocols}. Only DiscBridge is disabled; MailboxGUI remains enabled and existing data is preserved."

# ============================================================
# MailboxGUI-DiscBridge | General
# ============================================================
# Edit displayed text only; preserve keys, placeholders and color codes.
# Version fields and legacy language snapshots are migration references. Keep owner translations during upgrades; do not delete files or reset settings.

# ------------------------------------------------------------
# Command syntax
# ------------------------------------------------------------
# Command syntax settings belong to MailboxGUI's config.yml, not DiscBridge's config.yml.
# Integrated commands use MailboxGUI's supplied command locale; local notices derive syntax from MailboxGUI.

# Integrated Discord commands. Keep keys and placeholders; existing customized text is preserved.
integration:
  playercommands-disabled: "{prefix}&cPlayer Discord commands are disabled on this server."
  playercommands-unavailable: "{prefix}&cCannot enable player commands: DiscordSRV must be connected and account linking available."
  playercommands-set: "{prefix}&aPlayer commands: {state}"
  playercommands-save-failed: "{prefix}&cCould not save settings. Existing data was preserved."
  playercommands-usage: "{prefix}&e/mba discord playercommands on|off"
integrated-help:
  header: "&6&lMailboxGUI-DiscBridge v{version}"
  line-top: "&8&m------------------------------------------------&r"
  title-player: "&e&lPlayer Discord Commands"
  title-admin: "&e&lAdmin Discord Commands"
  playercommands: "&7  &f/mba discord playercommands on|off &8- &7Control player Discord commands."
  status: "&7Discord connection: {connected} | Account linking: {linking} | Player commands: {playercommands}"
  footer: "&fPage {page}/{total} - {command} {help}"

file-version: 4
discord-guide:
  title: "&e&lDiscord Mail Guide"
  help: "&7  &f/mb settings discord guide &8- &7Open the Discord mail guide."
  lines:
    - "&7  DiscBridge uses the same DiscordSRV account link; no separate player link is needed."
    - "&7  Account linking: /discordsrv link; send the code to the server bot in a Discord DM."
    - "&7  Notifications: /mb settings discord enable or /mb settings discord disable."
    - "&7  All mail types: letters, books, server letters, packages, COD and money; server settings apply."
    - "&7  Online DMs: /mb settings discord online on|off|toggle."
    - "&7  DM language: /mb settings discord language <language>; independent of in-game text."
    - "&7  Sender filters: /mb settings discord ignore <player> or /mb settings discord unignore <player>."
    - "&7  Admin mail: /mb settings discord ignoreadmin or /mb settings discord unignoreadmin; channel notices are unaffected."
    - "&7  Review settings: /mb settings discord status. Allow DMs from the server bot in Discord."
prefix: "<gradient:#FF8758:#ECE9E1:#FF8758>[MailboxGUI-DiscBridge]</gradient> <reset>"

# ------------------------------------------------------------
# General
# ------------------------------------------------------------
general:
  state-active: "&aActive"
  state-inactive: "&cInactive"
  state-enabled: "&aEnabled"
  state-disabled: "&cDisabled"
  state-channel-missing: "&cMissing channel ID"
  state-configured: "&aConfigured"
  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/mb settings discord help&c."
  reload-complete: "{prefix}&aMailboxGUI-DiscBridge reloaded."

# ------------------------------------------------------------
# Command syntax
# ------------------------------------------------------------
language:
  current: "{prefix}&7Discord message language: &f{language}"
  usage: "{prefix}&7Usage: &f/mb settings discord language <language>"
  supported: "{prefix}&7Supported: &f{supported}"
  unknown: "{prefix}&cUnknown Discord message language: &f{input}"
  set: "{prefix}&aDiscord message language set to &f{language}&a."

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

# ------------------------------------------------------------
# Administration
# ------------------------------------------------------------
admin:
  license-help: "&7  Admin license: /mba discord spigotlink <account-link-code> - Link the DiscBridge Premium purchase to the website, not a Discord account."
  # Read-only network diagnostics. Keep command syntax, IDs and placeholders unchanged; reports exclude credentials, tokens, message bodies and item payloads.
  network:
    heading: "&bDiscBridge Network Status"
    status: "&7Status: &f{state}"
    reason: "&7Reason: &f{reason}"
    backend: "&7Backend: &f{backend}"
    notifier: "&7Notifier: &f{notifier}"
    preferences: "&7Shared preferences: &f{preferences}"
    pending: "&7Pending retries: &f{count}"
    export-complete: "{prefix}&aSupport report saved: {path}"
    busy: "{prefix}&eA network diagnostic is already running. Try again shortly."
    export-failed: "{prefix}&cCould not export the network support report."
    no-network: "{prefix}&eNetwork notifications are not enabled."
    help-status: "&e/mba discord networkstatus &7- View network notifier status."
    help-support: "&e/mba discord networksupport &7- Export a sanitized network support report."
    transition: "&7DiscBridge network notifier: {state} ({reason})."
    staging-unavailable: "&eNetwork notification staging is unavailable."
    staging-save-failed: "&eCould not save staged network notifications."
    staging-oversized: "&eThe staged network notification is too large; it was not queued."
    staging-unreadable: "&eCannot read staged network notifications; saved data was preserved."
    states:
      active: "Active"
      standby: "Standby"
      starting: "Starting"
      degraded: "Degraded"
      unavailable: "Unavailable"
    reasons:
      runtime-unavailable: "Network runtime unavailable"
      notifier-unset: "Backend identity unavailable"
      notifier-conflict: "Multiple DiscBridge hosts detected; network notifications paused"
      lease-busy: "Notifier lease held by another instance"
      storage-unavailable: "Shared storage unavailable"
      prefs-unavailable: "Shared preferences unavailable"
      ready: "Ready"
      non-network: "Not using network notifications"
      busy: "Diagnostics busy"
      stale: "Outdated diagnostic result"
      local: "Local preferences"
      shared-ready: "Shared preferences ready"
      starting: "Preferences starting"
      conflict: "Preference revision conflict"
    preferences-states:
      preferences-closed: "Closed"
      preferences-paused: "Paused"
      preferences-local: "Local"
      preferences-unavailable: "Unavailable"
      preferences-loading: "Loading"
      preferences-ready: "Ready"

  # ------------------------------------------------------------
  # Administration
  # ------------------------------------------------------------
  mode:
    local:
      - "&bMailboxGUI-DiscBridge Mode Diagnostic"
      - "&7Mode: &e{mode}"
      - "&7MailboxGUI hook: {mailboxgui}"
      - "&7DiscordSRV hook: {discordsrv}"
      - "&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}"
      - "&7Install DiscBridge and DiscordSRV on exactly one backend. Identity comes from MailboxGUI."
      - "&7MailboxGUI controls network mode. Discord retries may duplicate an external send."
  test-channel-disabled: "{prefix}&cAdmin mass mail channel messages are disabled in config.yml."
  test-channel-failed: "{prefix}&cFailed to send test channel message. Check console for details."
  test-channel-missing: "{prefix}&cAdmin mass mail channel-id is missing in config.yml."
  test-channel-sent: "{prefix}&aTest channel message sent."
  test-dm-failed: "{prefix}&cFailed to send test DM to &e{player}&c. Check console for details."
  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-usage: "{prefix}&cUsage: &e/mba discord testdm <player>"

  # ------------------------------------------------------------
  # Notifications
  # ------------------------------------------------------------
  status:
    - "&bMailboxGUI-DiscBridge Admin Status"
    - "&7MailboxGUI hook: {mailboxgui}"
    - "&7DiscordSRV hook: {discordsrv}"
    - "&7Mode: &e{mode}"
    - "&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"

  # ------------------------------------------------------------
  # Premium account and access
  # ------------------------------------------------------------
  spigot-link-already-linked: "{prefix}&aThis plugin purchase is already linked to that website account."
  spigot-link-busy: "{prefix}&eA link request is already running. Wait before trying again."
  spigot-link-expired: "{prefix}&cThis link code expired. Generate a new code for this plugin on the website."
  spigot-link-failed: "{prefix}&cThe website link request failed. Try again later; the plugin will continue working normally."
  spigot-link-invalid: "{prefix}&cInvalid link code. Expected: MGUI-XXXX-XXXX."
  spigot-link-linked: "{prefix}&aThis plugin purchase is linked to your website account."
  spigot-link-not-verified: "{prefix}&cThis purchase could not be verified. Check your purchase and contact website support."
  spigot-link-other-account: "{prefix}&cThis purchase is already linked to another website account. Contact website support."
  spigot-link-pending: "{prefix}&ePurchase verification is pending. Check Purchases and Licenses on the website."
  spigot-link-rate-limited: "{prefix}&eToo many link attempts. Wait before generating or using another code."
  spigot-link-unavailable: "{prefix}&eSpigot account linking is unavailable. Use the purchase website."
  spigot-link-not-spigot-purchase: "{prefix}&cThis plugin was not purchased on SpigotMC. Linking requires a SpigotMC buyer download with all purchase identifiers injected."
  spigot-link-usage: "{prefix}&7Usage: &f/mba discord spigotlink <account-link-code>"
  spigot-link-working: "{prefix}&eChecking this SpigotMC purchase with the website..."
  spigot-link-wrong-resource: "{prefix}&cThis code or SpigotMC download belongs to a different plugin. Generate a code for this plugin."
  update-login-cleared: "{prefix}&aUpdate credentials cleared."
  update-login-console-only: "{prefix}&cOnly the server console can change update credentials."
  update-login-invalid: "{prefix}&cEnter a nonempty username without ':' and a nonempty password."
  update-login-not-set: "{prefix}&eUpdate credentials are not set."
  update-login-required: "{prefix}&cPremium updates require website purchase credentials. Use the console: /mba discord updatelogin set <username> <password>"
  update-login-save-failed: "{prefix}&cCould not save update credentials. Check the console."
  update-login-saved: "{prefix}&aUpdate credentials are saved."
  update-login-usage: "{prefix}&cUsage: /mba discord updatelogin status|clear, or /mba discord updatelogin set <username> <password>"

# ------------------------------------------------------------
# Notifications
# ------------------------------------------------------------
ignore:
  usage-ignore: "{prefix}&cUsage: &e/mb settings discord ignore <player>"
  usage-unignore: "{prefix}&cUsage: &e/mb settings discord 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."
online:
  usage: "{prefix}&cUsage: &e/mb settings discord online <on|off|toggle>"
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"

# ------------------------------------------------------------
# Integrations
# ------------------------------------------------------------
discord:
  not-linked: "{prefix}&cYour Minecraft account is not linked to DiscordSRV yet. If you just linked, wait a few seconds and try &e/mb settings discord 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."

# ------------------------------------------------------------
# Updates
# ------------------------------------------------------------
update:
  manager-unavailable: "{prefix}&cUpdate manager is unavailable."
updates:
  failure-cleanup: "{prefix}&cCould not remove the temporary update file: {value}"
  not-checked: "&7Not checked"
  disabled: "{prefix}&cUpdate checker is disabled in config.yml."
  checking: "{prefix}&eChecking the website release system for DiscBridge updates..."
  no-pending: "{prefix}&cNo pending update is ready to install."
  prepare: "{prefix}&eRun &f/mba discord update &eto prepare this update."
  already-staged: "{prefix}&aMailboxGUI-DiscBridge {version} is already staged for the next restart."
  restart: "{prefix}&eRestart the server to complete the update."
  no-download: "{prefix}&cThe website release did not provide a direct jar download URL."
  download: "&7Download: &f{value}"
  downloading: "{prefix}&eDownloading DiscBridge {version} for the next restart..."
  download-failed: "{prefix}&cUpdate download failed."
  unchanged: "&7Your current jar was not changed."
  staged: "{prefix}&aUpdate staged successfully."
  target: "&7Target version: &f{value}"
  file: "&7Staged file: &f{value}"
  available: "{prefix}&eUpdate available: &f{version}"
  current: "&7Current: &f{value}"
  details: "&7Run &f/mba discord updatecheck &7for details."
  failure-unusable: "{prefix}&cThe website endpoint did not return a usable release response."
  failure-http: "{prefix}&cThe website returned HTTP {value}."
  failure-json: "{prefix}&cThe website returned non-JSON content. Check the update.json route."
  failure-version: "{prefix}&cThe release response did not include a latest version."
  failure-product: "{prefix}&cThe website returned release data for the wrong product."
  failure-edition: "{prefix}&cRelease edition {actual} does not match this jar's edition {expected}."
  failure-channel: "{prefix}&cRelease channel {actual} does not match configured channel {expected}."
  failure-api: "{prefix}&cThe website endpoint is not using DiscBridge release API v2."
  failure-check: "{prefix}&cCould not check the website release system. Check console/connectivity."
  type: "&7Type: &f{value}"
  summary: "&7Summary: &f{value}"
  check-title: "{prefix}&eUpdate Check"
  source: "&7Website Release System"
  latest: "&7Latest: &f{value}"
  title: "&7Title: &f{value}"
  update-title: "{prefix}&eUpdate"
  status-current: "{prefix}&aMailboxGUI-DiscBridge is up to date."
  confirm: "{prefix}&eRun &f/mba discord update confirm &eto download and stage the update for the next restart."
  failure-folder: "{prefix}&cCould not create the Bukkit update folder: {value}"
  failure-jar: "{prefix}&cThe downloaded file is not a valid MailboxGUI-DiscBridge jar for this edition/version. Check the download URL."
  failure-download: "{prefix}&cCould not download/stage the update. Check connectivity and file permissions."
  failure-unknown: "{prefix}&cUnknown update failure."
  status-newer: "{prefix}&eRunning a newer/development build."
  status-major: "{prefix}&eMajor update available."
  status-feature: "{prefix}&eFeature update available."
  status-maintenance: "{prefix}&eMaintenance update available."
  type-release: "&7Type: &fRelease"
  type-beta: "&7Type: &fBeta"
  type-alpha: "&7Type: &fAlpha"

# Shared preferences load and save asynchronously. Conflicts preserve newer saved choices; upgrades retain custom settings. Do not report success until the save completes.
player:
  preferences-loading: "{prefix}&eYour shared notification preferences are loading. Please try again shortly."
  preferences-conflict: "{prefix}&eYour preferences changed elsewhere. The newer saved settings were preserved; try again."
  preferences-saved: "{prefix}&aYour shared notification preferences were saved."
disclanguage/messages_en.yml — Free
Download clean reference text
# In-game text supports legacy & colors, HEX (&#RRGGBB or <#RRGGBB>) and restricted visual MiniMessage formatting. Interactive click/hover/command tags are not supported.
# Discord output removes Minecraft colors and formatting tags while retaining Discord Markdown in custom templates. Keep placeholders such as {message} and {expiration} unchanged.
# ============================================================
# MailboxGUI-DiscBridge | General
# ============================================================
# Edit displayed text only; preserve keys, placeholders and color codes.
# Version fields and legacy language snapshots are migration references. Keep owner translations during upgrades; do not delete files or reset settings.
# Individual Discord DMs use the recipient's selected language; channel notices use the configured default Discord language.
# {server} {sender} {recipient} {price} {amount} {expiration} {message} {mention} {recipient_count}

messages-version: 4
template-profile: standard

messages:

  # ------------------------------------------------------------
  # Discord letters
  # ------------------------------------------------------------
  dm-book-letter:
    - "📬 You received a book letter from {sender} on {server}."
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-book-letter-expire:
    - "📬 You received a book letter from {sender} on {server}."
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-letter:
    - "📬 You received a letter from {sender} on {server}."
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-letter-expire:
    - "📬 You received a letter from {sender} on {server}."
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."

  # ------------------------------------------------------------
  # Discord packages
  # ------------------------------------------------------------
  dm-cod-item-currency-payment:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-item-currency-payment-expire:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-item-currency-payment-with-message:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-item-currency-payment-with-message-expire:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Expires: {expiration}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package-expire:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package-with-message:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package-with-message-expire:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Expires: {expiration}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package:
    - "📦 You received a package from {sender} on {server}."
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package-expire:
    - "📦 You received a package from {sender} on {server}."
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package-with-message:
    - "📦 You received a package from {sender} on {server}."
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package-with-message-expire:
    - "📦 You received a package from {sender} on {server}."
    - "Expires: {expiration}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package-expire:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package-with-message:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package-with-message-expire:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Expires: {expiration}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."

  # ------------------------------------------------------------
  # Discord money mail
  # ------------------------------------------------------------
  dm-money-mail:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-money-mail-expire:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-money-mail-with-message:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-money-mail-with-message-expire:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Expires: {expiration}"
    - "Message: {message}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."

  # ------------------------------------------------------------
  # Discord channel notices
  # ------------------------------------------------------------
  admin-mass-mail-channel:
    - "{mention} 📬 **Server Mail Notice**"
    - "Server mail was sent to multiple players on {server}."
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  admin-mass-mail-expire-channel:
    - "{mention} 📬 **Server Mail Notice**"
    - "Server mail was sent to multiple players on {server}."
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
disclanguage/messages_en.yml — Premium
Download clean reference text
# In-game text supports legacy & colors, HEX (&#RRGGBB or <#RRGGBB>) and restricted visual MiniMessage formatting. Interactive click/hover/command tags are not supported.
# Discord output removes Minecraft colors and formatting tags while retaining Discord Markdown in custom templates. Keep placeholders such as {message} and {expiration} unchanged.
# ============================================================
# MailboxGUI-DiscBridge | General
# ============================================================
# Edit displayed text only; preserve keys, placeholders and color codes.
# Version fields and legacy language snapshots are migration references. Keep owner translations during upgrades; do not delete files or reset settings.
# Individual Discord DMs use the recipient's selected language; channel notices use the configured default Discord language.
# {server} {sender} {recipient} {price} {amount} {expiration} {message} {mention} {recipient_count}
# Premium network
# {backend_id} {backend_name} {target_backends} {backend_group} {restriction_reason} {expiration_remaining} {mail_id}

# Optional [[if:origin_backend_id]], [[if:target_backends]], [[if:backend_group]] and [[if:restriction_reason]] blocks are hidden only when their metadata is absent. Unknown routing is not unrestricted; {routing_status} is the literal machine value known/unknown, not translated. {restriction_reason} keeps exact API reason codes. Native warning prose belongs in [[if:routing_unknown]]...[[/if]]. Origin and notifier are different backends; {backend_id}/{backend_name} remain origin aliases.
# [[if:notifier_backend_id]]...[[/if]]; [[if:routing_unknown]]...[[/if]]
# {origin_backend_id} {origin_backend_name} {notifier_backend_id} {notifier_backend_name}
messages-version: 4
template-profile: network

messages:

  # ------------------------------------------------------------
  # Discord letters
  # ------------------------------------------------------------
  dm-book-letter:
    - "📬 You received a book letter from {sender} on {server}."
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-book-letter-expire:
    - "📬 You received a book letter from {sender} on {server}."
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-letter:
    - "📬 You received a letter from {sender} on {server}."
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-letter-expire:
    - "📬 You received a letter from {sender} on {server}."
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."

  # ------------------------------------------------------------
  # Discord packages
  # ------------------------------------------------------------
  dm-cod-item-currency-payment:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-item-currency-payment-expire:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-item-currency-payment-with-message:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-item-currency-payment-with-message-expire:
    - "💜 You received a COD item-currency payment from {sender} on {server}."
    - "Payment: {price}"
    - "Expires: {expiration}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package-expire:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package-with-message:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-cod-package-with-message-expire:
    - "📦 You received a COD package from {sender} on {server}."
    - "Price: {price}"
    - "Expires: {expiration}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package:
    - "📦 You received a package from {sender} on {server}."
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package-expire:
    - "📦 You received a package from {sender} on {server}."
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package-with-message:
    - "📦 You received a package from {sender} on {server}."
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-package-with-message-expire:
    - "📦 You received a package from {sender} on {server}."
    - "Expires: {expiration}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package-expire:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package-with-message:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-returned-cod-package-with-message-expire:
    - "↩️ Your COD package was returned by {sender} on {server}."
    - "Expires: {expiration}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."

  # ------------------------------------------------------------
  # Discord money mail
  # ------------------------------------------------------------
  dm-money-mail:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-money-mail-expire:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-money-mail-with-message:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  dm-money-mail-with-message-expire:
    - "💰 You received money mail from {sender} on {server}."
    - "Amount: {amount}"
    - "Expires: {expiration}"
    - "Message: {message}"
    - "[[if:origin_backend_id]]Backend: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:routing_unknown]]Unknown; backend restrictions may apply[[/if]]"
    - "[[if:target_backends]]Targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "Time remaining (s): {expiration_remaining}"
    - "Mail ID: {mail_id}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."

  # ------------------------------------------------------------
  # Discord channel notices
  # ------------------------------------------------------------
  admin-mass-mail-channel:
    - "{mention} 📬 **Server Mail Notice**"
    - "Server mail was sent to multiple players on {server}."
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
  admin-mass-mail-expire-channel:
    - "{mention} 📬 **Server Mail Notice**"
    - "Server mail was sent to multiple players on {server}."
    - "Expires: {expiration}"
    - "Check your mailbox, a Public Access Mailbox, or a Public Access NPC in-game."
Back to top ↑

Configuration & templates

Customize Discord notification templates

Discord templates are YAML lists under messages: in disclanguage/messages_<locale>.yml. Each list becomes the lines of a Discord message. This is not gui.yml and not the in-game language file. Preserve template keys and use separate variants for attached messages and expiration.

Discord Markdown in trusted templates is supported. Minecraft & colors, compact HEX and restricted visual MiniMessage are converted to readable plain text before Discord delivery. Interactive click/hover/command tags and custom-font tags are not supported. Player message values are escaped so they cannot inject template conditions, Markdown or mass mentions.

Custom readable Free package message
messages:
  dm-package-with-message-expire:
    - "**New package from {sender}**"
    - "Server: {server}"
    - "Expires: {expiration}"
    - "Message: {message}"
    - "Open your mailbox in-game to claim it."
PlaceholderMeaning
{server}DiscBridge server-name, stripped to readable Discord text.
{sender}Sender display name from the delivery event.
{recipient}Individual recipient name when supplied by the event.
{price}MailboxGUI COD price text first (money/items/XP/template combinations), otherwise numeric COD price.
{amount}Money amount, formatted without unnecessary trailing zeroes.
{expiration}Localized expiration date/time in the Minecraft server JVM timezone; blank when none. %expiration% is also accepted.
{message}Visible attached message for non-letter variants; newline-normalized and safely escaped.
{mention}Configured @everyone only for channel notices when enabled; otherwise blank.
{recipient_count}Successful recipient count from a mass-delivery event, not the number eligible for DMs.

These are DiscBridge template tokens, not PlaceholderAPI percent-placeholders. Letter notifications intentionally do not publish the full letter/book body. Do not place confidential server information into templates that all recipients can read.

The renderer recognizes snake_case tokens and their normalized camelCase aliases. Misspelled/unknown tokens are not a reliable fallback: they can remain literal, or an optional value line can disappear. Direct messages disable Discord mentions; channel @everyone behavior is controlled by mention-everyone, not by granting players mention permissions.

An admitted outbox job retains its rendered message: editing a template does not rewrite pending notifications. Changing the configured channel or a recipient’s linked Discord account stops work aimed at the old target rather than silently retargeting private mail.

Apply edits after saving YAML
/mba discord reload
/mba discord testdm Alex
/mba discord testchannel
Back to top ↑

Premium networking • Premium only

Premium network setup step by step

  1. Configure MailboxGUI Premium on every mail backend first: shared MySQL/MariaDB, required Redis, one consistent namespace, unique backend IDs and healthy presence/coordination. Do not use different namespaces against the same shared mail database.
  2. Choose one backend, for example survival, and install matched DiscBridge Premium plus DiscordSRV there only. Remove extra DiscBridge installations during planned maintenance; preserve their private data/backups before relocating anything.
  3. In that host’s MailboxGUI network/config.yml, enable networking and set its unique network.server-id. DiscBridge inherits this backend identity automatically; no companion notifier-ID setting is needed. Keep backend clocks synchronized.
  4. Configure the host DiscordSRV bot/player Minecraft links. In DiscBridge config.yml set the desired notification switches, mass-mail TEXT channel, pacing and player-command gate. Set locale defaults in that host’s MailboxGUI config.yml.
  5. Run /mba reload for MailboxGUI network edits; Premium automatically refreshes the enabled local DiscBridge network state. This does not reload companion configuration, languages or templates. If you also edited companion files, run /mba discord reload to apply those separately. STARTING/unavailable APIs wait without silently switching to local sending.
  6. Check /mba discord networkstatus for one Active/Ready host, then enable player commands after bot/link-manager readiness. Wait for authoritative shared preferences before changing them.
  7. Test deliveries and integrated commands from another MailboxGUI Premium backend, including online/offline DMs, saved languages, channel notices, attached messages and restricted mail. A Discord notification does not grant claim eligibility.
Notifier: MailboxGUI network/config.yml fragment
network:
  enabled: true
  namespace: mailboxgui
  server-id: survival
  server-display-name: "Survival"

This MailboxGUI fragment assumes shared storage, Redis and other settings are already configured; it is not a full network file. The lobby backend uses its own unique server-id (for example lobby) and does not run DiscBridge. The single host automatically uses survival as its identity; no duplicated notifier selection is configured elsewhere.

Minimal centralized arrangement
Velocity/BungeeCord proxy (no DiscBridge jar)
├── survival: MailboxGUI Premium + DiscordSRV + DiscBridge Premium (notifier)
└── lobby: MailboxGUI Premium (mail backend)
Shared MailboxGUI MySQL/MariaDB + Redis
Full MailboxGUI Premium network installation MailboxGUI backend targeting & Multiverse setup
Back to top ↑

Premium networking • Premium only

Premium: integrated commands across backends

A single compatible DiscBridge Premium installation alongside DiscordSRV can serve integrated commands across a healthy MailboxGUI Premium network. Local requests call the companion on that backend; other participating MailboxGUI Premium backends forward authorized requests to the selected companion host through MailboxGUI’s network transport. Install DiscBridge + DiscordSRV on that ONE host only, not on every backend or additional standby nodes.

Same integrated commands on a participating Premium backend
/mb settings discord status
/mb settings discord language en
/mba discord status
/mba discord playercommands on

Remote commands use the companion host’s player-command gate, configuration, DiscordSRV account links and shared preference records. Reload, credential changes and update staging affect that host, not the jar/config folder of the backend where you typed the command. Administrative player-command enablement still requires the host bot connection and account-link manager to be ready.

Authenticated backend identity, runtime generation, bounded requests/replies, correlation and duplicate suppression protect forwarded work. Unavailable, incompatible or stale hosts do not authorize normal commands. A timeout means the result could not be confirmed; check status/current preferences before blindly repeating a non-idempotent administrative action. This is not automatic notifier failover and does not bypass player or staff permissions.

Command permission gates Incompatible-build update recovery
Back to top ↑

Premium networking • Premium only

Premium notifier ownership & recovery

Exactly ONE backend hosts DiscBridge + DiscordSRV and dispatches network Discord messages. Its notifier identity comes from MailboxGUI’s local backend ID. A renewable instance-bound lease protects overlapping instances during restarts. There is NO automatic notifier failover and multiple fresh hosts are a misconfiguration, not a supported standby arrangement.

  • Missing/invalid inherited backend identity or unavailable runtime/storage pauses sending.
  • Multiple fresh DiscBridge hosts pause network dispatch and produce a console warning. Remove the extra companion installation; stale host registrations age out after 45 seconds, then readiness/lease checks must pass before sending resumes.
  • Network runtime not enabled/started/available, stale generation or lost lease: dispatch waits.
  • Unreadable/unwritable/full local staging, oversized admission or unavailable shared storage: work is rejected/paused, not silently acknowledged.
  • Registration scans are bounded; saturation is treated as unavailable rather than ignoring a possible second host. Use unique MailboxGUI backend IDs and synchronized clocks.

The staging journal polls every five seconds. Admitted jobs have a 24-hour age limit; shared records have bounded cleanup after 48 hours. Those limits apply to notification work, not permanent player preferences or MailboxGUI mail retention.

Ownership uses a 20-second lease renewed every five seconds; fresh host registrations and preference snapshots have a 45-second freshness window. A standby/lease-busy diagnostic means this instance is waiting for ownership, not that installing standby companion copies is supported. Allow readiness and ownership to recover after fixing a conflict.

Dispatch diagnostics and recovery checks
Back to top ↑

Premium networking • Premium only

Premium shared player preferences

In Premium NETWORK_NODE, notification enabled, online-DM preference, admin-ignore, sender-ignore and selected Discord DM language use MailboxGUI’s shared companion coordination storage. LOCAL and Free retain local data/players.yml behavior. DiscBridge does not create its own MySQL or Redis login settings.

  • Existing local preferences are backed up before import. Existing authoritative shared choices win over a competing legacy local value.
  • Writes are asynchronous and revision-checked. A conflict preserves newer shared choices and notifies the player instead of silently replacing them.
  • While preferences are loading/unavailable, editing/sending pauses. Wait for the saved/ready response; an immediate command response is not a guarantee a remote write has committed.
  • Unknown network-wide presence or unavailable shared preferences pauses affected DMs; local “offline” alone cannot bypass a remote online-DM policy.
  • Switching edition/mode is an upgrade operation. Preserve local data and remote shared state, rather than copying one backend’s players.yml onto every other backend.
Check shared readiness
/mb settings discord status
/mba discord networkstatus
Back to top ↑

Premium networking • Premium only

Premium backend/routing template details

Premium notification metadata distinguishes the delivery’s origin, the notifier sending Discord, and the backend(s) where mail may be claimed. Backend groups and Multiverse logical-backend mappings belong to MailboxGUI. DiscBridge describes their event/cache metadata; it neither sets world mappings nor relaxes claim restrictions.

Premium-only placeholderMeaning
{origin_backend_id}Premium only: backend where delivery originated.
{origin_backend_name}Premium only: origin display name, falling back to its ID.
{backend_id} / {backend_name}Premium only: backward-compatible aliases for origin, NOT notifier.
{notifier_backend_id}Premium only: actual backend sending Discord notifications.
{notifier_backend_name}Premium only: notifier display name, falling back to ID.
{target_backends}Premium only: known MailboxGUI claim-target backend metadata; missing data is not proof of unrestricted mail.
{backend_group}Premium only: MailboxGUI backend group metadata when supplied.
{restriction_reason}Premium only: exact MailboxGUI API restriction reason code, not translated.
{routing_status}Premium only: machine value known or unknown.
{routing_unknown}Premium only: nonempty true when routing is unknown; useful in an optional warning block.
{network_context}Premium only: nonempty true when origin/notifier context exists.
{expiration_remaining}Premium only: remaining seconds, minimum 0; blank with no expiration.
{mail_id}Premium only: MailboxGUI mail identifier when provided.
Premium optional context example
messages:
  dm-package-with-message-expire:
    - "Package from {sender} on {server}."
    - "Message: {message}"
    - "Expires: {expiration}"
    - "[[if:origin_backend_id]]Origin: {origin_backend_name} ({origin_backend_id})[[/if]]"
    - "[[if:notifier_backend_id]]Notifier: {notifier_backend_name} ({notifier_backend_id})[[/if]]"
    - "[[if:target_backends]]Claim targets: {target_backends}[[/if]]"
    - "[[if:backend_group]]Group: {backend_group}[[/if]]"
    - "[[if:restriction_reason]]Restriction: {restriction_reason}[[/if]]"
    - "[[if:routing_unknown]]Routing unknown; backend restrictions may apply.[[/if]]"
    - "Mail ID: {mail_id}"

An optional [[if:key]]…[[/if]] section appears only when that metadata is nonempty. Missing target/group/restriction sections disappear. Unknown routing is NOT “unrestricted”; put translated caution prose inside [[if:routing_unknown]]. Keep routing_status known/unknown and restriction_reason API codes unchanged.

Optional markers may span lines and nest, but must be balanced and use valid keys. The renderer limits nesting to 16 and total markers to 2,048. Never substitute a message into template syntax; supplied player text is treated literally.

Back to top ↑

Premium networking • Premium only

Premium status & support reports

Premium read-only diagnostics
/mba discord networkstatus
/mba discord networksupport

Status shows state/reason, this backend, automatically inherited notifier identity, shared-preference readiness and pending work on this host. The pending count is local staging plus local in-flight/outbox work, NOT the total of every shared job.

StateMeaning
activeActive
standbyStandby
startingStarting
degradedDegraded
unavailableUnavailable
Reason codeMeaning
runtime-unavailableNetwork runtime unavailable
notifier-unsetBackend identity unavailable
notifier-conflictMultiple DiscBridge hosts detected; network notifications paused
lease-busyNotifier lease held by another instance
storage-unavailableShared storage unavailable
prefs-unavailableShared preferences unavailable
readyReady
non-networkNot using network notifications
busyDiagnostics busy
staleOutdated diagnostic result
localLocal preferences
shared-readyShared preferences ready
startingPreferences starting
conflictPreference revision conflict
Preference codeMeaning
preferences-closedClosed
preferences-pausedPaused
preferences-localLocal
preferences-unavailableUnavailable
preferences-loadingLoading
preferences-readyReady

networksupport writes network/diagnostics/report-<random-id>.json under the DiscBridge data folder. Reports use an allowlist and omit credentials, tokens, mail bodies, player UUIDs and items. Still inspect backend names and metadata before posting publicly.

The export is bounded to 16 KiB, at most 20 existing matching reports, and only one active export. If the folder is full, archive existing reports yourself before retrying; do not delete staging/outbox data to fix an export limit. Invalid/symlinked/unwritable paths cause export failure.

Send a sanitized report to plugin support
Back to top ↑

Maintenance & support

Updates, credentials & marketplace linking

  1. Select updates.channel: release, beta or alpha and leave updates.enabled true. Free and Premium use independent release/update channels.
  2. For Premium, set credentials from server console: mba discord updatelogin set <username> <password>. Console commands usually omit the leading slash. Never type real passwords into public chat.
  3. Run /mba discord updatecheck to inspect availability and release details.
  4. Run /mba discord update to prepare the matching release, then /mba discord update confirm to stage a validated jar.
  5. Apply the staged update during your normal planned restart. DiscBridge validates product/edition/version and does not hot-reload or restart the server for you.
Free update sequence
/mba discord updatecheck
/mba discord update
/mba discord update confirm
Premium update sequence — after console credential setup
/mba discord updatelogin status
/mba discord updatecheck
/mba discord update
/mba discord update confirm

Confirmation stages the validated replacement under Bukkit’s configured plugin update folder (normally plugins/update), using the current plugin jar’s filename. It does not replace the running jar immediately. Credential changes and a full companion reload invalidate prepared update state: check any already-staged replacement and prepare again. Do not leave both edition jars installed.

Premium download authentication uses the website username/password over the trusted HTTPS release host and requires the correct DiscBridge Premium entitlement. Credentials are stored in plain text in updates.auth; protect config, console history and backups. Clearing them does not revoke a purchase, but protected updates will need credentials again.

Optional SpigotMC website purchase linking

Exact English command
/mba discord spigotlink <account-link-code>

Linking is optional for operating the plugin. When the website verification flow is ready, generate a short-lived product-specific code from an authenticated, email-verified website account, then run the command using the purchased DiscBridge Premium Spigot build. Submitted Spigot identifiers are not cryptographic proof; the website must verify an eligible purchase independently.

If an injected buyer/resource/download identifier is missing or unresolved, the plugin reports “This plugin was not purchased on SpigotMC.” and sends no request. Plugin-side attempts have a 30-second cooldown and one request in flight. Linking only grants the matching product entitlement after verification—never MailboxGUI Premium or a resource pack automatically.

Purchases & license linking Get Free/Premium release emails
Back to top ↑

Maintenance & support

Compatibility failures & update-only recovery

When MailboxGUI requires a newer companion or protocol, DiscBridge stops before normal data migration/service registration. MailboxGUI stays enabled and mail operation continues without Discord notifications. This compatibility check runs independently of website update-check settings. Do not edit plugin version/protocol markers to bypass it.

Authorized recovery-capable builds — update only
/mba discord help
/mba discord updatecheck
/mba discord update
/mba discord update confirm

A disabled recovery-capable companion exposes authorized help/updatecheck/update/confirm through the still-enabled MailboxGUI host. Premium recovery also allows protected update-credential controls from the SERVER CONSOLE only, with admin access and the focused admin.updatelogin permission. Free does not offer those controls. Normal player preferences, notifications, setup and reload remain unavailable. Premium remote recovery enforces authenticated host routing, console identity and the advertised recovery operation, and stages the update on the companion host.

Premium recovery — SERVER CONSOLE ONLY; credentials are placeholders
mba discord updatelogin status
mba discord updatelogin set <username> <password>
mba discord updatelogin clear

Credential edits back up the latest disk configuration, preserve unrelated settings/comments, refresh the recovery credential context and invalidate pending update preparation. Passwords are not returned in replies or completion, but console history and config backups are sensitive. Set valid credentials and prepare again before confirming a protected update.

After staging, restart the companion host during your planned maintenance window. Normal integration resumes only after the new jar passes compatibility validation. The command does not restart Minecraft automatically. Older jars without recovery support, missing prerequisites or unrecoverable configuration still need manual replacement/repair. The matching Premium license remains required; recovery does not restore arbitrary administration.

Normal update configuration and commands
Back to top ↑

Maintenance & support

Files, backups, retries & privacy

Generated data layout (some files appear only when used)
plugins/MailboxGUI-DiscBridge/
├── config.yml
├── language/messages_<locale>.yml
├── disclanguage/messages_<locale>.yml
├── data/players.yml
├── data/notification-outbox.yml
├── data/network-dispatch-staging.yml       # Premium network only
├── network/diagnostics/report-<id>.json    # Premium report exports
├── backups/config/
├── backups/upgrades/
├── .discbridge-installation
└── .discbridge-upgrade-pending             # only during an unfinished upgrade

Notification-outbox data is durable retained work in both editions. Ordinary individual/channel transport retries have a four-attempt bound, with 30/60/120-second retry delays before attempts two/three/four; mass-DM transport retries use queue.max-retries plus the initial attempt and the configured retry delay. The outbox polls every five seconds, so actual timing can be later. Temporary policy unavailability is handled separately, without sending. Work ages out after 24 hours and the local outbox is bounded to 10,000 pending entries.

Premium staging rejects oversized jobs above 512 KiB and a serialized staging file above 16 MiB. Do not increase safety limits by editing data files. Correct storage access/availability and investigate sustained overload.

The Premium staging journal is also bounded to 10,000 entries. Each five-second pump attempts at most eight staging writes and scans shared dispatch records in pages of 32; the local outbox retry drain attempts at most ten jobs per pass. These are separate limits, not an exact messages-per-second promise. Pending diagnostics count this host’s work, not a network-wide total. LOCAL mass-DM recipients still waiting in the in-memory queue are not yet durable outbox entries; a full companion reload/restart can discard that waiting portion.

duplicate-protection controls the LOCAL in-memory delivered-event cache (30 minutes by default), which resets on full reload/restart. Durable outbox identities and Premium shared stable identifiers are separate safeguards and are not disabled by that setting.

Pre-upgrade snapshots cover existing local plugin data, excluding the backups subtree and the running jar. A first empty installation has no prior data to snapshot. Back up plugin jars and remote databases separately; a local ZIP is not a complete server/network rollback.

The admin status notification counters are process-session diagnostics, not financial records or permanent proof every Discord send was read. bStats is included; server owners can disable metrics globally in plugins/bStats/config.yml.

Back to top ↑

Maintenance & support

Upgrade & configuration synchronization

  1. Back up the jars, local plugin folders and authoritative remote storage before changing version/edition. Keep one matched edition jar per plugin; in Premium network mode keep exactly ONE DiscBridge host with DiscordSRV.
  2. Install compatible MailboxGUI 6.1.0+ and DiscBridge 2.1.0+ builds with matching editions. Check the release’s companion minimum/protocol; compatible versions need not update in lockstep. Mismatch checks stop before synchronization.
  3. On a version/edition change, DiscBridge makes a local pre-upgrade ZIP under backups/upgrades. An unfinished marker preserves/reuses that rollback point.
  4. Let validated config/language synchronization merge missing defaults and refresh recognized stock text. Retired plugin-owned locale/network settings are backed up before removal; unknown custom values/keys/comments and saved player choices remain. Do not edit schema/version markers yourself.
  5. Review MailboxGUI config.yml locale.default, locale.auto-detect-player-locale and command syntax. Saved Discord languages still override the default for DMs; Minecraft client locale never replaces that choice.
  6. Review MailboxGUI Premium network/config.yml for the real network.enabled and unique server-id. DiscBridge inherits mode and local identity, including Free-to-Premium or historical upgrades, rather than keeping an independent toggle or notifier ID.
  7. Attached-message templates are backed up/split into independent variants, including same-version reloads. Explicit custom variants remain preserved.
  8. Use /mba reload for MailboxGUI edits. On Premium it also refreshes the enabled local DiscBridge network state only; a network-only change does not require /mba discord reload. Use /mba discord reload for companion configuration, language or template edits; verify hooks, player-command gate, preferences and real notifications. MailboxGUI root-language changes need a planned restart, not server /reload.

The old test-build root messages.yml is no longer the Discord template file. Synchronization migrates recognized legacy content into disclanguage/messages_en.yml with backups. Edit the active language folders, not the retired test-build location.

Released 1.0.0, 1.0.1, 1.1.0, 1.1.1 and 2.0.0 baselines distinguish old stock text from custom edits. Future or malformed schema versions stop synchronization rather than downgrade files; failed locale synchronization does not mark an upgrade complete. Unknown legacy message fields remain for review. Preference saves use backed-up atomic writes preserving unknown fields/comments; a failed save keeps pending edits and stops reload before replacing the manager. Free retires only an exact unused stock-empty legacy credential block, not owner-populated credentials.

Enable player-commands deliberately after DiscordSRV setup; missing keys default off without erasing preferences. Backed-up synchronization retires DiscBridge’s owned mode/language, locale defaults/detection/syntax, discord-messages default, network.enabled and network-node.notifier-backend-id keys, removing empty containers. Unknown owner keys and unrelated configuration, credentials, saved player languages and notification preferences remain. Integrated help and the guide use six-entry pages; guide is the first entry in player help in every supported locale.

Back to top ↑

Maintenance & support

Integration boundaries

Third-party deliveries should use MailboxGUI’s supported delivery API/events. DiscBridge observes MailboxMailDeliveredEvent and MailboxMassMailDeliveredEvent, including event ID, origin/type, attached message and expiration. Premium uses MailboxGUI’s public network API for cached backend context, presence, shared records and notifier coordination.

The companion now provides the local command/status integration used by MailboxGUI, so the earlier statement that its API module was only an empty reserved package no longer applies. Private DiscBridge command transport/coordination interfaces are not third-party extension documentation and are intentionally not listed here. This is not an API for arbitrary Discord broadcasts or bypassing notification policy.

MailboxGUI public Developer API guide
Back to top ↑

Maintenance & support

Troubleshooting & verification checklist

SymptomChecks / recovery
Plugin disables on startupConfirm matched editions, MailboxGUI 6.1.0+ and its required companion version/protocol, DiscordSRV startup/API compatibility and valid YAML. Preserve files; read the first error. Use authorized update-only recovery where supported.
Discord player commands missingThey default off. Check /mba discord status, connected DiscordSRV and a ready link manager, then /mba discord playercommands on. Give the MailboxGUI player gateway permissions.
Remote commands unavailable or time outPremium only: verify the companion host, MailboxGUI network readiness and current compatible host status. Changes and update staging occur on that host, not the invoking backend. Retry after transport recovery; do not install mismatched editions to bypass it.
Player cannot enable notificationsLink Minecraft through DiscordSRV, allow lookup refresh and retry enable. Website support-role linking alone is insufficient.
Test DM works but real mail does notTest DM bypasses normal policy. Check opt-in, direct-messages, online default/override, ignores, actual delivery and Premium shared readiness.
No online DMsUse online on or deliberately change the global default; Premium must have known network presence.
Language does not changeDistinguish in-game locale, command syntax and Discord DM preference. Channel notices always use the configured default.
Player status appears ready but Discord is unlinkedPlayer status reports saved preferences/language, not account-link verification. Check /discordsrv linked on the companion host; website Discord support linking is separate.
Blank template still produces a notificationAn empty list can fall back to English or a simpler variant; disable the relevant notification switch instead.
Long notification never sendsKeep the final rendered Discord payload within 1–2,000 characters. Oversized messages are rejected, not split or truncated.
Translated command root missingMailboxGUI registers English + its startup-default command language roots. Change MailboxGUI config.yml, not the legacy DiscBridge syntax fields; plan a restart after changing the root default and check conflicts.
Book letter or COD price absentConfirm real supported delivery type and clean nonempty template; COD uses codPriceText first. Look at actual event-compatible builds.
Attached message absentEdit the with-message variant, not the normal variant; Letters/Book Letters do not have attached-message variants.
Mass-mail channel missingSet a TEXT channel ID, enable channel notices, verify bot permissions and run testchannel. A forum channel is not the current transport target.
Mass DMs missingThey are disabled by default. Check actual eligibility, recipient cap/over-limit policy, channel workflow and queue switches.
Waiting LOCAL mass DMs disappear after reloadOnly admitted outbox jobs are durable. The waiting LOCAL mass queue is in memory and is cleared by a full companion reload/shutdown; a network-only /mba reload preserves it.
Premium NETWORK_NODE not sendingCheck MailboxGUI network readiness and the host’s unique server-id, exactly ONE DiscBridge installation with DiscordSRV, lease ownership, shared preferences/presence and storage. There is no companion notifier-ID setting.
Network refresh fails or preferences pauseFix the reported MailboxGUI network/config/storage issue and retry /mba reload on the host. A failed network refresh pauses companion preference access and notifications; it does not fall back to permissive LOCAL sending. Use /mba discord reload separately for companion file changes.
Notifier conflict / lease busyCheck for an extra fresh DiscBridge host or overlapping instance. Remove the extra installation safely; stale registrations expire after 45 seconds, then readiness/ownership must recover. Standby replicas and automatic failover are not supported.
Routing targets absentUnknown metadata is not unrestricted. Check MailboxGUI backend/groups/Multiverse mapping and use the routing_unknown warning block.
Preferences Loading/ConflictWait for authoritative shared state; confirm storage/network, then retry the user change. Do not overwrite a newer shared record with copied local YAML.
Duplicate Discord messageInvestigate uncertain transport completion, retries and conflicting instances; cache/lease/durable IDs reduce duplicates but do not promise exactly-once.
Retry/staging pausedFix unreadable/unwritable/full local files or unavailable shared runtime. Preserve queued data; account for 24-hour bounds and policy changes.
Update denied/no prepared updateUse the matching edition/channel and valid product entitlement; Premium credentials are console-set. Prepare with update before update confirm.
Spigot linking not readyFollow the website’s verified purchase process; never treat raw identifiers as proof. Missing injections are rejected locally.
Support report export failsCheck network mode/permission, one-export limit, writable safe path and the 20-report bound. Archive reports; do not delete dispatch data.

Test after installation or an upgrade

  1. Confirm version/edition/hook status and inherited mode.
  2. Link a test Minecraft account through DiscordSRV, opt in, and test offline/online preferences.
  3. Send real classic/Book Letters, attached/expiring packages, COD payment/return and money mail where enabled.
  4. Verify saved Discord language, MailboxGUI default fallback and channel language separately; client-language changes must not select a different DM language.
  5. Test mass mail under/over the cap, then disable notifications and verify pending retries respect current policy.
  6. For Premium, test remote mail/commands, restrictions and shared preference writes through exactly ONE DiscBridge + DiscordSRV host. Check duplicate-host diagnostics only in a test environment; do not stop production services without a plan.
  7. Verify retained settings/templates and retired-key backups after reload/upgrade. Apply root-language changes only at a planned restart and keep sensitive files private.

The source’s automated tests are not a claim of live multi-backend MySQL/Redis/Discord validation. Perform real-server checks before relying on network delivery in production. For help, provide version/edition, sanitized error/status details and a Premium sanitized report when relevant.

Get setup help, configuration support or report a bug
Back to top ↑