View source for Macro

[[Category: Terminology]] [[Category: Guides]] [[Category:Commands]]
[[File:Macros.png|thumbnail|Macros]]
A '''Macro''' is a shortcut to execute a sequence of one to six commands, each of which can be used to activate a [[:Category:Job Abilities|Job Ability]], start casting a spell, issue a pet command, change an item of equipment, put text to a chat channel, or perform some other action. 

The execution is sequential, and can be interrupted by activating another macro during /wait commands, or by pressing the "Escape" key or the cancel button on a controller/gamepad during select target (for example, <st> or others) commands. A macro interrupted during its execution will not complete the command on which the interruption occurred, nor execute the remaining commands in the sequence.

Users are given 20 Books with 10 macro palettes each.  Each palette consists of 2 rows of 10 macros each.  Every character has its own, unique set of macro palettes, which are not shared with other characters on the same account. Macros are stored on the game client, not on the server. 
[[File:MacroSets.png|center|Macro Sets]]

==Backing up Macros==

To backup macros, make a copy of the "USER" folder. This can be found via the path ''HorizonXI > Game > SquareEnix > Final Fantasy XI > User'' .

==Available commands==
Each macro starts with a command to determine what type of command you will issue. The most common are:
:''See [[Commands]] for a complete list of commands that can be used.''

{|class="ffxi-table table-md"
! width="25%" | Command
! width="75%" | Definition
|- valign="top"
| '''[[Command/jobability|/ja]]'''
| [[:Category:Job Abilities|Job Ability]]
|- valign="top"
| '''[[Command/magic|/magic or /ma]]'''
| [[:category:magic|Magic]], [[:category:Songs|Songs]], or [[:category:ninjutsu|Ninjutsu]]
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/weaponskill|/ws]]'''
| [[:Category:Weapon Skills|Weapon Skill]]
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/range|/ra]]'''
| Performs a ranged attack on specified target.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/equip|/equip]]'''
| Equip an item.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/recast|/recast]]'''
| Displays recast time for Abilities or Spells.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/item|/item]]'''
| Allows you to use item in inventory, or trade a single item to an NPC.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/partycmd|/pcmd]]'''
| Party command
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/pet|/pet]]'''
| Pet commands
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/party|/p]]'''
| [[Party]] Chat
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/linkshell|/l]]'''
| [[Linkshell]] Chat
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/lockon|/lockon]]'''
| Locks player's view and direction to current selected target.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/check|/check]]'''
| Examines Player or Gauges the monster
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/target|/target]]'''
| Moves active pointer to target specified by targeting pronoun.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/targetnpc|/targetnpc]]'''
| Targets closest NPC or monster (including player pets if /ignorepet command is not active).
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/echo|/echo]]'''
| Displays text viewable only by the Macro user.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/wait|/wait ]] #'''
| Used in between other commands in macros to set a delay before moving onto the next line (where # = number of seconds desired).
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/wait|<wait #>]]'''
| Used on same line at the end of other commands in macros to set a delay before moving onto the next line (where # = number of seconds desired).
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/seacom|/seacom]]'''
| Allows users to create search comment macros.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/seacomup|/seacomup]]'''
| Allows user to set the category that a /seacom macro is inserted into.
|- style="background:#e3e6ff;"  valign="top"
| '''[[Command/macro|/macro]] set #'''<br>'''[[Command/macro|/macro]] book #'''
| Change to "#" macro line<br>Change to macro book "#"
|}

==Selecting a Target (Pronouns)==
Several commands require you to specify a target as a parameter to your action (such as /lockon, /target, /magic, and /range), you can use the following placeholders to select targets:

{|class="ffxi-table table-md"
! width="25%" | Pronoun
! width="75%" | Target
|- valign="top"
| '''<me>'''
| Activates automatically on your character
|- valign="top"
| '''<t>'''
| Activates on current selected target. If a command is missing a target, or the target is unrecognizable, its target is assumed to be the player's current target.
|- valign="top"
| '''<bt>'''
| Activates on last monster claimed by party (will not work on alliance targets).
|- valign="top"
| '''<ht>'''
| Activates on [[Call for Help]] target
|- valign="top" class="fellow"
| '''<ft>'''
| Activates on [[Adventuring Fellow Guide|NPC Fellow]]
|- valign="top"
| '''<st>'''
| Activates after toggling between available targets
|- valign="top"
| '''<stpc>'''
| Activates after toggling between available player characters
|-  valign="top"
| '''<stpt>'''
| Activates after toggling between available party members
|- valign="top"
| '''<stal>'''
| Activates after toggling between available alliance members
|- valign="top"
| '''<stnpc>'''
| Activates after toggling between available [[NPC]]s
|- valign="top"
| '''<lastst>'''
| Activates on last target acquired from <stpc>, <stnpc>, <stpt>, or <stal>
|- valign="top"
| '''<r>'''
| Activates on last player to /tell you (similar to /reply)
|- valign="top"
| '''<pet>'''
| Activates on your active [[pet]]
|- valign="top"
| '''<scan>'''
| Your [[Wide Scan]] target
|}

Targeting specific party and alliance members:
{|class="ffxi-table table-md"
! width="25%" | Pronoun
! width="75%" | Target
|- valign="top"
| '''<p0>'''
| Targets self
|- valign="top"
| '''<p1>''' ... '''<p5>'''
| Targets second party member, and so on to <p5>
|- valign="top"
| '''<a10>''' ... '''<a15>'''
| Targets top most alliance, first member, and so on to <a15>
|- valign="top"
| '''<a20>''' ... '''<a25>'''
| Targets second alliance, first member, and so on to to <a25>
|}

==Syntax==

