Description
Gallery
Changelog
Versions
📮 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
- Drop the JAR into your
/pluginsfolder and restart the server. - Adjust
config.ymlas needed (optional). - Build your post office using barrels as mailboxes.
- Place a sign on the front of a barrel.
- Look at the sign and run:
/postoffice register - Players can then run
/postoffice claimto claim an unclaimed post box. - Admins/mods can claim for others using
/postoffice claim <playername>
🔒 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 →
🔐 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 <player> |
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 →
- 🔧 Want dev builds? Check GitHub →
All Versions
+ Add Version| Name | Game version | Platforms | Published | Downloads | Actions |
|---|---|---|---|---|---|
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
| 18h ago | 1 | ||||
|
R
v1.1.0
|
18h ago | 1 |
[2.5.1] Post Office 2.5.1
by Shantek on Oct 15, 2026
Download
- Fix issue creating post boxes for a first time player on the server
- Bug fixes for counting number of boxes a player has
- Fixed bug with post box auto closing if chunk isn't loaded
- Added ability to remotely open your post box with /postbox
[2.4.0] Post Office 2.4.0
by Shantek on Oct 15, 2026
Download
Players can now register a primary box in your Post Office building, and can then register a secondary box outside (or inside) their base and it will link back to the inventory of their primary box, shows notifications on the sign and so on.
To use it, your players need to have a primary box and then do the following:
Note: They can remove it by typing **/postoffice removesecondary**. The default config allows them to have 5 secondary boxes, but you can have an infinite amount using -1 in the config.
To use it, your players need to have a primary box and then do the following:
- Rename a barrel to "secondary" and place it
- Places a sign on their barrel
- Looking at the sign on the barrel, type **/postoffice secondary**
- Enjoy checking their post office barrel in their base
Note: They can remove it by typing **/postoffice removesecondary**. The default config allows them to have 5 secondary boxes, but you can have an infinite amount using -1 in the config.
[2.3.1] Post Office 2.3.1
by Shantek on Oct 15, 2026
Download
- Fixed null inventory bug
[2.3.0] Post Office 2.3.0
by Shantek on Oct 15, 2026
Download
- Added blacklist.yml to prevent specific items being left in a post box
- Bumped lang file to v2
[2.2.1] Post Office 2.2.1
by Shantek on Oct 15, 2026
Download
- Fixed error with /postoffice command
[2.2.0] Post Office 2.2.0
by Shantek on Oct 15, 2026
Download
Players with the register permission node can now add text to the first line of a post box sign, allowing the use of tags like [Mod], [Admin] etc. - Colour codes can also be used on this line.
[2.1.1] Post Office 2.1.1
by Shantek on Oct 15, 2026
Download
- Fixed item removal bug
[2.1.0] Post Office 2.1.0
by Shantek on Oct 15, 2026
Download
- Fixed bug reloading config and lang files.
- Added debug toggle in config to help troubleshoot issues.
- Fixed bug removing items from a post box.
- Added config and lang file versioning.
- Added hopper checks to config and disabled by default to prevent lag.
[2.0.2] Post Office 2.0.2
by Shantek on Oct 15, 2026
Download
- Optimization/tweaks to barrel protection logic
[2.0.1] Post Office 2.0.1
by Shantek on Oct 15, 2026
Download
- Fixed bug reading _ in world names
- Fixed bug with registering/claiming a post box
[2.0.0] Post Office 2.0.0
by Shantek on Oct 15, 2026
Download
- Please note**: This is essentially a re-write of the plugin in a lot of areas and will require you to setup your players post boxes again - but will better allow me to add new functionality to the plugin moving forward. Lots of cool stuff to come!
To install this plugin, it's best to download a backup of your existing config and then start fresh. You can follow the setup guide here:
<iframe width="560" height="315" src="https://www.youtube-nocookie.com/embed/skb3oYxVzfg" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe>
## **Change Log**
- Plugin now uses player UUIDs, no longer relying on player names!
- Post boxes are now stores in a barrels config once registered.
- New permission node allows a player to claim a registered post box by themselves if desired.
- Post boxes are now registered/claimed using commands - no longer restricted by their name fitting on the line.
- Added visual "You have mail" message to the post box sign.
- Added StructureGrow event checks to post box protection.
- Rewrote config handling/reloading.
- Players now receive a notification when a post box is set up for them, if they're online.
- Moved all messaged from config to a new lang file.
- Better handling color codes in lang file.
- Added additional keys to the lang file.
- Disabled update check if unable to pull latest version from API.
- Disabled update check if using a dev build.
- Added use permission node, deny this to prevent players from using the post office system.
- Large scale project cleanup/refactoring.
[1.6.3] Post Office 1.6.3
by Shantek on Oct 15, 2026
Download
- Changed default mail notification delay to 1 second
- Added extra checks to post box protection
- Changed default "post box created for.." messages from red to green
- Added check for hopper minecart when removing items from a postbox
- Prevent protected post boxes/signs being blown up by tnt or creepers
- Prevent items being moved out of a post box with a hopper if post box protection is enabled
[1.6.2] Post Office 1.6.2
by Shantek on Oct 15, 2026
Download
- Removed unused "/postoffice barrelname" command
- General bug fixes
- Added 1.21 support
[1.6.1] Post Office 1.6.1
by Shantek on Oct 15, 2026
Download
- Added post box (barrel and sign) protection. Easily disabled in the config if using your own.
- Prevent players from swapping cursor items out of a post box.
- Prevent players from dropping items out of a post box.
- Prevent players from condensing items out of a post box.
- Add a 10 second delay to the "You have mail" notification when connecting.
- Added a plugin update notification system.
- Added extra language translation options to the config file.
- Removed the barrelname command as this should only be set once. Edit the config directly and use /postoffice reload to update the barrel name.
- Post Office has now been added to GitHub as a GPL3.0 Open Source project. You can find it here: https://github.com/shantek/PostOffice**
- Coming soon, v2 will update the plugin to use a players UUID and add additional flexibility to the plugin.
[1.5.4] Post Office 1.5.4
by Shantek on Oct 15, 2026
Download
- Fixed issues with reloading the plugin
- Added additional checks to reloading the config file
- If keys are not found in the config, they will now revert to the default options
- Fixed issues with showing the correct sent/received messages
[1.5.3] Post Office 1.5.3
by Shantek on Oct 15, 2026
Download
- Fixed issue with off hand swapping out of a post box
[1.5.2] Post Office 1.5.2
by Shantek on Oct 15, 2026
Download
- Removed ability to take items out of a post box using offhand or hot bar shortcuts.
- Added offhand-error & hotbar-error to the config file to customize the errors displayed.
- (Thanks to XaosKoltron for reporting the issue)*
Have suggestions for future updates? [Join my Discord](https://www.shantek.co/discord)
[1.5.1] Post Office 1.5.1
by Shantek on Oct 15, 2026
Download
- Added shantek.postoffice.removeitems permission node. Give this permission to your server mods/staff to allow them to remove items from Post Boxes
[1.5.0] Post Office 1.5.0
by Shantek on Oct 15, 2026
Download
Added additional message customization when sending notifications to the player.
cant-stack-items: "&4You don't have permission to do that." - A generic error shown in some circumstances when trying to stack items in another players post box.
remove-item-error: "&4You don't have permission to remove items from this post box." - The error shown when a player tries to remove an item from another players post box.
cant-stack-items: "&4You don't have permission to do that." - A generic error shown in some circumstances when trying to stack items in another players post box.
remove-item-error: "&4You don't have permission to remove items from this post box." - The error shown when a player tries to remove an item from another players post box.
[1.4.0] Post Office 1.4.0
by Shantek on Oct 15, 2026
Download
- General cleanup of the plugin.
- Added the following customizations available in the config file
sent-message: '&aMail sent to %receiver%.'
received-message: '&eYou got mail from %sender%!'
got-mail-message: '&a[Post Office] &fYou have mail!'
Have total control over what the plugin sends to your players!
[1.3.0] Post Office 1.3.0
by Shantek on Oct 15, 2026
Download
- Added support for 1.20
- Included a new notification system, receive a notification when joining the server, open your post box to clear it
[1.1.0] v1.1.0
by Shantek on Oct 15, 2026
Download
- General bug fixes
