Emailsendattachment (Slash Command): Difference between revisions

From Unofficial Homecoming Wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Historical|type=page}}
<div class="center" style="width:auto; margin-left:auto; margin-right:auto;">
{| width="550" border="1" style="text-align:left; background-color:lightgray"
|-
! From the [[Issue 8 Page 1]] Patch Notes:
|-
|* Remove /emailsend, /emailsendattachment, /gmailclaim, and /gmailreturn slash commands.
** These commands were intended for internal use by the UI and correct usage depends on knowing internal character state that is not visible to the player. Incorrect usage can leave the player's mailbox in a corrupt state that renders it unusable without manual administrator intervention to fix the database records.
|}</div>
==Slash command==
==Slash command==
{{SlashCommandArticle|command=emailsendattachment|options=<span style="color:blue">name</span> <span style="color:brown">subject</span> <span style="color:green">influence</span> <span style="color:orange">attachment_type</span> <span style="color:purple">inventory_location</span>  
{{SlashCommandArticle|command=emailsendattachment|options=<span style="color:blue">name</span> <span style="color:brown">subject</span> <span style="color:green">influence</span> <span style="color:orange">attachment_type</span> <span style="color:purple">inventory_location</span>  
<span style="color:tan">message</span>|note=Send message with an attachment.}}
<span style="color:#664229">message</span>|note=Send message with an attachment.}}


This command can send a message, a message with [[Inf|influence]], a message with an attachment (such as salvage, enhancements, etc.), or all of the above. Aside from influence, only a single item may be attached to an email.
This command can send a message, a message with [[Inf|influence]], a message with an attachment (such as salvage, enhancements, etc.), or all of the above. Aside from influence, only a single item may be attached to an email.
Line 10: Line 20:
::''<span style="color:orange">attachment_type</span>'' = the type of attachment expressed as a number
::''<span style="color:orange">attachment_type</span>'' = the type of attachment expressed as a number
::''<span style="color:purple">inventory_location</span>'' = the attachment item's location in the corresponding inventory window (see below).
::''<span style="color:purple">inventory_location</span>'' = the attachment item's location in the corresponding inventory window (see below).
::''<span style="color:tan">message</span>'' = the message you'd like to say (no quotes)
::''<span style="color:#664229">message</span>'' = the message you'd like to say (no quotes)


