Mails

!(https://cdn.modrinth.com/data/cached_images/42842d1ee202e01625163e03f9b5364a0ac07ce2.gif) !(https://cdn.modrinth.com/data/cached_images/45da74bd389d6d6c25b0bfcd78b31621181fe1d1.jpeg) # ✉️ MailBox

## Advanced Player Mail System

### By PrabhatPie

MailBox is a premium GUI mail plugin for Paper/Spigot servers with offline & online mail support, important staff mails, PlaceholderAPI support, async database handling, and fully configurable GUIs.

Perfect for SMP, Survival, RPG, Economy, and Community servers.

# 🌟 Features

## 📬 Mail System

Send mails to online & offline players Incoming, Sent & Important mail categories Persistent mail IDs Read/unread tracking Delete mails individually or all at once Pagination support

## 🖥️ GUI Features

`/mails` GUI Incoming Mail GUI Sent Mail GUI Important Mail GUI Read Mail GUI Remaining Mail Limits button Fully configurable GUI items & slots

## ⚡ Performance

Fully async operations SQLite support Optional MySQL support HikariCP connection pooling Thread-safe systems Optimized for large servers

# 🔐 Permission-Based Limits

## Examples

`mails.hour. 5` `mails.hour. 25` `mails.day. 10` `mails.day. 50`

The plugin automatically detects the highest permission value.

### Example

If a player has:

`mails.hour. 5` `mails.hour. 15`

Final limit:

`15 mails/hour`

# ⭐ Important Mail System

## Commands

`/mail important ` `/mail imp `

## Features

Important Mail category Glow effects Sounds Optional undeletable mails Join notifications

# 🔔 Join Notifications

## Examples

`You have 3 new mails! Check with /mails` `You have IMPORTANT mail waiting! Check /mails`

## Supports

Chat Actionbar Titles

# 📊 PlaceholderAPI

| Placeholder |Description | | ------------------- |------------------ | | %mailbox_unread% |Unread mails | | %mailbox_total% |Total mails | | %mailbox_important% |Important mails | | %mailbox_sent% |Sent mails | | %mailbox_limit% |Current mail limit | | %mailbox_remaining% |Remaining mails |

# 📜 Commands

| Command |Description | | ---------------------------------- |-------------------- | | /mail <player> <message> |Send normal mail | | /mail important <player> <message> |Send important mail | | /mail imp <player> <message> |Important mail alias | | /mails |Open mailbox GUI | | /mail delete <id> |Delete mail by ID | | /mail reload |Reload configs | | /mail clear <player> |Clear player mailbox |

# 🔑 Permissions

## Default Permissions

| Permission |Description |Default | | -------------- |-------------------------------- |------- | | mail.admin |Unlimited mails & admin commands |OP | | mail.important |Send important mails |OP |

## Hourly Permissions

`mails.hour. 1` `mails.hour. 2` `mails.hour. 3` … `mails.hour. 50`

## Daily Permissions

`mails.day. 1` `mails.day. 2` `mails.day. 3` … `mails.day. 50`

# ⚙️ Configurable

GUI items GUI titles Messages Sounds Limits Cooldowns Mail expiration Important mail settings Placeholder formatting

# 💾 Database Features

| Table |Purpose | | ----------- |--------------------------------- | | mails |Stores all player mails | | mail_limits |Stores player limit data | | mail_meta |Stores metadata like last mail ID |

## Features

Persistent IDs Restart-safe storage Soft-delete system Auto cleanup Async-safe queries

# 🧠 Why Use MailBox?

| Feature |Benefit | | ----------------- |----------------------------- | | GUI Mail System |Easy player experience | | Offline Messaging |Players never miss messages | | Async Database |No server lag | | PlaceholderAPI |Great for scoreboards & menus | | SQLite & MySQL |Flexible storage | | Pagination |Handles large inboxes | | Important Mail |Staff announcements | | Configurable GUIs |Match your server style |

# 🛠️ Compatibility

| Software |Supported | | -------- |--------- | | Paper |✅ | | Spigot |✅ | | Purpur |✅ |

## Minecraft Version

`1. 21+`

# 📦 Dependencies

| Plugin |Required | | -------------- |-------- | | Plac