RealMail
RealMail
What does it do?
Plain and simple, it replaces conventional chat-based mailing systems with something real, books and mailboxes.
I'm really glad to finally get this plugin updated and I hope everyone else will be just as excited as I am.
Features
- Physical mailboxes using Dinnerbone's playerhead snapshots
- 4 custom-made mailbox textures and more to come
- Attachments
- No need to ever run a single command (ignore command heading just a little below...)
How does it work?
- Craft a mailbox. The recipe is like an iron helmet in the lower-half with a chest in the center of the helmet and a piece of wool in the top-right.
- Craft some stationery. The recipe is shapless, just a feather and a piece of paper. If the server enables it, you can also use /mail new to spawn in some free stationery.
- Write a letter on the stationery. Stationery is just a cheap Book and Quill that cannot be traded with villagers. If the first line is in the format of [Subject:my subject] , the letter's name will include the subject after being signed.
- Attach an item to the stationery if you like. Just click the item you want to attach in your inventory and click the stationery with it. If you want to take it back off, click the stationery and right-click any empty slot.
- Sign the book with the recipient's name.
- Right-click any mailbox with that signed stationery (now a letter or package depending on if you attached items).
- The recipient will then receive the letter/package in his/her mailbox either immediately or at the time of day specified in the config. Please note that only the owner of a mailbox can open his/her own mailbox unless the other player is an op, has the correct permissions to bypass the lock, or the lock_mailboxes option in the config is changed to false. Also, breaking the mailbox will not drop the letters it holds; it acts like more of an enderchest for letters.
- The recipient can then read the letter and detach the contents if there are any.
*If the recipient's mailbox is full, the book won't be sent and the sender will be notified. *Attachments are pretty buggy in creative, so I recommend going survival when detaching items.
Videos
LtJim007
Wukkit
cobwebster
Commands
- /mail [page-number] - explains how to use RealMail
- /mail version - displays RealMail version
- /mail new - give the player one free stationery if enabled in config
- /mail send - (default:op) send a letter from anywhere without a mailbox
- /mail bulksend - (default:op) send a letter to everyone who has logged on since installing RealMail
- /mail spawn <mailbox|stationery> - (default:op) spawn in a mailbox or some stationery quickly
- /mail open [player] - (default:op) open your mailbox or another player's
To-Do
- Flags go up on mailboxes when unread*
- Economy support*
- More built-in mailbox textures*
- Bulk Mailing to specific groups
- Letter delivery queue to deliver mail every Minecraft morning or another configurable time
- Support for custom mailbox textures
- Blacklist for attaching items
- More letter tags and simpler subject tag
- Offline mode config option*
*Priority
Want to suggest some more features or submit some bugs? Here's a link to my issue tracker. While I'll try to respond to as many comments as I can, my issue tracker doesn't forget whereas I can.
Permissions
All permission nodes are listed on a separate page.
Configuration
Configuration options are listed on a separate page.
Language Support
All language files are listed on a separate page.
Downloads
v0.3.2 - 11/7/15
v0.3.1 - 11/5/15
v0.3.0 - 4/25/15
View Older Versions
RealMail on GitHub
Change-log
v0.3.2 - 11/7/15 *Fixed issue #5: now checks if recipient exists on signing *Fixed issue #6: mail.mailboxPlaced language node corrected *Fixed issue #2: can now send mail through any mailbox when universal v0.3.1 - 11/5/15 *Issue #3: Misspelling of stationery fixed *Issue #4: References to admin commands without perms fixed v0.3.0 - 4/25/15 *Fixed compatibility issue with CommandBook which broke exchanging recipes for mailboxes, found with the help of doitliketyler
As you can see from the statistics above, this plugin sends statistical information to mcstats.org. To disable this, change the line opt-out: false
to opt-out: true
in the config.yml inside the PluginMetrics folder in your plugins folder.
@HunterBloodwood
Since the problem seems to happen after a restart, I would guess that you probably have offlinemode=true in your server config. Currently RealMail uses the new UUID's to identify players since their usernames can now have name-changes. Offline mode is currently not supported because the UUID's are generated anew each offline server startup. The solution would be to have RealMail check if the server is in offline mode and save usernames instead of UUID's if that is the case. I plan to include this feature in the next release because it is asked for quite a lot. If the above is not true in your case, could you PM your RealMail yml files for me to take a look?
@Ha1fBit
We do stop and turn on the server every day since we don't have a host and there were no erorrs in mailboxes.yml just code so we removed it and replaced all the mailboxes in a try to redo the code so to speak we are just throwing idea's in the wind to be honest to fix it. lol
@HunterBloodwood
By any chance does your server run in offline mode and restart each night? Do you get any errors or does your mailboxes.yml remain blank?
Hello, My private server I run with two other friends is actually having alot of issues with this plugin we were able to fix them but namely one issue was after a while of the mailbox being placed by someone like for example I place a mailbox after crafting one a day passes and I check in the morning for any mail i cannot open my mailbox and we have tried reinstalling 3 times over and we are running out of idea's to fix it we really love your plugin and our players love it we don't really wanna switch to another mail plugin ;;
I like this plugin and have recently added it to my server. a couple of things I would like to see though:
1)the ability to spawn in the different colored mailboxes instead of punching them as there is a duplication glitch in creative, perhaps have it GUI style where you type "/mail spawn mailbox" and a GUI shows up with the different colors available?
2)more colors, however I know your probly very limited as to the colors and styles you can utilize (dinnerbones head if I recall) and I just noticed that's a future update to look forward too!
3)my main reason for commenting, I would like the ability to use a nametag on the box to show the players username or whatever slogan above the box.
4)perhaps be able to have a general post box that you can randomly place around spawns or villages without locking onto a players username (unless there's already a way to do that and I missed that option).
all in all a fun plugin that is well worth adding to any server for fun or comunication. keep up the good work!
Hello
I have a problem, I don´t can pack the letters with items. when I left-klick the Stationary with a item i switch from the item to the stationarity. where is meil fail or where kann I fix it? please help.
I use 0.3.0
Hey we're having a small bit of a bug on our server. Everything works flawlessly, up to trying to send the letter/package, when I right click the mail box it ignores that I've got the letter in my hand and just opens the letter. Am I missing some obvious configuration setting? I'm using the latest 1.8.3 build.
Hello, I have found a bug
after the server is restarted, the mailbox does not work anymore
Server Error log:
[01:12:22] [Server thread/ERROR]: Could not pass event PlayerInteractEvent to RealMail v0.3.0 org.bukkit.event.EventException at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:305) [spigot.jar:git-Spigot-e497721-96d09e3] at org.bukkit.plugin.RegisteredListener.callEvent(RegisteredListener.java:62) [spigot.jar:git-Spigot-e497721-96d09e3] at org.bukkit.plugin.SimplePluginManager.fireEvent(SimplePluginManager.java:502) [spigot.jar:git-Spigot-e497721-96d09e3] at org.bukkit.plugin.SimplePluginManager.callEvent(SimplePluginManager.java:487) [spigot.jar:git-Spigot-e497721-96d09e3] at org.bukkit.craftbukkit.v1_8_R1.event.CraftEventFactory.callPlayerInteractEvent(CraftEventFactory.java:226) [spigot.jar:git-Spigot-e497721-96d09e3] at org.bukkit.craftbukkit.v1_8_R1.event.CraftEventFactory.callPlayerInteractEvent(CraftEventFactory.java:193) [spigot.jar:git-Spigot-e497721-96d09e3] at org.bukkit.craftbukkit.v1_8_R1.event.CraftEventFactory.callPlayerInteractEvent(CraftEventFactory.java:189) [spigot.jar:git-Spigot-e497721-96d09e3] at net.minecraft.server.v1_8_R1.PlayerConnection.a(PlayerConnection.java:1153) [spigot.jar:git-Spigot-e497721-96d09e3] at net.minecraft.server.v1_8_R1.PacketPlayInArmAnimation.a(SourceFile:22) [spigot.jar:git-Spigot-e497721-96d09e3] at net.minecraft.server.v1_8_R1.PacketPlayInArmAnimation.a(SourceFile:8) [spigot.jar:git-Spigot-e497721-96d09e3] at net.minecraft.server.v1_8_R1.PacketHandleTask.run(SourceFile:13) [spigot.jar:git-Spigot-e497721-96d09e3] at java.util.concurrent.Executors$RunnableAdapter.call(Executors.java:511) [?:1.8.0] at java.util.concurrent.FutureTask.run(FutureTask.java:266) [?:1.8.0] at net.minecraft.server.v1_8_R1.MinecraftServer.z(MinecraftServer.java:683) [spigot.jar:git-Spigot-e497721-96d09e3] at net.minecraft.server.v1_8_R1.DedicatedServer.z(DedicatedServer.java:316) [spigot.jar:git-Spigot-e497721-96d09e3] at net.minecraft.server.v1_8_R1.MinecraftServer.y(MinecraftServer.java:623) [spigot.jar:git-Spigot-e497721-96d09e3] at net.minecraft.server.v1_8_R1.MinecraftServer.run(MinecraftServer.java:526) [spigot.jar:git-Spigot-e497721-96d09e3] at java.lang.Thread.run(Thread.java:744) [?:1.8.0] Caused by: java.lang.IndexOutOfBoundsException: Index: 1, Size: 1 at java.util.ArrayList.rangeCheck(ArrayList.java:638) [?:1.8.0] at java.util.ArrayList.get(ArrayList.java:414) [?:1.8.0] at com.challengercity.plugins.realmail.RealMail$MailListener.onUseItemEvent(RealMail.java:585) [?:?] at sun.reflect.GeneratedMethodAccessor180.invoke(Unknown Source) [?:?] at sun.reflect.DelegatingMethodAccessorImpl.invoke(DelegatingMethodAccessorImpl.java:43) [?:1.8.0] at java.lang.reflect.Method.invoke(Method.java:483) [?:1.8.0] at org.bukkit.plugin.java.JavaPluginLoader$1.execute(JavaPluginLoader.java:301) [spigot.jar:git-Spigot-e497721-96d09e3] ... 17 more
ask for quick help
I have 1.8.3 with the following plugins: BetterShops, TNTRun, MV portals, MV core, MV Inventories, MoneyMobs, Vault, World Guard, World Edit, Plotsquared, iConomy.
Your plugin and Bettershops working together causes an error
I get the following error.
http://pastebin.com/05tGEnkJ
@Wukkit
Thank you so much! I added the video to the main post. :)
Hey there dude, I did a small plugin review on this good piece of work! :) - https:www.youtube.com/watch?v=sAC8OBSdJj0 Its a really good and effective plugin man, keep up the good work!
@doitliketyler
Thanks to you, I was finally able to fix this bug! Turns out it was a compatibility issue with the plugin CommandBook, but it is now fixed in v0.3.0.
@CloudeLecaw
I knew I'd miss something when working through all the translations. It'll be fixed in the next update.
The custom names for packages, stationary, letters, and the instructions in each will be customizable, I'm just trying to figure out a way to still allow the old ones to be used along-side the newer translations. As it is, the plugin checks the items type and name to see if it is actually a letter, but if it starts looking for a new name, all previous letters will be broken. There's an easy fix though, just search for either Letter or the new name, but if you change the name more than once, some of the letters created and used in between will then be unusable.
Also, the simpler title will likely happen, I was mostly just trying to get the bugfixes out for the new Spigot in this version.
@doitliketyler
A few users are having this problem, but I'm having trouble recreating it. Could you PM me your server settings, server version, Spigot version, and error logs if there are any?
Hey...great idea. One issue I'm having tho is when I go to claim my mailbox the ticket disappears and I get no mailbox in my inventory. Am I missing something obvious? I feel like I am but I can't figure it out.
I will be glad if you move on Spigot :)
@CloudeLecaw
Okay, finally got all of those errors fixed as far as I can tell, and I did recompile Spigot just a few minutes ago, so it should be all good. I also added in some basic language support as you suggested.
@CloudeLecaw
Same issues. Im using Spigot 1.8.3 Ro1: realmail 0.2.8
@ha1fBit
thx a lot :)
@Androkai
I'll have to look at MultiInv and do some debugging, but I'll see if it's possible as soon as I can.
@CloudeLecaw
This will be fixed in the next update. Thank you for finding it and pasting your error log!
I`m using MultiInv which separate inventories in different world(-groups). Sadly this plugins seems not to work with this. Any idear how to fix it?
Thx for this great plugin. It`s really useful and hopefully I can use it :)