Download
(11 Kb)
Download
Updated: 12-15-12 05:47 AM
Pictures
File Info
Compatibility:
Landfall (5.1)
Mists of Pandaria (5.0.4)
Updated:12-15-12 05:47 AM
Created:06-22-12 09:32 AM
Downloads:1,241
Favorites:21
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)


Archived Files (7)
File Name
Version
Size
Author
Date
0.4.2
10kB
Tageshi
08-24-12 11:52 AM
0.4.1
10kB
Tageshi
07-07-12 08:47 PM
0.4.0
10kB
Tageshi
07-06-12 06:36 PM
0.3.1
9kB
Tageshi
07-01-12 09:42 AM
0.3.0
9kB
Tageshi
06-30-12 01:25 AM
0.2.0
9kB
Tageshi
06-25-12 09:36 AM
0.1.0
8kB
Tageshi
06-22-12 09:32 AM


Post A Reply Comment Options
Unread 06-24-12, 05:59 AM  
Namtab
A Kobold Labourer

Forum posts: 0
File comments: 71
Uploads: 0
wtb GUI

great addon!!!

been using -> Bulk Mail / Bulk Mail Inbox (specialy Bulk Mail cuse the other kinda renders useless due to some bug when picking specific items from mail box)

wtb gui soon!!!
maybe when GUI is ready u can add a search field and option to /openmail and pick X items instead of all of them

keep goin
Namtab is offline Report comment to moderator  
Reply With Quote
Unread 06-24-12, 08:36 AM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
Re: wtb GUI

Originally Posted by Namtab
great addon!!!

been using -> Bulk Mail / Bulk Mail Inbox (specialy Bulk Mail cuse the other kinda renders useless due to some bug when picking specific items from mail box)
You mean /openmail [itemlink] was bugged?
What happened?

Originally Posted by Namtab
wtb gui soon!!!
maybe when GUI is ready u can add a search field and option to /openmail and pick X items instead of all of them
keep goin
Pondering about good GUI for /forward, I have a few ideas but I wandering if this is best.
Also planning to make option to let you specify the number you want to pick up.
Tageshi is offline Report comment to moderator  
Reply With Quote
Unread 06-24-12, 11:20 AM  
Namtab
A Kobold Labourer

Forum posts: 0
File comments: 71
Uploads: 0
Re: Re: wtb GUI

nah i ment about the other addon i was using till now called Bulk Mail Inbox take a look if u like

http://www.curse.com/addons/wow/bulkmail-inbox

and hes brother Bulk Mail

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

yours seems to work fine, just missing the GUI
plus the possibility to chain macro is great
Last edited by Namtab : 06-24-12 at 11:22 AM.
Namtab is offline Report comment to moderator  
Reply With Quote
Unread 06-24-12, 11:50 AM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
Re: Re: Re: wtb GUI

Originally Posted by Namtab
nah i ment about the other addon i was using till now called Bulk Mail Inbox take a look if u like
oic
Tageshi is offline Report comment to moderator  
Reply With Quote
Unread 06-25-12, 09:41 AM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
Version 0.2

Version 0.2
- Added [Open AH] button in Inbox tab.
- Added [Forward All] button in SendMail tab.
Tageshi is offline Report comment to moderator  
Reply With Quote
Unread 06-30-12, 03:13 AM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
For MoP beta

Version 0.3
- Updated for Mist of Pandaria beta 15799.
- Added [Forward To] button in OpenMail window.
Tageshi is offline 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
siema_co is offline Report comment to moderator  
Reply With Quote
Unread 07-02-12, 07:47 AM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
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.
Tageshi is offline 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!
siema_co is offline Report comment to moderator  
Reply With Quote
Unread 07-06-12, 06:38 PM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
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.
Tageshi is offline Report comment to moderator  
Reply With Quote
Unread 07-07-12, 06:57 AM  
Talyrius
A Frostmaul Preserver
 
Talyrius's Avatar
AddOn Author - Click to view AddOns

Forum posts: 293
File comments: 266
Uploads: 1
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.
Talyrius is offline Report comment to moderator  
Reply With Quote
Unread 07-07-12, 10:42 AM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
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?
Tageshi is offline 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?
Azure is offline Report comment to moderator  
Reply With Quote
Unread 12-04-12, 04:06 AM  
Brudarek
A Defias Bandit

Forum posts: 3
File comments: 8
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.
Brudarek is offline Report comment to moderator  
Reply With Quote
Unread 12-04-12, 07:32 AM  
Tageshi
A Defias Bandit
AddOn Author - Click to view AddOns

Forum posts: 3
File comments: 256
Uploads: 16
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.
Tageshi is offline Report comment to moderator  
Reply With Quote
Post A Reply



Category Jump: