https://github.com/shantek/postoffice
A fully functional Post Office plugin for your Minecraft server. With a built in protection system, your post boxes are always safe from other players. A built in notification system informs players when they have items in their post box.
https://github.com/shantek/postoffice
bukkit-plugin java minecraft minecraft-plugin minecraftjava paper-plugin papermc purpur-plugin spigot spigot-plugin
Last synced: 16 days ago
JSON representation
A fully functional Post Office plugin for your Minecraft server. With a built in protection system, your post boxes are always safe from other players. A built in notification system informs players when they have items in their post box.
- Host: GitHub
- URL: https://github.com/shantek/postoffice
- Owner: shantek
- License: gpl-3.0
- Created: 2024-03-09T01:14:51.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-29T06:25:54.000Z (over 1 year ago)
- Last Synced: 2024-10-11T03:40:55.965Z (over 1 year ago)
- Topics: bukkit-plugin, java, minecraft, minecraft-plugin, minecraftjava, paper-plugin, papermc, purpur-plugin, spigot, spigot-plugin
- Language: Java
- Homepage: https://www.shantek.io
- Size: 174 KB
- Stars: 1
- Watchers: 1
- Forks: 2
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# 
---
[](https://modrinth.com/plugin/postoffice)
[](https://shantek.co/discord)
[](https://www.codefactor.io/repository/github/shantek/postoffice)
# 📮 Post Office Plugin
**A fully functional post box system for Bukkit-based Minecraft servers!**
Turn barrels into secure player mailboxes with claims, protection, and notifications.
> 🔄 **Version 2 is a full rewrite.** You’ll need to re-register existing post boxes.
> Just remove the player’s name from the sign and follow the steps below.
### 🔧 [Get the latest development builds here](https://github.com/shantek/PostOffice/releases/)
---
## ✉️ How It Works
1. Upload the JAR to your server and restart.
2. Edit the `config.yml` if needed (optional).
3. Place barrels in your post office build.
4. Attach a blank sign to the front of each barrel.
5. While looking at the sign, type `/postoffice register`.
6. Players can use `/postoffice claim` to claim a registered box.
7. Admins can claim on behalf of others with `/postoffice claim `.
> 📦 Anyone can deliver items into a post box, but only the **owner** can retrieve them.
> 🔐 Post boxes are protected from tampering unless permissions override this.
> You can disable built-in protection and use WorldGuard or other systems instead.
---
## 🎥 YouTube Tutorial
[](https://www.youtube.com/watch?v=WJtsFSBOviI)
---
## 🛠️ Commands
| Command | Description |
|--------|-------------|
| `/postoffice register` | Register a barrel + sign as a post box. |
| `/postoffice claim` | Claim a registered post box. |
| `/postoffice claim ` | Admin command to claim on behalf of a player. |
| `/postoffice remove` | Remove a post box (while looking at it). |
| `/postoffice info` | Show info about the post box you’re looking at. |
---
## 🔐 Permissions
| Node | Description |
|------|-------------|
| `shantek.postoffice.use` | Default true. Deny this to ban a player from using post boxes. |
| `shantek.postoffice.removeitems` | Allow access to remove items from any post box. |
| `shantek.postoffice.register` | Register or remove post boxes. |
| `shantek.postoffice.claim` | Claim a post box. |
| `shantek.postoffice.claim.others` | Claim for another player (admin/mod use). |
| `shantek.postoffice.updatenotification` | Receive plugin update notifications. |
---
## 📦 Downloads
Available on:
- [Spigot](https://www.spigotmc.org/resources/post-office.108343/)
- [Modrinth](https://modrinth.com/plugin/postoffice)
- [CurseForge](https://www.curseforge.com/minecraft/bukkit-plugins/post-office)
---
## 💬 Community & Support
- 🛠 [Report Bugs or Make Suggestions](https://github.com/shantek/PostOffice/issues)
- 💬 [Join the Discord](https://shantek.co/discord)
- ❤️ [Support via Patreon](https://shantek.co/patreon)
- ☕ [Or via PayPal](https://www.paypal.com/donate/?hosted_button_id=9N3RCSJF6PYPU)
---
## 📄 License
[](LICENSE)
Distributed under the **GNU General Public License v3.0**.
See the [`LICENSE`](LICENSE) file for details.
---
