Difference between revisions of "Macro"

From Final Fantasy XIV Online Wiki
Jump to navigation Jump to search
(→‎Targeting Placeholders: Removed outdated and added missing placeholders)
(added /title command removed /job command cause it's no longer in game)
 
(31 intermediate revisions by 7 users not shown)
Line 2: Line 2:
:''See also [[Commands]], [[Controller Guide]] and [[Macro Guides]]''
:''See also [[Commands]], [[Controller Guide]] and [[Macro Guides]]''
{{TOCRIGHT}}
{{TOCRIGHT}}
Macros are user-defined automated commands that allow you to record multiple actions and trigger them with a single button or key stroke.
[[File:Macro icon2.png|link=]] Macros are user-defined sequences of commands that allow you to record multiple actions and trigger them with a single button or key stroke.
==Creating Macros==
==Creating Macros==
#Open main menu
#Open the Main Menu.
#Take the User Macro Option
#Select the User Macro Option under "System".
#Select the macro number you wish to modify
#Select the Macro Number you wish to modify.
#Name the Macro
#Name the Macro.
#Select the Macro Icon
#Select the Macro Icon.
#Add the script to the Macro
#*Note: for additional icon options, you can use the ''/macroicon'' or ''/micon'' command within the macro.
#*For example, using ''/micon "Fast Blade"'' will set the Macro Icon to the same icon used by this ability (''Fast Blade'').
#Add the script to the Macro.
#The Macro can then be set from the Macro UI to the Hotbar as an action.


{{#ev:youtube|4pjQCbyxsIw|400|right|Hotbar macro guide}}
==Macro Functionality==
*Each macro can contain a maximum of 15 lines/commands.
*A macro cannot start another macro (no nested macro commands).
*Only one macro can run at a time. Starting a new macro will cancel the currently running macro.
*There is no way to change the behavior of any macro once it begins running, even if certain conditions have been changed. This means that the actions taken are set and writing branching actions/commands based on conditions within the macro is not possible.
*A character can have a maximum of 100 character-specific individual macros and 100 shared macros that are shared across all characters on the account.
** This means that each character has, at any given time, access to 200 macros.
 
==Uses of Macros==
 
*The ability to queue actions in sequence using the '''Wait Function''' subcommand (<wait.X>) allow for several actions to be performed with a single press of the Macro on the hotbar, allowing for players to perform multiple actions with ease.
** This mean that macros are often used by [[Crafter|Crafters]] to streamline the crafting process for large numbers of items, as using a standardised macro for crafting specific items is more convenient than multiple individual manual inputs.
*Another use of macros is to change the game's settings; it is possible to control game settings such as volume, battle effects display toggle, and HUD layouts without navigating through numerous menus.
** This allows for Macros to be used for other QoL purposes, such as allowing players to quickly change your gearsets & combining actions/emotes with messages to other players with an single macro. This serves to both add ease of convenience to key functions as well as add flavor to interactions with other players.
* Macros can also be used to rapidly send messages in party or alliance chat - this is used in certain cases to quickly communicate and visualize boss mechanics to the parties/alliance before major boss fights.
 
==Limitations==
*While macros may make it easier in theory to chain a sequence of actions, there are certain limitations that affect the effectiveness of said macros:  
** All macros are fixed to run even if conditions change. For crafters using Crafting Macros, altered material conditions (Poor/Good/Excellent) happening while the crafting macros are running may cause either delayed or failed syntheses.
** High level crafting usually does not fit within the 15 lines limit, so it is recommended to use 2 or more macros for certain crafting recipes.
* The process of using macros as actions while using the Wait Function (<wait.X>) to queue actions is also inherently slower than manual human inputs; the Wait Function can only delay actions by full seconds and does not allow the use of decimal points.
** This means that if the recast timer is the GCD standard of 2.5 seconds, there will be a sub-optimal delay of 0.5 seconds of inaction. As this delay adds up over time across commands within more complex macros, using macros to queue up combat actions is less time-efficient compared to manual inputs and is not recommended for multiplayer combat-oriented content.
** The Wait Function also counts the delay time starts when the first command/action is started, not after the specific command/action is executed. As the animation time for macros may vary between actions, this may make it tricky to time the sequencing of actions while writing the macro.


The Macro can then be dragged from the Macro UI to the Hotbar
==List of Commands==
==List of Commands==
''This section is largely incomplete and is in need of detailing.''
''This section is largely incomplete and is in need of detailing.''
===Text Commands===
===Text Commands===
Entering a text command starting with the / (forward slash) key allows players to change equipment, use abilities, perform emotes and various other actions. Additional directions such as subcommands and placeholders can be added to commands for even greater customization, such as specifying targets, toggling functions on and off, and so on. The additional directions should follow the main command, separated by a space.
In general, entering a text command starting with the forward slash key ("/") allows players to change equipment, use abilities, perform emotes and various other actions. Additional directions such as subcommands and placeholders can be added to commands for even greater customization, such as specifying targets, toggling functions on and off, and so on. The additional directions should follow the main command, separated by a space.
====Chat====
====Chat====
{{main|Chat Text Commands}}
{| class="wikitable"
{| class="wikitable"
!Command
!Command
!Shorthand
!Shorthand
!Help
!Help
|-
| /alliance [mes.]
| /a
|Sends a message to all members of your current alliance, regardless of their location.<br>Typing /alliance or /a without a message switches the default chat mode to [Alliance].
|-
| /freecompany [mes.]
| /fc
|Sends a message to all members of your current Free Company, regardless of their location.<br>Typing /freecompany or /fc without a message switches the default chat mode to [Alliance].
|-
|-
|-
| /say [mes.]
| /say [mes.]
Line 30: Line 64:
| /shout [mes.]
| /shout [mes.]
| /sh
| /sh
|.
|Sends a message to all PCs in the same area. The message will not be displayed if a PC has deselected [Shout] in the chat filter.  
|-
|-
|/tell[PC_name] [mes.]
|/tell[PC_name] [mes.]
Line 80: Line 114:
| ses a companion action. The target of companion actions cannot be specified. This cannot be used with companion actions you have not yet learned, or when restricted by other factors.
| ses a companion action. The target of companion actions cannot be specified. This cannot be used with companion actions you have not yet learned, or when restricted by other factors.
e.g. /companionaction Attacker Stance
e.g. /companionaction Attacker Stance
|-
| /macroicon [action name]
| /micon
| Changes icon with ability name and displays the cooldown spiral.
|-
| /macroicon [action name][Pet name]
| /micon
| Changes icon with Pet ability name and displays the cooldown spiral.
|-
|-
| /recast [action name]
| /recast [action name]
Line 151: Line 177:
!Shorthand
!Shorthand
!Help
!Help
|-
| /target [subcommand]
| /ta
| Targets the object/entity specified by [subcommand]. Does not work if the specified entity is out of targeting range or does not exist.
{| class="wikitable"
! Value
! Description
|+ Subcommands
|-
| '''<0>'''
| Targets self.
|-
| '''<1> through <8>'''
| Targets the specified party member. (1 is always self.)
|-
| '''Other game-recognized target placeholder.'''
| Examples: '''<pet>''', '''<comp>''' (companion), '''&lt;tt&gt;''' or '''<t2t>''' (target of your target), '''<f>''' or '''<focus>''', etc.
Of particular note, '''<t>''' or '''<target>''' (your target) does nothing with this command, since it will either target what you are already targeting, or will not exist if you have nothing targeted (causing the macro line to return an error).
A complete list of game-recognized target placeholders can be found here: https://na.finalfantasyxiv.com/lodestone/playguide/db/text_command/placeholder/
|}
|-
|-
| /targetmode [subcommand]
| /targetmode [subcommand]
Line 258: Line 305:
| When executed, the character will immediately turn to face the main target. If the character is in motion, the character will come to an immediate halt.
| When executed, the character will immediately turn to face the main target. If the character is in motion, the character will come to an immediate halt.
|}
|}
====Equipment====
====Equipment====
{| class="wikitable"
{| class="wikitable"
Line 291: Line 339:
| /display[slot] [subcommand]
| /display[slot] [subcommand]
| none
| none
| Toggle the display of gear in the head or main hand slots.
| Toggle the display of gear in the head and/or weapon slots.
Gear Slots:
{| class="wikitable"
* main (valid in passive mode only)
!Slots
* head
!Description
|+
|-
| '''arms'''
| Toggles the items equipped in the Main Hand & Off-Hand slots.
|-
| '''head '''
| Toggles the item equipped in the Head slot.
|}
{| class="wikitable"
{| class="wikitable"
!Value
!Subcommands
!Description
!Description
|+ Subcommands
|+  
|-
|-
| '''On'''
| '''On'''
Line 307: Line 363:
|}
|}
|-
|-
| /job [subcommand]
| /gearset [subcommand]
| /gs
| Execute gear set functions.
{| class="wikitable"
!Subcommands
!Description
|+
|-
| '''change [num1] [num2]'''
| Changes your equipment to the gear set registered to the slot [num1] specified.<br>If glamor plates are available, plate number [num2] can also be specified.
|-
| '''view[num]'''
| View your equipment in the gear set registered to the slot [num] specified.
|-
| '''save[num]'''
| Save current gear to to the slot [num] specified.<br>A gear set name can be specified in place of a slot number.
|-
| '''delete[num]'''
| Delete the gear set registered to the slot [num] specified.<br>A gear set name can be specified in place of a slot number.
|}
|-
| /title [subcommand]
| none
| none
| Toggle the job associated with your current class.  Toggle between off and on when no subcommand is specified.
| Change your currently selected title.
{| class="wikitable"
{| class="wikitable"
!Value
!Subcommands
!Description
!Description
|+ Subcommands
|+  
|-
|-
| '''On'''
| '''set "title"'''
| Activate the associated job.
| Change your current title to "title"
|-
|-
| '''Off'''
| '''clear'''
| Deactivate the associated job.
| Display no title.
|}
|}
|}
|}
Line 428: Line 505:
|-
|-
| '''on'''
| '''on'''
| Turn names one.
| Turn names on.
|-
|-
| '''off'''
| '''off'''
Line 563: Line 640:
| '''off'''
| '''off'''
| Disable character shadows.
| Disable character shadows.
|}
|-
| /dusteffect [subcommand]
| /dust
| Toggle the display of graphic effects left by characters feet. Toggles between enabled and disabled when no subcommand is specified.
{| class="wikitable"
!Value
!Description
|+ Subcommands
|-
| '''on'''
| Enable effects made by feet.
|-
| '''off'''
| Disable effects made by feet.
|}
|}
|-
|-
Line 744: Line 806:
!Help
!Help
|-
|-
| /?
| /? [command name]
| /[command name]
| /?
| Gives a detailed explanation of specified command. Abbreviations can be used.
| Gives a detailed explanation of specified command. Abbreviations can be used.
If a command name is incomplete or does not exist, similar commands will be listed.
If a command name is incomplete or does not exist, similar commands will be listed.
*  All names used with these commands must be one word or in quotation marks.
*  All names used with these commands must be either a single word or in quotation marks.
|-
| /macroicon [icon name] [category]
| /micon
| Changes icon with named item/action as specified by the category. Category defaults to action if none is specified.
{| class="wikitable"
!Category
!Icon Description
|+
|-
| '''action<br>blueaction<br>pvpaction'''
| Specified action, blue mage action, and/or PvP action will displayed as the icon.<br>Recast time and required MP (if any) will be displayed with the icon.
|-
| '''general'''
| Specified general action will be displayed as the icon.<br>Recast time will be displayed with the icon.
|-
| '''pet<br>companion'''
| Specified pet/companion action will be displayed as the icon.
|-
| '''item<br>emote<br>minion<br>mount<br>enemysign<br>waymark<br>gearset<br>classjob<br>quickchat<br>'''
| Specified named item/entity will be displayed as the icon.
|}
|-
|-
| /wait [time] <br> <wait.[time]>
| /wait [time] <br> <wait.[time]>
| none
| none
| A macro command for adjusting the pause between commands.
| A macro command for adjusting the pause between commands. A wait time amount of 1 equals one second, and the maximum wait time allowed is 60.
A wait time amount of 1 equals one second.
If the wait time amount is over 60, it will be counted as 60.
The maximum wait time allowed is 60.
If the wait time amount is over 60, it will be counted as 0.
<br> e.g. /action Swiftcast <me> <wait.1>
<br> e.g. /action Swiftcast <me> <wait.1>
|-
|-
Line 786: Line 867:
| /automove
| /automove
| none
| none
| Continue walking/running in the direction you are moving.  Move in the opposite direction to cancel.
| Begin moving in the current direction you are facing; move backwards to cancel manually.<br>Toggles between on and off when no subcommand is specified.
{| class="wikitable"
!Value
!Description
|+ Subcommands
|-
| '''on'''
| Turns autowalk/autorun on.
|-
| '''off'''
| Turns autowalk/autorun off.
|}
|-
|-
| /check [target name]
| /check [target name]
| /c
| Examines the specified PC. Examines current target when no PC is specified.<br>Used in conjunction with Placeholders (<t>, <target>, <1>-<8>) within Macros.
|-
| /timer [subcommand]
| none
| none
| Checks the targeted player
| Displays the [[Timers]] Interface, showing the Daily and Weekly Checklist for in-game activities as well as the time remaining until their Daily/Weekly Resets.
|-
|-
| /clock [subcommand]
| /random [subcommand]
| none
| none
| Displays the current time, as well as the time remaining until several in-game activities such as guildleve renewal and behests.
| Roll a random number between 0 and the specified upper limit value (from a minimum of 2 up to a maximum of 999). Results will be displayed in a /say radius. Rolls will be between 0 and 999 if no upper limit value is designated.
|-
|-
| /random [value]
| /dice [chat mode] [subcommand]
| /dice
| none
| Roll a random number between 0 and the desginated value (up to 1,000). Results will be displayed in a /say radius.
| Roll a random number between 0 and the specified upper limit value (from a minimum of 2 up to a maximum of 999). Results will be displayed in the specified chat channel. Rolls will be between 0 and 999 if no upper limit value is designated.
Rolls will be between 0 and 100 when no value is designated.
{| class="wikitable"
!Chat Mode
!Description
|+
|-
| '''party, p'''
| Results are displayed in Party Chat.
|-
| '''alliance, al'''
| Results are displayed in Alliance Chat.
|-
| '''freecompany, fc'''
| Results are displayed in Free Company Chat.
|-
| '''pvpteam, pt'''
| Results are displayed in PvP Team Chat.
|-
| '''linkshell1-8, l1-8'''
| Results are displayed in Linkshell Chat.
|-
| '''cwlinkshell1-8, cwl1-8'''
| Results are displayed in Cross-World Linkshell Chat.
|-
|}
|-
|-
| /equiplinkshell [subcommand]
| /equiplinkshell [subcommand]
Line 885: Line 1,004:
|-
|-
|<attack1>, <attack2>, <attack3>, <attack4>, <attack5>
|<attack1>, <attack2>, <attack3>, <attack4>, <attack5>
|Displays target to attack 1-5's name (Using Signs)
|Displays target to attack 1-5's name (using [[signs]])
|-
|-
|<bind1>, <bind2>, <bind3>  
|<bind1>, <bind2>, <bind3>  
|Displays target to attack 1-3's name (using signs)
|Displays target to bind 1-3's name (using [[signs]])
|-
|-
|<ignore1>, <ignore2>
|<ignore1>, <ignore2>
|Displays target to ignore 1-2's name (using signs)
|Displays target to ignore 1-2's name (using [[signs]])
|-
|-
|<square>
|<square>
|Displays the name of the target marked with a square (using signs)
|Displays the name of the target marked with a square (using [[signs]])
|-
|-
|<circle>
|<circle>
|Displays the name of the target marked with a circle (using signs)
|Displays the name of the target marked with a circle (using [[signs]])
|-
|-
|<cross>
|<cross>
|Displays the name of the target marked with a cross (using signs)
|Displays the name of the target marked with a cross (using [[signs]])
|-
|-
|<triangle>
|<triangle>
|Displays the name of the target marked with a triangle (using signs)
|Displays the name of the target marked with a triangle (using [[signs]])
|}
|}


====Non-Targeting Placeholders====
====Non-Targeting Placeholders====
{| class="wikitable"
{| class="wikitable"
!Command
!Placeholder
!Help
!Description
|-
|<class>, <job>
|Displays current class (or job) and level. <br>Example: scholar(80)
|-
|-
|<hp>
|<hp>
Line 923: Line 1,045:
|Displays current MP as a percentage.<br>Example: 75%
|Displays current MP as a percentage.<br>Example: 75%
|-
|-
|<tp>
|<comphp>
|Displays current TP.<br>Example: 3000
|Displays your chocobo's current HP and maximum HP.<br>Example: 150/200
|-
|-
|<lastst>
|<comphpp>
|Displays name of last subtarget.
|Displays your chocobo's current HP as a percentage.<br>Example: 75%
|-
|-
|<pos>
|<thpp>, <targethpp>
|Display's coordinates of current location.
|Displays target's current HP as a percentage.<br>Example: 75%
|-
|-
|<sign0>
|<fhpp>, <focushpp>
|Displays ally sign 0.
|Displays focus target's current HP as a percentage.<br>Example: 75%
|-
|-
|<sign1>
|<fclass>, <focusclass>, <fjob>, <focusjob>
|Displays ally sign 1.
|Displays focus target's class (or job). <br>Example: astrologian
|-
|-
|<sign2>
|<pos>
|Displays ally sign 2.
|Display's coordinates of current location.
|-
|<sign3>
|Displays ally sign 3.
|-
|<sign4>
|Displays ally sign 4.
|-
|<sign5>
|Displays ally sign 5.
|-
|-
|<sign6>
|<flag>
|Displays ally sign 6.
|Display's coordinates of flag's location.
|-
|-
|<sign7>
|<recast.[action name]>
|Displays ally sign 7.
|Display's cooldown for specified action. <br>Example (<recast.summon seraph>): 1:32
|}
|}