When programming your macros, be sure to always include proper spelling, punctuation, and targets. Refer to the page for each command for more information about their usage and examples. Quotation marks are optional when referencing a single-word ability, weapon skill, spell, etc. (for instance, "/ja Benediction <me>" is a working macro). 
*You may also create macro command lines (such as the examples listed below) with words used in the [[Auto-Translator]] format which can cut down on time it takes (and make sure it is spelled correctly) to write out an ability, weaponskill, or items. All auto-translated words appear as '''<span style="color:green;">{</span>example<span style="color:red;">}</span>'''.
**''Make sure as you are typing out a macro line you put the auto-translated format of whichever word first and then go back and add quotation marks to each side of the auto-translated phrase. As putting a quotation mark first and typing out the first couple of letters and pressing TAB will interfere.''

{|class="ffxi-table table-md"
! width="40%" | Syntax
! width="60%" | Example
|- valign="top"
| '''/ja "Job Ability" <target>'''
| /ja "[[Benediction]]" <me><br>/ja "[[Steal]]" <bt>
|- valign="top"
| '''/ma "Spell Name" <target>'''
| /ma "Blizzard IV" <bt><br>/ma "[[Curaga]]" <stpc>
|- valign="top"
| '''/nin "Ninjutsu Name" <target>''' <br> '''/ma "Ninjutsu Name" <target>'''
| /nin "[[Hojo: Ni]]" <bt><br>/nin "[[Utsusemi: Ichi]]" <me><br>/ma "[[Utsusemi: Ni]]" <me>
|- valign="top"
| '''/so "Song Name" <target>''' <br> '''/ma "Song Name" <target>'''
| /so "[[Army's Paeon III]]" <me><br>/so "[[Horde Lullaby]]" <t><br>/ma "[[Mage's Ballad]]" <me>
|-  valign="top"
| '''/ws "Weapon Skill Name" <target>'''
| /ws "[[Sturmwind]]" <bt><br>/ws "[[Hexa Strike]]" <bt>
|- valign="top"
| '''/range "[target name]"'''
| /ra <stnpc><br>/shoot <bt><br>/throw <stnpc>
|- style="background:#e3e6ff;"  valign="top"
| '''/item "item" [target]'''
| /item "Rolanberry Pie" <me> <br>/item "Imperial Silver Piece" <t>
|- style="background:#e3e6ff;"  valign="top"
| '''/equip <slot> "Gear"'''
| /equip ring1 "[[Zircon Ring]]"<br>/equip main "[[Ice Staff]]"<br> /equip main
|- style="background:#e3e6ff;"  valign="top"
| '''/ta "Target Name or Pronoun"
| ''Example:'' /ta <bt>
|- style="background:#e3e6ff;"  valign="top"
| '''/pcmd [subcommand]
| /pcmd add "Dudeman"<br>/pcmd leave
|- style="background:#e3e6ff;"  valign="top"
| '''/pet [subcommand]
| /pet "Deploy" <t><br>/pet "Deactivate" <me>
|}

==Other Placeholders==
These are some additional placeholders which make using macros more helpful. These may be placed anywhere in a chat or echo line:

{|class="ffxi-table table-md"
! width="40%" | Syntax
! width="60%" | Definition
|- style="background:#e3e6ff;"  valign="top"
| '''<hp>'''
| Your current hit points as a ratio of current HP over max HP.
|- style="background:#e3e6ff;"  valign="top"
| '''<hpp>'''
| Your current hit points as a percentage.
|- style="background:#e3e6ff;"  valign="top"
| '''<tp>'''
| Your current TP as a percentage.
|- style="background:#e3e6ff;"  valign="top"
| '''<mp>'''
| Your current MP as a ratio of remaining MP over max MP.
|- style="background:#e3e6ff;"  valign="top"
| '''<mpp>'''
| Your current MP as a percentage.
|- style="background:#e3e6ff;"  valign="top"
| '''<pet>'''
| Your pet's name
|- style="background:#e3e6ff;"  valign="top"
| '''<pethpp>'''
| Your pet's current HP as a percentage.
|- style="background:#e3e6ff;"  valign="top"
| '''<petmpp>'''
| Will display the current MP of your pet or automaton as a percentage of its maximum value.
|- style="background:#e3e6ff;"  valign="top"
| '''<pettp>'''
| Your pet's current TP as a percentage.
|- style="background:#e3e6ff;"  valign="top"
| '''<fthpp>'''
| Your NPC Fellow's current HP as a percentage.
|- style="background:#e3e6ff;"  valign="top"
| '''<call0>'''
| Sends out an audible signal and vibrate the controller of everyone in your party.  May only be used with /party command.
|- style="background:#e3e6ff;"  valign="top"
| '''<ncall0>'''
| Sends out an audible signal to everyone in your party.  May only be used with the /party command.
|- style="background:#e3e6ff;"  valign="top"
| '''<scall0>'''
| Sends out an audible signal to everyone in your party, but without the controller vibration.  May only be used with the /party command.
|- style="background:#e3e6ff;"  valign="top"
| '''<job>'''
| Displays your current job/subjob and their levels.
|- style="background:#e3e6ff;"  valign="top"
| '''<mjob>'''
| Displays your current job level (without subjob).
|- style="background:#e3e6ff;"  valign="top"
| '''<sjob>'''
| Displays your current subjob level (without main job).
|- style="background:#e3e6ff;"  valign="top"
| '''<pos>'''
| Your current map coordinates. Will not work while under the effects of [[Charm (Status Effect)]].
|- style="background:#e3e6ff;"  valign="top"
|}

==Macro Guides==
* [[Beginner's Macro Guide]]
* [[Intermediate Macro Guide]]
* [[ASCII Alt Codes Guide]] (i.e., how to make special characters)