BookMailbox
BookMailbox
BookMailbox is a plugin that you can use to send written books to player's mailboxes. Players are notified if receive mail while they are online. Its like your own personal Minecraft-Amazon service.
Features
- Make your own mailbox and receive books
- Protection for mailboxes
- Offline messaging
- Send books to your friends
- Flatfile configuration
- Simple to use
The box
Basically you use a single chest place a sign on a space above it.
Right click the sign and your ready to receive mail.
Sending
- Command
- /mail {player}
- Sends mail to that players box if they have one.
- (Must be holding the book you want to send.)
- Node: bookmailbox.command
Permissions
bookmailbox.admin - overrides protection for mailbox.
TODO
Add economy support to charge players for books sent.
Add notification for joining players to check mail.
Add alternate databases for storage.
Limitations
Currently players only get one box. If they move to a new unassigned mailbox then the box and protection move with it, but not the books contained in it.
Source
One of my favorite sites. GitHub
Changelog
Version 0.4
- Updated to support 1.7.2-R0.3
- Corrected to support names of infinite length.
- Performance improvements for location-to-mailbox searching.
- Miscellaneous bug fixes
- Code cleanup
Version 0.3
- Changed ownership-checking method to utilize internal config instead of sign
- Formatting re-added to player name on sign
Version 0.2.1
- Bug fixes
Version 0.2
- Supports names up to 30 characters
Version 0.1
- Creation
Video
By Pixler2
Hey just the plugin i'm looking for, and funny how you made it :P now i know why its on the server and working like a charm!
Sweet and simple. I like plugins which I understand on the first sight.
Suggestion: /mail_all sends to all players with a mailbox. Restricted to operators.
Suggestion: public mailboxes for distribution of newspapers. Sign format:
1: [Mailbox]
2: [daily_news] (newspaper name in brackets)
3: player name (in this case sign creator, not receiver)
4: Date and Time of issue (or "sold out" if none)
Command for newspaper distribution is /mail [daily_news]. Brackets indicate the newspaper name. Multiple chests with the same sign could serve as distribution points for the newspaper. Multiple newspapers could co-exist, e.g. [weekly_mirror] in the third line. Would require special permissions for creating and submitting/sending.
An update has been released and is currently awaiting approval from BukkitDev staff. This update should fix a number of issues.
First off, it's now built for 1.7.2 (R0.3). Names of (theoretically) infinite length are supported.
A few other changes were made to the way signs are updated. When the book count is greater than 0, the colour will change. Also, the book count will update more frequently, such as when a player removes/adds a book by hand, and when a player sends a book to an unloaded chunk.
I have begun updating the code to work better with names of length greater than 15. I'm hoping to have an update out within a week.
I love the concept and execution of this plugin. However, it's malfunctioning on my server (Running CB 1.7.2 R0.2). I also realize this could be a conflict with other plugins, so who knows for sure? But the issue we're having is our mailboxes after a short time become unopenable. We have to break the chest and sign and replace them to fix the issue, but then it just happens again after a short time. Seems just about all the other book mail plugins I find weren't updated since about 1.6.4
Can you make some link's i searched for alternate databases and couldent find it please i need this plugin
Thanks for the continued support.
A nice feature would be to send other items with or without the letter
I have decided to further development on this plugin. I have just submitted the next version (v0.3), which no longer relies on signs for Mailbox ownership-checking. Signs are still used for displaying information, but ownership checking is now done through the internal configuration (as the owner and player names are stored).
I'm hoping to optimize this further by redoing the configuration file, possibly making locations the primary key in the config, but this is still in the planning stage. If Death_Marine, PlanarWarp, or any other developers would like to assist, feel free to fork our code and send a pull request. You can access the most recent code here.
Enjoy!
@Jikoo_K
Thanks for sending in the pull request! I have been a bit busy with other stuff to be able to work on this, so I'm glad someone else has taken some initiative in fixing it. I will upload it in the next few minutes, so expect it to be available in a couple days.
Sent a pull request with fixed 16 character name support to Matt.
A side note: You may want to either add Matt to the original repo, or change the source link.
@mattfielding
Today I looked at your code, realized what my issue was before.
sign.setLine(2, event.getPlayer().getName().substring(15, 15)); should be sign.setLine(2, event.getPlayer().getName().substring(15, 30));
I could be mistaken, I don't often use Java any more, but that would explain my problems with the guy with a 16 character name.
@solo7319
Mailboxes are stored in a database - you can't just write a sign and receive mail in a chest under it, the "box" has to be registered with the plugin. If User1 wrote a sign over a chest like that, it would just be a sign over a chest afaik.
You can also remove 1 if from the code to allow it to send any item... I'd imagine that support for every item won't be added by the devs, it's BookMailbox :p
@mattfielding @Death_marine ; This plugin looks pretty cool. The only reason it's not on my server already is because there are a few things that I'd like to see added. First; can any player make a mailbox for any player? I.e; can <User1> write a mailbox sign with <User2>s name on it? I know that user2 wouldn't be able to open the chest, but it would take the protection off user1's real mailbox; allowing user2 to open the real mailbox and steal user1's mail. If user2 was smart, he'd then change the mailbox back, so that no one would even know that the theft had happened...
Obviously I'd like to know if this could happen. It would be easily remedied by adding 2 permissions nodes; bookmailbox.create.self and bookmailbox.create.admin, the former allowing creation of only mailboxes with your name on it, the latter allowing creation of any mailbox.
The second feature that would be cool is support for item transfer in addition to book transfer.
can you add item sending
@mattfielding
Started running your v0.2 because I have a user with a 16 character name. Remade all the mailbox signs, his still doesn't work. Only puts the first 15 characters on the second line, then /mail [hisnamehere] returns mailbox not found
Edit: I didn't try using our sign editing program to put the last character of his name on the third line, but one assumes that I shouldn't have to >.> Probably should have thought of that before posting, though.
One thing I forgot to mention with 0.2 is that, because it now extends the player's name onto the third line (for longer names) and colouring is removed from the second and third lines, it will NOT work with signs created with older versions of BookMailbox.
So, here's a quick breakdown of the two versions I have compiled:
v0.1 (fixed)
v 0.2
Hope this clears up any questions you have. If I do end up continuing development on this plugin (as its authors seem to be busy), my next step is to completely remove the player-name sign dependence and use the data stored in config.yml (as it seems to already store mailbox locations).
I'll try to keep you posted!
@mattfielding
Yeah I tried your version (0.2) but i am getting the same error for all my users except op...
@lord_moonscar
Permissions are supposed to be only for admins to access all chests. No other permissions are required. However, there is a bug in the currently posted version (v0.1) which checks the wrong line on the sign for ownership. I have uploaded a fixed version already, available here. This version now supports player names of length up to 30 (by allowing the name to continue on the third line).
@Death_marine: Would I possibly be able to become an official contributor to your plugin? People need a bug-free version of the plugin, and that's what I intend to give them.
Can you make permissions optional in the config ? Or one without permissions ? Thank you Bedbug1226
@mattfielding
regular players can use the box's if you give them admin perms, and have a plugin like LWC installed. This way they can access their mailbox, otherwise, I found on my server they couldnt.
@ Death_marine, I just want to say that your plugin is amazing, it is one of the most crucial plugins on my server as I use it to conduct voting competitions and many more things. Thank you so much for your work. I will donate when I can. <3 Cat