Latest revision as of 17:44, 21 October 2024

Key elements of this article are incomplete. You can help the Final Fantasy XIV Wiki by expanding it.
See also Commands, Controller Guide and Macro Guides

Macro icon2.png Macros are user-defined sequences of commands that allow you to record multiple actions and trigger them with a single button or key stroke.

Creating Macros

  1. Open the Main Menu.
  2. Select the User Macro Option under "System".
  3. Select the Macro Number you wish to modify.
  4. Name the Macro.
  5. Select the Macro Icon.
    • Note: for additional icon options, you can use the /macroicon or /micon command within the macro.
    • For example, using /micon "Fast Blade" will set the Macro Icon to the same icon used by this ability (Fast Blade).
  6. Add the script to the Macro.
  7. The Macro can then be set from the Macro UI to the Hotbar as an action.

Macro Functionality

  • Each macro can contain a maximum of 15 lines/commands.
  • A macro cannot start another macro (no nested macro commands).
  • Only one macro can run at a time. Starting a new macro will cancel the currently running macro.
  • There is no way to change the behavior of any macro once it begins running, even if certain conditions have been changed. This means that the actions taken are set and writing branching actions/commands based on conditions within the macro is not possible.
  • A character can have a maximum of 100 character-specific individual macros and 100 shared macros that are shared across all characters on the account.
    • This means that each character has, at any given time, access to 200 macros.

