Mailboxes

Description

Mailboxes is an open source plugin that allows players and plugins to send persistent messages to players. Players can also attach items to their messages, making it easy to transfer items securely through in-game mail.

Supported Minecraft Versions

This plugin is supported on the Minecraft versions listed in minecraft-versions.json: currently 1.19.4, 1.21.11 and 26.2 (Spigot and its forks). Every stable release is booted on a real server of each of these versions before it is published, and every build checks that the plugin only uses Bukkit API that exists on all of them. Other versions from 1.19.4 onwards are expected to work but are not tested. To support another version, add it to the file: both checks pick it up.

Features

• Persistent Messaging: Send messages that persist across server restarts
• Item Attachments: Attach items to messages for secure item transfer
• Configurable Limits: Server admins can configure attachment limits
• Permission-Based: Control who can use attachment features
• API Support: External plugins can integrate with Mailboxes

For more information about the item attachments feature, see ATTACHMENTS.md.

For Plugin Developers

Want to integrate Mailboxes into your plugin? Get started in minutes!

• Quick Start Guide - Send your first message in 5 minutes
• Complete API Documentation - Full API reference with examples

Key Features for Developers

• Simple API - send messages with just a few lines of code
• Support for online and offline players
• Messages persist across server restarts
• No complex setup required

Server Software

This plugin was developed using the Spigot API. Users may run into trouble using it with other available server softwares like Paper.

Installation

1. You can download the plugin from this page.

2. Once downloaded, place the jar in the plugins folder of your server files.

3. Restart your server.

Usage

• User Guide (coming soon)
• List of Commands
• FAQ (coming soon)

Support

You can find the support discord server here.

Experiencing a bug?

Please fill out a bug report here.

Roadmap

• Known Bugs
• Planned Features
• Planned Improvements

Contributing

• API Documentation for Plugin Developers
• Notes for Developers (coming soon)

Authors and acknowledgement

Name	Main Contributions
Daniel Stephenson	Creator

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

You are free to use, modify, and distribute this software, provided that:

• Source code is made available under the same license when distributed.
• Changes are documented and attributed.
• No additional restrictions are applied.

See the LICENSE file for the full text of the GPL-3.0 license.

Project Status

This project is in active development.

bStats

You can find the bStats page for this plugin here.

Usage reporting

Usage reporting is on by default: when the plugin is enabled, and each time one of its commands is used, it sends its name, version and the command name to the author's trace server so it is known which plugins are actually in use. Nothing about players, worlds, IPs or the server is sent, and nothing typed after a command. The plugin says on the console at every start whether reporting is on. To turn it off:

• for this plugin: set usage-reporting.enabled to false in plugins/Mailboxes/config.yml;
• for every plugin on the server that reports to trace: set enabled to false in plugins/trace/config.yml (created on first start);
• for the whole server process: set the environment variable TRACE_USAGE_REPORTING=off or DO_NOT_TRACK=1.

Details: https://github.com/Stephenson-Software/trace#usage-reporting