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
Any News on the update? :)
In reply to thief001:
Any sneak peaks? ;D
Looking forward to the next release.
Exciting news!!! I can't wait for the new release!
@ozanalp200
Just to Keep you all Updated on the Progress :
UUID Support : Done
language.yml: Partially completed
ProtocolLib to get input for recipient/amounts: Partially completed
I've also decided that when mail is sent to a user, the mail will now appear in their inbox as a letter as usual. However, if there are item attachments, the user will be able to right-click the letter item to open up a new inventory GUI with the items in it. This way each inventory sent to a user is saved with the letter, so the only way for a mailbox to be full is if the user does not check their mailbox for a while. Even then, PaperMail will queue the letters up.
Thanks
@madtomic
It's coming! I'm working on a rewrite currently. It will include a new mail notification system, improved mailing queue, a language.yml, sending mail to groups(possible optional Towny support), and an Enderchest fix, as well as perhaps a few more features. When I added a bunch of things to this plugin a year ago I was an incredible Java noob, and it's amazing I was even able to do some of the things I did with the knowledge I had(I didn't even know what a Javadoc was or how to access and read the bukkit api reference online, I taught myself from examining code on GitHub and googling.). Needless to say a rewrite is definitely in order, to improve efficiency, fix errors/bugs, and add a few more features into the plugin successfully and smoothly. I can't say how long it will take, as I am currently starting my own server, so I am constantly finding myself fixing other people's plugins to make them work on my server or coding some new minimalist plugin to provide a feature I desire, but I have started on it and should be getting to this plugin shortly. I'm also in the process of helping Wizzledonker update and add features to TrainTicket and helping izbay update StableMaster, and I made two new plugins, UnLivingHorsies and the yet unfinished BetterBoots, so I've been a little busy :P Thanks so much for your patience guys. I think to hold you guys over I can try to pump out a 1.7.9+ version of the current plugin and upload it until PaperMail 2.0 is released.
cb1.7.9+ support?
Good to hear your back. Looking forward to the next update.
@thief001
That will definitely help!
I'm back on the programming scene with my new plugin coming out, BetterBoots, and the release of www.MyekaanCraft.com Towny RPG Server coming soon. Expect an update to this plugin after the 1.0 release of BetterBoots.
nice,
thank you so mutch.
on a sidenote:
ill test it out, if it helps you in any way.
@Zauber55
Hey guys, sorry I have been SOOOOO lazy. I'm thinking about doing a recode on this plugin when I implement UUIDs and the Language.yml with the upgrade to 1.7.10/1.8 to come. Probably will make protocolLib an optional dependency since many other plugins require it anyway.
@Zauber55 > Disabling the Enderchest is something I screwed up in the code when I first got the plugin. I'll attempt to fix this in the recode. Also, I can add a permissions node for creating mailboxes when I do the recode.
@thief001 > Will be fixing the left clicking of mailboxes. I may be able to implement sending to groups/all when I do the recode. I'll include things in the update logs to let everyone know what's been fixed/added.
Hello It is a great plugin, but I have a question is there a way to stop everyone building mailboxes? And another question I am not able to change configurations like disable enderchest any ideas?
hi,
love this plugin, but i wonder if theres a way to send a message to all players at once?
so if i have an anouncment, i can sent it to all player without having to change name for anyone?
like using the permissionex goups for recipient?
on a sidenote:
when i leftklick a [mailbox] sign, i got in to an in chest, but theres nothing in, even if i have a mail... any way to make it show my inbox when cklicking? remote?
so if im in a postoffice at the other end of the map i dont have to travel all across just to get my mails...
thx, and keep up the good work :)
@Techwolf77
I should be able to get to it this weekend. Not sure if I'll have anything somewhat stable or not but I'll try. I tested a simple update I did on my own test server and it seems there's a lot more work to do for this 1.7.9 update than some of the previous updates. :( Hopefully it won't be anything too large.
When do you plan for this to be updated?
I could also help you test the plugin! I need it for my RP server too.
@PrimerBlock
That's just a versioning error that will be fixed easily with the next update, with will also implement the UUID changes and sport a language.yml. If you see I don't have a version for 1.7.9 released yet...
@Hmmcrunchy
I'm getting a similar error too. But I am trying with the latest version of Spigot and have also tried Craft Bukkit 1.7.9. Also can't send or receive mail. May be this version is not compatible with the new UUID update? I'll post a more detail bug later.
hi there
i seem to get this on login
http://pastebin.com/LHBxxr3Y