Overview - Mail - Bukkit Plugins - Projects

Mail

Table of Contents

What is Mail?

This plugin was originally based off of the functionality found in Minemail. This plugin is a fully-featured mailing system that allows you to send mail to any player. All data is backed up and stored via MySQL for easy access and for organisation. Almost everything is fully customizable and documentation on this can be found here

Features

DeityAPI integration
Econ support (If values are configured to 0, this will be disabled)
Mail that is close to another sent will be disregarded. Check v12.07.19 change-log
MySQL
Permissions/SuperPerms support
Locally referenced mail id's
Mail to offline players
Notifications when new mail arrives
Language.yml to change the plugin to suit what your server needs

Requirements

DeityAPI
MySQL (no flatfile support atm)
Permissions (SuperPerms supported)

Commands

/mail reload: Reloads the config and all mail (requires Mail.admin.reload)
/mail convert <old-table-name>: Converts the old mail data to the new format (requires Mail.admin.convert)
/mail inbox <read|unread>: Checks your inbox (requires Mail.general.inbox)
/mail read [index]: Opens the specified mail (requires Mail.general.read)
/mail [write/create/new] [receiver] [message]: Sends a new mail (requires Mail.general.write)

Set up

Place Mail.jar within your plugins folder
Profit??? Optional: you can change almost every user message and formatting via the language.yml file

Extra Links

Source: GitHub

Documentation: Wiki

Stats

Comments

_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#48 _ForgeUser6866240

View User Profile

Send Message

Posted Feb 14, 2012
@ALexisB02 ill look into it

@watarimon ill edit the message a bit. The "invalid syntax" is simply being put out because you dont have any mails and its to remind you of the command list.

@kcorb90 signs cannot store enough text on them and its just plain hard to read from signs.

Rollback Post to Revision RollBack
_ForgeUser6154406
- Join Date: 12/18/2010
- Posts: 39
- Member Details
#47 _ForgeUser6154406

View User Profile

Send Message

Posted Feb 14, 2012
Can you make mail boxes using signs? That would be awesome if this has that.

Rollback Post to Revision RollBack
_ForgeUser7956475
- Join Date: 11/27/2011
- Posts: 125
- Member Details
#46 _ForgeUser7956475

View User Profile

Send Message

Posted Feb 13, 2012
Running a /mail on an empty inbox gives this

[Mail] Your inbox is empty! [Mail] Invalid Syntax, use "/mail ?" for help.

With mails present in the inbox I don't get the syntax error..?
Rollback Post to Revision RollBack
_ForgeUser8260841
- Join Date: 1/15/2012
- Posts: 17
- Member Details
#45 _ForgeUser8260841

View User Profile

Send Message

Posted Feb 11, 2012
I checked several times, the file is ok but not working ...

Rollback Post to Revision RollBack
_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#43 _ForgeUser6866240

View User Profile

Send Message

Posted Feb 9, 2012
@arsjet Im sorry i am confused as to what you are trying to say. What does a minimum word have to do with sending mail in japanese?

Rollback Post to Revision RollBack
_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#41 _ForgeUser6866240

View User Profile

Send Message

Posted Feb 8, 2012
@ALexisB02 check it against a yaml file validator to verify that the spacing is all correct.

@arsjet There is no word limit, however im going to assume you mean the minimum. If someone is sending you a mail that is under 3 words, chances are its unimportant. However i may in the future

Rollback Post to Revision RollBack
_ForgeUser7463114
- Join Date: 8/29/2011
- Posts: 15
- Member Details
#40 _ForgeUser7463114

View User Profile

Send Message

Posted Feb 8, 2012
Please add a setting that disables the word limit.

Rollback Post to Revision RollBack

_ForgeUser8260841

Join Date: 1/15/2012
Posts: 17
Member Details

#39 Posted Feb 7, 2012

I use the variables allowed as you can see in this post, and don't work. =(

header: '&7[&cMail&7] &f'
mail:
  inbox:
    new:
      general: '&aTu as un nouveau message !'
      singular: '&fTu as &a%numMessages nouveau message &fdans ta boite aux lettres !'
      plural: '&fTu as &a%numMessages nouveaux messages &fdans ta boite aux lettres !'
    check: '&fUtilise la commande &b/mail &fpour verifier ta boite aux lettres.'
    empty:
      general: '&fTa boite aux lettres est vide !'
      other: '&fLa boite est vide.'
  delete:
    singular: '&fSuppresion du message &a%messageNumber reussie.'
    plural: '&fSuppression de tous les mails reussie.'
  sent: '&fTon message a ete envoye a &a%messageReceiver - %messageMessage'
  message:
    long: '&7[%messageLocalIndex] &f%messageSender: &7%messageLongMessage &8[%messageSendDate&8]'
    short: '&7[%messageLocalIndex] &f%messageSender: &7%messageShortMessage'
  error:
    permissions: '&cTu ne possedes pas la permission pour faire ca.'
    help: '&eCommande invalide, utilise "/mail ?" pour voir les commandes.'
    invalid_selected: '&cCe message est introuvable.'
    not_long_enough: '&cTon message doit etre plus long que &4%messageLength mots.'
  command:
    header: '&c--[Mail Command Help]--'
    command: '&3%command: &b%explanation'

