PaperMail
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:
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 costsAdd ability to send moneyFix 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
@KJ_Shipp
Not sure what you mean. I just tested this and if I hit cancel, my item drops on the ground. And if I hit escape to close the window, the item drops on the ground. If there's a third way to close the window let me know so I can see if this happens.
Working on paperMail atm. Will address all bugs over the next few days and hopefully get the queue mail system in place once and for all. Thanks for your patience everyone.
@diannetea
Oh, and to delete a mailbox, punch the ground beneath it. Sorry late on that reply.
@diannetea
My Minecraft server was down for about 2 months and I finally got the hardware I needed to set it back up. I will try to fix as many bugs as possible in the upcoming days, and then try to add some of the features you guys have mentioned. Thanks for all of the input guys!
Couple of other things. How do you delete a mailbox (punching it in creative doesn't work)..
The letter papers aren't working for me at all, only mailboxes
And is there any way I could configure what the Recipient paper says? I think it would be much clearer if it said something like "Title a book with the player's username that you are sending the mail to, then place it here." (lol my mom just fell victim to this, she said it won't let her define a recipient)
Um, so I have a few requests (I know I'm a pain :( ) Instead of having to write books with the player title, would it be possible to make a like, "written letter" where the name of the paper is the users name and the body is any text they want? so they have to be holding a paper, and they can use something like
I used the lore plugin I use to make an example:
And maybe the ability to define formatting in the config? So like all usernames are &b and all body text is &f
I'm just going to assume it's supposed to be players/name.yml and not players\name.yml
@AT_HE
Thanks for the bug report! I've taken a month long siesta from programming but I should get on fixing this stuff immediately. I am so sorry for the bugs and the late responses. When adding new features there are always bugs to work out, but new features are what makes a plugin better over time.
thanks, your plugin is very nice and useful .. but..
i noticed every time i send a mail message, it generates a "paper item" ... that way nobody will farm sugar canes to get them
in addition, somebody could send a lot of mails, get the paper and make books or sell it to villagers .. that sounds like an exploit to me, can you correct this?
Major bug that needs to be addressed. If you place something in the PaperMail GUI but dont hit send or cancel, it just disappears. This is going to cause a lot of problems for players and Admins alike. Using version 1.0.1.3 on correct bukkit version.
This plugin looks like exactly what I was looking for. I'll beta test for you. Do you want us to use the development build?
@DrkMatr1984
Indeed, I do like the idea of the bank note. I thought it was pretty cool to have something that you could deposit like a check. Hopefully there's a way to retain that somehow while finding a way to increase the amount you can send.
Also, when someone sent me stuff, even though he didn't mean to send money, I still received a bank note of 0.
There's a plugin I use called GemXP that you can store XP in an item of your choice (like ender pearls). Maybe you could be required to craft a bank note (similar to the letter paper, like with a gold nugget instead of ink, or maybe just use the letter paper itself for a dual purpose) then right click somewhere with it to manually set how much money you want to add to it. Then you could just put it in the sign/chest with the other stuff to mail when it comes down to it.
Not sure how doable that is but that's what came to mind lol
@Icedevimon
"Speaking of money, the price to send mail doesn't seem to be working for me. Even though I have it set to 10 per item it's saying it's charged 0 when I send the item."
I'll look into that immediately and fix it with the next bugfix update.
@Icedevimon
Yeah, Icedevimon, I thought about the mailbox on a fencepost thing. There's a similar plugin that does this. I might be able to implement that.
About the sending money thing, I COULD make it a command, but then the plugin would not be very unique, would it?(albeit, the bank note item would still be somewhat unique). The only other way I can increase the amount able to send would be implement Protocolib to use the sign GUI to collect a value of the monetary amount. I think at the very least I can implement a command to send the money and a new permission to use it for those who want to stick to the GUI method for roleplaying.
Finally, Yeah, I will definitely add a notification system. I use essentials on my server and that give mail notifications, it only stands to reason any other simple mail plugin should do the same.
All that being said, It might take some time to implement it all! But definitely look forward to some of those added features in the future. There's already a small bugfix in the works that fixes a problem where when you send money with no items it still charges you one moneys for sending an item.
I've been messing around with it a little. So far, I second the idea for a mail notification if something's been received. There's no way to know right now.
Also, I find the maximum money that you can send to be very very low. Only 64? I wonder if there's some other way to do it. 64 is not much on my server XD Guess our scale is very high.
Speaking of money, the price to send mail doesn't seem to be working for me. Even though I have it set to 10 per item it's saying it's charged 0 when I send the item.
I also wonder about needing to use a command to make the mailbox stored in a chest. Is there any way to make it automatic if you place the mailbox sign on a chest itself?
I don't see anything about this in the plugin's info, but it would be nice if there was a notification when someone logs in, or that repeats at a configurable time to notify them that they have mail.
Love This Plug Using it on my server working great so far let you know if i have any problems :)
@Melonking
Thank you! MelonKing, Would you like to be a bug tester? early release to plugin updates, and quick fixes for bugs are some of the perks, plus I'll add your name to the Contributors list.
Getting this error on the latest build, did not happen on the old one!
PaperMail v1.0.1.3 Uploaded and Pending Approval! File number 14. This version changes values in the Config so you may need to delete your config.yml and let a new one spawn. Config now has EnableSendMoney as an option. Set to true to allow players to send money. :) (False by default) Updated Pom to include CraftBukkit 1.7.2-R0.2-SNAPSHOT. Finished adding in support to send money. Money is sent by clicking the Gold Bar GUI item. After the money is sent to the player, the player will find a "Bank Note" (A piece of paper) item in their inbox which they may then right click to deposit their cash.
@AielloBrothers
Der_Wisch is MIA and I don't have access to the LoreLocks Bukkit Page. He passed development of Papermail onto me several months ago. I currently have several other side projects going on as well as this plugin, But if I can get ahold of Der_Wisch I would gladly take over dev for his other plugin as well.