project-831258

The ultimate Post Office plugin for your Minecraft SMP!

Easily turn any barrel in to a Post Box for the players on your SMP! The plugin comes with built in post box protection and a mail notification system. Please note: V2 brings a full rewrite to how the barrels are stored/managed and will require you to set up new post boxes for your players. Simply remove the players name from the sign and follow the below instructions to set up a new post box. Need help? Jump on my Discord!

Show your support for the Plugin via PayPal or Patreon.

YouTube Tutorial

How does the plugin work?

• Upload the JAR to your server and reboot
• Make any desired changes to the config file (not essential), and then type /postoffice reload' as an op.
• Place your barrels in your amazing Post Office build.
• Place a blank sign on the front of the barrel.
• While looking at the sign, type '/postoffice register' to register the barrel in the config file.
• Again while looking at the sign, if permitted your players can type '/postoffice claim' on a registered post box to claim it.
• Admin/mods can look at a sign and use '/postoffice claim playername' to claim a post box on behalf of another player.
• Enjoy your awesome post office on your SMP!

All player can place an item in another players post box but only the owner can take the items out. The plugin now comes with built in barrel protection to help protect your post office. Prefer to use something like WorldGuard? You can disable the built in protection in the config file.

## Default Configuration

If the plugin detects any issues with your config file, these values will be reverted to the default values. You can find the default config file here.

If the plugin detects any issues with your config file, these values will be reverted to the default values. You can find the default config file here.

Commands

Below are the commands used to manage the post office barrels and plugin:

/postoffice register

Place a barrel and a sign on the front. Run this command while looking at the sign to register the post box in the config.

/postoffice claim

If players have the claim permission, this command will allow them to claim an already registered post box.

/postoffice claim playername

Used for an admin/mod to claim a post box on behalf of another player.

/postoffice remove

Run while looking at a registered or claimed post box to remove the owner and the post box from the config.

/postoffice info

Run while looking at a post box barrel to get information about the registration state/owner.

Permissions

The below permissions are intended for giving your mods extra access and abilities within your post office. By default, players will be able to access their own post box without any additional permission nodes being granted.

shantek.postoffice.use

This permission prevents a player from using/interacting with the post office. All players have this by default, so use this to deny access to any players you wish to ban from the post box system.

shantek.postoffice.removeitems

Allow these players to remove items from any post box.

shantek.postoffice.register

Allow a player to register/remove a post box in the config.

shantek.postoffice.claim

Allow a player to claim their own post box.

shantek.postoffice.claim.others

Allow a player to claim a post box for other players (generally used by admin/mods).

shantek.postoffice.updatenotification

Any player with this permission will be notified if there is an update to the plugin.

Support & Dev Builds

• Want to help support my plugins? Subscribe to my patreon!
• Need support? Have suggestions, join my Discord.
• Want the latest and greatest? You can find dev builds here.

License

Distributed under the GNU General Public License v3.0.