_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#38 _ForgeUser6866240

View User Profile

Send Message

Posted Feb 7, 2012
@bazookapooka the name extra for reading mail is only present to people with the admin permission node. Its an optional value that will allow you to read other peoples mail specifically. the same goes for '/mail <name>' you can just use '/mail' and '/mail read [number]' to interact with your own mailbox. I shall take a look at the updating notifications as well. And ill get the thread updated. thanks

@ALexisB02 As long as you are using the possible values defined in the wiki, you should be able to convert it to any language.

Last edited by _ForgeUser6866240: Feb 7, 2012

Rollback Post to Revision RollBack
_ForgeUser4901962
- Join Date: 8/24/2010
- Posts: 33
- Member Details
#37 _ForgeUser4901962

View User Profile

Send Message

Posted Feb 6, 2012
your plugin is awesome ! i love that its simple

oh yea when i get a mail from someone and read it, when i rejoin , it still says i have a new message even though it has already been read unless i delete it.

also the commands can be a bit confusing cuz at first i thought i had to type the senders name to read the message /mail read name number

maybe can change so we dont need to type the name and just be like /mail read number

other than that, it is awesome . very simple and configurable :)

also you might want to update the version number for the plugin thread cuz i thought this was outdated till i clicked link to bukkit dev

Last edited by _ForgeUser4901962: Feb 6, 2012

Rollback Post to Revision RollBack

_ForgeUser8260841

Join Date: 1/15/2012
Posts: 17
Member Details

#36 Posted Feb 5, 2012

Hi ! Can not make it work in French. Why ? With this :

header: '&7[&cMail&7] &f'
mail:
  inbox:
    new:
      general: '&aTu as un nouveau message !'
      singular: '&fTu as &a%numMessages nouveau message &fdans ta boite aux lettres !'
      plural: '&fTu as &a%numMessages nouveaux messages &fdans ta boite aux lettres !'
    check: '&fUtilise la commande&b/mail &fpour verifier ta boite aux lettres.'
    empty:
      general: '&fTa boite aux lettres est vide !'
      other: '&fLa boite de %player est vide.'
  delete:
    singular: '&fSuppresion du message &a%messageNumber reussie.'
    plural: '&fSuppression de tous les mails reussie.'
  sent: '&fTon message a ete envoye a &a%messageReceiver - %messageMessage'
  message:
    long: '&7[%messageLocalIndex] &f%messageSender: &7%messageLongMessage &8[%messageSendDate&8]'
    short: '&7[%messageLocalIndex] &f%messageSender: &7%messageShortMessage'
  error:
    permissions: '&cTu ne possedes pas la permission pour faire ca.'
    help: '&eCommande invalide, utilise "/mail ?" pour voir les commandes.'
    invalid_selected: '&cCe message est introuvable.'
    not_long_enough: '&cTon message doit etre plus long que &4%messageLength mots.'
  command:
    header: '&c--[Mail Command Help]--'
    command: '&3%command: &b%explanation'

Last edited by _ForgeUser8260841: Feb 5, 2012

_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#35 _ForgeUser6866240

View User Profile

Send Message

Posted Jan 30, 2012
@freaky85

you are correct, i updated it in the default lang however you can change it locally through the lang file yourself now as well. Thanks for notifying me of this.

Rollback Post to Revision RollBack
_ForgeUser2694929
- Join Date: 6/6/2009
- Posts: 17
- Member Details
#34 _ForgeUser2694929

View User Profile

Send Message

Posted Jan 30, 2012
Theres a typo. It has to be: Your message has to be longer than 3 words.

I think?

Rollback Post to Revision RollBack
_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#33 _ForgeUser6866240

View User Profile

Send Message

Posted Jan 30, 2012
@Alexander_Winters I looked into how SimpleClans was doing this and its something that's not possible with mail. In the future ill add a lang file so you can change the phrases around yourself however.

@richboos Fixed in v0.8.1 as well as another bug similar to this with /mail delete. Also it was supposed to send the help to the player however i was being negligent

Rollback Post to Revision RollBack

_ForgeUser7133525

Join Date: 7/3/2011
Posts: 67
Member Details

#32 Posted Jan 28, 2012

This happens with v0.8 if a player doesn't complete a command, for example only entering /mail write

