xMail
xMail
DISCONTINUED
This plugin is no longer maintained. Support is no longer provided and updates will not be issued. If you would like to take over the project, please contact me.
xMail is a Bukkit plugin used to send messages and items to players on other servers, or locally. With a few simple commands you can send a message to your friend to join you on your server, or you can call over an admin to help with a server emergency.
xMail doesn't stop there, of course. xMail also allows you to send and recieve mail ONLINE at xmail.turt2live.com, allowing you to always know what's going on. xMail also offers you the ability to mass-send mail, and send mail to the consoles of servers if needed.
xMail is incredibly light weight as everything is handled on the xMail servers, all you have to do is drag and drop and you're good to go.
Cool features xMail supports
- You can send mail to the console of any server, including the one you are on. To do so, send mail to 'CONSOLE@<server IP>'. If you want to send mail to the current server you are on, simply send mail to "console".
- You only need to login once to be logged in on any xMail server you visit.
- xMail supports the client mod SimpleNotice
- xMail allows sending of items and (soon) money.
- xMail can be used on a cloud server without ever needing to visit the xMail server. This means you can create your own xMail server and tell xMail to connect to it rather than the world-wide server
- xMail has an API for other plugins to use. Hello developers! If you want to hook into xMail, look at the downloads page
- MAILBOXES Yes, you can send "snail mail" to people with books. Just don't put your diamonds in the box...
BUGS / ERRORS / SUGGESTIONS
For errors and/or bugs, please use the ticket system. Reports will be ignored (and likely removed) if left in the comments below. If you have a "critical" bug (like a duplication glitch) that you do not want posted publicly, please use the contact form found here.
"What are the comments for?" - The comments are for suggesting features, asking quick things (like permission nodes, commands, etc) and are NOT for posting bugs. Feedback is also appreciated in the comments.
Download
Permissions and Commands
Permissions
- xMail.send = Allows sending of mail
- xMail.sendchest = Allows sending of chests
- xMail.build = Allows players to use /xmail build
- xMail.creative = Allows creative mode protection bypass
- xMail.mailbox = Allows mailbox use
- xMail.anymailbox = Allows the use of any mailbox (not for peeking though)
- xMail.inbox = Allows reading of mail
- xMail.login = Allows login/registration functions
- xMail.masssend = Allows /xmail masssend
- xMail.reload = Allows /xmail reload
- xMail.warn = Allows the player to get notifications of large mail
- xMail.sendlarge = Allows the player to bypass the large mail restrictions
Commands
- /xmail help [page #] = Help command
- /xmail build = Create a new mail message using steps
- /xmail inbox <page> = View inbox
- /xmail sent <page> = View sent mail
- /xmail readmail <page> = View read mail
- /xmail read <id> [folder] = Read a message from folder, folder is optional and defaults to inbox
- /xmail readall = Mark all mail as read, fetching all attachments
- /xmail send <to> <message> = Send a message
- /xmail sendchest <to> <message> = Send the targeted chest's contents to someone
- /xmail reply <message> = Reply to your last read message
- /xmail register <password> = Register for an xMail account, your password is hashed before use
- /xmail login <password> = Login to your xMail account, your password is hashed before use
- /xmail logout = Logout of your xMail account
- /xmail masssend <message> = Send a message to all known xMail accounts on the local server
- /xmail reload = Reload the plugin
- /xmail status = Get information about you
- /xmail simplenotice = If SimpleNotice is installed, you can toggle whether or not xMail will use it for you only
- /xmail version = Get the xMail version
Source?
xMail is an OPEN SOURCE project, plugin side. The plugin source is located on GitHub. If you would like the server source (or downloads), please visit the xMail downloads page.
Custom Servers
xMail allows you to run your own server rather than use the turt2live "main" server. If you would like to do this, make the choice of the xMail PHP server, or the xMail Java Server. If you have issues setting the servers up, please contact turt2live. Instructions, and downloads, are available on the xMail download page.
IRC Support
xMail does have an irc bot hanging out on EsperNet (#turt2live) for you to check and send basic mail. Want to run an xMail IRC bot on your own server? Check the xMail downloads page.
Need an IRC client/don't know how to connect? Use this simple client. (Provided by EsperNet)
Large Mail Blocker
Because xMail is cross-server, in versions 1.4.0+ there is a system in place to help with economy and player transfers. If configured, xMail will disallow (by default) any "large mail" messages. With the defaults, a "large mail message" is one with 257 items, $501, or 8+ diamond blocks. If any of the conditions specified are matched, the plugin can either deny, warn, or do nothing with the mail message.
By default xMail will only WARN and not deny. You will have to specify xMail to deny messages as needed. Check out the 'large-mail-rules.yml' file for more information.
Feedback and Suggestions
If you have anything you'd like me to know about, please let me know!
xMail PHP Server Updated
The xMail PHP Server (the "custom" server) has been updated (finally!) to support the latest versions of xMail.
You can download the server software from here.
There is a demo of the NEW website interface here, if you like. The web interface is designed to be simplistic, it is supposed to be replaced.
@Anokka
I can look into it, yes.
@SonarBeserk
I have no plans for it, but there is a built in API to send mail to people (with items).
@turt2live
thanks! also, is there any chance you will make console able to send mail with items in it? i would love to use xmail to deliver my donation packages.
@SonarBeserk
The config has that setting just for that reason.
Under "settings" is "server-ip", change that to your liking.
(If you wanted you could change it to "derp" to make the console's name "console@derp")
is it possible to have messages sent to console localy use the domain name instead of the true ip? i want to use domains instead of straight up showing the ip itself.
@In5aN1aC
What was the message?
There is support for per-player settings in the plugin. All that needs to be done is the web side (xmail.turt2live.com) to actually apply the settings.
For a plugin like this I don't feel it's right for servers to decide what the user sees, so that's why I made this system.
@turt2live
Looking great.
Could You possibly add a Per-Server (server-side) option for a few of the messages or something. Have 2 minor complaints:
1. All of a sudden, the server went down, Know this doesn't happen often, and this time it was your update, but at least 7 players complained because it was spamming a message every 60 seconds.
Some kind of option to disable certain player messages would be nice. Also, I personally Think any kind of unnecessary notices on login is horrible, as if there is more than one or two lines of text, players will not read any of it at all, which is bad when you have rules / important notices there, so a server option to disable notices for successful login / uneventful events would be nice.
(just my two cents since I was basically forced to take the plugin off when 7+ people complained about the constant spam.)
Version 1.2.0
This is basically a 1.4 update. See the files tab for download :D
@In5aN1aC
No need to compile it yourself, I have a Jenkins for that. (link)
The official xMail server (xmail.turt2live.com) will always support the development versions as well as the previous releases. Everything should work as expected otherwise.
Although, make a backup, just in case. If xMail has some weird bug in the development versions, it's not my fault (until I release it).
@turt2live
I see you've been making a lot of commits recently. Is any of this cool stuff you've been adding ready at all (if I compile it myself) or does much of it rely on back-end that is not necessarily there yet?
@In5aN1aC
Maybe I'll add a way for users to edit their settings. As per-server settings and globally setting them isn't exactly the best idea
@turt2live
Awesome. Think i'll be putting it on the server pretty soon here.
Really the only complain / worry I have about the plugin, is that I like as minimal "spam" on server join as possible.
(in my mind)
In a perfect world, If you automatically get logged in, and have no mail, it wouldn't even say anything. And would only notify you if you didn't have an account / not logged in / error / message.
I forked your code on github, and was gunna just make my own build with some of that removed / slightly modified, but I didn't see an easy way to do that, as the login is async task (as it should be) so I couldn't figure out an easy way to return the success and notify the user and such, since it's not my code xD
anyways, thats my only complaint. we'll see how the users like it.
@In5aN1aC
Blocking of external 'attachments' is now supported in the dev versions.
At the bottom of the configuration is 'routing'. It's pretty self-explanatory.
Jenkins: CLICK MEH
(Yes, it's stable)
@In5aN1aC
It's already supported, just hidden. I'm working out a few bugs (like replying to emails) that need to be ironed out.
@turt2live
Well, that's awesome. (and that means you are too :P )
I suppose I'll install it for now, and just have items disabled until that's possible.
I Really like being able to read & send in-game mail, even while not in the game. A feature that would be awesome (although I can see it would be more technically-difficult) is a way to actually integrate this with real e-mail. However, I can see this getting exploited for spam, and such, so maybe that isn't the greatest idea :)
Still, pretty awesome, none the less.
@In5aN1aC
Not currently.
I guess I'm making a version 1.2.0 :P
Hmm really like the idea & execution of this plugin.
I'd like to put it on my decently-populated server (I don't know why no-one uses this plugin I alone would double your players in the mcstats graph :/ which is disappointing, because It's a really cool plugin.)
Anyways, I have a question that I'm not sure how to configure / solve.
I want my players to be able to receive all mail and such, but is it possible to still allow users to receive items, but only when that item originated from my server? (rather than exploiting and sending from another server, as the config makes me think is possible.)
@HammyHavoc
It's not outdated, I just forgot to change the text (I'll do that right away).
As well, I've designed xMail so you can use any plugin version with any server version, depending on the age of either though some features will be missing.
According to your website, the PHP custom server zip file is outdated, is there any plan to update this? Is there any alternative? If I want to use the outdated version then am I required to use an older version of xMail on my Minecraft server? I'm currently working on integrating this into an iOS app via Xcode for our server, Split An Atom Gaming. Absolutely brilliant plugin concept.