* When composing the slash command, all 6 arguments (variables) need to be used with a space in-between each, and placed in the exact sequence as noted above (even if you're only doing one thing). If you don't want to send an item, merely type <code>0</code>.  
* When composing the slash command, all 6 arguments (variables) need to be used with a space or comma in-between each, and placed in the exact sequence as noted above (even if you're only doing one thing). If you don't want to send an item, merely type <code>0</code>.  
* The email slash commands do not like spaces in either character or global names. Using a name with spaces in it can potentially cause the email system to lock up for the character that sent the email, or otherwise cause trouble for an extended period of time. It's a bug.  
* The email slash commands do not like spaces in either character or global names. Using a name with spaces in it can potentially cause the email system to lock up for the character that sent the email, or otherwise cause trouble for an extended period of time. It's a bug.  
* Long ''subjects'' with spaces need to be enclosed by double quotes ("Long Subject").
* Long ''subjects'' with spaces need to be enclosed by double quotes ("Long Subject").
* Do '''not''' enclose the ''message'' with double quotes. Doing so will prevent any attachment from sending.
* Do '''not''' enclose the ''message'' with double quotes. Doing so will prevent any attachment from sending.
* {{red|Caution:}} Players have reported that this command has the potential to corrupt your character/email due to indexing issues. Although problems seem unlikely, use at your own risk. See Editor's Note at the bottom of the page.


==Attachment Types==
==Attachment Types==
Line 22: Line 33:
     5 - Enhancements
     5 - Enhancements
   11 - Salvage
   11 - Salvage
   12 - Recipes (broken?)
   12 - Recipes


==Inventory Locations==
==Inventory Locations==
Line 57: Line 68:
The inventory location for the [[The Players' Guide to the Cities/User Interface/Enhancements Window|Enhancements window]]  is determined by counting in sequence from 0 starting on slot 1 of tab 1, to 69 for slot 10 of tab 7. For example, slot 10 of tab 1 is enhancement-slot# 9, slot 1 of tab 2 is enhancement-slot# 10, and slot 1 of tab 3 is enhancement-slot# 20.  
The inventory location for the [[The Players' Guide to the Cities/User Interface/Enhancements Window|Enhancements window]]  is determined by counting in sequence from 0 starting on slot 1 of tab 1, to 69 for slot 10 of tab 7. For example, slot 10 of tab 1 is enhancement-slot# 9, slot 1 of tab 2 is enhancement-slot# 10, and slot 1 of tab 3 is enhancement-slot# 20.  


A fast way to determine the enhancement-slot# you want is to remember that the first enhancement-slot# of every tab ends in a zero (just counts up by tens starting at 0), then just count on from there. For example: tab 1 is the 0s, tab 2 is the 10s, tab 3 is the 20s, tab 4 is the 30s, tab 5 is the 40s, tab 6 is the 50s, and tab 7 is the 60s.
A fast way to determine the enhancement-slot# you want is to use the tab number as the tens digit and the slot number as the ones digit, combine them, then subtract 11. For example: let's say you want to know the inventory location for an enhancement in tab 5, slot 8... 58 - 11 = 47.
 
{| class=wikitable style="text-align: center;"
|+ [[The Players' Guide to the Cities/User Interface/Enhancements Window|Enhancements window]]
|-
! style=max-width:5em| Slot #
 
!! style=max-width:4em| 1
!! style=max-width:4em| 2
!! style=max-width:4em| 3
!! style=max-width:4em| 4
!! style=max-width:4em| 5
!! style=max-width:4em| 6
!! style=max-width:4em| 7
!! style=max-width:4em| 8
!! style=max-width:4em| 9
!! style=max-width:4em| 10
|-
!  scope="row"|&nbsp;&nbsp;Tab 1&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;0&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;1&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;2&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;3&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;4&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;5&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;6&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;7&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;8&nbsp;&nbsp;&nbsp;&nbsp;
|  &nbsp;&nbsp;&nbsp;&nbsp;9&nbsp;&nbsp;&nbsp;&nbsp;
|-
! scope="row" | Tab 2
|  10
|  11
|  11
|  13
|  14
|  15
|  16
|  17
|  18
|  19
|-
! scope="row" | Tab 3
|  20
|  21
|  22
|  23
|  24
|  25
|  26
|  27
|  28
|  29
|-
! scope="row" | Tab 4
|  30
|  31
|  32
|  33
|  34
|  35
|  36
|  37
|  38
|  39
|-
! scope="row" | Tab 5
|  40
|  41
|  42
|  43
|  44
|  45
|  46
|  47
|  48
|  49
|-
! scope="row" | Tab 6
|  50
|  51
|  52
|  53
|  54
|  55
|  56
|  57
|  58
|  59
|-
! scope="row" | Tab 7
|  60
|  61
|  62
|  63
|  64
|  65
|  66
|  67
|  68
|  69
|}


===Salvage===
===Salvage===
Each piece of salvage is assigned its own inventory ID number in the [[The Players' Guide to the Cities/User Interface/Salvage Window|Salvage window]]. The inventory ID number is based on the order in which the salvage type was first acquired by the character starting with the number zero (0). This means that the inventory ID for each piece of salvage will be different for every character.   
Each piece of salvage is indexed and assigned its own inventory ID number in the [[The Players' Guide to the Cities/User Interface/Salvage Window|Salvage window]]. The inventory ID number is based on the order in which the salvage type was first acquired by the character starting with the number zero (0). This means that the inventory ID for each piece of salvage will be different for every character.   


If a type of salvage is removed from the inventory (deleted, sold, spent, traded, or moved to the Vault Reserve), the inventory ID number that it had will no longer have any salvage associated with it. The next new (or unique) salvage type that is added to the inventory will be assigned that free inventory ID number, or the first available inventory ID number. This makes it possible to assign a salvage type a specific inventory ID number by removing all salvage from the inventory, and then adding it back one at a time, taking note of the order in which you added the salvage back to the inventory. For example, if the salvage inventory is empty, the first piece of salvage will be assigned the inventory ID of "0". The second piece will be "1", the third piece, "2", the fourth piece "3", and so on.   
If a type of salvage is removed from the inventory (deleted, sold, spent, traded, emailed, or moved to the Vault Reserve), the inventory ID number that it had will no longer have any salvage associated with it. The next new (or unique) salvage type that is added to the inventory will be assigned that free inventory ID number, or the first available inventory ID number. This makes it possible to assign a salvage type a specific inventory ID number by removing all salvage from the inventory, and then adding it back one at a time, taking note of the order in which you added the salvage back to the inventory. For example, if the salvage inventory is empty, the first piece of salvage will be assigned the inventory ID of "0". The second piece will be "1", the third piece, "2", the fourth piece "3", and so on.   


Attempting to assign salvage inventory ID numbers manually is complicated by the fact that some salvage can not be removed from a character's inventory and can not be reassigned to a different inventory ID number during that game instance... this includes any salvage type that is not "tradable," such as Incarnate salvage. These untradeable salvage pieces will always have the same inventory ID number until the game is restarted.
Attempting to assign salvage inventory ID numbers manually is complicated by the fact that some salvage can not be removed from a character's inventory and can not be reassigned to a different inventory ID number during that game instance... this includes any salvage type that is not "tradable," such as Incarnate salvage. These untradeable salvage pieces will always have the same inventory ID number until the game is restarted.
Line 71: Line 183:


===Recipes===
===Recipes===
'''<span style="color:red">Possibly Broken</span>'''
The number used to attach recipes is not an inventory number at all but rather a special AttribFileItem ID number. There is an ID number for every enhancement recipe at every level, which makes for a lot of ID numbers. Potentially, there could be up to 50 different ID numbers for a single enhancement recipe, and 300 for an entire enhancement set. So you need to look for your exact recipe and its level when you try to attach it to an email.
 
To find the ID number for your recipe, see the [[Emailsendattachment (Slash Command)/Recipes|Recipe AttribFIleItem ID Numbers]] list.


Might be attempting to send incarnate recipes that are not tradeable. How to attach a recipe is currently unknown.




==Tips==
==Tips==
* The [[The Players' Guide to the Cities/User Interface/Email Window|Email window]] in game accepts long names with spaces, and is in general more reliable, less buggy, and easier for the average player.
* The [[The Players' Guide to the Cities/User Interface/Email Window|Email window]] in game accepts long names with spaces, and is in general more reliable, less buggy, and easier for the average player.  
* If you want to spend the time to figure out the inventory ID number for special salvage such as Empyrean Merits, Reward Merits, etc... you can use {{slashcommand|emailsendattachment}} to send yourself those items in small amounts (one at a time). This helps when a character only needs a few salvage items, or if you want to transfer all of those special salvage items to another character using your global name and leave none on your current character.
* If you want to spend the time to figure out the inventory ID number for special salvage such as Empyrean Merits, Reward Merits, etc... you can use {{slashcommand|emailsendattachment}} to send yourself those items in small amounts (one at a time). This helps when a character only needs a few salvage items, or if you want to transfer all of those special salvage items to another character using your global name and leave none on your current character.
* Make a {{slashcommand|Macro}} to send yourself attachments SUUUUUUUPER quickly! That's right gingerbread man, click as fast as you can!
* Attachments, including influence, can only be sent to [[Global Chat Handle|global names]] (not local character names).
 


'''Editor's Note:''' This is a great command. Extremely useful. There have been a lot of people warning about using it, how it will break your global email and such... and they're not wrong. In my experience, problems occur when the command is used too quickly to send multiple emails fast. The email system just can't keep up, wires get crossed, and you end up with a broken global email account. This is also true for sending emails with the <code>/toggle compose</code> command. It seems to skirt around some safeguards that are in place when you open the Compose window through the Email window. Again, it's sending emails very quickly that appears to break the global email. So my suggestion is, if you use this command (or any of the email commands), go slowly. Give the global email system time to catch up before you send the next email. This is just a guess, mind you, so use at your own risk.




==Example==
==Example==
  /emailsendattachment <span style="color:blue">@SuperBob</span> <span style="color:brown">"Some Moola"</span> <span style="color:green">1000000</span> <span style="color:orange">0</span> <span style="color:purple">0</span> <span style="color:tan">Have a great day!</span>
  /emailsendattachment <span style="color:blue">@SuperBob</span> <span style="color:brown">"Some Moola"</span> <span style="color:green">1000000</span> <span style="color:orange">0</span> <span style="color:purple">0</span> <span style="color:#664229">Have a great day!</span>
 
==See Also==
* {{slashcommand|emailsend}}
* {{slashcommand|emailsendattachment}}
* {{slashcommand|mailview}}
* {{slashcommand|window_show|email}}
* {{slashcommand|window_show|compose}}
* [[Mail System|Mail System]]
 
 
{{Navbox Communication}}
[[Category:Communication Commands]]

Latest revision as of 03:19, 23 October 2024

This page contains information that no longer applies to the current version of Homecoming: City of Heroes/Villains. It is provided for historical purposes.

From the Issue 8 Page 1 Patch Notes:
* Remove /emailsend, /emailsendattachment, /gmailclaim, and /gmailreturn slash commands.
    • These commands were intended for internal use by the UI and correct usage depends on knowing internal character state that is not visible to the player. Incorrect usage can leave the player's mailbox in a corrupt state that renders it unusable without manual administrator intervention to fix the database records.

Slash command

/emailsendattachment name subject influence attachment_type inventory_location message

Send message with an attachment.

This command can send a message, a message with influence, a message with an attachment (such as salvage, enhancements, etc.), or all of the above. Aside from influence, only a single item may be attached to an email.

name = either a character name or global name of a player (no spaces allowed)
subject = the subject of the email
influence = in-game money expressed in numbers
attachment_type = the type of attachment expressed as a number
inventory_location = the attachment item's location in the corresponding inventory window (see below).
message = the message you'd like to say (no quotes)
  • When composing the slash command, all 6 arguments (variables) need to be used with a space or comma in-between each, and placed in the exact sequence as noted above (even if you're only doing one thing). If you don't want to send an item, merely type 0.
  • The email slash commands do not like spaces in either character or global names. Using a name with spaces in it can potentially cause the email system to lock up for the character that sent the email, or otherwise cause trouble for an extended period of time. It's a bug.
  • Long subjects with spaces need to be enclosed by double quotes ("Long Subject").
  • Do not enclose the message with double quotes. Doing so will prevent any attachment from sending.
  • Caution: Players have reported that this command has the potential to corrupt your character/email due to indexing issues. Although problems seem unlikely, use at your own risk. See Editor's Note at the bottom of the page.

Attachment Types

   0 - None
   2 - Inspirations
   5 - Enhancements
  11 - Salvage
  12 - Recipes

Inventory Locations

Inspirations

Inspirations Window
Columns 0 1 2 3 4
Row 3     03         13         23         33         43    
Row 2 02 12 22 32 42
Row 1 01 11 21 31 41
Row 0 00 10 20 30 40

The inventory location for Inspirations is expressed as a 2-digit number, where the first digit to the left is the column number (starting from zero on the far left of the Inspirations window), and the second digit is the row number (starting from zero at the bottom of the Inspirations window). For example, "12" would refer to the inspiration located in column #1, row #2.

Enhancements

The inventory location for the Enhancements window is determined by counting in sequence from 0 starting on slot 1 of tab 1, to 69 for slot 10 of tab 7. For example, slot 10 of tab 1 is enhancement-slot# 9, slot 1 of tab 2 is enhancement-slot# 10, and slot 1 of tab 3 is enhancement-slot# 20.

A fast way to determine the enhancement-slot# you want is to use the tab number as the tens digit and the slot number as the ones digit, combine them, then subtract 11. For example: let's say you want to know the inventory location for an enhancement in tab 5, slot 8... 58 - 11 = 47.

Enhancements window
Slot # 1 2 3 4 5 6 7 8 9 10
  Tab 1       0         1         2         3         4         5         6         7         8         9    
Tab 2 10 11 11 13 14 15 16 17 18 19
Tab 3 20 21 22 23 24 25 26 27 28 29
Tab 4 30 31 32 33 34 35 36 37 38 39
Tab 5 40 41 42 43 44 45 46 47 48 49
Tab 6 50 51 52 53 54 55 56 57 58 59
Tab 7 60 61 62 63 64 65 66 67 68 69

Salvage

Each piece of salvage is indexed and assigned its own inventory ID number in the Salvage window. The inventory ID number is based on the order in which the salvage type was first acquired by the character starting with the number zero (0). This means that the inventory ID for each piece of salvage will be different for every character.

If a type of salvage is removed from the inventory (deleted, sold, spent, traded, emailed, or moved to the Vault Reserve), the inventory ID number that it had will no longer have any salvage associated with it. The next new (or unique) salvage type that is added to the inventory will be assigned that free inventory ID number, or the first available inventory ID number. This makes it possible to assign a salvage type a specific inventory ID number by removing all salvage from the inventory, and then adding it back one at a time, taking note of the order in which you added the salvage back to the inventory. For example, if the salvage inventory is empty, the first piece of salvage will be assigned the inventory ID of "0". The second piece will be "1", the third piece, "2", the fourth piece "3", and so on.

Attempting to assign salvage inventory ID numbers manually is complicated by the fact that some salvage can not be removed from a character's inventory and can not be reassigned to a different inventory ID number during that game instance... this includes any salvage type that is not "tradable," such as Incarnate salvage. These untradeable salvage pieces will always have the same inventory ID number until the game is restarted.

If the game is restarted, all salvage (including non-tradable salvage) will be reassigned somewhat randomly to the first available inventory ID numbers starting with zero.

All of this makes sending salvage using the /emailsendattachment command possible but not very practical.

Recipes

The number used to attach recipes is not an inventory number at all but rather a special AttribFileItem ID number. There is an ID number for every enhancement recipe at every level, which makes for a lot of ID numbers. Potentially, there could be up to 50 different ID numbers for a single enhancement recipe, and 300 for an entire enhancement set. So you need to look for your exact recipe and its level when you try to attach it to an email.

To find the ID number for your recipe, see the Recipe AttribFIleItem ID Numbers list.


Tips

  • The Email window in game accepts long names with spaces, and is in general more reliable, less buggy, and easier for the average player.
  • If you want to spend the time to figure out the inventory ID number for special salvage such as Empyrean Merits, Reward Merits, etc... you can use /emailsendattachment to send yourself those items in small amounts (one at a time). This helps when a character only needs a few salvage items, or if you want to transfer all of those special salvage items to another character using your global name and leave none on your current character.
  • Attachments, including influence, can only be sent to global names (not local character names).


Editor's Note: This is a great command. Extremely useful. There have been a lot of people warning about using it, how it will break your global email and such... and they're not wrong. In my experience, problems occur when the command is used too quickly to send multiple emails fast. The email system just can't keep up, wires get crossed, and you end up with a broken global email account. This is also true for sending emails with the /toggle compose command. It seems to skirt around some safeguards that are in place when you open the Compose window through the Email window. Again, it's sending emails very quickly that appears to break the global email. So my suggestion is, if you use this command (or any of the email commands), go slowly. Give the global email system time to catch up before you send the next email. This is just a guess, mind you, so use at your own risk.


Example

/emailsendattachment @SuperBob "Some Moola" 1000000 0 0 Have a great day!

See Also