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
@Icedevimon
I might be able to work on shipping fees, sending money, and linking vault into the plugin. Next weekend I have off I'll work on it. I'm thinking I'll make shipping fees configurable in the config file and do that first as well as the linking with vault. Ill do sending money after that as that might require quite a bit more coding as I'll have to edit the GUI also. Anyway interested in helping me code the plugin, check out my github
https://github.com/DrkMatr1984/paperMail
Could be great if you implemented shipping fees by linking into economy plugins. It's been hard finding a plugin that works for me because each one that looks great ends up lacking one aspect I want lol
@shadvalentine
yeah, PEX doesnt support negative permissions. Try giving only Admins papermail.* and add the individual permissions for other Users and groups custom based on who you want to use this plugin.
@MikeGold
Im sure if you use gringotts or physiconomy or something with a Physical Money system you can send money. As for accounts such as vault and most economy plugins use, no.
Is the economy supported in this plugin? Can I send money?
@DrkMatr1984
Hey GeekTechMedia, I just looked into that thing you said about not being able to use the plugin while opped and you're correct. It sort of works, but is a little buggy. However, I also see why Der_Wisch made the plugin this way. In order to pick your mail up from the [Mailbox] Sign posts, you must left click. On survival this won't destroy the sign, but opped players in creative are able to destroy the signposts while non-opped players will see the sign destroyed for a second and then respawn, but are still able to retrieve and send mail normally as if on survival, thus making it easier to run this plugin on a Creative Mode Server without having everyone destroying your mailbox everyday :) (and without the use of a protection plugin)
@GeekTechMedia
Thanks man, I'll look into that. I'm still finding out the ropes of this program, I recently took over the project. I run my own craftbukkit server myself of course. Between keeping up with updates with that, my job, etc etc I haven't had a lot of time to address issues. I'll see how it handles name association with the mailboxes and let you know if there is a way to work around the nickname problem. Also, I'll check out the opped thing, although I'm pretty sure I've tried this before on my own server and it worked..
A couple suggestions. You cannot operate a mailbox when opped, also I noticed you can not use a mailbox when you have a nickname (at least the inbox does not work). I am not sure if there is a way to override this but that is what I have come across so far. Thank you and great plugin.
The Geek
@shadvalentine
Does peX Support negative permissions? I know a few dont. I know Group Manager does. Might want to check on that, it might be peX and not this plugin.
this plugin looks great .. however .. the permissions don't work for me .. I have added
- -papermail.*
but it did not remove the permissions from the players .. I use permissionsex
Starting work on the Postbox. Give me a month or two.
Opps, The update says "DrkMatr1984 for CB". I mustv'e mislabeled it during the upload. If you click on the link, you will see that it is indeed the correct file however.
@Der_Wisch
Thank you again, Der_Wisch for allowing me to assume management over this plugin!
Papermail v. 1.0.0.5 for Craftbukkit 1.6.2 R.01(Also works on R.02) uploaded and waiting for approval.
First of all I want to apoglize to all people who used or still are using papermail.
I'm too busy with work at the moment (and most likeley also for the near future) to maintain two plugins.
I've given the plugin to DrkMatr1984 because I don't want the plugin to vanish.
So this is it.
I'm sure DrkMatr1984 will do his best :)
@Melonking
Inbox me if interested in a working release for 1.6.2.
This update would be quite nice to have, this plugin has been non functioning since my server went up 2 months ago.
As I had much trouble with examns in the past months I had not much time to maintain this plugin.
My deepest apologies for this.
As I've finished examns now expect an update to the current version soon ;)
Errors on the latest 1.5.1 beta
Please create a post box! Which when you stick your letter in it, it send it to the player you put as the "signature". Maybe create an envelope item?