Menu
Collapse
Expand

A Guide to Writing FFXIV Macros

Last Updated: February 27th, 2014 [ Patch 2.1 ]
Introduction to Macros
Overview
Introduction to Macros Guide

Macros are an amazing way to improve your gameplay. They allow you to add multiple abilities to a single button, cast abilities on mouse-over, cast abilities on a marked enemy instead of your target, and much more. Unfortunately, these macros can be a bit confusing to set up. The goal of this guide is to give you a complete understanding of how macros work and how to design them to do exactly what you want.

Getting Started

Important: By default, error messages are enabled in the default chat window. I recommend going to the System Menu (Esc) > Character Configuration > Log Window Settings > [1] General > Announcements tab > Turn Off "Error Messages."

To start making macros, open the System menu using the Escape key and select "User Macros." You'll notice there are some default macros already created in the upper left. You can choose to delete, modify, or ignore these. To create a new macro, select one of the empty numbers on the left and lets get started.

A macro is divided into three parts. You have the macro name, the macro icon, and the chat commands. Most of these chat commands will also require a targeting placeholder, such as <t> or <me>. When creating a new macro, the first step is to give it a name and then click on the empty box to the left of the name to assign an icon. The name and icon can be anything you want and have no effect on the macro's functionality.

Once the macro is named, you can move onto the commands. While the most common commands for macros are /action (/ac), /wait, and /marking (/mk), there are a large number of possible commands. You can have up to 15 of these commands in a single macro. To create a macro, you will need to decide what you want the macro to do. Let's start out simple and make a macro to combine multiple defensive buffs into a single button. To do this, you would give the macro a name and icon (anything), and then add the following lines:

/macroicon "Foresight"
/ac "Featherfoot" <me>
/ac "Keen Flurry" <me>
/ac "Foresight" <me>

The /macroicon "Foresight" command will change the icon to Foresight, allowing you to track it's cooldown on the icon. The first time you click this macro, it would use Featherfoot. If you click it again, it will use Keen Flurry since the first ability, Featherfoot, is on cooldown. This allows you to condense many abilities into a few buttons. If you would like all the abilities to be used from a single click, you can add a /wait 2.5 command between each /action. I personally prefer not to use /wait, as not using it allows me to control if I use all the abilities, or only a few.

Don't stop here, though! Combining abilities is far from the only thing macros can do. Check out the macro templates below, as well as the Job Macro lists to get an idea of the different functions macros can perform. Once you're comfortable using the templates and pre-made macros, don't forget to check out the command and placeholder lists to create your own.

Useful Macros Templates

Macro Description
/macroicon "Ability"
/ac "Ability" <t>
/ac "Ability" <tt>
Attempts to use the action on the current target. If the action cannot be used on the target, it will attempt to use it on your target's target. Useful for healers to nuke the tank's target. You can also use this with healing spells, allowing you to target monsters and heal whoever it is attacking.
/macroicon "Ability"
/ac "Ability" <mo>
Attempts to cast the ability on your mouseover target. This is great for healers to heal while having an enemy targeted.
/macroicon "Buff #3"
/ac "Buff #1" <me>
/ac "Buff #2" <me>
/ac "Buff #3" <me>
This will use one of the Buffs each time the button is clicked, starting with Buff #1. This is great for both defensive and offensive cooldowns. If you would wish for all of the buffs to be used with a single press of the button, add /wait 0.5 between each buff.
/macroicon "Attack #1"
/ac "Attack #1" <t>
/ac "Attack #2" <t>
/ac "Attack #3" <t>
While similar to the above example, this macro would be used for attacks that have a cooldown, allowing you to create a priority list. The main Job that benefits from such macros is Bard. This macro attempts to use attack #1. If it cannot due to attack #1 being on cooldown, not having enough MP/TP, or during a global cooldown, it will attempt to use the next ability and repeat this process.
/mk "bind2" <t> This will mark your target with the bind2 icon. You can use a number of different icons, including attack1-5, stop1-2, bind1-3, square, circle, cross, or triangle. You can also use different targeting methods, such as <mo>. Get creative!
/macroicon "Ability"
/mk "attack1" <t>
/ac "Ability" <t>
This is a great tank macro to use with your initial pulling ability such as Shield Lob or Tomahawk. It will use that ability and mark the target as the priority kill target.
/macroicon "CC Ability"
/ac "CC Ability" <bind1>
/ac "CC Ability" <t>
Attempts to cast a crowd-control ability, such as Sleep, on the bind1 target. You can also use other targeting options such as ignore1-5 or focus. If no target is marked or set to focus, the macro will just cast the ability on your target.
/blist add <r> This will add the last player to send you a message to your blacklist. Perfect for minimizing gil-seller spam.
Job Specific Macros
Macro Guide
Job Specific Macros

