Introduction

With this plugin you can send other players items,texts, and money with a physical mailbox.

Every player has an default mailbox which can be accessed by left clicking a mailbox sign. Also a mailbox can be created from a chest to add additional space in a players inbox.

Items can be sent either through right clicking with an item or by right clicking a mailbox sign.

Texts which are sent through a command get converted to a physical letter and get placed inside the recipients mailbox.

Money may be sent through the ItemMail GUI by right clicking a mailbox or letterpaper. Inside the ItemMail GUI, there is now a gold Bar item that appears if Sending money is enabled in the config. You may left click to increase the amount and right click to decrease the amount. When you are done, click send and your money will be converted into a "Bank Note" item(a piece of paper) and be sent to the recipient! The recipient may then hold this Bank Note in their hand and right click it to deposit the money into their account.

Features

Fully configurable default inbox
Fully configurable sending window
Sending items to other players inboxes
Send texts as items
Charge money to send text mail (v1.0.0.7)
Charge money to send items, configurable per item or per mail. (v1.0.0.7)
Send money through a Bank Note Item. (v1.0.1.3)

Screenshots and other images

Because pictures say more than 1000 words here some pictures: Example Mailbox Mailing GUI Letter paper crafting

Videos

Plugin Showcase by bobby1727mc :

Special thanks to ApacheMC and Sparky12387 for making this video!

Commands

/papermail sendtext <PLAYER> <TEXT> Sends a textmail to the player
/papermail createbox <PLAYER> Creates an InboxChest when typed while looking at a chest.

How to use

Item Mailing

To get started with the item mailing you need to create a mailbox sign or craft some letterpaper to send a itemletter.

You can create the sign by placing a sign and putting "[Mailbox]" in the second line, letter paper can be created by placing paper, a feather and an ink sac into the crafting grid in any shape.

When right-clicking, either the mailbox sign or with the letter paper, the mail window opens.

To define the recipient of the mail add a written book in the top-left slot of the window and add the other items you want to send.

When clicking the send button (the green wool on the right side) your mail will be sent.

Text Mailing

To send a text mail simply enter the command

/papermail sendtext

followed by the recipient and your message.

Permissions

papermail.send.text

Allows to use the command /papermail sendtext Is set by default

papermail.send.item

Allows to use mailbox signs or rightclick with letter paper to send items Is set by default

papermail.createchest

Allows to create inbox chests using /papermail createbox Is set by default

papermail.costs.exempt

Makes the user exempt from mailing costs. is false by default.

Configuration

general:
  EnableTextMail: true       //Allow the use of Text mail messages with /papermail sendtext
  EnableItemMail: true      // Allow the use of Item Mailing
  EnableEnderchest: true     // Allow access to Enderchest from ItemMail GUI
  EnableMailCosts: false     // Enable costs to send texts and Item Mails
  EnablePerItemCosts: false     // Enable Costs per item instead of per mail instance
 EnableSendMoney: false    //Enable the Ability to send Money through the PaperMail GUI
  CostToText: 0.0    // Cost to send Text mail messages with /papermail sendtext
  SendItemCost: 0.0   // Cost to send an item(or PerItemCost if PerItemCosts is enabled)
  MailWindowRows: 3   // Size of the mail window
  DefaultBoxRows: 4   // Size of the default inbox which is accessed by left clicking the sign
  EnderChestRequirementID: 368
  EnderChestRequirementDV: 0
  MailItemID: 339   // Item ID of the Item which is used to create item mails
  MailItemDV: 1     // Data value of the Item which is used to create item mails
  MailItemName: Letter paper  // Name of the Item which is used to create item mails
messages:
  inbox-full-send: The mailbox of %recipient% is full, the items have been sent back to you.  // Message displayed when recipients mailbox is full
  ingredient-missing: You are missing %item% to create a new letter.   // Message displayed when missing ingredients to create Letter Paper Item.

Depends

1.0.0.7 and above softdepends on vault if you want to use the MailCosts or Send Money options with an economy plugin. If no economy is detected but MailCosts is still on, Papermail will default to a Gold Ingot barter system.

To do

~~Add permissions .exempt for costs~~
~~Add ability to send money~~
Fix Items losing their NBTTag data when mailing items. (This plugin causes some special items created by other plugins such as the EpicItems from EpicBoss Gold Edition to lose their special tag abilities when mailed through the ItemMail system.
~~Make barter item configurable instead of permanently set as GOLD_INGOT.~~
Create the ability to read from a language,yml to support multiple languages
~~Fix PaperMail mailing the signed book item also.~~ Create a letterpaper dispenser sign that charges GOLD_INGOTS or money for letterpaper.
Change the Recipient Interface to SignGUI if possible
Hook into GlobalMarket so you will only need one mailbox
Create some kind of new mail notification system
Make it that it doesn't take a command to create a chestbox (Chest on a fencepost)
Create a command and permission to send money with command. Possible protocolib dependency for this as well? (Use sign GUI to get amount)

Source Code

Want to see the source code? Here it is! https://github.com/BukkitCodersUnited/paperMail

ATTENTION!!!

I REALLY NEED BUG TESTERS! IF INTERESTED PLEASE PM ME!I I WILL GIVE YOU CREDIT ON THE PLUGIN PAGE AND PLUGIN ITSELF FOR YOUR HELP! (This plugin is provided donation free. It takes a lot of time to code a plugin and testing for all possible scenarios is not easy for me :/ To Eliminate time with releasing stable copies of updated PaperMail versions with new features, bug testing helps alot, plus you/your server will have access to early releases of the plugin before they are hosted on bukkit.)

Acclamades

This plugin was featured on Curse! Check out the Spotlight here : http://www.curse.com/spotlight/bukkit-plugins/minecraft/49271-minecraft-spotlight-papermail

Testimonials

"I use a lot of plugins, but this has got to be the most awesome plugin I have ever used!" -DrkMatr1984