# Paper/book sending uses separate type settings; each player command requires its type and command flags. Admin gates are independent; existing letters remain manageable.
# gui.yml changes display appearance and notification item metadata, not physical placement, unchecked-mail lifecycle or mandatory inbox protection.
# In-game text supports legacy & colors, HEX (RRGGBB or <#RRGGBB>) and restricted visual MiniMessage formatting. Interactive click/hover/command tags are not supported.
# ============================================================
# MailboxGUI | 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.
# Paper letters and package/money messages allow 256 visible characters, 28 per line and 17 total body lines. Wrapping, /n, actual line breaks and blank lines share this limit. //n displays literal /n; color codes do not count.
# ------------------------------------------------------------
# Command syntax
# ------------------------------------------------------------
# Command syntax has independent language settings; it does not follow message-language settings automatically.
# locale.command-syntax.default: At startup, registers ONLY this language's command roots plus English roots, which are always available.
# Changing the registered roots requires a server restart; reload does not register new roots.
# locale.command-syntax.auto-detect-player-locale: true uses the supported Minecraft client language ONLY for subcommands, help arguments, flags and tab completion, never for roots.
# With false, syntax follows the root used: /mb uses English, /bz uses Spanish, etc. (if that root was registered at startup).
# Console and unsupported client locales fall back to the invoking root's language: /mba remains English even with command-syntax.default: es.
# Message, GUI and date locales remain independent of command syntax.
file-version: 16
messages:
help-command-send: " send"
help-desc-send: "Send mail using an enabled mail type."
discord-installed-incompatible: "✖ Installed DiscBridge %installed% (integration protocol %protocol%) is incompatible. MailboxGUI requires DiscBridge %minimum% or newer with protocol %minimum_protocol%-%maximum_protocol%. DiscBridge has been disabled; update the companion to restore Discord integration. MailboxGUI remains enabled."
network-discord-incompatible-host: "⚠ [Network] DiscBridge on %server% is incompatible: installed version %installed_version%, integration protocol %installed_protocol%; required version %required_version% or newer, protocol %minimum_protocol%-%maximum_protocol%. Discord routing and command completion are disabled for this host."
admin-update-discbridge-requirement: "MailboxGUI %version% requires DiscBridge %minimum% or newer for Discord integration (protocol %protocol%)."
admin-update-discbridge-satisfied: "✔ Installed DiscBridge %installed% satisfies this update's Discord integration requirements."
admin-update-discbridge-update-required: "✖ Installed DiscBridge %installed% does not satisfy this update's Discord integration requirements. Update DiscBridge before using Discord integration with this MailboxGUI release."
admin-update-discbridge-optional: "DiscBridge is not installed. This requirement is optional and applies only if you use Discord integration; you do not need to install DiscBridge."
admin-update-discbridge-unverified: "Installed DiscBridge %installed% compatibility could not be verified. Verify its version and integration protocol before updating."
admin-update-discbridge-metadata-unavailable: "Discord integration requirements for MailboxGUI %version% are not published. Verify DiscBridge compatibility before updating."
admin-update-discbridge-staged-preview: "Staged MailboxGUI %version%: Discord integration compatibility preview."
admin-update-discbridge-not-published: "not published"
admin-update-discbridge-version-unknown: "unknown version"
discord-integration-unavailable: "DiscBridge integration is unavailable."
discord-integration-failed: "✖ Discord command failed. Please try again."
discord-player-commands-disabled: "Discord player commands are disabled by the server administrator."
help-desc-discord: "Shows Discord mail notification settings."
help-desc-admin-discord: "Manages DiscBridge integration and Discord notifications."
settings-discord-usage: "Use /mb settings discord help."
restricted-package-detail-header: "Package restriction details"
restricted-package-detail-target: "Target: %target%"
restricted-package-detail-versions: "Origin Minecraft (data version) / MailboxGUI: %source%; local Minecraft (data version): %local%"
restricted-package-detail-supported: "Readable and supported on this backend"
restricted-package-detail-tree-codec: "This item tree is blocked by an unavailable nested material or an incompatible item codec; individual codec failures are not identified."
restricted-package-detail-empty-group: "no configured members"
restricted-package-detail-requirement-unknown: "Required version unknown (material, payload or codec)."
restricted-package-detail-requirement-known: "Stable Minecraft Java Edition release introduction: %version% (experimental availability may be earlier); required payload/codec version unknown."
restricted-package-detail-item: "#%index% %material% x%amount%: %reason% %requirement%"
restricted-package-detail-no-manifest: "No readable manifest item list is available."
restricted-package-detail-unavailable: "This older or invalid placeholder has no diagnostic snapshot. Reopen the inbox to refresh it."
# ------------------------------------------------------------
# General
# ------------------------------------------------------------
attached-sign-required: "That mailbox body must have the correct matching regular wall sign."
citizens-unavailable: "Citizens is not installed or not enabled."
error: "✖ Something went wrong. Please check the console for details."
guide-basics-line-1: "Mailboxes and Public Access Mailbox access points open your MailboxGUI inbox."
guide-basics-line-2: "Mail stays in MailboxGUI storage, not inside the vanilla block inventory."
guide-basics-line-3: "Use physical mailboxes, Public Access Mailboxes, or Public Access NPCs when available."
guide-design-classic-barrel-description: "Uses a barrel as the mailbox body."
guide-design-classic-bookshelf-description: "Uses a chiseled bookshelf when this server version supports it."
guide-design-classic-chest-description: "Uses a chest or trapped chest as the mailbox body."
guide-design-classic-copper-description: "Uses supported copper chest stages when this server version supports them."
guide-design-classic-crafter-description: "Uses a crafter when this server version supports it."
guide-design-classic-shulker-description: "Uses a shulker box color supported by this server version."
guide-design-classic-structure: "Place the body, attach a regular wall sign to the front, and use a fence below for personal mailboxes."
guide-design-classic-utility-description: "Uses supported utility blocks such as droppers, dispensers, or ender chests."
guide-design-materials: "Supported bodies: %materials%"
guide-design-personal-fence-not-required: "No fence post is used for this design."
guide-design-personal-fence-required: "Personal mailbox: Fence below required. Public Access Mailbox: Fence not required."
guide-design-shelf-description: "Uses a shelf with a regular wall sign directly below it."
guide-design-shelf-structure: "Mount the shelf on a wall and place the wall sign directly below, aligned to the same wall."
guide-footer: "After registration, open your mailbox to send and receive mail."
guide-line-top: "------------------------------------------------"
guide-navigation-next: "Next ▶"
guide-navigation-previous: "◀ Prev"
guide-navigation-separator: " | "
guide-no-public-access: "This server does not currently have public Public Access Mailbox access points available."
guide-page: "Page %page%/%pages%"
guide-personal-step-1: "1. Place a fence post."
guide-personal-step-2: "2. Choose your mailbox style."
guide-personal-step-3: "3. View the next guide pages to see styles you can build."
guide-personal-step-4: "4. Run /mailbox register."
guide-personal-step-5: "5. Click the mailbox sign or body when prompted."
guide-public-access-intro: "You can access your mail at public Public Access Mailbox access points on this server."
guide-public-npc-line-1: "Right-click a Public Access NPC to open your mailbox menu."
guide-public-pobox-line-1: "Public Access Mailboxes are shared mail access points that any player can open."
guide-public-pobox-line-2: "They are not registered to one specific player."
guide-public-pobox-line-3: "Opening one shows your own personal mailbox menu."
invalid-mailbox-block: "Right-click a supported mailbox body with its matching sign, or right-click the matching sign."
itemtemplate-delete-failed: "✖ Failed to delete item template: %id%"
itemtemplate-delete-success: "✔ Deleted item template: %id%"
itemtemplate-give-received: "✔ You received item template: %id%"
itemtemplate-give-success: "✔ Gave item template %id% to %target%."
itemtemplate-give-target-online: "Target player must be online."
itemtemplate-invalid-id: "Invalid item template ID."
itemtemplate-list-empty: "No item templates have been saved yet."
itemtemplate-list-entry: "- %id% -> %item%"
itemtemplate-list-entry-missing: "- %id% -> missing item"
itemtemplate-list-header: "MailboxGUI Item Templates (Page %page%/%total%)"
itemtemplate-list-page-hint: "Page %page%/%total% - %command% {page}"
itemtemplate-no-permission-delete: "You do not have permission to delete item templates."
itemtemplate-no-permission-give: "You do not have permission to give item templates."
itemtemplate-no-permission-list: "You do not have permission to list item templates."
itemtemplate-no-permission-save: "You do not have permission to save item templates."
itemtemplate-save-failed: "✖ Failed to save item template: %id%"
itemtemplate-save-hold-item: "Hold the item you want to save as a template in your main hand."
itemtemplate-save-player-only: "Only players can save item templates because an item must be held in hand."
itemtemplate-save-success: "✔ Saved item template: %id%"
itemtemplate-save-use-as: "Use it in packages as: template:%id%:1"
itemtemplate-unknown: "Unknown item template: %id%"
mail-message-invalid: "Use up to 256 visible characters and 17 body lines total. Automatic wrapping and /n share this limit."
mail-sending-options-unavailable: "No mail sending options are currently available."
material-acacia-fence: "Acacia Fence"
material-acacia-shelf: "Acacia Shelf"
material-acacia-sign: "Acacia Sign"
material-bamboo-fence: "Bamboo Fence"
material-bamboo-shelf: "Bamboo Shelf"
material-bamboo-sign: "Bamboo Sign"
material-barrel: "Barrel"
material-birch-shelf: "Birch Shelf"
material-black-shulker-box: "Black Shulker Box"
material-blue-shulker-box: "Blue Shulker Box"
material-brown-shulker-box: "Brown Shulker Box"
material-cherry-fence: "Cherry Fence"
material-cherry-shelf: "Cherry Shelf"
material-cherry-sign: "Cherry Sign"
material-chest: "Chest"
material-chiseled-bookshelf: "Chiseled Bookshelf"
material-copper-chest: "Copper Chest"
material-crafter: "Crafter"
material-crimson-shelf: "Crimson Shelf"
material-cyan-shulker-box: "Cyan Shulker Box"
material-dark-oak-fence: "Dark Oak Fence"
material-dark-oak-shelf: "Dark Oak Shelf"
material-dark-oak-sign: "Dark Oak Sign"
material-dispenser: "Dispenser"
material-dropper: "Dropper"
material-ender-chest: "Ender Chest"
material-exposed-copper-chest: "Exposed Copper Chest"
material-gray-shulker-box: "Gray Shulker Box"
material-green-shulker-box: "Green Shulker Box"
material-jungle-shelf: "Jungle Shelf"
material-light-blue-shulker-box: "Light Blue Shulker Box"
material-light-gray-shulker-box: "Light Gray Shulker Box"
material-lime-shulker-box: "Lime Shulker Box"
material-magenta-shulker-box: "Magenta Shulker Box"
material-mangrove-shelf: "Mangrove Shelf"
material-mangrove-sign: "Mangrove Sign"
material-oak-fence: "Oak Fence"
material-oak-shelf: "Oak Shelf"
material-oak-sign: "Oak Sign"
material-orange-shulker-box: "Orange Shulker Box"
material-oxidized-copper-chest: "Oxidized Copper Chest"
material-pale-oak-fence: "Pale Oak Fence"
material-pale-oak-shelf: "Pale Oak Shelf"
material-pale-oak-sign: "Pale Oak Sign"
material-pink-shulker-box: "Pink Shulker Box"
material-purple-shulker-box: "Purple Shulker Box"
material-red-shulker-box: "Red Shulker Box"
material-shulker-box: "Shulker Box"
material-spruce-fence: "Spruce Fence"
material-spruce-shelf: "Spruce Shelf"
material-spruce-sign: "Spruce Sign"
material-trapped-chest: "Trapped Chest"
material-warped-fence: "Warped Fence"
material-warped-shelf: "Warped Shelf"
material-warped-sign: "Warped Sign"
material-waxed-copper-chest: "Waxed Copper Chest"
material-waxed-exposed-copper-chest: "Waxed Exposed Copper Chest"
material-waxed-oxidized-copper-chest: "Waxed Oxidized Copper Chest"
material-waxed-weathered-copper-chest: "Waxed Weathered Copper Chest"
material-weathered-copper-chest: "Weathered Copper Chest"
material-white-shulker-box: "White Shulker Box"
material-yellow-shulker-box: "Yellow Shulker Box"
no-mailbox: "You do not have a registered mailbox."
no-permission: "You do not have permission."
not-your-mailbox: "This mailbox does not belong to you."
paper-letter-sending-unavailable: "Paper Letter sending is currently unavailable."
prefix: "[MailboxGUI] "
registration-cancelled: "Mailbox registration cancelled."
registration-prompt: "Right-click the mailbox chest/barrel or its front sign to register it. Left-click anywhere to cancel. Mailboxes: %current%/%max%."
restricted-package-codec-unsupported: "A custom item codec reported that %material% is unsupported on this backend."
restricted-package-default-reason: "Package compatibility could not be verified."
restricted-package-message: "This package cannot be claimed on this backend. %reason%"
restricted-package-placeholder-click: "Click to view restriction details."
restricted-package-placeholder-contents: "Contents: %count%"
restricted-package-placeholder-created-with: "Created With: %version%"
restricted-package-placeholder-lore-1: "This package exists, but it cannot"
restricted-package-placeholder-lore-2: "be claimed on this backend."
restricted-package-placeholder-name: "Restricted Package"
restricted-package-placeholder-origin: "Origin Backend: %backend%"
restricted-package-placeholder-reason: "Reason: %reason%"
restricted-package-placeholder-separator: "--------------------"
restricted-package-reason-cod-unreadable: "COD payment data cannot be read safely."
restricted-package-reason-legacy-unverified: "Legacy package compatibility could not be verified."
restricted-package-reason-missing-manifest: "Package is missing a compatibility manifest."
restricted-package-reason-newer-data-version: "Package was created on a newer Minecraft data version."
restricted-package-reason-not-package: "Item is not a MailboxGUI package."
restricted-package-reason-other-backend: "Package is not claimable on this backend."
restricted-package-reason-unsupported-material: "Package contains unsupported material: %material%"
settings-kit-alert-invalid: "Invalid mailbox kit reminder setting. Use on or off."
settings-kit-alert-status: "Mailbox Kit Reminder: %status% (Uses left: %remaining%)"
settings-kit-alert-updated: "✔ Mailbox kit reminders set to %status%."
settings-line-top: "------------------------------------------------"
settings-mode-advanced: "Advanced"
settings-mode-off: "Off"
settings-mode-simple: "Simple"
settings-offline-invalid: "Invalid offline notification mode. Use simple, advanced, or off."
settings-offline-status: "Offline Notifications: %mode%"
settings-offline-updated: "✔ Offline mail notifications set to %mode%."
settings-online-invalid: "Invalid online notification setting. Use on or off."
settings-online-status: "Online Notifications: %status%"
settings-online-updated: "✔ Online mail notifications set to %status%."
settings-sound-alert-invalid: "Invalid sound alert setting. Use on or off."
settings-sound-alert-status: "Online Sound Alert: %status%"
settings-sound-alert-updated: "✔ Online mail sound alert set to %status%."
settings-status-off: "Off"
settings-status-on: "On"
target-inbox-full: "That player's inbox is full."
target-no-mailbox: "That player does not have a registered mailbox."
track-entry: "%type% arrives on %date%"
track-line-top: "------------------------------------------------"
track-none: "You do not have any delayed mail waiting to arrive."
typed-recipient-admin-multi-prompt: "Type one or more player names separated by commas, or type cancel to return. Example: {name1}, {name2}, {name3}. All players must exist in MailboxGUI data or server playerdata."
typed-recipient-admin-not-found: "These players have never logged into this server before: %targets%. No mail was sent."
typed-recipient-cancelled: "Player name selection cancelled."
typed-recipient-invalid: "Please type a valid player name, or type cancel to return."
typed-recipient-not-found: "Player %target% has never logged into this server before."
typed-recipient-player-prompt: "Type the player name in chat, or type cancel to return. This searches MailboxGUI data and imports server-known players."
typed-recipient-prompt: "Type the player name in chat, or type cancel to return. This searches MailboxGUI data and imports server-known players."
typed-recipient-suggestions: "Did you mean: %suggestions%?"
typed-recipient-suggestions-separator: ", "
unregister-cancelled: "Mailbox unregister cancelled."
unregister-prompt: "Right-click your mailbox chest/barrel or sign to unregister it. Left-click anything to cancel."
world-list-none: "None configured"
# ------------------------------------------------------------
# Command syntax
# ------------------------------------------------------------
itemtemplate-usage-delete: "Usage: /mba itemtemplate delete {id}"
itemtemplate-usage-full: "Full command form also works: /mba itemtemplate {save|delete|list|give}"
itemtemplate-usage-give: "Usage: /mba itemtemplate give {id} [player]"
itemtemplate-usage-header: "Item template commands:"
itemtemplate-usage-itdelete: "/mba itdelete {id}"
itemtemplate-usage-itgive: "/mba itgive {id} [player]"
itemtemplate-usage-itlist: "/mba itlist [page]"
itemtemplate-usage-itsave: "/mba itsave {id}"
itemtemplate-usage-save: "Usage: /mba itemtemplate save {id}"
# ------------------------------------------------------------
# Help menus
# ------------------------------------------------------------
help-command-admin: " admin"
help-command-admin-admininbox: " admininbox"
help-command-admin-base: "/mailbox admin"
help-command-admin-base-alias: " or /mba"
help-command-admin-clean: " clean"
help-command-admin-convert: " convert {YAML|SQLITE|MYSQL}"
help-command-admin-convert-current: " convert current"
help-command-admin-import-playerdata: " import player {name1}[,{name2}]"
help-command-admin-inboxnotification: " inboxnotification [on|off]"
help-command-admin-itemtemplate-delete: " itdelete {id}"
help-command-admin-itemtemplate-give: " itgive {id} [player]"
help-command-admin-itemtemplate-list: " itlist [page]"
help-command-admin-itemtemplate-save: " itsave {id}"
help-command-admin-networkindex: " networkindex"
help-command-admin-purge: " purge {player|all} CONFIRM"
help-command-admin-redis: " redis status"
help-command-admin-register: " register {playername}"
help-command-admin-reload: " reload"
help-command-admin-scheduledmail: " scheduledmail {reload|list|info|run|enable|disable}"
help-command-admin-send-book-letter: " sla {recipients} '{message}' --title {title} --from {sender} --delay {seconds}"
help-command-admin-send-cod: " scod {recipients} p:{price} r:{player}/admin [item:amount,t:id:amount,xp:amount] --from {sender} --delay {seconds} --expire {time}"
help-command-admin-send-cod-admin: "Use r:admin to return successful payments and declined/expired Packages to the Shared Admin Inbox."
help-command-admin-send-letter: " sl {recipients} '{message}' --from {sender} --delay {seconds}"
help-command-admin-send-money: " sm {recipients} {amount} --from {sender} --delay {seconds}"
help-command-admin-send-package: " sp {recipients} [item:amount,t:id:amount,xp:amount] --from {sender} --delay {seconds}"
help-command-admin-spigotlink: " spigotlink {code}"
help-command-admin-testaimoney: " testaimoney {amount}"
help-command-admin-testaipackage: " testaipackage {codr|codi} {amount}"
help-command-admin-testletter: " testletter {paper|book} {player} {amount}"
help-command-admin-testmoney: " testmoney {standard|cod} {player}"
help-command-admin-testpackage: " testpackage {type} {amount} {player}"
help-command-admin-tools: " tools"
help-command-admin-unregister: " unregister"
help-command-admin-update: " update"
help-command-admin-updatecheck: " updatecheck"
help-command-admin-updatelogin: " updatelogin {status|set|clear}"
help-command-base: "/mailbox"
help-command-base-alias: " or /mb"
help-command-check: " check"
help-command-guide: " guide"
help-command-kit: " kit"
help-command-letter: " letter"
help-command-money: " money"
help-command-open: " open"
help-command-package: " package"
help-command-register: " register"
help-command-settings: " settings"
help-command-track: " track"
help-command-unregister: " unregister"
help-desc-admin-admininbox: "Open the Shared Admin Inbox."
help-desc-admin-base: "Base admin command and opens admin help menu."
help-desc-admin-clean: "Cleans MailboxGUI backup files from old upgrades, syncs, and conversions. Confirm mail data is working before use."
help-desc-admin-convert: "Converts MailboxGUI storage to the selected mode. The target cannot be the current storage mode."
help-desc-admin-convert-current: "Shows the current active MailboxGUI storage mode."
help-desc-admin-import-playerdata: "Creates MailboxGUI data for named players who have logged in before."
help-desc-admin-inboxnotification: "Toggle online Shared Admin Inbox alerts. Leave off on busy servers unless you want frequent admin notices."
help-desc-admin-itemtemplate-delete: "Deletes a saved package item template."
help-desc-admin-itemtemplate-give: "Gives a saved package item template."
help-desc-admin-itemtemplate-list: "Lists saved package item templates."
help-desc-admin-itemtemplate-save: "Saves the held item as a package template."
help-desc-admin-networkindex: "Indexes this backend's known players for network-wide recipient lookup."
help-desc-admin-purge: "Clears inbox contents without deleting player records, mailboxes, settings, or plugin data."
help-desc-admin-redis: "Checks Redis, channels, and known backend health."
help-desc-admin-register: "Registers a mailbox to a specific player."
help-desc-admin-reload: "Reloads configs and language files."
help-desc-admin-scheduledmail: "Manage Scheduled Mail tasks from scheduled-mail/scheduled-mail.yml."
help-desc-admin-send-book-letter: "Sends an admin book letter by command or console."
help-desc-admin-send-cod: "Sends a COD package using Vault currency, item currency, XP, or t:{id} templates."
help-desc-admin-send-letter: "Sends an admin classic paper letter by command or console."
help-desc-admin-send-money: "Sends admin-origin money mail by command or console."
help-desc-admin-send-package: "Sends materials, XP, or t:{id} item templates as a package."
help-desc-admin-spigotlink: "Prepared placeholder for linking future SpigotMC Premium buyers."
help-desc-admin-testaimoney: "Creates Shared Admin Inbox COD money payment test mail items. Amount controls how many are created."
help-desc-admin-testaipackage: "Creates Shared Admin Inbox package test mail for returned COD and item-currency payment flows."
help-desc-admin-testletter: "Creates multiple paper or book test Letter mail items with complete inbox lore."
help-desc-admin-testmoney: "Creates player inbox money or COD payment test mail."
help-desc-admin-testpackage: "Creates player inbox package test mail for standard, COD, payment, returned, and accepted package flows."
help-desc-admin-tools: "Opens the admin tools menu."
help-desc-admin-unregister: "Unregister a player's registered mailbox."
help-desc-admin-update: "Stages the latest website release update after confirmation."
help-desc-admin-updatecheck: "Checks the website release system for the latest MailboxGUI version."
help-desc-admin-updatelogin: "Set or check Premium website login credentials for protected Premium updates."
help-desc-base: "Base command and opens help menu."
help-desc-check: "Shows a summary of your unchecked mail."
help-desc-guide: "Shows how to access mail and choose a mailbox style to build."
help-desc-kit: "Gives starter blocks for building a mailbox."
help-desc-letter: "Compose and send a Letter without opening a mailbox."
help-desc-money: "Send Money Mail by command after choosing a recipient and entering the amount in chat."
help-desc-open: "Opens your mailbox menu by command when enabled."
help-desc-package: "Compose a Package by command, choose a recipient, add items or XP, and send without using a mailbox access point."
help-desc-register: "Register a mailbox."
help-desc-settings: "Shows and changes your mailbox settings: notifications, resource pack, and Discord when available."
help-desc-settings-notification: "Manage mail notifications, sounds, and mailbox kit reminders."
help-desc-settings-resourcepack: "Choose resource-pack icons or built-in icons."
help-desc-settings-discord: "Manage Discord mail notifications when available."
help-desc-settings-notification-status: "Shows your current notification settings."
help-desc-settings-notification-offline: "Choose simple, advanced, or no mail notifications when you join."
help-desc-settings-notification-online: "Turn new-mail notifications while online on or off."
help-desc-settings-notification-soundalert: "Turn mail notification sounds on or off."
help-desc-settings-notification-kit: "