While this is not a complete list of possible macros, it should be a great start to your macro library. I'll be adding more macros to this list as I come across them.

White Mage Macros

Macro Description
/macroicon "Cure"
/ac "Cure" <mo>
This will cast Cure on your mouseover target. If you are a fan of mouseover healing, create a macro like this for each targeted heal.
/macroicon "Stone"
/ac "Stone" <t>
/ac "Stone" <mo>
/ac "Stone" <tt>
This will allow you to cast Stone on your mouseover or tank's target without ever losing target of the tank. Make this macro for Stone II, Aero, and Aero II. The <mo> line is optional.
/macroicon "Cure"
/ac "Cure" <tt>
/ac "Cure" <t>
This macro is mainly for FATE healing. If you target an enemy, it will heal whoever it is attacking. I don't recommend using this macro as your main healing macro since it will heal the wrong person if you target another healer.
/macroicon "Benediction"
/ac "Benediction" <t>
This macro will prevent Benediction from smart-targeting and accidentally healing yourself if you lose your target.
/macroicon "Repose"
/ac "Repose" <ignore1>
This will allow you to Repose a target without having to lose target on the tank. You can choose a number of targeting options, including <focus>, <ignore1-2>, <bind1-3>, or even <mo>.
/macroicon "Divine Seal"
/ac "Divine Seal" <me>
/ac "Presence of Mind" <me>
This will combine your Divine Seal and Presence of Mind into a single button. One click will only use Divine Seal, while multiple clicks will activate both. You can choose to add a /wait 0.5 between them if you would always like Presence of Mind to activate, but I wouldn't recommend it.
/macroicon "Raise"
/ac "Swiftcast" <me>
/ac "Raise" <t>
This macro will Swiftcast > Raise as quickly as possible, but you will need to spam the button.

Scholar Macros

Macro Description
/macroicon "Adloquium"
/ac "Adloquium" <mo>
This will cast Adloquium on your mouseover target. If you are a fan of mouseover healing, create a macro like this for each targeted heal.
/macroicon "Bio"
/ac "Bio" <t>
/ac "Bio" <mo>
/ac "Bio" <tt>
This will allow you to cast Bio on your mouseover or tank's target without ever losing target of the tank. Make this macro for all of your damaging spells. The <mo> line is optional.
/macroicon "Adloquium"
/ac "Adloquium" <tt>
/ac "Adloquium" <t>
This macro is mainly for FATE healing. If you target an enemy, it will heal whoever it is attacking. I don't recommend using this macro as your main healing macro since it will heal the wrong person if you target another healer.
/macroicon "Resurrection"
/ac "Swiftcast" <me>
/ac "Resurrection" <t>
This macro will Swiftcast > Resurrection as quickly as possible, but you will need to spam the button.

Bard Macros

Macro Description
/macroicon "Bloodletter"
/ac "Heavy Shot" <t>
/ac "Misery's End" <t>
/ac "Bloodletter" <t>
This will try to use Misery's End and Bloodletter during the global cooldown. I recommend creating macros for Windbite, Venomous Bite, and Straight Shot in place of Heavy Shot.
/macroicon "Hawk's Eye"
/ac "Barrage" <me>
/ac "Hawk's Eye" <me>
This will use both buffs at the same time. While you could add more buffs into this, these are the only two that have the same cooldown.
The Chat Commands
Reference Table
The Chat Commands

The chat commands are the part of the macro that determine what it does. The most common commands for combat macros are /action, /wait, and /marking.

