Download
(11Kb)
Download
Updated: 12-15-12 05:47 AM
Pictures
File Info
Updated:12-15-12 05:47 AM
Created:06-22-12 09:32 AM
Downloads:3,635
Favorites:18
MD5:

ForwardMail

Version: 0.4.3
by: Tageshi [More]

ForwardMail -- Created by Tageshi

-------------------------------------------------------------------------
1. WHAT IS "ForwardMail"?
-------------------------------------------------------------------------

ForwardMail is a simple and powerful mailing addon which let you
transfer Dozens or Hundreds of items from your inbox to other characters
with a single slash command.

Also ForwardMail provides other mail related commands such as fetching
all AH mails too.
There are three slash-commands /forward and /sendmail and /openmail.
(/fw, /mail, /open for short)

Slash Command Usage:
/forward [recipient] [#] [itemlink] ...
or /fw [recipient] [#] [itemlink] ...
to transfer specific items from your inbox (and your bags too) to other character.
Prefix number [#] is to limit sending item quantity to a specific number.

/sendmail [recipient] [#] [itemlink] ...
or /mail [recipient] [#] [itemlink] ...
to transfer specific items from your bags to other character.
Prefix number [#] is to limit sending item quantity to a specific number.

/openmail [#] [itemlink] ...
or /open [#] [itemlink] ...
to loot specific items from your inbox.
Prefix number [#] is to limit looting item quantity to a specific number.

/openmail
or /open
to loot items and money from all AH mails from your inbox.

GUI:
- [Open AH] button in Inbox tab of Mailbox
This button is same as /openmail slash-command.

- [Forward All] button in SendMail tab of Mailbox
This button is same as /forward slash-command.

- [Forward To] button in OpenMail window of Mailbox.
This button will pick up attachments of the mail currently opened,
and then arrange SendMail tab with all attachments for forwarding.



-------------------------------------------------------------------------
2. HOW TO USE "ForwardMail"?
-------------------------------------------------------------------------

Assuming that you have bought hundreds of Hypnotic Dusts at AH,
and want to store all of them in the bank-alt's inbox.

Open Mailbox window and just type:
/fw YOURBANKALT [Hypnotic Dust]
(also you can shift-click the item to input item link here.)

If you prefer GUI operation, there is another way.
1. Open Mailbox window.
2. Select Send Mail Tab.
3. Input recipient name in To: field.
4. Right-click one of [Hypnotic Dust] in your bag to place into attachment slot.
5. Push [Forward All] button (instead of normal [Send] button!)

Now enjoy watching all Hypnotic Dusts are automatically looted
one by one and sended away to your alt forming 12 stacks each mail.
It's super fast!

If your inbox has overflaws (more than 50 mails),
ForwardMail will wait for refresh with one minute timer until more mails
will be shown, and then automatically continues its job.


ForwardMail only provide GUI for tiny subset of its slash-commands.
(More GUI function planned for later version!)
So you need to rely on manually typing slash command OR using macro.
You can write multiple lines of slash commands in a macro;
ForwardMail will correctly accept all commands at once and run them one by one.

For example, when you are buying lots of [Obsidium Ore] and [Elementium Ore] to
craft [Stormforged Shoulders] and planning to disenchant it into [Heavenly Shard]
with another alt, you can use a single same macro like below to use for
all the three alts.

#####_START_OF_MACRO_#####
/fw YOURMINER [Obsidium Ore]
/fw YOURMINER [Elementium Ore]
/fw YOURBLACKSMITH [Obsidium Bar]
/fw YOURBLACKSMITH [Elementium Bar]
/fw YOURDISENCHANTER [Stormforged Shoulders]
#####_END_OF_MACRO_#####

Tips: If the recipient is yourself, that command will be safely skipped
and nothing happen. That's why you don't need three different versions
of this macro. Just write all the commands within a single macro.


If you don't have enough free slot for your macro icons,
I suggest using other addons to make more macros.
My another addon BindPad, for example, will allow you to create
almost unlimited number of macros within it.
(Though you cannot put those BindPad Macros into actionbar,
you can directly bind keys instead.)


-------------------------------------------------------------------------
3. DETAILS AND MORE INFORMATIONS
-------------------------------------------------------------------------

Sending and receiving mails is such simple and easy job at first glance.
But actually it is very difficult to correctly handle mailing APIs of WoW.
If you call these APIs too quickly, it fail and
"Internal Mail Database Error" happens.

Thus most current addons manage to avoid this error by waiting for interval
time between API calls and throttling,
for example looting one mail per 0.5 sec or so.

Whereas ForwardMail can precisely handle all mailing related events to
make it run faster and error-proof. Related events are listed below:

MAIL_SEND_SUCCESS : After SendMail call.
MAIL_SEND_INFO_UPDATE: While(!) ClickSendMailItemButton() call.
MAIL_SUCCESS : After MAIL_SEND_SUCCESS and TakeInboxItem/TakeInboxMoney
ITEM_PUSH : After TakeInboxItem
BAG_UPDATE : After all TakeInboxItem indicating SendMail is possible.
PLAYER_MONEY : After TakeInboxMoney
MAIL_INBOX_UPDATE : After any change in inbox. Most notably when GetInboxInvoiceInfo is available
MAIL_FAILED : Rerely happens.
UI_ERROR_MESSAGE : Rerely happens.

For handling these events, I am using lua's coroutines as threads.
Look at how fm.WaitFor(event) function neatly works if you are interested in details.


-------------------------------------------------------------------------
4. WHERE CAN I GET LATEST VERSION?
-------------------------------------------------------------------------

You can get latest version of ForwardMail from www.wowinterface.com:

http://www.wowinterface.com/downloads/info21163-ForwardMail.html

Or from Curse:

http://www.curse.com/addons/wow/forwardmail

Version 0.4.3
- Added slash command option "-toggle" to hide buttons on MailFrame.
Type
/fw -toggle Forward All
/fw -toggle Forward To
/fw -toggle Open AH
to hide/show the buttons.


Version 0.4.2
- Fixed item messages of "Open AH" button.
- Fixed some lua errors by addon conflict.


Version 0.4.1
- Fixed bug /fw may fail on arithmetic on a nil value.
(because GetItemInfo won't return values when you have none in your bag.)
- Fixed bug /fw sometimes didn't correctly marge smaller stacks before sending.


Version 0.4
- Slash-commands now accept a quantity prefix-number to send/receive specific number of items.
Ex.) /fw Tageshi 5 [Elementium Ore] 10 [Obsidium Ore]
/mail Tageshi 2 [Stormforged Shoulders]
/open 5 [Hypnotic Dust]
- /forward now always marge stacks to the maximum item count each stack.


Version 0.3.1
- Fixed "script run too long" error.
- Fixed bug: [Forward To] sometimes looted wrong mails.


Version 0.3
- Updated for Mist of Pandaria beta 15799.
- Added [Forward To] button in OpenMail window.


Version 0.2
- Added [Open AH] button in Inbox tab.
- Added [Forward All] button in SendMail tab.


Version 0.1
- Initial release.
Optional Files (0)


Post A Reply Comment Options
Unread 12-15-13, 07:20 AM  
Udangul
A Kobold Labourer
 
Udangul's Avatar

Forum posts: 0
File comments: 7
Uploads: 0
Hi!
Error mass send Cyrillic (Russian) name, said: "This recipient does not exist"
Any idea how to fix it?


Привет!
Ошибка массовой отправки на кириллические (Русские) имена, сообщает: "Такого получателя не существует"
Last edited by Udangul : 12-15-13 at 07:21 AM.
Report comment to moderator  
Reply With Quote
Unread 02-02-13, 06:54 AM  
Namtab
A Kobold Labourer

Forum posts: 0
File comments: 67
Uploads: 0
Originally Posted by Brudarek
Originally Posted by Tageshi
ForwardMail doesn't randomly picks.
Perhaps you tried to pull multiple Unique items?
What 12 items exactly did you try to forward?
Just any mail with 12 BoE armor items. It only adds a few of them to the new mail. By 'random' I meant it's not the 1st 3-4 or last few or any that were in order in the original mail.
well i'm seeing a similar behavior to this... happens when there's a duplicate item -> equipment boe / recipe / battle pets / starting quests aka darkmoon faire world drops (seems to happen only with this kind of items). will pick all the items but then will break when there's a copy / duplicate, leaving empty spaces in the send mail / forward... so i gotta look for those copys and add them manually.
Last edited by Namtab : 02-04-13 at 06:06 AM.
Report comment to moderator  
Reply With Quote
Unread 12-16-12, 08:42 PM  
Tageshi
A Murloc Raider
AddOn Author - Click to view AddOns

Forum posts: 7
File comments: 249
Uploads: 4
Thank you for the report!
I will investigate it.
Originally Posted by Aisenfaire
Great idea for an addon!

Just wanted to note that when BulkMail Inbox is enabled, this addon does not work (nothing happens when attempting to forward). Would there be any chance of making it work despite Bulk Mail Inbox being enabled?
Report comment to moderator  
Reply With Quote
Unread 12-16-12, 08:46 AM  
Aisenfaire
A Murloc Raider

Forum posts: 6
File comments: 394
Uploads: 0
Great idea for an addon!

Just wanted to note that when BulkMail Inbox is enabled, this addon does not work (nothing happens when attempting to forward). Would there be any chance of making it work despite Bulk Mail Inbox being enabled?
Last edited by Aisenfaire : 12-16-12 at 09:17 AM.
Report comment to moderator  
Reply With Quote
Unread 12-05-12, 12:22 AM  
Brudarek
A Defias Bandit

Forum posts: 3
File comments: 13
Uploads: 0
Originally Posted by Tageshi
ForwardMail doesn't randomly picks.
Perhaps you tried to pull multiple Unique items?
What 12 items exactly did you try to forward?
Just any mail with 12 BoE armor items. It only adds a few of them to the new mail. By 'random' I meant it's not the 1st 3-4 or last few or any that were in order in the original mail.
Report comment to moderator  
Reply With Quote
Unread 12-04-12, 07:32 AM  
Tageshi
A Murloc Raider
AddOn Author - Click to view AddOns

Forum posts: 7
File comments: 249
Uploads: 4
ForwardMail doesn't randomly picks.
Perhaps you tried to pull multiple Unique items?
What 12 items exactly did you try to forward?

I have no idea about any non-soulbound items for transmoglify though.


Originally Posted by Brudarek
Damn, was hoping this would work. I forward a ton of mails back and forth managing xmog items. The forward option doesn't pick up all 12 items, just seems to randomly pick a few.

I swear there used to be another mod that would forward mail with 1 click. It would pull everything into your bags and then put it all into a new mail.
Last edited by Tageshi : 12-04-12 at 07:34 AM.
Report comment to moderator  
Reply With Quote
Unread 12-04-12, 04:06 AM  
Brudarek
A Defias Bandit

Forum posts: 3
File comments: 13
Uploads: 0
Damn, was hoping this would work. I forward a ton of mails back and forth managing xmog items. The forward option doesn't pick up all 12 items, just seems to randomly pick a few.

I swear there used to be another mod that would forward mail with 1 click. It would pull everything into your bags and then put it all into a new mail.
Last edited by Brudarek : 12-04-12 at 04:06 AM.
Report comment to moderator  
Reply With Quote
Unread 10-04-12, 11:44 PM  
Azure
A Kobold Labourer
 
Azure's Avatar

Forum posts: 0
File comments: 5
Uploads: 0
Originally Posted by Tageshi
Originally Posted by Talyrius
Suggestion:
Add support for LibPeriodicTable-3.1 and allow whole categories of items (enchanting materials, herbs, ore, and etc.) to be sent to your recipient.
Any example of how and what do you use ForwardMail with it when supported?
As a long time user of Bulkmail, I have loved its features of being able to automatically send items (Whether they are unique items such as "Linen Cloth", or all Cloth from the lowest to the highest level version. You can configure a set of rules which say 'Hey, send all my gathered cloth (using PT3 to identify it all) to my Tailoring Alt'. This is where its use of LibPeriodicTable-3.1 is perfect.

Even if you decide not to use PT3, would you consider the creation of permanent rules that can be implemented each time you visit a mailbox?
Report comment to moderator  
Reply With Quote
Unread 07-07-12, 10:42 AM  
Tageshi
A Murloc Raider
AddOn Author - Click to view AddOns

Forum posts: 7
File comments: 249
Uploads: 4
Originally Posted by Talyrius
Suggestion:
Add support for LibPeriodicTable-3.1 and allow whole categories of items (enchanting materials, herbs, ore, and etc.) to be sent to your recipient.
Any example of how and what do you use ForwardMail with it when supported?
Report comment to moderator  
Reply With Quote
Unread 07-07-12, 06:57 AM  
Talyrius
An Onyxian Warder
 
Talyrius's Avatar
AddOn Author - Click to view AddOns

Forum posts: 363
File comments: 259
Uploads: 3
Suggestion:
Add support for LibPeriodicTable-3.1 and allow whole categories of items (enchanting materials, herbs, ore, and etc.) to be sent to your recipient.
Last edited by Talyrius : 07-07-12 at 06:58 AM.
Report comment to moderator  
Reply With Quote
Unread 07-06-12, 06:38 PM  
Tageshi
A Murloc Raider
AddOn Author - Click to view AddOns

Forum posts: 7
File comments: 249
Uploads: 4
Version 0.4

Version 0.4
- Slash-commands now accept a quantity prefix-number to send/receive specific number of items.
Code:
  Ex.) /fw Tageshi 5 [Elementium Ore] 10 [Obsidium Ore]
       /mail Tageshi 2 [Stormforged Shoulders]
       /open 5 [Hypnotic Dust]
- /forward now always marge stacks to the maximum item count each stack.
Last edited by Tageshi : 07-06-12 at 09:04 PM.
Report comment to moderator  
Reply With Quote
Unread 07-02-12, 08:13 AM  
siema_co
A Deviate Faerie Dragon
 
siema_co's Avatar
AddOn Author - Click to view AddOns

Forum posts: 12
File comments: 64
Uploads: 7
Originally Posted by Tageshi
Originally Posted by siema_co
Hi, nice idea for addon.
Any chances to add an option to send only a specific amount of item?
Like
Code:
/fw TruegoldSlave [Volatile Air] 50 [Volatile Fire] 50 [Volatile Water] 50 [Pyrium Bar] 15
I am planning this right now. (only reverse order!)

TODO list!
- GUI for /open [itemlink]
- /fw # [itemlink] ... and /open # [itemlink] ... for specific amount #.
- GUI for the above.
- Rearrange stacks to always make it maximum items per stack.
Thanks! Looking forward to this!
Report comment to moderator  
Reply With Quote
Unread 07-02-12, 07:47 AM  
Tageshi
A Murloc Raider
AddOn Author - Click to view AddOns

Forum posts: 7
File comments: 249
Uploads: 4
Originally Posted by siema_co
Hi, nice idea for addon.
Any chances to add an option to send only a specific amount of item?
Like
Code:
/fw TruegoldSlave [Volatile Air] 50 [Volatile Fire] 50 [Volatile Water] 50 [Pyrium Bar] 15
I am planning this right now. (only reverse order!)

TODO list!
- GUI for /open [itemlink]
- /fw # [itemlink] ... and /open # [itemlink] ... for specific amount #.
- GUI for the above.
- Rearrange stacks to always make it maximum items per stack.
Report comment to moderator  
Reply With Quote
Unread 07-02-12, 03:40 AM  
siema_co
A Deviate Faerie Dragon
 
siema_co's Avatar
AddOn Author - Click to view AddOns

Forum posts: 12
File comments: 64
Uploads: 7
Hi, nice idea for addon.
Any chances to add an option to send only a specific amount of item?
Like
Code:
/fw TruegoldSlave [Volatile Air] 50 [Volatile Fire] 50 [Volatile Water] 50 [Pyrium Bar] 15
Report comment to moderator  
Reply With Quote
Unread 06-30-12, 03:13 AM  
Tageshi
A Murloc Raider
AddOn Author - Click to view AddOns

Forum posts: 7
File comments: 249
Uploads: 4
For MoP beta

Version 0.3
- Updated for Mist of Pandaria beta 15799.
- Added [Forward To] button in OpenMail window.
Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: