SMail

# SMail — Physical Mailbox System for Paper **SMail** turns a humble barrel into a real, in-world mailbox. Place one down, claim your own postal address, and start receiving packages from anywhere on the server. No commands required, no GUIs to memorize — just walk up to a mailbox and send. Built for **Paper 1.21.1**. --- ## ✨ Features - **Physical mailboxes.** Craft a custom mailbox item, place it as a barrel, and it becomes a registered post point with its own address. - **Custom addresses.** Every mailbox has a unique, player-chosen address (Latin / Cyrillic / digits supported). Rename it any time. - **Send items to any address.** Open someone's mailbox to deliver a package — or send from your own mailbox by address. - **Public / Private toggle.** Decide whether anyone can deliver to you, or only you can use your mailbox. - **Member access.** Invite trusted players to read your inbox without giving them full ownership. - **Delivery cost.** Optional configurable cost item (default: one Deepslate Diamond Ore per delivery) to give mail real weight on your economy. - **Animated arrivals.** Sounds and particles fire on every mailbox the moment new mail lands. - **SQLite persistence.** All mailboxes, addresses, members, and contents are saved server-side. Nothing lives in chunks — break the barrel, the mailbox is gone; place it back, it's still yours. - **Custom recipe.** A configurable crafting recipe for the mailbox item, toggleable in config. - **Fully translatable.** All player-facing text lives in `messages.yml` with full MiniMessage formatting. --- ## 📦 How it works 1. **Get a mailbox** — craft one with the configured recipe, or run `/smail give <player>` as admin. 2. **Place it down** — right-click any barrel placement; you'll be assigned a fresh address (or you can rename it). 3. **Send mail** — right-click anyone's mailbox to open the visitor menu and put items into the Send GUI. Hit confirm; the recipient gets a notification. 4. **Receive mail** — right-click your own mailbox to open your inbox. 5. **Manage** — toggle public/private, rename, add members, or delete the mailbox from the owner menu. --- ## 🛠 Commands | Command | Permission | Description | |---|---|---| | `/smail reload` | `smail.admin` | Reload config and messages | | `/smail give <player>` | `smail.admin` | Give the mailbox item to a player | | `/smail inspect <address>` | `smail.admin` | Inspect a mailbox by address | ## 🔑 Permissions | Node | Default | Description | |---|---|---| | `smail.use` | true | Open and interact with mailboxes | | `smail.create` | true | Craft and place mailboxes | | `smail.send` | true | Send mail to other mailboxes | | `smail.rename` | true | Rename your own mailboxes | | `smail.admin` | op | Full admin access | --- ## ⚙️ Configuration Everything is configurable in `config.yml`: - Default mailbox inventory size (9 – 54) - Maximum mailboxes per player - Maximum members per mailbox - Delivery delay (in ticks) - Delivery cost item & amount - Sounds & particles toggles - Recipe toggle All messages can be edited in `messages.yml` using **MiniMessage** formatting — full colors, gradients, hover and click events supported. --- ## 📥 Installation 1. Download the latest `SMail.jar` from the Files tab. 2. Drop it into your server's `plugins/` folder. 3. Restart the server (Paper **1.21.1** required). 4. Open the generated `plugins/SMail/config.yml` and tune to taste. 5. `/smail reload` after any edits. ---