About MailBox
**The Ultimate Communication Solution Rust Servers**
Transform your server's communication with the most advanced mailbox system available !
MailBox brings immersive, feature-rich messaging that keeps players engaged and creates new economy opportunities.
- Fully customizable interface with your own background images
- Modern, responsive design that adapts to all screen sizes
- Custom icons and visual elements for a polished experience
- Seamless integration with Rust's native UI system
MESSAGE SYSTEM
- Send messages with item attachments (up to 7 slots)
- Integrated money transfer system
- Message pagination and smart organization
- Read/unread status tracking
- Message expiration and auto-cleanup
REGISTERED MAIL
- Secure item delivery with confirmation fees
- Accept/reject registered mail functionality
- Automatic return on rejection with original items
- Security deposit system for valuable deliveries
- Fee distribution to server treasury
SMART DELIVERY
- Configurable delivery delays by permission group
- VIP delivery tiers (Instant, 5min, 15min, 30min)
- Queue management with admin controls
- Delivery notifications and status tracking
COMMING SOON !
COMMING SOON !
Automatic language detection with localized item names
English (Default)
French (Français)
Chinese Simplified (中文)
Russian (Русский)
Spanish (Español)
Italian (Italiano)
{ "UI.InboxTitle": "INBOX", "UI.ComposeTitle": "Send a message", "UI.InboxButton": "INBOX", "UI.SendButton": "Send a message", "UI.OpenAllButton": "OPEN ALL", "UI.PrevButton": "PREVIOUS", "UI.NextButton": "NEXT", "UI.Page": "Page {0}/{1}", "UI.MessageBoxEmpty": "MAILBOX EMPTY", "UI.DeleteAll": "DELETE ALL", "UI.DeleteMessage": "Delete this message", "UI.Send": "Send", "UI.Cancel": "Cancel", "UI.Delete": "Delete", "UI.Back": "Back", "UI.Reply": "Reply", "UI.To": "To:", "UI.Subject": "Subject:", "UI.From": "From: {0}", "UI.Date": "Date: {0}", "UI.Fee": "Fee: ", "UI.FreeSending": "Free", "UI.Economics": "Cost: {0}", "UI.ServerRewards": "Cost: {0} points", "UI.ItemCost": "Cost: {0}", "UI.MoneyAmount": "Amount:", "UI.SendMoney": "Send money", "UI.Recommended": "Registered", "UI.Balance": "Balance: {0} {1}", "UI.AllPlayers": "All Players", "UI.AdminMode": "Admin Mode: Unlimited Money", "UI.MassMailInfo": "This message is intended for all players with mailbox.use permission", "UI.RecoveryFee": "Recovery fee: {0} {1}", "UI.PaymentQuestion": "Do you want to pay these fees to recover the content?", "UI.MainInventory": "MAIN INVENTORY", "UI.Belt": "BELT", "UI.SelectItem": "SELECT AN ITEM", "UI.QuantitySelector": "Select quantity", "UI.QuantityToSend": "Quantity to send:", "UI.AvailableQuantity": "Available: {0}", "UI.Half": "Half ({0})", "UI.Max": "Max ({0})", "UI.Confirm": "Confirm", "UI.ClickToSelect": "Click on an item to select it", "UI.ItemsAttached": "Items attached:", "UI.ClonedItems": "cloned items", "UI.RestrictedItem": "RESTRICTED", "UI.CollectItems": "Items to collect:", "UI.CollectMoney": "Money to collect:", "UI.NoMessages": "No pending messages", "UI.IncomingMessages": "{0} message{1} pending reception", "UI.RejectButton": "Reject", "UI.ValidateButton": "Validate", "UI.ReportMessage": "REPORT USER", "UI.ReportTitle": "REPORT A MESSAGE", "UI.ReportPrompt": "Please select the reason for the report:", "UI.ReportWarning": "⚠ False reports may result in sanctions.", "UI.Report": "REPORT", "UI.SelectReason": "Please select a reason", "Report.Reason1": "Offensive Language & Insults", "Report.Reason2": "Threats & Intimidation Behavior", "Report.Reason3": "Harassment & Spam Activities", "Report.Reason4": "Inappropriate Content Sharing", "Report.Reason5": "Scamming & Fraudulent Schemes", "Report.Reason6": "Other Rule Violations", "Report.ReasonGeneral": "Rule Violation", "Report.None": "No message reports have been recorded.", "Report.Cleared": "The report file has been cleared.", "Report.Empty": "The report file is empty.", "Report.Total": "There are {0} report(s) in total.", "Report.Displaying": "Displaying the last {0} reports:", "Report.Preview": "--- Report {0} ---\n{1}\n{2}\nUse '/mailreports view {0}' to see the full report.", "Report.Commands": "Available commands: /mailreports [number], /mailreports view [id], /mailreports clear", "Report.InvalidID": "Invalid report ID. Choose a number between 1 and {0}.", "Report.Complete": "=== COMPLETE REPORT #{0} ===\n{1}\n--- END OF REPORT ---", "Report.AdminNotification": "<color=#FF0000>[MailBox Report]</color> {0} has reported a message from {1}. Reason: {2}. Check the report file.", "Report.AlreadyReported": "You have already reported this message.", "Report.TotalReports": "This message has been reported {0} time(s) in total.", "Report.ReportListHeader": "Reports: {0}", "Report.NoReports": "No reports recorded.", "Report.StatsTitle": "=== REPORT STATISTICS ===", "Report.MessagesReported": "Messages reported: {0}", "Report.TotalReportsCount": "Total reports: {0}", "Report.TopReported": "Top reported messages:", "Report.MessageFrom": "{0}. Message from {1}: {2} report(s)", "Report.ClearStats": "Report statistics cleared: {0} entries deleted.", "Message.NoRecipient": "Please enter a recipient.", "Message.NoSubject": "No subject", "Message.NoMessage": "Please enter a message.", "Message.PlayerNotFound": "Player '{0}' not found.", "Message.InsufficientFunds": "You don't have enough money to send this message.", "Message.InsufficientPoints": "You don't have enough reward points to send this message.", "Message.InsufficientItems": "You don't have enough {0} to send this message.", "Message.Sent": "Message sent to {0}.", "Message.Deleted": "Message deleted.", "Message.MarkedAsRead": "All messages have been marked as read.", "Message.NoPermission": "You don't have permission to use this command.", "Message.NoUnread": "You have no new messages.", "Message.Unread": "You have {0} unread message{1}. Use /mail to read them.", "Message.NewMail": "You have received a new message! Use /mail to check it.", "Message.UnreadReminder": "Reminder: You have {0} unread message{1} in your mailbox.", "Message.NoMoreMessages": "No more messages", "Message.AdminModeInfo": "Message to all players", "Message.RecommendedMustHaveItems": "A registered mail must contain at least one item.", "Message.MoneyWithdrawError": "Error withdrawing money.", "Message.MessageSentToAll": "Message sent to {0} players", "Message.NoPlayersWithPermission": "No players with the required permission were found.", "Message.TestSent": "Test message sent to {0}.", "Message.RecipientOnline": "The recipient is online.", "Message.RecipientOffline": "The recipient is offline.", "Message.InsufficientFundsForRecommended": "You don't have enough funds to open this registered mail.", "Message.RecommendedOpened": "Registered mail opened. {0} {1} have been withdrawn.", "Message.RecommendedRejected": "Registered mail rejected.", "Message.MoneyAmountSet": "Amount set: {0:F2}", "Message.MoneySent": "{0} {1} sent with the mail.", "Message.RecommendedReturnedTo": "Your registered mail sent to {0} has been rejected and returned to you.", "Message.RecommendedReturnSubject": "Return: {0}", "Message.RecommendedReturnBody": "Your registered mail was rejected by {0}.\n\nOriginal message:\n{1}", "Message.RegisteredMailIndicator": "Registered mail", "Message.FeeToSender": "Your registered mail has been opened by {0}. You received {1} {2}.", "Money.AmountSet": "Amount set: {0:F2}", "Money.InsufficientFundsRecommended": "Insufficient funds to open this registered mail.", "Money.RecommendedOpened": "Registered mail opened. {0} {1} have been withdrawn.", "Money.SecurityDeposit": "This amount is a security deposit for registered mail and cannot be recovered.", "Money.PayFirst": "You must first pay the fees for this registered mail.", "Money.Added": "{0:F2} {1} have been added to your account.", "Money.Error": "Error adding money to your account.", "Message.MassMailSuccess": "Message sent to {0} players successfully.", "Message.MassMailWithItemsMoney": "Message sent to {0} players with {1} items and {2} {3}.", "Message.NoPlayersFound": "No players with the required permission were found.", "Message.InsufficientFundsForMassMail": "Insufficient funds for mass mailing. Total cost: {0}", "Message.MassMailModeEnabled": "Mass mail mode enabled. The message will be sent to all players.", "Message.MassMailModeDisabled": "Mass mail mode disabled.", "Item.RecoveryFailed": "Unable to recover item", "Item.Recovered": "{0} recovered", "Item.Removed": "Item removed from mail", "Item.InventoryFull": "Some items were dropped on the ground (inventory full)", "Item.DropInfo": "Inventory full! The following items have been dropped: {0}", "Item.SpaceNeeded": "Unable to add {0} item(s): {1}. Free up space and try again.", "Item.UnknownItem": "Unknown item", "Item.DropWarning": "Some items were dropped on the ground (inventory full)", "Confirm.MessagesDeleted": "{0} message(s) deleted.", "Confirm.MessagesProcessed": "{0} message(s) have been processed.", "Confirm.ItemsCollected": "{0} item(s) collected", "Confirm.ItemsDropped": "{0} item(s) dropped on the ground", "Confirm.MoneyCollected": "{0:F2} {1} collected", "Confirm.ReportSent": "<color=#00FF00>Report sent successfully!</color> An administrator will review this message.", "Confirm.ReportCancelled": "Report cancelled.", "Confirm.InputError": "Invalid input. Current quantity: {0}", "Confirm.AttentionRequired": "<color=#FF6347>Attention: {0} registered mail{1} await{2} you.</color>", "Delivery.QueuedForDelivery": "Your message will be delivered in {0} minute(s).", "Delivery.InstantDelivery": "Your message was delivered immediately.", "Delivery.DelayInfo": "Delivery delay: {0} minute(s)", "Delivery.NoMessages": "No pending messages.", "Delivery.ListHeader": "Pending messages: {0}", "Delivery.MessageInfo": "{0}. ID: {1}, From: {2}, To: {3}, Delivery in: {4}, Subject: {5}", "Delivery.MoreMessages": "... and {0} more messages", "Delivery.Commands": "Available commands: /mailpending process, /mailpending clear, /mailpending deliver [id]", "Delivery.ProcessForced": "Forced processing of pending messages. {0} messages delivered.", "Delivery.Cleared": "{0} pending messages cleared.", "Delivery.Delivered": "Message {0} delivered successfully.", "Delivery.NotFound": "Message {0} not found in queue.", "Delivery.UnknownCommand": "Unknown command. Use /mailpending without arguments to see the list of pending messages.", "Delivery.MessageDelivered": "Your message to {0} has been delivered.", "Help.Title": "=== Mail System ===", "Help.Main": "/mail - Open the main interface", "Help.Send": "/mail send <player> <subject> <message> - Send a quick message", "Help.Check": "/mail check - Check unread messages", "Help.Clear": "/mail clear - Mark all messages as read", "Help.Usage": "Usage: /mail send <player> <subject> <message>", "Help.Unknown": "Unknown command. Use /mail help to see available options.", "Help.MailTest": "Usage: /mailtest <recipient> <subject> <message>", "Command.MailDisabled": "Using the /mail command is disabled. Please use a mailbox.", "Command.IconEnabled": "Notification icon enabled.", "Command.IconDisabled": "Notification icon disabled (will only appear for unread messages).", "Command.IconOptions": "Options: /mailicon on, /mailicon off", "Command.IconStatus": "Notification icon: {0}", "Command.WelcomeReset": "Welcome mail configuration reset.", "Command.EnterRecipient": "Enter the recipient in chat starting with @ (example: @DevilWill)", "Command.EnterSubject": "Enter the subject in chat starting with # (example: #Welcome)", "Command.EnterMessage": "Enter the message content in chat starting with ! (example: !Here is the message)", "Command.SubjectSet": "Subject set: {0}", "Command.MessageSet": "Message set: {0}", "Command.PageSet": "Page set to {0}", "Command.PageCurrent": "Current page: {0}/{1} (Total messages: {2})", "Command.QuantitySet": "Quantity set: {0}", "Command.AllUIsClosed": "All interfaces have been closed. You can try again now.", "Command.StatusOn": "enabled", "Command.StatusOff": "disabled", "Config.Usage": "Usage: /mailconfig <option> <value>", "Config.Options": "Options: cost, item, itemamount, itemskin, useeconomics, useserverrewards, useitem", "Config.Examples": "Examples:", "Config.ExampleCost": "/mailconfig cost 50 - Set sending cost to 50", "Config.ExampleItem": "/mailconfig item scrap - Set payment item", "Config.ExampleAmount": "/mailconfig itemamount 15 - Set item quantity to pay", "Config.ExampleEconomics": "/mailconfig useeconomics true/false - Enable/disable Economics", "Config.ExampleServerRewards": "/mailconfig useserverrewards true/false - Enable/disable ServerRewards", "Config.ExampleUseItem": "/mailconfig useitem true/false - Enable/disable item payment", "Config.CostSet": "Message sending cost set to {0}", "Config.CurrentCost": "Current cost: {0}", "Config.ItemSet": "Payment item set: {0} ({1})", "Config.ItemNotFound": "Item not found: {0}", "Config.CurrentItem": "Current item: {0} ({1})", "Config.AmountSet": "Item quantity set to {0}", "Config.CurrentAmount": "Current quantity: {0}", "Config.SkinSet": "Skin ID set to {0}", "Config.CurrentSkin": "Current Skin ID: {0}", "Config.EconomicsSet": "Economics usage: {0}", "Config.CurrentEconomics": "Current Economics usage: {0}", "Config.ServerRewardsSet": "ServerRewards usage: {0}", "Config.CurrentServerRewards": "Current ServerRewards usage: {0}", "Config.ItemPaymentSet": "Item payment usage: {0}", "Config.CurrentItemPayment": "Current item payment usage: {0}", "Config.UnknownOption": "Unknown option. Use /mailconfig without arguments to see available options.", "Prefab.Info": "Prefab info: {0}", "Prefab.ShortName": "Short name: {0}", "Prefab.EntityID": "Entity ID: {0}", "Prefab.IsStorage": "This is a storage container!", "Prefab.NoEntity": "No entity found.", "Prefab.Nothing": "Nothing found. Aim at an object and try again.", "Time.JustNow": "Just now", "Time.MinutesAgo": "{0} minute(s) ago", "Time.HoursAgo": "{0} hour(s) ago", "Time.DaysAgo": "{0} day(s) ago", "Time.HoursRemaining": "{0}h {1}m", "Time.MinutesRemaining": "{0}m", "Time.DaysRemaining": "{0} D", "Reply.OriginalMessage": "------ Original message ------\nFrom: {0}\nDate: {1}\n\n{2}", "Debug.MailboxInfo": "Mailbox Debug:\n- AllMessagesRead: {0}\n- Unread messages: {1}\n- Items to collect: {2}\n- Total messages: {3}", "Debug.ResetRead": "AllMessagesRead reset to false", "Debug.SetRead": "AllMessagesRead set to true", "Debug.AutoRead": "AllMessagesRead automatically set to {0}", "Debug.SaveForced": "Forced save of data: {0} pending messages", "Debug.SaveComplete": "Save complete. You can now reload the plugin.", "Debug.EconomicsStatus": "Economics Plugin: {0}", "Debug.PluginLoaded": "Loaded", "Debug.PluginNotLoaded": "Not Loaded", "Debug.UseEconomics": "UseEconomics: {0}", "Debug.EconomicsAmount": "Economics Amount: {0}", "Debug.YourBalance": "Your balance: {0}", "Debug.CouldNotGetBalance": "Could not get balance", "Debug.CurrentPage": "Page set to {0}", "Debug.PageInfo": "Current page: {0}/{1} (Total messages: {2})", "System.MessageSender": "Mail System", "System.TreasuryDefaultAccount": "City of Stormheim", "System.MailboxPrefix": "<color=#00FF00>[MailBox]</color> ", "Log.EconomicsDetected": "[Mailbox] Economics detected.", "Log.EconomicsAPIWorks": "[Mailbox] Economics API works.", "Log.EconomicsAPIError": "[Mailbox] Economics API is not responding correctly.", "Log.EconomicsTestError": "[Mailbox] Error testing Economics: {0}", "Log.EconomicsCost": "[Mailbox] Economics sending cost: {0}", "Log.EconomicsConfiguredButNotLoaded": "[Mailbox] Economics is configured but not loaded.", "Log.ServerRewardsDetected": "[Mailbox] ServerRewards detected. Sending cost: {0} points", "Log.ServerRewardsConfiguredButNotLoaded": "[Mailbox] ServerRewards is configured but not loaded.", "Log.ItemPaymentConfigured": "[Mailbox] Item payment configured. Sending cost: {0}x {1}", "Log.ItemNotExists": "[Mailbox] The configured item '{0}' does not exist.", "Log.TreasuryTransferSuccess": "[MailBox] Fees of {0} successfully transferred to RustTreasury account '{1}'", "Log.TreasuryTransferFailed": "[MailBox] Failed to transfer fees of {0} to RustTreasury. Check that account '{1}' exists.", "Log.TreasuryNotAvailable": "[MailBox] RustTreasury plugin not available, fees cannot be transferred", "Log.TreasuryDefaultUsed": "[MailBox] Using default account: City of Stormheim", "Log.TreasuryAPIFailed": "[MailBox] API_RegisterMailboxTransaction failed, trying with AddIncome" }
Supported Payment Systems:
- Economics plugin
- ServerRewards points
- Custom item-based payments
- Configurable pricing for all features
Built-in Reporting System:
- 6 detailed report categories (harassment, spam, etc.)
- Automatic admin notifications
- Complete logging system
- Anti-spam protections
- Content filtering options
Mass Communication:
- Broadcast messages to all players
- Targeted messages by permission group
- Welcome mail for new players
- Scheduled server announcements
Management Tools:
- Queue controls: view / force / clear deliveries
- View/delete player messages
- Usage statistics & logs
- Debug commands 
// Send mail
bool success = MailBox.Call("API_SendMail", senderID, "System", recipientID, "Welcome!", "Hello!");
// Get unread count
int unreadCount = (int)MailBox.Call("API_GetUnreadCount", playerID);
// Delete old messages
bool deleted = (bool)MailBox.Call("API_DeleteMessages", playerID, 30);
- Click physical mailboxes to open UI
- Public/private mailbox compatibility
- Location-based mailbox access
- Full permission ownership system
- Command access as fallback: `/mail`
- **UI Colors & Backgrounds**
- **Economy Settings & Costs**
- **Message Rules & Expiry**
- **Delivery Options & Tiers**
- **Notification Settings**
- **Welcome Mail Templates**
{
"UISettings": {
"MainColor": "0.1 0.1 0.1 0.95",
"AccentColor": "0.7 0.4 0.1 1",
"TextColor": "0.9 0.9 0.9 1",
"ButtonColor": "0.2 0.2 0.2 0.9",
"HighlightColor": "0.8 0.5 0.2 1",
"UnreadIndicatorColor": "0.9 0.3 0.3 1",
"ReadIndicatorColor": "0.3 0.7 0.3 1"
},
"EconomySettings": {
"SendMessageCost": 30,
"SendPackageCost": 50,
"MaxPackageItems": 6,
"MaxPackageWeight": 500,
"RestrictedItems": [
"rifle.ak",
"rocket.launcher",
"ammo.rocket.hv",
"ammo.rocket.basic",
"explosive.timed"
],
"UseEconomics": true,
"EconomicsAmount": 30,
"UseServerRewards": false,
"ServerRewardsAmount": 50,
"UseItemCost": false,
"ItemCostShortname": "scrap",
"ItemCostAmount": 10,
"ItemCostSkinId": 0,
"ItemCostDisplayName": "Ferraille",
"TreasuryAccount": "Ville de Stormheim"
},
"MessageSettings": {
"MaxMessageLength": 500,
"MaxSubjectLength": 50,
"MaxMessagesPerPlayer": 50,
"MessageExpiryDays": 30,
"AllowAttachments": true,
"AdminMessagePrefix": ""
},
"NotificationSettings": {
"EnableNotifications": true,
"NotifyOnLogin": true,
"NotificationInterval": 300,
"NotificationSound": true,
"NotificationSoundFile": "assets/bundled/prefabs/fx/notice/item.pickup.fx.prefab"
},
"UIImages": {
"BackgroundImage": "https://image.noelshack.com/fichiers/2025/19/6/1746904609-boite.jpg",
"MailOpenedIcon": "https://image.noelshack.com/fichiers/2025/19/6/1746907837-mail.png",
"MailClosedIcon": "https://image.noelshack.com/fichiers/2025/19/6/1746907837-mail-recu.png",
"ComposeBackgroundImage": "https://image.noelshack.com/fichiers/2025/20/3/1747258969.jpg",
"TrashIcon": "https://image.noelshack.com/fichiers/2025/20/7/1747585588-bb33137e-9b5d-4fe0-8a83-9b9986f931b6-.png",
"ItemBackgroundIcon": "https://image.noelshack.com/fichiers/2025/20/1/1747078289-mail-recu.png",
"ReadMessageBackgroundImage": "https://image.noelshack.com/fichiers/2025/21/4/1747949049-mail.jpg",
"RecommendedMessageBackgroundImage": "https://image.noelshack.com/fichiers/2025/21/4/1747939967-boite.jpg",
"ReportBackgroundImage": "https://image.noelshack.com/fichiers/2025/21/5/1747993444-fond-reportl.jpg",
"MoneyIcon": "https://image.noelshack.com/fichiers/2025/20/5/1747347738-icone.png",
"InventoryBackgroundImage": "https://image.noelshack.com/fichiers/2025/21/2/1747695770-inventaire.png",
"QuantitySelectorBackgroundImage": "https://image.noelshack.com/fichiers/2025/21/4/1747920211-background-montant.png"
},
"WelcomeMailSettings": {
"Enabled": true,
"Sender": "Administration",
"Subject": "Welcome to the server",
"Body": "You can take all this package for free !",
"Money": 100.0,
"Items": [
{
"ShortName": "wood",
"Amount": 500,
"SkinId": 0
},
{
"ShortName": "stones",
"Amount": 500,
"SkinId": 0
}
]
},
"AllowMailCommand": true,
"DeliverySettings": {
"DefaultDeliveryDelayMinutes": 30,
"AdminsInstantDelivery": true,
"CustomDelayGroups": [
{
"GroupName": "vip",
"Permission": "mailbox.vip",
"DelayMinutes": 15
},
{
"GroupName": "vip+",
"Permission": "mailbox.vipplus",
"DelayMinutes": 5
},
{
"GroupName": "elite",
"Permission": "mailbox.elite",
"DelayMinutes": 0
}
]
}
}
5-Step Setup:
1. Upload to `/oxide/plugins/`
2. Set up permissions
3. Configure `MailBox.json` to fit your server
4. (Optional) Install Economics / ServerRewards / RustTreasury
5. Reload plugin & test 
- Large community servers
- RP servers needing immersive messaging
- Economy-based servers
- Global/multilingual audiences
- Professional Rust projects
MailBox — Enterprise-grade messaging for your Rust server.
Includes lifetime updates, full source, and premium support.