Uses of Macros

  • The ability to queue actions in sequence using the Wait Function subcommand (<wait.X>) allow for several actions to be performed with a single press of the Macro on the hotbar, allowing for players to perform multiple actions with ease.
    • This mean that macros are often used by Crafters to streamline the crafting process for large numbers of items, as using a standardised macro for crafting specific items is more convenient than multiple individual manual inputs.
  • Another use of macros is to change the game's settings; it is possible to control game settings such as volume, battle effects display toggle, and HUD layouts without navigating through numerous menus.
    • This allows for Macros to be used for other QoL purposes, such as allowing players to quickly change your gearsets & combining actions/emotes with messages to other players with an single macro. This serves to both add ease of convenience to key functions as well as add flavor to interactions with other players.
  • Macros can also be used to rapidly send messages in party or alliance chat - this is used in certain cases to quickly communicate and visualize boss mechanics to the parties/alliance before major boss fights.

Limitations

  • While macros may make it easier in theory to chain a sequence of actions, there are certain limitations that affect the effectiveness of said macros:
    • All macros are fixed to run even if conditions change. For crafters using Crafting Macros, altered material conditions (Poor/Good/Excellent) happening while the crafting macros are running may cause either delayed or failed syntheses.
    • High level crafting usually does not fit within the 15 lines limit, so it is recommended to use 2 or more macros for certain crafting recipes.
  • The process of using macros as actions while using the Wait Function (<wait.X>) to queue actions is also inherently slower than manual human inputs; the Wait Function can only delay actions by full seconds and does not allow the use of decimal points.
    • This means that if the recast timer is the GCD standard of 2.5 seconds, there will be a sub-optimal delay of 0.5 seconds of inaction. As this delay adds up over time across commands within more complex macros, using macros to queue up combat actions is less time-efficient compared to manual inputs and is not recommended for multiplayer combat-oriented content.
    • The Wait Function also counts the delay time starts when the first command/action is started, not after the specific command/action is executed. As the animation time for macros may vary between actions, this may make it tricky to time the sequencing of actions while writing the macro.

List of Commands

This section is largely incomplete and is in need of detailing.

Text Commands

In general, entering a text command starting with the forward slash key ("/") allows players to change equipment, use abilities, perform emotes and various other actions. Additional directions such as subcommands and placeholders can be added to commands for even greater customization, such as specifying targets, toggling functions on and off, and so on. The additional directions should follow the main command, separated by a space.

Chat

Main article: Chat Text Commands
Command Shorthand Help
/alliance [mes.] /a Sends a message to all members of your current alliance, regardless of their location.
Typing /alliance or /a without a message switches the default chat mode to [Alliance].
/freecompany [mes.] /fc Sends a message to all members of your current Free Company, regardless of their location.
Typing /freecompany or /fc without a message switches the default chat mode to [Alliance].
/say [mes.] /s Sends a message to all PCs within a small radius.
The message will not be displayed if a PC has their [Say] chat filter turned on.
Typing /say or /s without a message switches the default chat mode to [Say].
/shout [mes.] /sh Sends a message to all PCs in the same area. The message will not be displayed if a PC has deselected [Shout] in the chat filter.
/tell[PC_name] [mes.] /t Sends a message to a specific PC within the same World.
This message cannot be seen by any other PCs.
Typing /tell or /t [PC_name] without a message switches the default chat mode to [Tell].
/party [mes.] /p Sends a message to all members of your current party, regardless of their location.
Typing /party or /p without a message switches the default chat mode to [Party].
/linkshell [mes.] /l Sends a message to all members of your active linkshell, regardless of their location.
Typing /linkshell or /l without a message switches the default chat mode to [Linkshell].
/echo [mes.] /e Displays a message that only you can see.
/chatmode [chat mode] /cm Set the default chat mode.

>>Example:
/chatmode party
(Changes default chat mode to party chat.)
The default mode will be deactivated after a single message if it is set to Shout.
When setting the default mode to Tell, you are still required to enter the recipient PC's name.


If no chat mode is specified, the current default setting will be displayed.

Actions

Command Shorthand Help
/action [action name] /ac Uses an action on a specified target. This cannot be used with actions you have not yet learned, or when restricted by other factors.
/petaction [action name] /pac Uses a pet action on the specified PC. Uses current target when not specified. This cannot be used with pet actions you have not yet learned, or when restricted by other factors.

e.g. /petaction Obey

/companionaction [action name] /cac ses a companion action. The target of companion actions cannot be specified. This cannot be used with companion actions you have not yet learned, or when restricted by other factors.

e.g. /companionaction Attacker Stance

/recast [action name] none Displays time remaining until the specified action can be used again.
/actionerror [toggle] /aerror Disables, or enabled action errors, useful for preventing messaging on macros that are intended to fallback.
Value Description
Options
On Enable action error messages
Off Disable action error messages
/equipaction [slot] [action name] /eaction Equips an action to a specified slot.


If an action name is omitted, the action currently equipped to that slot will be removed. Basic class actions cannot be removed. Slots are designated by the numbers 1–30.

/actionqueue [subcommand] /aq Toggle the priority input feature for actions.

Displays whether priority input is enabled or disabled when no subcommand is specified.

Value Description
Subcommands
On Enable priority input
Off Disable priority input
/actioncancel [subcommand] /acan Enable cancelling of actions by selecting them again from the action bar while they are being cast or channeled.

Toggles between on and off when no subcommand is specified.

Value Description
Subcommands
On Enable cancelling via the action bar.
Off Disable cancelling via the action bar.

Targeting

Command Shorthand Help
/target [subcommand] /ta Targets the object/entity specified by [subcommand]. Does not work if the specified entity is out of targeting range or does not exist.
Value Description
Subcommands
<0> Targets self.
<1> through <8> Targets the specified party member. (1 is always self.)
Other game-recognized target placeholder. Examples: <pet>, <comp> (companion), <tt> or <t2t> (target of your target), <f> or <focus>, etc.

Of particular note, <t> or <target> (your target) does nothing with this command, since it will either target what you are already targeting, or will not exist if you have nothing targeted (causing the macro line to return an error).

A complete list of game-recognized target placeholders can be found here: https://na.finalfantasyxiv.com/lodestone/playguide/db/text_command/placeholder/

/targetmode [subcommand] /tmode Toggle between targeting modes.
Value Description
Subcommands
a Activate targeting mode A. Use up and down to target party members, and left and right to cycle targets based on current target filter.
b Activate targeting mode B. Use up and down to select a target filer, and left and right to cycle targets.
c Activate targeting mode C. Use up and down to target party members, and left and right to cycle all targets.
/battletargetmode [subcommand] /btmode Toggle targeting mode only for enemies that are engaged. Toggle on and off when no subcommand is specified.
Value Description
Subcommands
On Activate targeting mode.
Off Disable targeting mode.
/directtarget [subcommand] /dtar Toggle direct targeting on. Press accept/confirm to select the nearest target, regardless of filters. Toggle between on and off when no subcommand is specified.
Value Description
Subcommands
On Toggle direct targeting on. Press Accept/Confirm to select the nearest target, regardless of target filters.
Off Toggle direct targeting off.
/targetpc none Targets the closest PC within a certain radius.
/targetnpc none Targets the closest NPC or enemy within a certain radius.
/targetenemy /tenemy Targets the closest enemy
/battletarget /bt Targets the closest engaged target
/lockon none Locks on to the target. Enter the command again to turn lock off.
/autolockon [subcommands] /autolock Automatically lock onto targets. Toggle between enabled and disabled modes when no subcommand is specified.
Value Description
Subcommands
On Enable automatic target lock.
Off Disable automatic targtet lock.
/assist /as Targets the target of a PC specified by a ‹t› or ‹p#› macro.
/subtarget [subcommand] /st Toggles subtargeting when executing commands directly from the action bar. Toggle between on and off when no command is specified.
Value Description
Subcommands
On Enable subtargeting.
Off Disable subtargeting.
/facetarget /ft When executed, the character will immediately turn to face the main target. If the character is in motion, the character will come to an immediate halt.

Equipment

Command Shorthand Help
/display[slot] [subcommand] none Toggle the display of gear in the head and/or weapon slots.
Slots Description
arms Toggles the items equipped in the Main Hand & Off-Hand slots.
head Toggles the item equipped in the Head slot.
Subcommands Description
On Show the item equipped in the designated slot.
Off Hide the item equipped in the designated slot.
/gearset [subcommand] /gs Execute gear set functions.
Subcommands Description
change [num1] [num2] Changes your equipment to the gear set registered to the slot [num1] specified.
If glamor plates are available, plate number [num2] can also be specified.
view[num] View your equipment in the gear set registered to the slot [num] specified.
save[num] Save current gear to to the slot [num] specified.
A gear set name can be specified in place of a slot number.
delete[num] Delete the gear set registered to the slot [num] specified.
A gear set name can be specified in place of a slot number.
/title [subcommand] none Change your currently selected title.
Subcommands Description
set "title" Change your current title to "title"
clear Display no title.

Party

Command Shorthand Help
/partycmd [subcommand] /pcmd Executes various party commands.
Value Description
Subcommands
join Accept a party invite.
decline Decline a party invite.
add [name] Invite targeted PC to your party.
leave Leave your current party.
kick [name] Oust a PC from your party.
breakup Dissolve your current party.
/join none Accepts a party invite.
/decline none Declines a party invite.

UI Display

Command Shorthand Help
/actionbar [subcommand] /abar Toggle actionbar display method. Toggles between on and off when no subcommand is specified.
Value Description
Subcommands
on Always display actionbar.
off Display bar only when executing commands.
/actionbarhelp [subcommand] /abarhelp Display pop-up help text for action bars. Toggle between on and off when no subcommand is specified.
Value Description
Subcommands
on Display help text.
off Hide help text.
/targetcursor [subcommand] /tcursor Set the default position of the target cursor.
Value Description
Subcommands
a Set to central.
b Set to floating.
c Set to both central and floating.
/names [subcommand] none Turn all name displays on or off. Toggles between on and off when no subcommand is specified.
Value Description
Subcommands
on Turn names on.
off Turn names off.
/enemylevel [subcommand] /elevel Display levels below enemies' names. Toggles between off and on when no subcommand is specified.
Value Description
Subcommands
on Display enemy levels
off Hide enemy levels.
/enemyicon [subcommand] /eicon Display active and non-active icons for enemies. Toggles between off and on when no subcommand is specified.
Value Description
Subcommands
on Display active (red) and non-active (green) icons.
off Hide active (red) and non-active (green) icons.
/enmity [subcommand] /enm Display enemy enmity icons. Toggles between off and on when no subcommand is specified.
Value Description
Subcommands
on Display enmity icons next to enemy HP bars.
off Hide enmity icons.
/away [subcommand] none Change your online status to away. Toggles between off and on when no subcommand is specified.
Value Description
Subcommands
on Display away icon.
off Hide away icon.
/countdown [value] /count Initiate a countdown in seconds, starting at the designated value (up to 20 seconds).

Countdown length is 5 seconds when no value is specified. Words and numbers displayed will not appear in screenshots.

Menus

Command Shorthand Help
/loot none Opens your loot list.
/friendlist /flist Opens your friend list.
/blacklist [subcommand] /blist Opens your blacklist.
Command Description
Subcommands
add [name] Adds the character with the specified name to your blacklist.
/map none Opens the current area map.
/supportdesk /helpdesk Opens the help desk menu.
/logout none Begins the log out process.
/shutdown none Log out and exit the game.

Configuration

Command Shorthand Help
/shadow [subcommand] none Toggle the display of character shadows. Toggles between enabled and disabled when no subcommand is specified.
Value Description
Subcommands
on Enable character shadows.
off Disable character shadows.
/physics [subcommand] none Toggle realistic physics effects. Toggles between enabled and disabled modes when no subcommand is specified.
Value Description
Subcommands
on Enable realistic physics effects.
off Disable realistic physics effects.
/profanity [subcommand] none Toggle the profane language filter. Toggles between enabled and disabled when no subcommand is specified.
Value Description
Subcommands
on Enable the language filter.
off Disable the language filter.
/scrollingbattletext [subcommand] /sbt Toggle the display of damage and other combat information.
Value Description
Subcommands
on Enable graphic combat text.
off Disable graphic combat text.
/extendeddraw [subcommand] /edraw Extend the range at which graphics are drawn. Toggles between off and on when no subcommand specified.
Value Description
Subcommands
on Enable extended drawing.
off Disable extended drawing.
/textclear [num] [subcommand] /tc Toggle the text auto-hide feature for num log window. Text will be hidden after 60 seconds.

Toggles between off and on when no subcommand is specified.

Value Description
Subcommands
on Turn on the log text hide feature.
off Turn off the log text hide feature.
/camera [subcommand] /cam Set the current camera position as default when no subcommand is specified.
Value Description
Subcommands
reset Reset position to system default.
/uilock [subcommand] none Prevents movement or resizing of UI elements. Toggles between on and off when no subcommand is specified.
Value Description
Subcommands
on Lock the position and size of all UI elements.
off Unlock the position and size of all UI elements.
/uihelp [subcommand] none Display pop-up help text for each UI element. Toggles between on and off when no subcommand given.
Value Description
Subcommands
on Display help text.
off Hide help text.

Player Search

Command Shorthand Help
/search [query] ... /who Search for players using the designated conditions. Results are displayed in the player search interface.

The following can be used as search subcommands:

  • Status
  • Class
  • Level
  • Job
  • Grand Company Affiliation
  • Area
  • Language

Subcommands for the /search (/who) text command can be input directly in the language selected in the FINAL FANTASY XIV Config. Searches can also be made using words found in the auto-translate dictionary.

Other

Command Shorthand Help
/? [command name] /? Gives a detailed explanation of specified command. Abbreviations can be used.

If a command name is incomplete or does not exist, similar commands will be listed.

  • All names used with these commands must be either a single word or in quotation marks.
/macroicon [icon name] [category] /micon Changes icon with named item/action as specified by the category. Category defaults to action if none is specified.
Category Icon Description
action
blueaction
pvpaction 		Specified action, blue mage action, and/or PvP action will displayed as the icon.
Recast time and required MP (if any) will be displayed with the icon.
general Specified general action will be displayed as the icon.
Recast time will be displayed with the icon.
pet
companion 		Specified pet/companion action will be displayed as the icon.
item
emote
minion
mount
enemysign
waymark
gearset
classjob
quickchat
 		Specified named item/entity will be displayed as the icon.
/wait [time]
<wait.[time]> 		none A macro command for adjusting the pause between commands. A wait time amount of 1 equals one second, and the maximum wait time allowed is 60.

If the wait time amount is over 60, it will be counted as 60.
e.g. /action Swiftcast <me> <wait.1>

