Описание
[](LICENSE)
[](https://shantek.co/discord)
# 📮 Post Office Plugin
**The ultimate mail system for your Minecraft SMP!**
Turn barrels into secure, player-owned post boxes with claim functionality, protection, and notifications.
> ⚠️ **Note:** Version 2 introduces a full system rewrite. You'll need to re-register post boxes. Simply remove the player’s name from the sign and follow the setup steps below.
🎥 **Quick Demo:**
---
## ✉️ How It Works
1. Drop the JAR into your `/plugins` folder and restart the server.
2. Adjust `config.yml` as needed (optional).
3. Build your post office using barrels as mailboxes.
4. Place a sign on the front of a barrel.
5. Look at the sign and run: `/postoffice register`
6. Players can then run `/postoffice claim` to claim an unclaimed post box.
7. Admins/mods can claim for others using `/postoffice claim `
> 🔒 Items can be deposited by anyone but **only the owner** can retrieve them.
🛡️ Built-in protection ensures post boxes can’t be tampered with. Prefer WorldGuard or another region plugin? You can disable the internal protection in the config.
---
## ⚙️ Default Configuration
If any issues are found in your `config.yml`, default settings will be restored.
🔗 [View default config on GitHub →](https://github.com/shantek/PostOffice/blob/master/src/main/resources/config.yml)
---
## 🔐 Post Box Protection
Enabled by default, this protects both barrels and signs from griefing.
To disable and use an external protection system, set `postbox-protection: false` in the config.
---
## 🛠️ Commands
| Command | Description |
|--------|-------------|
| `/postoffice register` | Register a post box (barrel with a sign). |
| `/postoffice claim` | Claim a registered post box for yourself. |
| `/postoffice claim ` | Admins: Claim a post box for someone else. |
| `/postoffice remove` | Remove a post box (while looking at it). |
| `/postoffice info` | View owner or registration status of a post box. |
---
## 🧾 Permissions
| Node | Description |
|------|-------------|
| `shantek.postoffice.use` | Prevents a player from accessing post boxes (default: allowed). |
| `shantek.postoffice.removeitems` | Allow removal of items from any post box. |
| `shantek.postoffice.register` | Register/remove post boxes in config. |
| `shantek.postoffice.claim` | Claim a post box for yourself. |
| `shantek.postoffice.claim.others` | Claim a post box for another player. |
| `shantek.postoffice.updatenotification` | Notify this player of plugin updates. |
---
## 💬 Support & Dev Builds
- 💡 Questions or suggestions? [Join the Discord →](https://www.shantek.co/discord)
- 🔧 Want dev builds? [Check GitHub →](https://github.com/shantek/PostOffice/releases)
- ❤️ Support development: [Patreon →](https://www.shantek.co/patreon)
