Undine Mailer
Release page for Japanese is here.
http://forum.minecraftuser.jp/viewtopic.php?f=38&t=24681
Features
- This plugin UndineMailer provides a mail sending and receiving system to your server!
- You can exchange mails with online/offline players.
- Clickable Chat Component GUIs. Easy to make mails!
- You can attach items to your mails!
- You can set "C.O.D. item" or "C.O.D. money" to open attachment item box.
- Mail list group management systems.
- Sender and recipients are managed with UUID. You can change Minecraft ID, but you can see your mail history!
Screen shots
Mail Detail View
Inbox GUI
Mail Edit GUI
Group Management
How to use
Please use CraftBukkit 1.7.2-R0.3 or later version!
Put "UndineMailer.jar" in plugins folder.
You can enter the mail edit mode by "/mail write" command. You can see mail editor GUI in your chat window. You can reopen GUI by "/mail write" command, even if you close your client.
Regarding C.O.D. feature
You can use C.O.D. (Cash on delivery) feature as trading items between players.
Sender can request money or item as C.O.D.
(If you want to use C.O.D. money feature, you need Vault and any economy plugin.)
If recipient opens mail item box, $30 is sent to sender.
If recipient refuses mail item box, item box is sent back to sender.
Regarding PermissionsEx co-operation feature
This plugin can use PermissionsEx's groups as mail list group.
Please add "receive-mail: true" flag to PermissionsEx groups.
ex)
groups: default: options: default: true permissions: - modifyworld.* test: options: receive-mail: true send-mode: op
NOTE: "send-mode" is optional. You can set it from "op", "member", "everyone". If you not add "send-mode", "specialGroupPexSendMode" config value will be used.
Commands
Command is "/umail". Aliase is "/mail".
- /mail - Display your inbox mail list.
- /mail outbox - Display your outbox mail list.
- /mail trash - Check your deleted mails.
- /mail text <to> <message> - Send simple text message to the specified player.
- /mail write - Enter to mail creation mode.
- /mail item - Show the detailed information of item in your hand.
- /mail trash all - Move all your readed received/sent mails to trash box.
- /mail trash restoreAll - Restore all your trash box mails from trash box.
- /ugroup - Show the group management menu.
- /mail reload - Reload UndineMailer config. Only OP can run this command.
- /mail help - Show the help menu.
Commands for server console
If you want to send mail from server console, please use the following commands also.
- mail write - Enter to mail edit mode.
- mail to <number> <destination player name> - Set the destination of mail.
- mail to delete <number> - Delete the specified number's destination player.
- mail to group <number> <destination group name> - Set the destination group of mail.
- mail to group delete <number> - Delete the specified number's destination group.
- mail message <number> <message> - Set the message of mail.
- mail attach add <item> [amount] - Add an item as attachment. <item> is item description. You can use item name and item ID and data value.
ex) "mail attach add WOOL:11 30" (Adding 30 blue wools.)
ex) "mail attach add 35:11 30" (Adding 30 blue wools. Same as above.) - mail attach clear - Clear all attachment items.
- mail send - Send mail.
Permissions
- undine.<each sub commands>
Permission for each sub commands. Default assigned to Everyone.
ex) /mail write -> undine.write - undine.read-all
Permission to read other's mails. Default assigned to OP. - undine.attach-infinity
Permission to make the attachment item box infinity. Default assigned to OP. - undine.attach-sendmail
Permission of opening the attachment box of send mail. Default assigned to Everyone. - undine.attach-inboxmail
Permission of opening the attachment box of inbox mail. Default assigned to Everyone. - undine.command-attach
Permission to use "/mail attach add" command and "/mail attach clear" command. - undine.multiple-attach
Permission of sending item attached mail to multiple destinations. - undine.group.infinite-create
Permission to make the mail list group infinity. Default assigned to OP. - undine.group.infinite-add-member
Permission to add members infinity to your group. Default assigned to OP. - undine.group.modify-all
Permission to modify all of mail groups. Default assingned to OP. - undine.group.dissolution-all
Permission to break-up all of mail groups. Default assingned to OP. - undine.group.*
All of group management permissions. - undine.*
All of UndineMailer permissions.
Configs
You can configuration Undine Mailer by editing "plugins/UndineMailer/config.yml".
# UndineMailer v1.7.1 # @author ucchy # @license LGPLv3 # @copyright Copyright ucchy 2015 # -------------------- Misc -------------------- # Message locale. lang: en # Enable to send mail to oneself. enableSendSelf: false # Display empty line count before display UI. uiEmptyLines: 2 # Enable to use player list address book. enablePlayerList: false # Limitation number of mail destination. maxDestination: 10 # Limitation number of mail destination group. maxDestinationGroup: 3 # Mail store period. # If you set 30, the system deletes mails that 31 days passed from sending. mailStorageTermDays: 30 # Mail spam protection seconds. # If you set 15, players need 15 seconds, from sending a mail to sending next mail. mailSpamProtectionSeconds: 15 # Mail notification delay seconds on player login. loginNotificationDelaySeconds: 3 # -------------------- Attachment Item Box -------------------- # Enable the attachment item box. enableAttachment: true # Attachment item box line size. Please set 1 - 6. # ex) 1 -> you can attach 9 items per 1 mail. # ex) 6 -> you can attach 54 items per 1 mail. attachBoxSize: 1 # Max usage count of attachment item box per a player. maxAttachmentBoxCount: 3 # World names that disable to open attachment item box. disableWorldsToOpenAttachBox: [] # Specify the items that cannot be attached to the mail. # For example, the following setting makes that gold apple and quartz block will not be attached. # prohibitItemsToAttach: [GOLDEN_APPLE, QUARTZ_BLOCK] # Possible item name, please see the following URL as a reference. # https://github.com/ucchyocean/UndineMailer/blob/master/src/main/java/org/bitbucket/ucchy/undine/item/TradableMaterial.java#L16-L357 prohibitItemsToAttach: [] # -------------------- C.O.D. Setting -------------------- # Enable C.O.D. money feature by using currency of economy plugin. # If you want to use C.O.D. money feature, you need Vault and any economy plugin. enableCODMoney: true # Enable C.O.D. item feature. enableCODItem: true # When paying cash on delivery fee to the other player, # if the amount of post-payment does not match, you can set whether an error. # In such Essentials "max-money" setting, if you have set the upper limit of money, # payment will be disappear. So please make this setting to true, for saving payment. # If you are using such as taking a tax on payment in your economy plugin, # so you will not be able to remittances, please make this setting to false. depositErrorOnUnmatch: true # -------------------- Send Fee -------------------- # Enable mail sending fee. enableSendFee: false # Sending fee per a destination. sendFee: 10 # Attaching fee per an item. attachFee: 10 # Attaching fee is needed whether per the item amount, or per the item stack. attachFeePerAmount: false # COD money tax. Please specify parcentage. # If you set "codMoneyTax: 10", and one of player set $300 as COD, # this player need to pay the additional sending fee $30 (= $300 * 10%). codMoneyTax: 0 # COD item tax. Please specify price per item amount. # If you set "codItemTax: 10", and one of player set DIAMOND * 8 as COD, # this player need to pay the additional sending fee $80 (= $10 * 8). codItemTax: 0 # -------------------- Mail Group -------------------- # Max group creation num per a player. maxCreateGroup: 5 # Max member num per a group. maxGroupMember: 15 # Default mode of send mail permission. # OP: only OP can send mail to this group. # OWNER: owner and OP can send mail to this group. # MEMBER: group members anyone can send mail to this group. # EVERYONE: everyone can send mail to this group. sendModeDefault: MEMBER # Default mode of members modification. # OP: only OP can add/remove members. # OWNER: owner and OP can add/remove members. # MEMBER: group members anyone can add/remove members. # EVERYONE: everyone can add/remove members. modifyModeDefault: OWNER # Default mode of dissolution. # OP: only OP can break-up group. # OWNER: owner and OP can break-up group. # MEMBER: group members anyone can break-up group. # EVERYONE: everyone can break-up group. dissolutionModeDefault: OWNER # Sending permission mode of special group "All" (all players group). specialGroupAllSendMode: OP # Default of sending permission mode of special group "PEX" (PermissionsEx group). # You can arrange this permission each groups by setting "send-mode" option value. specialGroupPexSendMode: OP # Sending permission mode of special group "AllConnected" (all connected players without newcomers). specialGroupAllConnectedSendMode: OP # Sending permission mode of special group "AllLogin" (all connecting players). specialGroupAllLoginSendMode: OP # -------------------- Welcome Mail -------------------- # Welcome email is a mail sent to the player that was first connected to the server. # You can change the message of welcome mail, by changing WelcomeMailBody of messages_en.yml file. # Enable welcome mail. useWelcomeMail: true # Delay seconds to send welcome mail. welcomeMailDelaySeconds: 30 # Attachment items of welcome mail. welcomeMailAttachments: attachment1: material: STONE_SPADE attachment2: material: STONE_PICKAXE attachment3: material: STONE_AXE attachment4: material: STONE_SWORD attachment5: material: TORCH amount: 64 attachment6: material: BREAD amount: 16
Source Code
Source codes managed in Github. https://github.com/ucchyocean/UndineMailer
These codes licensed under LGPLv3.
I get this error at serverstart: http:dev.bukkit.org/paste/12159/
Using Undine Mailer 1.4.0 with on of the latest spigot-builds (git-Spigot-1d14d5f-ba32592 (MC: 1.8.3) (Implementing API version 1.8.3-R0.1-SNAPSHOT))
As always, a great job on the new update! Thanks!
@Locorunner21
New commands "/mail trash all" and "/mail trash restoreAll" were added @ UndineMailer v1.3.3.
Please download v1.3.3 after approval, and try these commands.
@Locorunner21
Thanks for your suggestion.
It's OK to add "/mail trash all".
but I do not think the appropriate GUI.
Is it OK to add only command?
Wow! You update so quick!
Is there a command to send ALL mail in trash? like /umail trash set * or easier- /mail trash all
does the trash folder get erased?
@ucchy
The new update just make it EVEN BETTER! Thank you! :)
@Locorunner21
Still the best Mail plugin i've ever used!
Thanks! :D
How do I delete mail?
Sorry, the players cannot delete mails for now.
OK, I will add "trash folder" feature at next version.
In fact, I found the fatal issue just now.
Everyone, Don't attach the decorated banner to your mail.
This issue will be fixed next version 1.3.2.
Still the best Mail plugin i've ever used!
The only problem I have is this: How do I delete mail?
@madtomic
COD is just another fee paid by the sender for using the service. This is on top of the send fee already.
OK, I will think about this.
Yes, you should as it will use mail as standard.
Yes. I feel your said is right. I change the default command.
Maybe add in mouseover message to tell player how to create group.
Ah, OK. Nice idea.
"mail send attachconfirm" Maybe show this instead of [OK]
Good suggestion. I will modify that.
Thank you for all your responds. I hope my suggestions will help this plugin a bit more easier to use.
Already, your suggestions are very helpful for me. Thanks a lot!
@ucchy
Hmm... I think it's difficult, because COD is sender's requirements but "send fee" is server owner's policy. These are completely different things. So I think, "send fee" should not be changed by COD.
COD is just another fee paid by the sender for using the service. This is on top of the send fee already.
-
Ah, yes. Undine Mailer's default command is "/undine". so we have to do "/help undine". Should I change the default command from "/undine" to "/mail"?
Yes, you should as it will use mail as standard.
-
Did you say that it is necessary to describe how to create a group?
Maybe add in mouseover message to tell player how to create group.
-
"mail send attachconfirm"
Maybe show this instead of [OK]
Thank you for all your responds. I hope my suggestions will help this plugin a bit more easier to use.
@madtomic
Thank you so much for giving so many comments!
These are very helpful for me.
Suggestion: Should disable Add destination if Player List is enabled.
OK. I will update this at next version.
Suggestion: When Send Fee is enabled. Can you add option to charge additional item fee based on total value of COD amount? 0.1 or 10 percents? The whole mail fee is mail fee, + standard item mail fee (if used) + total item COD fee (if used). Standard item mail fee is a set fee that is charged when send item is use in message. I don't know how it would work for item economy.
Hmm...
I think it's difficult, because COD is sender's requirements but "send fee" is server owner's policy. These are completely different things. So I think, "send fee" should not be changed by COD.
Suggestion: When /help mail Can you please add in the new alias for command help. Right now it's all /Undine not /mail. Although, I already set to EN as lang.
Update: I found out /mail help works with lang file but not default /help mail from bukkit.
Ah, yes. Undine Mailer's default command is "/undine". so we have to do "/help undine". Should I change the default command from "/undine" to "/mail"?
Suggestion: A better explanation on how to create groups for users or how to do it within the mail write?
Did you say that it is necessary to describe how to create a group?
Suggestion: Can the plugin pick up groups automatic from PEX or any permission plugins?
It's possible. I will try to do that.
Question: How to add more players to groups?
At group detail GUI.
Suggestion: When sending as Admin. Please add and allow Admin to send out mass mails with attachments. Of course, all free of charge.
"undine.multiple-attach" permission is that. OP has this permission already.
Issue: Server console mail send is kinda of hard, I can't click [OK] to send mail. After /mail send if I have more than one destinations.
Oh, yes. Please do additional command "mail send attachconfirm". I will fix it.
Suggestion: Should disable Add destination if Player List is enabled.
Suggestion: When Send Fee is enabled. Can you add option to charge additional item fee based on total value of COD amount? 0.1 or 10 percents (for example)? The whole mail fee is mail fee, + standard item mail fee (if used) + total item COD fee (if used). Standard item mail fee is a set fee that is charged when send item is use in message. I don't know how it would work for item economy.
Suggestion: When /help mail Can you please add in the new alias for command help. Right now it's all /Undine not /mail. Although, I already set to EN as lang.
Update: I found out /mail help works with lang file but not default /help mail from bukkit.
Suggestion: A better explanation on how to create groups for users or how to do it within the mail write?
Suggestion: Can the plugin pick up groups automatic from PEX or any permission plugins?
Question: How to add more players to groups?
Suggestion: When sending as Admin. Please add and allow Admin to send out mass mails with attachments. Of course, all free of charge.
Issue: Server console mail send is kinda of hard, I can't click [OK] to send mail. After /mail send if I have more than one destinations.
@Locorunner21
Undine Mailer v1.2.0 was uploaded. Now waiting approval.
I added so many features. Of course, including all of your requests.
Have a fun. (*´ω`*)
@ucchy
Thanks!
I can't wait to see how it goes!
Cheers!
@Locorunner21
Thank you so much for selecting this plugin!! I feel all your suggestion is important. I will add these features in the next version.
1. Having a console command of some kind to send mail to all players, so not having to define each player's name. (This would you could alert all players online via the console of a special or limited offer.)
Yes, I think to add the pre-defined special mail groups.
ops - All of OPs (and CONSOLE) mail group. All members can send to this group. You can use this such as a grief reporting.→ Sorry, I feel this special group is no need. Please make "moderators" group manually.
2.Furthermore, it could be helpful to have a mail command so that a console can add an item to the attachment box without having it in hand. For example, giving an item Id, or a rare artefact from a Lore type plugin. (But that could require some API compatibility.)
Hmm, OK. I will add the command line attachment items edit.
Edit: (I can't find a way to delete mail? maybe you should add this, otherwise you may have some heavy lag after awhile.)
Nice suggestion. I think to add the mail clean up feature. Example, 1 month excess from at everyone reading mail.
You have done a great job! I'd love to see what else you are doing!
Thank you liked!! The following plugins are my masterpieces, check it out!
StingerMissile - Lock-on horming weapon. http://dev.bukkit.org/bukkit-plugins/stingermissile/
LandmineBusters - Additional minigame, like a minesweeper. http://dev.bukkit.org/bukkit-plugins/landmine-busters/
This is a great plugin!
Great job on this, it is very easy to use and extremely ergonomic! I'm now using this on my server, and it seems to be working flawlessly.
I do have a few suggestions if you are still interested in further development:
1. Having a console command of some kind to send mail to all players, so not having to define each player's name. (This would you could alert all players online via the console of a special or limited offer.)
2.Furthermore, it could be helpful to have a mail command so that a console can add an item to the attachment box without having it in hand. For example, giving an item Id, or a rare artefact from a Lore type plugin. (But that could require some API compatibility.)
You have done a great job! I'd love to see what else you are doing!
Edit: (I can't find a way to delete mail? maybe you should add this, otherwise you may have some heavy lag after awhile.)
@madtomic
Thanks! Please tell me anything!
I will test it out and let you know what I think.