/battlemode [subcommand] /bm Toggles between active and passive mode. Toggles between active and passive mode when no subcommand is specified.
Value Description
Subcommands
on Switch to active mode.
off Switch to passive mode.
/item [item name] [target name] none Uses an item on the specified target. Cannot be used with items that are not in your inventory, or when restricted by other factors.
/marking [num] [target] /enemysign Set an enemy sign on the specified target. Select the type of sign using a number from 1 to 8

Example: 

/enemysign 1

sets sign type one on target.

/automove none Begin moving in the current direction you are facing; move backwards to cancel manually.
Toggles between on and off when no subcommand is specified.
Value Description
Subcommands
on Turns autowalk/autorun on.
off Turns autowalk/autorun off.
/check [target name] /c Examines the specified PC. Examines current target when no PC is specified.
Used in conjunction with Placeholders (<t>, <target>, <1>-<8>) within Macros.
/timer [subcommand] none Displays the Timers Interface, showing the Daily and Weekly Checklist for in-game activities as well as the time remaining until their Daily/Weekly Resets.
/random [subcommand] none Roll a random number between 0 and the specified upper limit value (from a minimum of 2 up to a maximum of 999). Results will be displayed in a /say radius. Rolls will be between 0 and 999 if no upper limit value is designated.
/dice [chat mode] [subcommand] none Roll a random number between 0 and the specified upper limit value (from a minimum of 2 up to a maximum of 999). Results will be displayed in the specified chat channel. Rolls will be between 0 and 999 if no upper limit value is designated.
Chat Mode Description
party, p Results are displayed in Party Chat.
alliance, al Results are displayed in Alliance Chat.
freecompany, fc Results are displayed in Free Company Chat.
pvpteam, pt Results are displayed in PvP Team Chat.
linkshell1-8, l1-8 Results are displayed in Linkshell Chat.
cwlinkshell1-8, cwl1-8 Results are displayed in Cross-World Linkshell Chat.
/equiplinkshell [subcommand] /el Activate the designated linkshell. Unequips active linkshell when no subcommand is specified.
Value Description
Subcommands
LS Name Equip linkshell with provided name. Quotation marks are required for names containing a space.
LS Number Equip linkshell corresponding to designated number.

Placeholders

The following placeholder commands are also available for chatting and text commands.

Targeting Placeholders

Placeholder Description
<t>, <target> Displays current target's name.
<tt>, <t2t> Displays target of current target's name
<f>, <focus> Displays your focus target's name
<r>, <reply> Displays the name of the last player to send you a /tell
<pet> Displays your current (Familiar/Egi/Fairy) name
<comp>, <buddy>, <c>, <b> Displays your summoned chocobo companion's name
<mo>, <mouse> Displays the name of the target under your mouse cursor (or party/ally UI)
<f>, <focus> Displays the name of your /focustarget
<me>, <0> Displays your character's name.
<1> Party Member 1. Displays name of first party member in list.
<2> Party Member 2. Displays name of second party member in list.
<3> Party Member 3. Displays name of third party member in list.
<4> Party Member 4. Displays name of fourth party member in list.
<5> Party Member 5. Displays name of fifth party member in list.
<6> Party Member 6. Displays name of sixth party member in list.
<7> Party Member 7. Displays name of seventh party member in list.
<8> Party Member 8. Displays name of eighth party member in list.
<la>, <lastattacker> Displays the last enemy that attacked you.
<le>, <lastenemy> Displays the last enemy you targeted.
<lt>, <lasttarget> Displays your last target.
<attack1>, <attack2>, <attack3>, <attack4>, <attack5> Displays target to attack 1-5's name (using signs)
<bind1>, <bind2>, <bind3> Displays target to bind 1-3's name (using signs)
<ignore1>, <ignore2> Displays target to ignore 1-2's name (using signs)
<square> Displays the name of the target marked with a square (using signs)
<circle> Displays the name of the target marked with a circle (using signs)
<cross> Displays the name of the target marked with a cross (using signs)
<triangle> Displays the name of the target marked with a triangle (using signs)

Non-Targeting Placeholders

Placeholder Description
<class>, <job> Displays current class (or job) and level.
Example: scholar(80)
<hp> Displays current HP and maximum HP.
Example: 150/200
<hpp> Displays current HP as a percentage.
Example: 75%
<mp> Displays current MP and maximum MP.
Example: 75/100
<mpp> Displays current MP as a percentage.
Example: 75%
<comphp> Displays your chocobo's current HP and maximum HP.
Example: 150/200
<comphpp> Displays your chocobo's current HP as a percentage.
Example: 75%
<thpp>, <targethpp> Displays target's current HP as a percentage.
Example: 75%
<fhpp>, <focushpp> Displays focus target's current HP as a percentage.
Example: 75%
<fclass>, <focusclass>, <fjob>, <focusjob> Displays focus target's class (or job).
Example: astrologian
<pos> Display's coordinates of current location.
<flag> Display's coordinates of flag's location.
<recast.[action name]> Display's cooldown for specified action.
Example (<recast.summon seraph>): 1:32

Guides

Main article: Macro Guides

Retrieved from "https://ffxiv.consolegameswiki.com/mediawiki/index.php?title=Macro&oldid=840516"