org.bukkit.command.CommandException: Unhandled exception executing command 'mail' in plugin Mail v0.8
        at org.bukkit.command.PluginCommand.execute(PluginCommand.java:42)
        at org.bukkit.command.SimpleCommandMap.dispatch(SimpleCommandMap.java:168)
        at org.bukkit.craftbukkit.CraftServer.dispatchCommand(CraftServer.java:386)
        at net.minecraft.server.NetServerHandler.handleCommand(NetServerHandler.java:777)
        at net.minecraft.server.NetServerHandler.chat(NetServerHandler.java:737)
        at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:725)
        at org.getspout.spout.SpoutNetServerHandler.a(SpoutNetServerHandler.java:178)
        at net.minecraft.server.Packet3Chat.handle(Packet3Chat.java:33)
        at net.minecraft.server.NetworkManager.b(NetworkManager.java:226)
        at net.minecraft.server.NetServerHandler.a(NetServerHandler.java:100)
        at org.getspout.spout.SpoutNetServerHandler.a(SpoutNetServerHandler.java:587)
        at net.minecraft.server.NetworkListenThread.a(NetworkListenThread.java:78)
        at net.minecraft.server.MinecraftServer.w(MinecraftServer.java:536)
        at net.minecraft.server.MinecraftServer.run(MinecraftServer.java:434)
        at net.minecraft.server.ThreadServerApplication.run(SourceFile:465)
Caused by: java.lang.ArrayIndexOutOfBoundsException: 1
        at com.imdeity.mail.cmd.MailCommand.writeCommand(MailCommand.java:150)
        at com.imdeity.mail.cmd.MailCommand.parseCommand(MailCommand.java:70)
        at com.imdeity.mail.cmd.MailCommand.onCommand(MailCommand.java:43)
        at org.bukkit.command.PluginCommand.execute(PluginCommand.java:40)
        ... 14 more

Purely cosmetic, but perhaps it could be adjusted to display the mail help instead?

_ForgeUser6827079
- Join Date: 5/17/2011
- Posts: 27
- Member Details
#31 _ForgeUser6827079

View User Profile

Send Message

Posted Jan 28, 2012
@vanZeben

What would be a really good idea imo would be replacing {unreadmessages} with the actual number of unread messages like SimpleClans does with {clan}, though I have no idea how possible or executable that would be. It'd be cool though, as it could satisfy people using any and all announcement/motd plugins. I would use it with CommandBook myself :3

That said, awesome plugin mate! Thanks for releasing :D

Rollback Post to Revision RollBack
_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#30 _ForgeUser6866240

View User Profile

Send Message

Posted Jan 28, 2012
@Liger_XT5

its no trouble at all, we just don't want to release certain "features" that will never get used by the general populous.

@predawnia

"mail.player.read" - to read messages "mail.player.join" - to receive join messages "mail.player.delete" - to delete messages "mail.player.write" - to write messages "mail.admin" - for admin

would be the correct set of nodes. you can use "mail.player.*" for short, i had forgot to update the OP so ill do that now

Rollback Post to Revision RollBack
_ForgeUser1573474
- Join Date: 11/6/2008
- Posts: 649
- Member Details
#29 _ForgeUser1573474

View User Profile

Send Message

Posted Jan 27, 2012
In 0.8 do we still have

"mail.read" - to read messages
"mail.join" - to receive join messages
"mail.delete" - to delete messages
"mail.write" - to write messages

or is it now changed to

"mail.player.read" - to read messages
"mail.player.join" - to receive join messages
"mail.player.delete" - to delete messages
"mail.player.write" - to write messages
"mail.admin" - for admin

Rollback Post to Revision RollBack
LigerXT5
- Location: USA
- Join Date: 5/21/2008
- Posts: 686
- Member Details
#28 LigerXT5

View User Profile

Send Message

Posted Jan 27, 2012
@vanZeben

It may show that I am a developer, but I have not released anything. I'm working on a plugin as I figure out how while I'm taking classes in programming.

I am not the author of rTriggers, I use rTriggers to do all the macro work I've been needing.

I am sorry for the trouble.

Rollback Post to Revision RollBack
_ForgeUser6866240
- Join Date: 5/21/2011
- Posts: 156
- Member Details
#27 _ForgeUser6866240

View User Profile

Send Message

Posted Jan 27, 2012
@Liger_XT5

Your a developer, shouldn't be too hard to personalize something for your server. Im not going to add a command in to show the welcome message from mail, as it has no use to the general populous except for your specific case. However I have added a static api call for you so all you need to do is "com.imdeity.mail.Mail.sendUnreadMailCountMessage(playername);" (without the quotation marks), and it'll send said message to the player. This function isn't in the released version atm its in a dev build from my git however ill release it formally later tonight.

Also super perms support will be release with the "dev build" that i mentioned earlier for those who are wondering

Last edited by _ForgeUser6866240: Jan 27, 2012

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.

Project ID

31907
Created

Sep 7, 2011
Last Released File

Aug 18, 2012
Total Downloads

19,028
License

GNU General Public License ver...

Bukkit

Mail

Bukkit Plugins

Mail

Table of Contents

What is Mail?

Features

Requirements

Commands

Set up

Extra Links

Source: GitHub

Documentation: Wiki

Comments

About This Project

Categories

Members

Recent Files

Bukkit