Official page:
Mail System (+Support Ticket System)
Mail System is an in-game mail and notification system for Rust servers, allowing players to send “emails” to online and offline players. Admins will also benefit from being able to include attachments such as items, commands, and economy rewards, and players can now open support tickets for staf...
codefling.com
About Mail System (+Support Ticket System)
Mail System is an in-game mail and notification system for Rust servers, allowing players to send “emails” to online and offline players. Admins will also benefit from being able to include attachments such as items, commands, and economy rewards, and players can now open support tickets for staff assistance directly in-game.
Designed for wipes, announcements, rewards, crash compensation, support, and direct communication, Mail System ensures both online and sleeping players receive admin messages, while also providing threaded conversations—replies are appended to the original message—so players can follow the full back-and-forth anytime via a simple UI they can access at any time.
- Admin announcements
- Server rules and new player welcome messages
- Compensations
- Reward delivery
- Event prizes
- Player to Player communication
Persistent inbox per player
- Messages are delivered even when players are currently offline
- Configurable inbox limits per player - oldest message deleted if limit exceeded.
- Optional wipe-based inbox clearing
- Ability to input subject and message content
- Recipient can be easily selected via a player picker UI, with unique colors and icons for Online/Sleeper/Staff
- Optional image per message via ImageLibrary. Available Image URLs (recommend square images eg 512x512) can be configured. Default/Example images have been included.
- Clean scrollable UI and configurable max length for long messages.
- Admins can easily include a combination of items, economies, or commands ran against the recipient.
- Messages and attachments can also be created via console commands, perfect for use in other plugins.
- Known Limitation:
- Rust does not currently have a functional multi-line support (as in, hitting enter to create a line break won't create a line break for the recipient). However. when typing message content, entering \n will create a new line in the resulting message as shown in attached screenshots. Facepunch is aware of this and UI input functionality will be updated accordingly.
- Notification sound upon receiving new message
- Visual indicator for unread messages and attachments
- Customizable position and size of on-screen notification bell
- Create new tickets with subject + message
- Staff groups can view/respond to all tickets (permission group based, configurable)
- Open & Closed ticket views (toggle), with close/reopen controls
- Threaded ticket history: every reply is stored and displayed as a conversation
Each message can include any combination of:
- Item rewards
- Multiple items per message
- Custom display names
- Optional skin IDs
- Inventory-safe claiming
- Ability to run server commands on claim
- Supports placeholders to ensure command is run against the recipient (%steamid%)
- Repeatable command execution via amount entry
- Economics
- ServerRewards
- TCBank
- each handled independently, with clear failure feedback if unavailable or failed
🛠 Admin & Console Tools
Send messages with attachments:
- Using In-game UI
- Using Console commands
- Attach rewards and images using simple flag-based commands
- Ability to include attachments is admin permission based
- Individual players
- All players (Online and Sleepers)
- Customize HUD icon and unread indicators
- Customize online/sleeper/staff icons
- Built-in notification HUD position & size editor (no config guessing)
- Customize available images which can be included in messages.
- Adjust HUD colors
- Configure subject/message max lengths and inbox size.
- Localization via lang files
- Timestamp +/- offset
/inbox - Opens the Inbox UI where players can view and send/reply messages
/tickets - opens the Tickets UI
/sendmail "PlayerName" - optional chat command to send message to specific player without going through inbox/player picker
/inbox_top - Admin command to view players with largest inbox sizes
/inbox_clear "PlayerName" - Admin command to clear a specific player's inbox
/notif_iconpos - Admin command to reposition and resize the notification icon (auto saves)
mailsystem.send - required to be able to send messages
mailsystem.admin - required to add attachments via UI and run admin commands
mailsystem.ticketopen - allows opening/using the Tickets UI
mailsystem.ticketstaff - marks a player as ticket staff (can view/respond to all tickets)
mailsystem.ticketmanage - allows managing tickets (e.g., close/reopen regardless of creator)
Console commands can be used for both messaging and attachment delivery using flags, with included option to select which image will appear in the message
Basic command structure is as follows:
mail.send <playername OR SteamID> "<subject>" "<content>" [flags]
mail.sendall "<subject>" "<content>" [flags]
Available flags are desribed below and may be used multiple times and in any order:
Image Flag:
-img <number>
Sets the message image.
- Uses the image list from the config
- Index starts at 0
- 0 = first image, 1 = second, etc.
Item Flag:
-item <shortname> <amount> <skinId> optional:"displayName"
Adds an item attachment.
- skinId may be 0
- Custom name is optional
- If omitted, the item’s default name is used
Commands Flag:
-cmd "<name>" "<command>" <amount>
Runs a server command when claimed.
- amount specified how many time to run the command. It defaults to 1
- Supports %steamid% and %name% wildcards - useful when sending to all players or via other plugins.
- "name" is what the player will see as the attachment name (instead of seeing the command itself)
Economy Flag:
-eco <type> <amount>
Adds a currency attachment.
- Supported types:
- Economics
- ServerRewards
- TCBank
