View source for Macros


[[Category: Terminology]] [[Category: Guides]] [[Category:Commands|Commands]]
{{tocright}}
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 the HorizonXI server; users playing with the same account on multiple clients (for example, another PC or Handheld device like Steam Deck) will not have access to the macros written on another machine. However, macros can be manually stored and copied over to the other device. this is Also helpful if you need to reinstall the game due to any issue and don't want to remake all your Macros.

==Backing up Macros==

===PC Users===
{{verification}}
===Steam Deck===
{{verification}}
==Available commands==
:''See [[Commands]] for a complete list of commands that can be used.''

Each macro starts with a command to determine what type of command you will issue. The most common are:
:{| width="60%" cellpadding="2" cellspacing="2"
! style="background:#ffdead;" width="25%" | Command
! style="background:#ffdead;" width="75%" | Definition
|- style="background:#e3e6ff;"  valign="top"
| '''/ja'''
| [[:Category:Job Abilities|Job Ability]]
|- style="background:#e3e6ff;"  valign="top"
| '''/magic or /ma'''
| [[:category:magic|Magic]], [[:category:Songs|Songs]], or [[:category:ninjutsu|Ninjutsu]]
|- style="background:#e3e6ff;"  valign="top"
| '''/ws'''
| [[:Category:Weapon Skills|Weapon Skill]]
|- style="background:#e3e6ff;"  valign="top"
| '''/ra'''
| Performs a ranged attack on specified target.
|- style="background:#e3e6ff;"  valign="top"
| '''/equip'''
| Equip an item.
|- style="background:#e3e6ff;"  valign="top"
| '''/recast'''
| Displays recast time for Abilities or Spells.
|- style="background:#e3e6ff;"  valign="top"
| '''/item'''
| Allows you to use item in inventory, or trade a single item to an NPC.
|- style="background:#e3e6ff;"  valign="top"
| '''/pcmd'''
| Party command
|- style="background:#e3e6ff;"  valign="top"
| '''/pet'''
| Pet commands
|- style="background:#e3e6ff;"  valign="top"
| '''/p'''
| [[Party]] Chat
|- style="background:#e3e6ff;"  valign="top"
| '''/l'''
| [[Linkshell]] Chat
|- style="background:#e3e6ff;"  valign="top"
| '''/lockon'''
| Locks player's view and direction to current selected target.
|- style="background:#e3e6ff;"  valign="top"
| '''/check'''
| Examines Player or Gauges the monster
|- style="background:#e3e6ff;"  valign="top"
| '''/target'''
| Moves active pointer to target specified by targeting pronoun.
|- style="background:#e3e6ff;"  valign="top"
| '''/targetnpc'''
| Targets closest NPC or monster (including player pets if /ignorepet command is not active).
|- style="background:#e3e6ff;"  valign="top"
| '''/echo'''
| Displays text viewable only by the Macro user.
|- style="background:#e3e6ff;"  valign="top"
| '''/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"
| '''<wait>'''
| Used on same line at the end of other commands in macros to set a delay before moving onto the next line.
|- style="background:#e3e6ff;"  valign="top"
| '''/seacom'''
| Allows users to create search comment macros.
|- style="background:#e3e6ff;"  valign="top"
| '''/seacomup'''
| Allows user to set the category that a /seacom macro is inserted into.
|- style="background:#e3e6ff;"  valign="top"
| '''/macro set #'''<br>'''/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:

:{| width="50%" cellpadding="2" cellspacing="2"
! style="background:#ffdead;" width="25%" | Pronoun
! style="background:#ffdead;" width="75%" | Target
|- style="background:#e3e6ff;"  valign="top"
| '''<me>'''
| Activates automatically on your character
|- style="background:#e3e6ff;"  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.
|- style="background:#e3e6ff;"  valign="top"
| '''<bt>'''
| Activates on last monster claimed by party (will not work on alliance targets).
|- style="background:#e3e6ff;"  valign="top"
| '''<ht>'''
| Activates on [[Call for Help]] target
|- style="background:#e3e6ff;"  valign="top"
| '''<ft>'''
| Activates on [[Adventuring Fellow Guide|NPC Fellow]]
|- style="background:#e3e6ff;"  valign="top"
| '''<st>'''
| Activates after toggling between available targets
|- style="background:#e3e6ff;"  valign="top"
| '''<stpc>'''
| Activates after toggling between available player characters
|- style="background:#e3e6ff;"  valign="top"
| '''<stpt>'''
| Activates after toggling between available party members
|- style="background:#e3e6ff;"  valign="top"
| '''<stal>'''
| Activates after toggling between available alliance members
|- style="background:#e3e6ff;"  valign="top"
| '''<stnpc>'''
| Activates after toggling between available [[NPC]]s
|- style="background:#e3e6ff;"  valign="top"
| '''<lastst>'''
| Activates on last target acquired from <stpc>, <stnpc>, <stpt>, or <stal>
|- style="background:#e3e6ff;"  valign="top"
| '''<r>'''
| Activates on last player to /tell you (similar to /reply)
|- style="background:#e3e6ff;"  valign="top"
| '''<pet>'''
| Activates on your active [[pet]]
|- style="background:#e3e6ff;"  valign="top"
| '''<scan>'''
| Your [[widescan]] target
|}

Targeting specific party and alliance members:
:{| width="50%" cellpadding="2" cellspacing="2"
! style="background:#ffdead;" width="25%" | Pronoun
! style="background:#ffdead;" width="75%" | Target
|- style="background:#e3e6ff;"  valign="top"
| '''<p0>'''
| Targets self
|- style="background:#e3e6ff;"  valign="top"
| '''<p1>''' ... '''<p5>'''
| Targets second party member, and so on to <p5>
|- style="background:#e3e6ff;"  valign="top"
| '''<a10>''' ... '''<a15>'''
| Targets top most alliance, first member, and so on to <a15>
|- style="background:#e3e6ff;"  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.''

:{| width="75%" cellpadding="2" cellspacing="2"
! style="background:#ffdead;" width="40%" | Syntax
! style="background:#ffdead;" width="60%" | Example
|- style="background:#e3e6ff;"  valign="top"
| '''/ja "Job Ability" <target>'''
| /ja "[[Benediction]]" <me><br>/ja "[[Steal]]" <bt>
|- style="background:#e3e6ff;"  valign="top"
| '''/ma "Spell Name" <target>'''
| /ma "Blizzard IV" <bt><br>/ma "[[Curaga]]" <stpc>
|- style="background:#e3e6ff;"  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>
|- style="background:#e3e6ff;"  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>
|- style="background:#e3e6ff;"  valign="top"
| '''/ws "Weapon Skill Name" <target>'''
| /ws "[[Sturmwind]]" <bt><br>/ws "[[Hexa Strike]]" <bt>
|- style="background:#e3e6ff;"  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:

:{| width="75%" cellpadding="2" cellspacing="2"
! style="background:#ffdead;" width="40%" | Syntax
! style="background:#ffdead;" 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)|Charm]].
|- style="background:#e3e6ff;"  valign="top"
|}

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