Fabric Mail

Fabric Mail

Send messages and items to any player, online or offline.
All Server-Sided; Players don’t need any mods.

Features

• Mail anyone. Send a message of up to 1024 characters to any player, including one who is offline or has never joined the server.
• Parcels. Attach the item stack in your hand to a message. Enchantments, names and other item data are kept.
• Never miss a message. Online players are told when mail arrives, and everyone else is told how much mail is waiting when they log on.
• A mailbox GUI. Browse your inbox and outbox in a chest menu with sorting, parcel filters and click actions, or use clickable lists in chat.
• Unsend mistakes. Revoke any mail still in the recipient’s mailbox and get back a parcel they have not claimed.
• Server announcements. Admins can broadcast a message to all, online or offline players, or airdrop an item to them with it.
• Stops item hoarding. A configurable limit on outbound parcels stops players from using other people’s mailboxes as free storage.
• Built for servers. No client mods, mail that is saved with the world, settings that can be changed without a restart, and a permission node for every command.

Getting Started

1. Send a message. /mail send <player> <message> delivers it straight away, even if the player is offline.
2. Send an item. Hold a stack in your main hand and run /mail parcel <player> <message>.
3. Check your mailbox. /mail gui opens your mailbox and /mail list shows the same mail in chat. Reading a mail puts its parcel in your inventory.
4. Clean up. Mail stays in your mailbox until you delete it. Deleting a mail also destroys any unclaimed parcel, so you can get rid of unwanted or troll parcels without them flooding your inventory. If you want the item, read the mail first.
5. Change your mind. /mail outbound lists the mail you have sent that is still in a mailbox. Click one to revoke it and get back its parcel if it has not been claimed.

Server Setup

1. Install Fabric Loader and Fabric API on your server, then put the Fabric Mail jar in the mods folder. Every other library is bundled, and players do not need to install anything.
2. (Optional) For custom textures in the mailbox GUI, launch the server once, open config/polymer/auto-host.json and change "enabled": false to true. The server now generates a resource pack and sends it to players when they connect. Without it, the GUI’s frame shows vanilla items.

Commands

• /mail gui Opens the mailbox GUI.
• /mail list Lists your mail in chat. Click an entry to read it.
• /mail outbound Lists the mail you have sent that is still in the recipient’s mailbox. Click an entry to revoke it.
• /mail send <player> <message> Sends a message to a player.
• /mail parcel <player> <message> Sends a message and the item stack in your main hand to a player.
• /mail delete all Clears your mailbox, including any unclaimed parcels.

Admins can send mail to everyone with /mail broadcast and /mail airdrop. The parcel limit and other settings can be viewed and changed in game with /mailconfig, and every command has a Fabric Permissions API node with a vanilla permission level fallback.

The full reference is on GitHub: commands, configuration and permission nodes.

Try My Other Mods!

All server-side Fabric mods — no client installation required.

| | Mod | Description | Links |
|:—:|—|—|—|
| | Arcana Novum | Minecraft’s biggest server-side magic mod: powerful items, multiblock structures, custom bosses and deep lore. | |
| | Ancestral Archetypes | A highly configurable, Origins-style mod that lets players pick a mob to gain unique abilities! | |
| | Ender Nexus | Highly configurable /home, /spawn, /warp, /tpa and /rtp commands all in one, and individually disablable. | |
| | Fabric Trade | Adds /trade, a secure player-to-player trading interface. | |
| | Limited AFK | AFK detection and management with configurable kick thresholds for servers. | |
| | Links in Chat | Makes URLs posted in chat clickable. | |
| | PulseNet | A networking optimization mod that uses packet batching and other optimizations. Fully compatible with Krypton. | |

Support

Questions go to the Discord, and bug reports and suggestions go to GitHub Issues.

Support My Work

Fabric Mail and all of my other mods are free and will stay that way. I make them in my spare time, so if they have been useful to you or your server and you would like to help keep development going, you can chip in at borisshoes.net/donate. Supporters get access to special skins in Arcana Novum, along with a special role and channel on the Discord. Every bit is always appreciated.

License Notice

By using this project in any form, you hereby give your “express assent” for the terms of the license of this project, and acknowledge that I, BorisShoes, have fulfilled my obligation under the license to “make a reasonable effort under the circumstances to obtain the express assent of recipients to the terms of this License.”