Chat Command Description Example
/? This will provide help text and any sub-commands for the specified command. /? /action
/action (/ac) This will use any ability, weaponskill, or spell. This is the most common command in macros. /ac "Cure II" <mo>
/macroicon (/micon) This will change the icon of the macro to display the cooldown and MP/TP cost of the selected ability. Only used in the first line of a macro. /macroicon "Cure II"
/wait # Adds a delay (in seconds) /wait 2.5
/focus Sets the target as your focus target. /focus
/marking (/mk) By itself, /mk will open the Marking Menu. The following sub-commands will place their respective symbol on the target:
/mk attack1-5
/mk bind 1-3
/mk ignore1-2
/mk square
/mk circle
/mk cross
/mk triangle
/mk off (Turns off any symbol on the target)
/mk attack1 <t>
/partycmd (/pcmd) By itself, /pcmd will open the Party Menu. The following sub-commands can be added for different actions:
/pcmd add - Invites the target to your party.
/pcmd kick - Kicks the target from your party.
/pcmd leave - Leaves your party.
/pcmd breakup - Disbands your party.
/pcmd leader - Gives the target party leader.
/pcmd add <t>
/target (/ta) This will target the specified NPC or PC. /target <bind1>
/target <3>
/targetenemy (/tenemy) This will target the nearest enemy. /tenemy
/targetnpc (/tnpc) This will target the nearest NPC. /tnpc
/battletarget (/bt) This will target the nearest enemy that is in combat with you. /bt
/facetarget (/ft) This will face you towards your target. /ft
/assist (/as) This will change your target to be the target of another NPC or enemy. For example, /assist while targeting an enemy will target the player that enemy is attacking. /assist <t>
/say (/s)
/shout (/sh)
/yell (/y)
/party (/p)
/freecompany (/fc)
/linkshell (/L1-8)
Displays a message in desired chat channel. /p Stack up in melee!
/echo (/e) Displays a message to yourself in the chat log. /e Enemy is now asleep.
/recast Displays the remaining cooldown of an ability in the chat log. /recast Virus
/trade Initiates trade with another player. /trade <t>
/loot Opens the loot list. /loot
/automove Toggles Auto-Run on and off. /automove
/trade Initiates trade with another player. /trade <t>
/visor Raises or lowers the visor on certain helms. /visor
/legacymark (/lmark) Toggles the Mark of the Twelve on and off. /lmark
The Targeting / Placeholder Syntax
Reference Table
The Targeting / Placeholder Syntax

Once you have selected the proper chat commands, most of them will need a target. Choose the desired target from the table below. Also, using these placeholders in chat will display the name of the target.

Targeting Syntax Description Example
<t> Targets your target. /ac "Virus" <t>
<tt> Targets the target of your target. /ac "Stone II" <tt>
<mo> Targets your mouseover. /ac "Cure" <mo>
<focus> Targets your focus. /ac "Sleep" <focus>
<me> or <0> Targets yourself. /ac "Raging Strikes" <me>
<1> - <8> Targets your party members. /ac "Esuna" <7>
<attack1-5> Targets the attack markings. /ac "Fire" <attack2>
<ignore1-2> Targets the ignore markings. /ac "Sleep" <ignore2>
<bind1-3> Targets the bind markings. /ac "Sleep" <bind2>
<square> Targets the square marking. /ac "Aetherial Manipulation" <square>
<circle> Targets the circle marking. /ac "Leeches" <circle>
<cross> Targets the cross marking. /ac "Fluid Aura" <cross>
<triangle> Targets the triangle marking. /ac "Stoneskin" <triangle>
<lasttarget> or <lt> Targets your last target. /ac "Virus" <lt>
<lastenemy> or <le> Targets the last enemy you targeted. /ac "Bio" <le>
<lastattacker> or <la> Targets the last enemy you have attacked. /ac "Miasma" <la>

Other Placeholders

In addition to the above, these placeholders can be used to display information in your chat log. For example, the statement "I'm at <pos>" will create the message "I'm at Ul'dah - Steps of Nald (11,9)."

Placeholder Syntax Description
<hp> Displays your current health as an absolute number.
<hpp> Displays your current health as a percentage.
<mp> Displays your current MP as an absolute number.
<mpp> Displays your current MP as a percentage.
<tp> Displays your current TP.
<reply> or <r> Displays the last player to send you a message.
<focus> or <f> Displays the name of your focus target.
<pos> Displays your current position and creates a link to your current location.
<class> or <job> Displays your current class or job.
<pet> or <p> Displays your pets name.
<se.1-16> Plays a sound effect. Only usable in party chat. Do not use this frequently.